Здравствуйте, уважаемые подписчики. Перед вами очередной выпуск рассылки "WinAPI
на русском".
Сайт рассылки: http://www.winnt.rsm.org.ru. Материалы по Win32 API, C++Builder.
Раздел "WinAPI": http://www.winnt.rsm.org.ru/winapi/winapi.htm
Раздел "C++Builder": http://www.winnt.rsm.org.ru/cbuilder/cbuilder.htm
Раздел "Советы & примеры": http://www.winnt.rsm.org.ru/tipstricks/tipstricks.htm
Обновления на сайте
Нет.
Перевод
Сегодня вашему вниманию представлен перевод функции DragQueryFile.
DragQueryFile
Функция DragQueryFile извлекает имена перемещенных мышью файлов.
UINT DragQueryFile(
HDROP hDrop, // дескриптор структуры для перемещенных файлов
UINT iFile, // индекс запрошенного файла
LPTSTR lpszFile, // буфер для имени файла
UINT cch // размер буфера для имени файла
);
Параметры
hDrop – идентифицирует структуру, содержащую имена файлов.
iFile – определяет индекс запрашиваемого файла. Если значение параметра iFile
равно
0xFFFFFFFF, DragQueryFile возвращает число перемещенных файлов. Если значение
параметра iFile лежит между нулем и количеством перемещенных файлов, DragQueryFile
копирует соответствующее значению им файла в буфер, указанный параметром lpszFile.
lpszFile – указывает на буфер для имени перемещенного файла. Им файла представляет
собой завершающуюся нулем строку. Если значение lpszFile равно NULL, DragQueryFile
возвращает необходимый размер буфера в символах.
cch – определяет размер буфера в символах.
Возвращаемые значения
Когда функция копирует имя файла в буфер, то возвращается число скопированных
символов без учета завершающего нулевого символа.
Если значение параметра iFile равно 0xFFFFFFFF, то возвращается число перемещенных
мышью файлов.
Если значение параметра iFile лежит между нулем и количеством перемещенных файлов,
и
значение параметра lpszFile равно NULL, возвращается требуемый размер буфера,
в
символах, без учета завершающего нулевого символа.
См. также
DragQueryPoint.
хелп по WinAPI: http://www.winnt.rsm.org.ru/winapi/winapirefresh.htm
С уважением,
ведущий рассылки
Тарас Сорока.
mailto:tnsoroka@online.ru