PSM_INSERTPAGE сообщение

  • Статья

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

Параметры

wParam

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

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

lParam

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

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

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

Комментарии

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

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

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

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

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

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

Примечание

Это сообщение не поддерживается при использовании стиля мастера Aero (PSH_AEROWIZARD).

Требования

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