OFNHookProc

Функция приложения библиотека определенная или обратного вызова, используемый в стиле проводника Открыть и Сохранить как общие диалоговые является процедуру подключения OFNHookProc . Эта функция получает уведомления сообщений, отправленных из общего диалогового окна. Эта функция получает сообщения для любых дополнительных элементов управления, которые вы определили, указав шаблон диалогового окна ребенок.

Тип LPOFNHOOKPROC определяет указатель на эту функцию обратного вызова. OFNHookProc — это имя приложения библиотека определенная или функции.

Если не указан флаг OFN_EXPLORER при создании открытым или Сохранить как общее диалоговое окно, и вы хотите процедуру подключения, необходимо использовать процедуру подключения старого стиля OFNHookProcOldStyle . В этом случае диалоговое окно будет иметь старый стиль пользовательского интерфейса.

(UINT обратного ВЫЗОВА OFNHookProc HWND  hdlg, / / обработать для детской диалогового окнаUINTuiMsg, / / сообщение идентификаторWPARAMwParam, / / сообщение параметрLPARAMlParam / / сообщение параметр);
 

Параметры

hdlg
Дескриптор диалоговое окно ребенок диалогового окна Открыть или Сохранить как . Использовать функцию GetParent для того чтобы получить дескриптор окна поле диалогового окна Открыть и Сохранить как.
uiMsg
Идентифицирует сообщение.
wParam
Задает дополнительную информацию о сообщении. Точное значение зависит от значения параметра uiMsg.
lParam
Задает дополнительную информацию о сообщении. Точное значение зависит от значения параметра uiMsg.

Если параметр uiMsg указывает сообщение WM_INITDIALOG , lParam является указателем на структуру OPENFILENAME содержит значения, указанные при создании диалогового окна.

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

Если процедура ловушка возвращает ноль, процедуру диалогового окна по умолчанию обрабатывает сообщение.

Если процедура ловушка возвращает ненулевое значение, процедуру диалогового окна по умолчанию игнорирует это сообщение.

Для CDN_SHAREVIOLATION и CDN_FILEOK сообщений уведомления процедуру подключения должен возвращать ненулевое значение для обозначения, что он использует функцию SetWindowLong для задания ненулевое значение DWL_MSGRESULT.

Примечания

При использовании функции GetOpenFileName или GetSaveFileName для создания стиле проводника Открыть или Сохранить как общее диалоговое окно, можно предоставить процедуру подключения OFNHookProc . Чтобы включить процедуру подключения, используйте OPENFILENAME структура, переданных в функцию создания диалогового окна. Укажите указатель на процедуру подключения в элементе lpfnHook и укажите флаг OFN_ENABLEHOOK в странах-членах флаги.

Если вы предоставите процедуру подключения общего диалогового стиле проводника, система создает диалоговое окно, является дочерним для диалогового окна по умолчанию. Процедуру подключения действует как процедура диалогового окна для ребенка диалогового окна. Это диалоговое окно ребенка основана на шаблоне, указанный в структуре OPENFILENAME , или это диалоговое окно ребенка по умолчанию, если ни один шаблон не указан. Ребенок диалоговое окно создается, когда по умолчанию процедура диалогового окна обрабатывает сообщение WM_INITDIALOG . После того, как ребенок диалогового окна обрабатывает сообщение WM_INITDIALOG, по умолчанию диалоговое окно процедура перемещает стандартные элементы управления, при необходимости освободить место для любых дополнительных элементов управления диалогового окна ребенка. Система затем посылает сообщение уведомления CDN_INITDONE процедуру подключения.

Процедуру подключения не получает сообщения, предназначенные для стандартных элементов управления диалогового окна по умолчанию. Вы можете подкласс стандартных элементов управления, но это не рекомендуется потому, что он может сделать ваше приложение несовместимо с будущими версиями диалогового окна Общий. Однако общих диалоговых окон проводника стиль обеспечивают набор сообщений, которые процедуру подключения можно использовать для мониторинга и контроля диалогового окна. К ним относятся набор уведомлений сообщения, отправленные из диалогового окна, а также сообщений, которые вы можете отправить для извлечения сведений из диалогового окна. Полный список этих сообщений см. в Стиле проводника крюк процедур.

Если процедуру подключения обрабатывает сообщение WM_CTLCOLORDLG , он должен возвращать дескриптор действительный кисти для покраски фон диалогового окна. В общем если она обрабатывает сообщения WM_CTLCOLOR, он должен возвращать дескриптор действительный кисти для рисования фона указанного элемента управления.

Не следует вызывать функцию EndDialog из процедуру подключения. Вместо этого процедуру подключения может вызывать функцию PostMessage для WM_COMMAND сообщение с IDABORT значением процедуру диалогового окна. Размещение IDABORT закрытие диалогового окна и диалогового окна поле функция возвращает значение FALSE. Если вам нужно знать, почему процедуру подключения закрытия диалогового окна, необходимо предоставить собственные механизмы связи между процедуру подключения и ваше приложение.

QuickInfo

nbsp; Windows &NT: требует версии 3.1 или более поздней версии.
Windows:Требует Windows 95 или более поздней версии.
Windows CE:Не поддерживается.
Заголовок:Объявленные в commdlg.h.
Импорта библиотеки:Определяемые пользователем.

Родственные слова

Общие диалогового окна Обзор библиотеки, Общие функции диалогового окна Box, GetOpenFileName, GetSaveFileName, OFNHookProcOldStyle, OPENFILENAME

Index