CHeaderCtrl::Create

创建一个标头控件并将它附加到 CHeaderCtrl 对象。

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

参数

  • dwStyle
    指定标头控件的样式。 有关标头控件样式的说明,请参见。Windows SDK的 标头控件样式

  • rect
    指定标头控件的大小和位置。 它可以是 CRect 对象或 RECT 结构。

  • pParentWnd
    指定标头控件的父窗口,通常 CDialog。 不能为 NULL

  • nID
    指定标头控件的ID.

返回值

非零,如果初始化成功;否则零。

备注

在构造在两个步骤的一 CHeaderCtrl 对象。 首先,调用构造函数然后调用 Create,创建标头控件并将它附加到 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 而不是 Create

示例

// 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