屬性表

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

綜述

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

功能

主題	內容
AddPropSheetPageProc	指定屬性表延伸模組用來將頁面新增至屬性表的應用程式定義回呼函式。
CreatePropertySheetPage	建立屬性表的新頁面。
DestroyPropertySheetPage	終結屬性表頁面。 應用程式必須針對尚未傳遞至 propertySheet 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 巨集。

通知

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