макрос PropSheet_RemovePage (prsht.h)

Статья
10/24/2024

Удаляет страницу из листа свойств. Этот макрос можно использовать или явно отправить сообщение PSM_REMOVEPAGE.

Синтаксис

VOID PropSheet_RemovePage(
   HWND           hDlg,
   int            index,
   HPROPSHEETPAGE hpage
);

Параметры

hDlg

Тип: HWND

Дескриптор на лист свойств.

index

Тип: int

Отсчитываемый от нуля индекс страницы.

hpage

Тип: HPROPSHEETPAGE

Дескриптор на страницу для удаления.

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

Тип: VOID

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

Замечания

Приложение может указать страницу, которую нужно удалить, назначив значение индексу или hpage. Если значения назначены индексу и hpage, hpage имеет приоритет.

Во время управления списком страниц выполняется ряд сообщений и один вызов функции. Хотя это действие происходит, попытка изменить список страниц будет иметь непредсказуемые результаты. Соответственно, не следует использовать макрос PropSheet_RemovePage в реализации PropSheetPagePro c или при обработке следующих уведомлений и сообщений Windows.

Если необходимо изменить страницу листа свойств во время обработки одного из этих сообщений или во время PropSheetPageProc работает, опубликуйте личное сообщение Windows. Приложение не получит это сообщение до тех пор, пока диспетчер листов свойств завершит свои задачи. Затем можно изменить список страниц.

Следующие уведомления также влияют на изменение листа свойств.

Вы можете добавлять или удалять страницы в ответ на эти уведомления, если вы возвращаете (через DWL_MSGRESULT) ненулевое значение, чтобы указать нужную новую страницу. Обратите внимание, что при удалении страницы, расположенной до текущей страницы (которая имеет меньший индекс, чем текущая страница), PSN_KILLACTIVE может быть отправлена на неправильную страницу.

Примечание Этот макрос не поддерживается при использовании стиля мастера Аэро (PSH_AEROWIZARD).

Требования

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

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