CHeaderCtrl::Create
Crea un control de encabezado y lo asocia a un objeto de CHeaderCtrl .
virtual BOOL Create(
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID
);
Parámetros
dwStyle
Especifica el estilo del control de encabezado. Para obtener una descripción de los estilos del control de encabezado, vea Estilos del Control de encabezado en Windows SDK.rect
Especifica el tamaño y la posición del control de encabezado. puede ser un objeto de CRect o una estructura de RECT .pParentWnd
Especifica la ventana principal del control de encabezado, normalmente CDialog. no debe ser NULL.nID
Especifica el identificador de control de encabezado
Valor devuelto
Distinto de cero si la inicialización se realizó correctamente; si no cero.
Comentarios
Se crea un objeto de CHeaderCtrl en dos pasos. Primero, llame al constructor y llame a Crear, que hace que el control de encabezado y lo asocia al objeto de CHeaderCtrl .
Además de los estilos del control de encabezado, puede utilizar los siguientes estilos de controles comunes para determinar cómo las posiciones del control de encabezado y se cambia el tamaño (vea Estilos de controles comunes para obtener más información):
CCS_BOTTOM hace que el control para colocarse en la parte inferior del área de cliente de la ventana primaria y establece el ancho sea igual que el ancho de la ventana primaria.
CCS_NODIVIDER impide que un resaltado de dos- píxel es dibujado en la parte superior del control.
CCS_NOMOVEY hace que el control para cambiar el tamaño y para moverse horizontalmente, pero no verticalmente, en respuesta a un mensaje de WM_SIZE . Si se utiliza el estilo de CCS_NORESIZE , este estilo no se aplica. los controles de encabezado tienen este estilo de forma predeterminada.
CCS_NOPARENTALIGN impide que el control automáticamente desplácese a la parte superior o inferior de la ventana primaria. En su lugar, el control mantiene su posición dentro de la ventana primaria a pesar de los cambios de tamaño de la ventana primaria. Si el estilo de CCS_TOP o de CCS_BOTTOM también se usa, el alto se ajusta al valor predeterminado, pero permanecen la posición y el ancho sin modificar.
CCS_NORESIZE impide que el control use el ancho y el alto predeterminados al establecer el tamaño inicial o un nuevo tamaño. En su lugar, el control utiliza el ancho y el alto especificados en el orden la creación o el tamaño.
CCS_TOP hace que el control para colocarse en la parte superior del área de cliente de la ventana primaria y establece el ancho sea igual que el ancho de la ventana primaria.
También puede aplicar los estilos de ventana siguientes a un control de encabezado (vea Estilos de ventana para obtener más información):
WS_CHILD crea una ventana secundaria. No se puede utilizar con el estilo de WS_POPUP .
WS_VISIBLE crea una ventana que se muestra inicialmente.
WS_DISABLED crea una ventana que se deshabilite inicialmente.
WS_GROUP especifica el primer control de un grupo de controles en los que el usuario pueda desplazarse desde un control al siguiente con las teclas de dirección. Todo controla definido con el estilo de SE después del primer control pertenece al mismo grupo. El control siguiente con el estilo de SE finaliza el grupo de estilo e inicie el grupo siguiente (es decir, extremos de un grupo donde comienza siguientes).
WS_TABSTOP especifica uno de cualquier número de controles en los que el usuario pueda desplazarse mediante la tecla TAB. La tecla TABULADOR desplaza el control siguiente especifica el estilo de WS_TABSTOP .
Si desea utilizar estilos extendidos de las ventanas con el control, llame a CreateEx en lugar de Crear.
Ejemplo
// pParentWnd is a pointer to the parent window.
m_myHeaderCtrl.Create(WS_CHILD | WS_VISIBLE | HDS_HORZ,
CRect(10, 10, 600, 50), pParentWnd, 1);
Requisitos
encabezado: afxcmn.h