共用方式為


CHeaderCtrl::Create

建立標題控制項並將其附加至 CHeaderCtrl 物件。

virtual BOOL Create(
   DWORD dwStyle,
   const RECT& rect,
   CWnd* pParentWnd,
   UINT nID 
);

參數

  • dwStyle
    指定標題控制項的樣式。 如需標頭的控制項模式的說明,請參閱 Windows SDK的 標題控制項模式。

  • rect
    指定標題控制項的大小和位置。 它可以是 CRect 物件或 的長度 結構。

  • pParentWnd
    指定標題控制項的父視窗,通常 CDialog。 不得為 NULL

  • nID
    指定標題控制項的 ID.

傳回值

如果不是零,初始化成功,則為零。

備註

您建構以兩個步驟的 CHeaderCtrl 物件。 首先,請呼叫建構函式,然後呼叫 建立建立標題控制項並將其附加至 CHeaderCtrl 物件。

除了標題控制項樣式之外,您還可以使用下列通用控制項樣式決定標題控制項如何放置和調整大小 通用控制項模式 (請參閱以取得詳細資訊):

  • CCS_BOTTOM 導致控制項將其本身定位在父視窗的工作區底端的並設定這個寬度與父視窗的寬度。

  • CCS_NODIVIDER 防止兩個像素反白顯示控制項的最上層繪製。

  • CCS_NOMOVEY 使控制項水平,但是,垂直調整大小和自行捲動,以回應 WM_SIZE 訊息。 如果使用 CCS_NORESIZE 樣式,該樣式並不適用。 預設標題控制項具有樣式。

  • CCS_NOPARENTALIGN 防止控制項自動移至父視窗的頂端或底端。 相反地,控制項會保留它的父視窗中的位置雖然父視窗大小的變更。 如果同時也使用 CCS_TOPCCS_BOTTOM 樣式,為預設高度會調整,不過,這個位置和寬度維持不變。

  • 表示設定其初始大小或新的大小時,CCS_NORESIZE 被使用的預設寬度和高度。 相反地,控制項會建立或調整大小用於要求指定的高度和寬度。

  • CCS_TOP 導致控制項將其本身定位在父視窗的工作區上方並設定這個寬度與父視窗的寬度。

您也可以將下列視窗樣式為標題控制項 (請參閱 視窗樣式 以取得詳細資訊):

  • WS_CHILD 建立子視窗。 無法搭配 WS_POPUP 樣式。

  • WS_VISIBLE 建立一開始都是可見的視窗。

  • WS_DISABLED 建立初始停用的視窗。

  • WS_GROUP 指定控制項群組的第一個控制項可讓使用者從一個控制項移至下一個與方向鍵。 所有控制項定義為 WS_GROUP 樣式在第一個控制項之後屬於相同群組。 使用 WS_GROUP 樣式的下一個控制項的結束樣式群組並開始下一個群組 (也就是一組結束下啟動) 的位置。

  • WS_TABSTOP 指定使用者可以移動任何數目的控制項的其中一個使用 TAB 鍵。 TAB 鍵會將使用者移至 WS_TABSTOP 樣式指定的下一個控制項。

如果您想要使用控制項的延伸視窗樣式,請呼叫 CreateEx 而不是 建立

範例

// pParentWnd is a pointer to the parent window.
m_myHeaderCtrl.Create(WS_CHILD | WS_VISIBLE | HDS_HORZ,
   CRect(10, 10, 600, 50), pParentWnd, 1);

需求

Header: afxcmn.h

請參閱

參考

CHeaderCtrl 類別

階層架構圖

CHeaderCtrl::CHeaderCtrl