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

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

  • Статья

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

Синтаксис

void PropSheet_RemovePage(
   hDlg,
   index,
   hpage
);

Параметры

hDlg

Тип: HWND

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

index

Тип: int

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

hpage

Тип: HPROPSHEETPAGE

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

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

None

Remarks

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

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

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

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

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

Требования

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