属性表

本节包含与属性表一起使用的编程元素的有关信息。

概述

主题	目录
关于属性表	属性表是一个允许用户查看和编辑项目属性的窗口。
创建向导	向导是一种属性表，它提供了一种简单而强大的方法来指导用户完成过程。
使用属性表	本节将介绍使用属性表的实现详细信息和示例代码。

函数

主题	目录
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	启用或禁用航空向导中的任何标准按钮。 可以显式发送此消息或使用 PropSheet_EnableWizButtons 宏。
PSM_GETCURRENTPAGEHWND	检索属性表当前页面窗口的句柄。 可以显式发送此消息，也可以使用 PropSheet_GetCurrentPageHwnd 宏来发送此消息。
PSM_GETRESULT	由无模式属性表用于获取 PropertySheet 返回给模式属性表的信息。 可以显式发送此消息或使用 PropSheet_GetResult 宏。
PSM_GETTABCONTROL	检索属性表的选项卡控件的句柄。 可以显式发送此消息，也可以使用 PropSheet_GetTabControl 宏来发送此消息。
PSM_HWNDTOINDEX	获取属性表页面的窗口句柄，并返回其从 0 开始的索引。 可以显式发送此消息或使用 PropSheet_HwndToIndex 宏。
PSM_IDTOINDEX	获取属性表页面的资源 ID 并返回其从 0 开始的索引。 可以显式发送此消息或使用 PropSheet_IdToIndex 宏。
PSM_INDEXTOHWND	获取属性表页面的索引并返回其窗口句柄。 可以显式发送此消息或使用 PropSheet_IndexToHwnd 宏。
PSM_INDEXTOID	获取属性表页面的索引并返回其资源 ID。 可以显式发送此消息或使用 PropSheet_IndexToId 宏。
PSM_INDEXTOPAGE	获取属性表页面的索引并返回其 HPROPSHEETPAGE 句柄。 可以显式发送此消息或使用 PropSheet_IndexToPage 宏。
PSM_INSERTPAGE	在现有属性表中插入新页面。 可在指定索引处或指定页面后插入该页面。 可以显式发送此消息，也可以使用 PropSheet_InsertPage 宏来发送此消息。
PSM_ISDIALOGMESSAGE	向属性表对话框传递消息，并指明对话框是否处理了该消息。 可以显式发送此消息，也可以使用 PropSheet_IsDialogMessage 宏来发送此消息。
PSM_PAGETOINDEX	获取属性表页面的 HPROPSHEETPAGE 句柄，并返回其从 0 开始的索引。 可以显式发送此消息或使用 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	设置 Aero 向导中按钮上的文字。 可以显式发送此消息，也可以使用 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 宏来发送此消息。

通知

主题	目录
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	包含属性表通知代码的信息。