cch - определяет размер буфера в символах.
Возвращаемые значения
Когда функция копирует имя файла в буфер, то возвращается число скопированных символов без учета завершающего нулевого символа.
Если значение параметра iFile равно 0 xFFFFFFFF, то возвращается число перемещенных мышью файлов.
Если значение параметра iFile лежит между нулем и количеством перемещенных файлов, и значение параметра lpszFile равно NULL, возвращается требуемый размер буфера, в символах, без учета завершающего нулевого символа.
См . также
DragQueryPoint .
DragQueryPoint
Функция DragQueryPoint возвращает позицию курсора мыши в тот момент, когда при перетаскивании файлов была отпущена левая кнопка мыши.
BOOL DragQueryPoint (
HDROP hDrop , // дескриптор структуры для перемещенных файлов
LPPOINT lppt // указатель на структуру для координат мыши
);
Параметры
hDrop - идентифицирует структуру, описывающую перемещенные мышью файлы.
lppt - указывает на структуру POINT , которую функция заполняет координатами мыши в тот момент, когда при перетаскивании файлов была отпущена левая кнопка мыши.
Возвращаемые значения
Если отпускание левой кнопки мыши происходит в клиентской области окна, то возвращается ненулевое значение.
Если отпускание левой кнопки мыши происходит вне клиентской области окна, то возвращается нуль.
Комментарии
Координаты курсора мыши возвращаются для окна, получающего сообщение WM _ DROPFILES .
См. также
DragQueryFile, POINT , WM_DROPFILES.
FindExecutable
Функция FindExecutable возвращает имя и дескриптор исполняемого (.ЕХЕ) файла, ассоциированного с указанным файлом.
HINSTANCE FindExecutable (
LPCTSTR lpFile , // указатель на строку с именем файла
LPCTSTR lpDirectory , // указатель на строку с директорией по
// умолчанию
LPTSTR lpResult // указатель на буфер для строки с именем
// возвращаемого .ЕХЕ файла
);
Параметры
lpFile - указатель на завершающуюся нулем строку, определяющую имя файла. Файл может быть либо документом, либо исполняемым файлом.
lpDirectory - указатель на завершающуюся нулем строку, определяющую директорию по умолчанию.
lpResult - указатель на буфер для имени возвращаемого функцией файла. Имя файла представляет собой завершающуюся нулем строку, определяющую исполняемый файл, который запускается при открытии файла, заданного параметром lpFile .
Возвращаемые значения
В случае успеха возвращаемое значение больше 32. В случае неудачи возвращаемое значение меньше или равно 32. В следующей таблице приведены возможные ошибочные значения:
|
Значение |
Пояснение |
|
0 |
Недостаток памяти или ресурсов. |
|
31 |
Отсутствует ассоциация для данного типа файлов. |
|
ERROR_FILE_NOT_FOUND |
Указанный файл не найден. |
|
ERROR_PATH_NOT_FOUND |
Указанный путь не найден. |
|
ERROR_BAD_FORMAT |
Неверный формат .ЕХЕ файла (не Win32 .EXE или поврежденный файл) |
Комментарии
При возвращении параметр lpResult может содержать путь к серверу DDE, запускаемому, если не получен ответ на запрос инициации DDE-диалога.
См . также
ShellExecute .
Заполненные фигуры
FrameRect
Функция FrameRect рисует границу вокруг заданного прямоугольника, используя указанную кисть. Ширина и высота границы всегда равны одной логической единице.
int FrameRect (
HDC hDC , // дескриптор контекста устройства
CONST RECT *lprc , // указатель на координаты прямоугольника
HBRUSH hbr // дескриптор кисти
);
Параметры
hDC - идентифицирует контекст устройства, в котором будет нарисована граница.
lprc - указывает на структуру типа RECT , которая содержит логические координаты верхнего левого и правого нижнего углов прямоугольника.
hbr - идентифицирует кисть, используемую для рисования границы
Возвращаемые значения
В случае успеха возвращается TRUE.
В случае неудачи возвращается FALSE. Для получения дополнительной информации об ошибке вызовите функцию GetLastError .
Комментарии
Кисть, идентифицируемая параметром hbr , должна быть создана с использованием функций CreateHatchBrush, CreatePatternBrush или CreateSolidBrush , или извлечена с использованием функции GetStockObject .
Если член bottom структуры типа RECT меньше или равен члену top , или член right меньше или равен члену left , то функция не рисует прямоугольник.
См. также
CreateHatchBrush, CreatePatternBrush, CreateSolidBrush, GetStockObject, RECT .
Класс окна
GetClassName
Функция GetClassName извлекает имя класса, к которому принадлежит заданное окно.
int GetClassName (
HWND hWnd , // дескриптор окна
LPTSTR lpClassName , // адрес буфера для имени класса
int nMaxCount // размер буфера, в символах
);
Параметры
hWnd - идентифицирует окно и, неявно, класс, к которому оно принадлежит.
lpClassName - указывает на буфер, который получает строку с именем класса.
nMaxCount - определяет размер буфера, указанного параметром lpClassName , в символах. Строка с именем класса усекается, если ее длина больше размера буфера.
Возвращаемые значения
В случае успеха возвращается количество скопированных в буфер символов.