Лист свойств

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

Общие сведения

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

Функции

Раздел Содержимое
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_SEТБ UTTONTEXT Задает текст на кнопке в мастере Аэро. Это сообщение можно отправлять явным образом или с помощью макроса 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 Задает текст кнопки "Далее " в мастере. Это сообщение можно отправить явным образом или с помощью макроса PropSheet_SetNextText.
PSM_SETTITLE Задает заголовок листа свойств. Это сообщение можно отправить явно или с помощью макроса PropSheet_SetTitle.
PSM_SETWIZBUTTONS Включает или отключает кнопки "Назад", "Далее" и "Готово " в мастере. Вы также можете использовать макрос PropSheet_SetWizButtons для публикации сообщения.
PSM_SHOWWIZBUTTONS Отображает или скрывает кнопки в мастере. Это сообщение можно отправить явно или с помощью макроса PropSheet_ShowWizButtons.
PSM_UNCHANGED Сообщает листу свойств, что сведения на странице отменить изменения в ранее сохраненное состояние. Это сообщение можно отправить явно или с помощью макроса PropSheet_UnChanged.

Notifications

Раздел Содержимое
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 Содержит сведения для кодов уведомлений листа свойств.