CDM_GETFILEPATH сообщение

[Начиная с Windows Vista, общие диалоговые окна "Открыть" и "Сохранить как" заменены диалоговым окном "Общий элемент". Мы рекомендуем использовать API общих диалоговых окон вместо этих диалоговых окон из общей библиотеки диалоговых окон.]

Извлекает путь и имя выбранного файла в диалоговом окне Открыть или Сохранить как в стиле Обозреватель. Диалоговое окно должно быть создано с флагом OFN_EXPLORER ; В противном случае сообщение завершается ошибкой.

#define WM_USER                  0x0400
#define CDM_FIRST               (WM_USER + 100)
#define CDM_GETFILEPATH         (CDM_FIRST + 0x0001)

Параметры

wParam

Размер буфера lParam в символах. Для версии ANSI это число байтов; Для версии Юникода это число символов.

lParam

Указатель на буфер, получающий имя файла и путь.

Возвращаемое значение

Если сообщение завершается успешно, возвращаемым значением является размер (в символах) имени файла и строки пути, включая завершающий символ NULL. Это либо количество байтов или символов, скопированных в буфер, либо требуемый размер буфера, если буфер слишком мал.

При возникновении ошибки возвращаемое значение меньше нуля.

Комментарии

Соответствующий макрос выглядит следующим образом:

int CommDlg_OpenSave_GetFilePath(hwnd, lparam, wparam); 

Требования

См. также раздел

Справочные материалы

GetOpenFileName

GetSaveFileName

OPENFILENAME

Основные понятия

Общая библиотека диалоговых окон