CPropertySheet 類別

發行項
03/15/2013

表示屬性工作表，也稱為選項] 對話方塊。

class CPropertySheet : public CWnd

成員

公用建構函式

名稱	描述
CPropertySheet::CPropertySheet	建構 CPropertySheet 物件。

公用方法

名稱	描述
CPropertySheet::AddPage	將頁面加入至屬性工作表。
CPropertySheet::Construct	建構 CPropertySheet 物件。
CPropertySheet::Create	顯示非強制回應的屬性工作表。
CPropertySheet::DoModal	顯示強制回應屬性工作表。
CPropertySheet::EnableStackedTabs	這個屬性工作表使用直式或捲動索引標籤。
CPropertySheet::EndDialog	結束屬性工作表。
CPropertySheet::GetActiveIndex	擷取屬性工作表的使用中的頁面的索引。
CPropertySheet::GetActivePage	傳回使用中的頁面物件。
CPropertySheet::GetPage	擷取指標設定為指定的頁面。
CPropertySheet::GetPageCount	擷取頁面數目屬性工作表的。
CPropertySheet::GetPageIndex	擷取屬性工作表中指定的頁面索引。
CPropertySheet::GetTabControl	擷取指標索引標籤控制項。
CPropertySheet::MapDialogRect	轉換矩形的對話方塊單位篩選單位。
CPropertySheet::OnInitDialog	擴充屬性工作表初始化的覆寫。
CPropertySheet::PressButton	模擬指定按鈕的屬性工作表的。
CPropertySheet::RemovePage	從屬性工作表移除網頁。
CPropertySheet::SetActivePage	以程式設計方式設定使用中的頁面物件。
CPropertySheet::SetFinishText	設定結束按鈕的文字。
CPropertySheet::SetTitle	將屬性工作表的標題。
CPropertySheet::SetWizardButtons	精靈啟用按鈕。
CPropertySheet::SetWizardMode	啟動精靈模式。

公用資料成員

名稱	描述
CPropertySheet::m_psh	視窗 PROPSHEETHEADER 結構。提供對基本屬性工作表參數。

備註

屬性工作表包含 CPropertySheet 物件和一或多個 CPropertyPage 物件。這個架構顯示屬性工作表為包含目前所選取之頁面的一組視窗索引標籤和區域。使用適當的索引標籤，使用者巡覽至特定頁面。

CPropertySheet 為 Windows 98 和 Windows NT 引入的展開 PROPSHEETHEADER 結構支援 2000 年。結構包含使用「浮水印」幕後點陣圖，支援的額外旗標和成員。

若要自動顯示這些新影像在屬性工作表物件，請將點陣圖和調色盤影像的有效值在對的呼叫 CPropertySheet::Construct 或 CPropertySheet::CPropertySheet。

即使 CPropertySheet 從 CDialog並非衍生自類別，處理 CPropertySheet 物件與處理 CDialog 物件。例如，屬性工作表的建立需要兩部分語法結構:呼叫建構函式，然後呼叫強制回應屬性工作表的非強制回應屬性工作表的 DoModal 或建立。CPropertySheet 建構函式 (Constructor) 有兩種: CPropertySheet::Construct 和 CPropertySheet::CPropertySheet。

當您 CPropertySheet 建構物件時，某些視窗樣式。可能會讓第一個可能發生的例外狀況 (Exception)。在工作表建立之前，這是因為與嘗試這個系統變更屬性工作表的樣式。若要避免這個例外狀況，請確定您已將下列模式，當您建置 CPropertySheet時:

DS_3DLOOK
DS_CONTROL
WS_CHILD
WS_TABSTOP

下列模式是選擇性的並不會產生第一個可能發生的例外狀況:

DS_SHELLFONT
DS_LOCALEDIT
WS_CLIPCHILDREN。

任何其他 Window Styles 禁止，而且您不應該讓它們。

在 CPropertySheet 物件和外部物件之間交換資料類似於使用物件 CDialog 交換資料。主要差異是屬性工作表的設定通常是 CPropertyPage 物件的成員變數而不是 CPropertySheet 物件。

您可以建立名為精靈的 [選項] 對話方塊的型別，其中包括使用屬性頁序列的屬性工作表透過作業步驟引導使用者的動作，例如設定裝置或建立目前通訊。在精靈的索引標籤的對話方塊中，屬性頁沒有索引標籤，然後，只有一個屬性頁一次只能看見。此外，並非 [確定] 和 [現在套用] 按鈕，一個精靈類型的索引標籤對話方塊有一個 [背景] 按鈕、一個 [下一個] 或 [完成] 按鈕、一個 [取消] 按鈕和一個 [說明] 按鈕。

若要建立精靈類型的對話方塊，請遵循您會遵循建立標準屬性工作表的相同步驟，但是，呼叫 SetWizardMode ，在您呼叫之前 DoModal。若要啟用精靈按鈕，請呼叫 SetWizardButtons旗標，用來自訂其函式和外觀。在使用者稍後要啟用 [完成] 按鈕，呼叫 SetFinishText 採用到精靈的最後一頁的動作。

如需如何使用 CPropertySheet 物件的詳細資訊，請參閱本文屬性工作表的屬性頁。此外，請參閱知識庫文件 Q146916:HOWTO:建立具有標準按鈕和文件 Q300606 的非強制回應 CPropertySheet:HOWTO:設計可調整大小的 MFC 屬性工作表。