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

Статья
08/25/2023

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

Синтаксис

void PropSheet_AddPage(
   hDlg,
   hpage
);

Параметры

hDlg

Тип: HWND

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

hpage

Тип: HPROPSHEETPAGE

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

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

None

Remarks

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

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

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

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	prsht.h

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