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

Статья
10/24/2024

Добавляет новую страницу в конец существующего листа свойств. Этот макрос можно использовать или явно отправить сообщение PSM_ADDPAGE.

Синтаксис

BOOL PropSheet_AddPage(
   HWND           hDlg,
   HPROPSHEETPAGE hpage
);

Параметры

hDlg

Тип: HWND

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

hpage

Тип: HPROPSHEETPAGE

Обработайте страницу, чтобы добавить. Страница должна быть создана с помощью предыдущего вызова функции CreatePropertySheetPage.

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

Тип: BOOL

Возвращает TRUE, если выполнено успешно или FALSE в противном случае.

Замечания

Новая страница не должна быть больше самой большой страницы в настоящее время в листе свойств, так как лист свойств не изменяется, чтобы соответствовать новой странице.

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

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

Требования

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

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