屬性表

本節包含與屬性表搭配使用之程序設計專案的相關信息。

概觀

主題	目錄
關於屬性表	屬性 表 是一個視窗，可讓用戶檢視和編輯項目的屬性。
建立精靈	精靈是一種屬性表類型，可提供簡單且強大的方法來引導使用者完成程式。
使用屬性表	本節提供使用屬性表的實作詳細數據和範例程序代碼。

函式

主題	目錄
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	設定 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 宏。

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	包含屬性表通知碼的資訊。