Функция обратного вызова LPFNPSPCALLBACKA (prsht.h)

Статья
11/20/2024

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

Синтаксис

LPFNPSPCALLBACKA Lpfnpspcallbacka;

UINT Lpfnpspcallbacka(
            HWND hwnd,
  [in]      UINT uMsg,
  [in, out] _PROPSHEETPAGEA *ppsp
)
{...}

Параметры

hwnd

Тип: HWND

Скрытный; должен быть null.

[in] uMsg

Тип: UINT

Флаг действия. Этот параметр может быть одним из следующих значений.

Ценность	Значение
PSPCB_ADDREF	версии 5.80 или более поздней. Создается страница. Возвращаемое значение не используется.
PSPCB_CREATE	Диалоговое окно для страницы создается. Верните ненулевое значение, чтобы разрешить его создавать или нулю, чтобы предотвратить его.
PSPCB_RELEASE	Страница уничтожается. Возвращаемое значение игнорируется.

[in, out] ppsp

Тип: LPPROPSHEETPAGE

Указатель на структуру PROPSHEETPAGE , которая определяет созданную или уничтоженную страницу. Дополнительные сведения см. в разделе "Замечания".

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

Тип: UINT

Возвращаемое значение зависит от значения параметра uMsg.

Замечания

Приложение должно указать адрес этой функции обратного вызова в элементе pfnCallback члена структуры PROPSHEETPAGE перед передачей структуры в функцию CreatePropertySheetPage.

Примечание Лист свойств находится в процессе управления списком страниц при вызове этой функции. Не пытайтесь добавлять, удалять или вставлять страницы при обработке этого уведомления. Это приведет к непредсказуемым результатам.

За исключением члена lParam приложение не должно изменять структуру PROPSHEETPAGE. Это приведет к непредсказуемым результатам. Элемент lParam содержит данные, определенные приложением, и его можно изменить по мере необходимости.

Заметка

Заголовок prsht.h определяет LPFNPSPCALLBACK в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	prsht.h

Поделиться через