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


Лист свойств

В этом разделе содержатся сведения о элементах программирования, используемых с листами свойств.

Обзоры

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

Функции

Тема Содержание
AddPropSheetPageProc Указывает функцию обратного вызова, определяемую приложением, которую использует расширение листа свойств для добавления страницы на лист свойств.
CreatePropertySheetPage Создает новую страницу для листа свойств.
DestroyPropertySheetPage Удаляет страницу листа свойств. Приложение должно вызвать эту функцию для страниц, которые не были переданы функции PropertySheet.
PropertySheet Создает лист свойств и добавляет страницы, определенные в указанной структуре заголовка листа свойств.
PropSheetPageProc Указывает функцию обратного вызова, определяемую приложением, которая вызывает лист свойств при создании страницы и когда она будет уничтожена. Приложение может использовать эту функцию для выполнения операций инициализации и очистки страницы.
PropSheetProc Определяемая приложением функция обратного вызова, вызываемая системой при создании и инициализации листа свойств.

Сообщения

Тема Содержание
PSM_ADDPAGE Добавляет новую страницу в конец существующего листа свойств. Это сообщение можно отправлять явным образом или с помощью макроса PropSheet_AddPage.
PSM_APPLY Имитирует выбор кнопки "Применить ", указывая на изменение одной или нескольких страниц, а изменения должны быть проверены и записаны.
PSM_CANCELTOCLOSE Отправляется приложением при выполнении изменений с момента последнего уведомления PSN_APPLY, которое невозможно отменить. Это сообщение можно отправить явным образом или с помощью макроса PropSheet_CancelToClose.
PSM_CHANGED Сообщает листу свойств, что сведения на странице изменились. Это сообщение можно отправлять явным образом или с помощью макроса PropSheet_Changed.
PSM_ENABLEWIZBUTTONS Включает или отключает любую из стандартных кнопок в мастере Aero. Это сообщение можно отправить явно или использовать макрос PropSheet_EnableWizButtons.
PSM_GETCURRENTPAGEHWND Извлекает дескриптор в окно текущей страницы листа свойств. Это сообщение можно отправить явно или с помощью макроса PropSheet_GetCurrentPageHwnd.
PSM_GETRESULT Используется листами свойств без режима для получения сведений, возвращаемых модальным листам свойств, PropertySheet. Это сообщение можно отправить явно или использовать макрос PropSheet_GetResult.
PSM_GETTABCONTROL Извлекает дескриптор в элемент управления вкладкой листа свойств. Это сообщение можно отправлять явным образом или с помощью макроса PropSheet_GetTabControl.
PSM_HWNDTOINDEX Принимает дескриптор окна страницы листа свойств и возвращает его отсчитываемый от нуля индекс. Это сообщение можно отправить явно или использовать макрос PropSheet_HwndToIndex.
PSM_IDTOINDEX Принимает идентификатор ресурса страницы листа свойств и возвращает его отсчитываемый от нуля индекс. Это сообщение можно отправить явно или использовать макрос PropSheet_IdToIndex.
PSM_INDEXTOHWND Принимает индекс страницы листа свойств и возвращает его дескриптор окна. Это сообщение можно отправить явно или использовать макрос PropSheet_IndexToHwnd.
PSM_INDEXTOID Принимает индекс страницы листа свойств и возвращает идентификатор ресурса. Это сообщение можно отправить явно или использовать макрос PropSheet_IndexToId.
PSM_INDEXTOPAGE Принимает индекс страницы листа свойств и возвращает его дескриптор HPROPSHEETPAGE. Это сообщение можно отправить явно или использовать макрос PropSheet_IndexToPage.
PSM_INSERTPAGE Вставляет новую страницу в существующий лист свойств. Страницу можно вставить либо по указанному индексу, либо после указанной страницы. Это сообщение можно отправлять явным образом или с помощью макроса PropSheet_InsertPage.
PSM_ISDIALOGMESSAGE Передает сообщение в диалоговое окно листа свойств и указывает, обрабатывает ли диалоговое окно сообщение. Это сообщение можно отправить явно или с помощью макроса PropSheet_IsDialogMessage.
PSM_PAGETOINDEX Принимает дескриптор HPROPSHEETPAGE страницы листа свойств и возвращает его отсчитываемый от нуля индекс. Это сообщение можно отправить явно или использовать макрос PropSheet_PageToIndex.
PSM_PRESSBUTTON Имитирует выбор кнопки листа свойств. Это сообщение можно отправить явным образом или с помощью макроса PropSheet_PressButton.
PSM_QUERYSIBLINGS Отправляется на лист свойств, который затем пересылает сообщение на каждую страницу. Это сообщение можно отправить явным образом или с помощью макроса PropSheet_QuerySiblings.
PSM_REBOOTSYSTEM Указывает, что системе необходимо перезапустить, чтобы изменения вступили в силу. Вы можете явно отправить сообщение PSM_REBOOTSYSTEM или с помощью макроса PropSheet_RebootSystem.
PSM_RECALCPAGESIZES Пересчитывает размер страницы стандартного или мастера после добавления или удаления страниц. Это сообщение можно отправить явно или использовать макрос PropSheet_RecalcPageSizes.
PSM_REMOVEPAGE Удаляет страницу из листа свойств. Это сообщение можно отправлять явным образом или с помощью макроса PropSheet_RemovePage.
PSM_RESTARTWINDOWS Указывает, что Windows необходимо перезапустить, чтобы изменения вступили в силу.
PSM_SETBUTTONTEXT Задает текст на кнопке в мастере Аэро. Это сообщение можно отправлять явным образом или с помощью макроса PropSheet_SetButtonText.
PSM_SETCURSEL Активирует указанную страницу на листе свойств. Это сообщение можно отправить явным образом или с помощью макроса PropSheet_SetCurSel.
PSM_SETCURSELID Активирует данную страницу на листе свойств на основе идентификатора ресурса страницы. Это сообщение можно отправить явно или с помощью макроса PropSheet_SetCurSelByID.
PSM_SETFINISHTEXT Задает текст кнопки Готово в мастере, отображает и включает кнопку и скрывает кнопку Далее и кнопки "Назад". Это сообщение можно отправить явным образом или с помощью макроса PropSheet_SetFinishText.
PSM_SETHEADERBITMAP Это сообщение не реализовано.
PSM_SETHEADERBITMAPRESOURCE Это сообщение не реализовано.
PSM_SETHEADERSUBTITLE Задает текст субтитров для заголовка внутренней страницы мастера. Это сообщение можно отправить явно или использовать макрос PropSheet_SetHeaderSubTitle.
PSM_SETHEADERTITLE Задает текст заголовка для заголовка внутренней страницы мастера. Это сообщение можно отправить явно или использовать макрос PropSheet_SetHeaderTitle.
PSM_SETNEXTTEXT Задает текст кнопки Next в мастере. Это сообщение можно отправлять явным образом или с помощью макроса PropSheet_SetNextText.
PSM_SETTITLE Задает заголовок листа свойств. Это сообщение можно отправить явно или с помощью макроса PropSheet_SetTitle.
PSM_SETWIZBUTTONS Включает или отключает кнопки back, Nextи Готово в мастере. Для публикации сообщения можно также использовать макрос PropSheet_SetWizButtons.
PSM_SHOWWIZBUTTONS Отображает или скрывает кнопки в мастере. Это сообщение можно отправлять явным образом или с помощью макроса PropSheet_ShowWizButtons.
PSM_UNCHANGED Сообщает листу свойств, что сведения на странице вернулись в ранее сохраненное состояние. Это сообщение можно отправить явным образом или с помощью макроса PropSheet_UnChanged.

Уведомления

Тема Содержание
PSN_APPLY Отправляется на каждую страницу на листе свойств, чтобы указать, что пользователь нажимал кнопку "ОК", "Закрыть" или "Применить" и хочет, чтобы все изменения вступили в силу. Это уведомление отправляется в виде сообщения WM_NOTIFY.
PSN_GETOBJECT Отправляется листом свойств, чтобы запросить целевой объект удаления, когда курсор передает одну из кнопок элемента управления вкладки.
PSN_HELP Уведомляет страницу о том, что пользователь нажимал кнопку справки. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
PSN_KILLACTIVE Уведомляет страницу о потере активации либо из-за активации другой страницы, либо пользователь щелкнул кнопку ОК. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
PSN_QUERYCANCEL Указывает, что пользователь отменил лист свойств. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
PSN_QUERYINITIALFOCUS Отправляемая листом свойств для предоставления страницы листа свойств возможность указать, какой элемент управления диалогового окна должен получить начальное фокус. Это уведомление отправляется в виде сообщения WM_NOTIFY.
PSN_RESET Уведомляет страницу о том, что лист свойств будет уничтожен. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
PSN_SETACTIVE Уведомляет страницу о том, что она будет активирована. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
PSN_TRANSLATEACCELERATOR Уведомляет лист свойств о получении сообщения клавиатуры. Она предоставляет страницу возможность перевода приватных акселераторов клавиатуры. Это уведомление отправляется в виде сообщения WM_NOTIFY.
PSN_WIZBACK Уведомляет страницу о том, что пользователь щелкнул кнопку "Назад" в мастере. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
PSN_WIZFINISH Уведомляет страницу о том, что пользователь щелкнул кнопку Готово в мастере. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
PSN_WIZNEXT Уведомляет страницу о том, что пользователь щелкнул кнопку Далее в мастере. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.

Структуры

Тема Содержание
PROPSHEETHEADER Определяет кадр и страницы листа свойств.
PROPSHEETPAGE Определяет страницу на листе свойств.
PSHNOTIFY Содержит сведения для кодов уведомлений листа свойств.