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

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

  • Статья

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

Синтаксис

void PropSheet_InsertPage(
   hDlg,
   index,
   hpage
);

Параметры

hDlg

Тип: HWND

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

index

Тип: HWND

Место вставки страницы. Присвойте wParam значение NULL , чтобы сделать новую страницу первой. Чтобы указать место вставки новой страницы, можно передать индекс или дескриптор HPROPSHEETPAGE существующей страницы.

Значение Значение
index
 Если wParam меньше MAXUSHORT (наибольшее короткое целое число без знака), он указывает отсчитываемый от нуля индекс для новой страницы. Например, чтобы сделать вставленную страницу третьей страницей на странице свойств, задайте для индекса значение 2. Чтобы сделать его первой страницей, присвойте индексу значение 0. Если индекс имеет значение больше, чем количество страниц и меньше, чем MAXUSHORT, страница будет добавлена.
hpageInsertAfter
 Если задать wParam для дескриптора HPROPSHEETPAGE существующей страницы, новая страница будет вставлена после нее.

hpage

Тип: HWND

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

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

None

Remarks

Страницы после точки вставки смещаются вправо для размещения новой страницы.

Размер страницы свойств не изменяется в соответствии с новой страницей. Не делайте новую страницу больше самой большой страницы страницы свойств.

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

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

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

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

Требования

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