通过

属性表

  • 项目

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

综述

主题 内容
关于属性表 的 属性表 是一个窗口，允许用户查看和编辑项的属性。
创建向导 向导是一种属性表类型，提供一种简单而强大的方法来指导用户完成过程。
使用属性表 本部分提供用于处理属性表的实现详细信息和示例代码。

功能

主题 内容
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 获取属性表页的窗口句柄并返回其从零开始的索引。 可以显式发送此消息或使用 PropSheet_HwndToIndex 宏。
PSM_IDTOINDEX 获取属性表页的资源 ID 并返回其从零开始的索引。 可以显式发送此消息或使用 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 句柄并返回其从零开始的索引。 可以显式发送此消息或使用 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 设置向导中 “下一”按钮的文本。 可以显式发送此消息，也可以使用 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 包含属性表通知代码的信息。