CHeaderCtrl::criar
Cria um controle de cabeçalho e a anexa um CHeaderCtrl objeto.
virtual BOOL Create(
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID
);
Parâmetros
dwStyle
Especifica o estilo de cabeçalho do controle.Para obter uma descrição dos estilos de controle de cabeçalho, consulte Estilos de controle de cabeçalho in the Windows SDK.rect
Especifica o dimensionar e posição do controle de cabeçalho.Pode ser qualquer um CRect objeto ou um RECT estrutura.pParentWnd
Especifica a janela de pai do controle de cabeçalho, geralmente um CDialog. Não deve ser NULO.nID
Especifica a ID. do controle de cabeçalho
Valor de retorno
Diferente de zero se a inicialização foi bem-sucedida; caso contrário, nenhum.
Comentários
Construir um CHeaderCtrl objeto em duas etapas. Primeiro, telefonar construtor e, em seguida, telefonar Criar, que cria o controle de cabeçalho e a anexa à CHeaderCtrl objeto.
Juntamente com os estilos de controle de cabeçalho, você pode usar os seguintes estilos de controle comuns para determinar como o controle de cabeçalho posiciona e redimensionado (consulte Estilos de controle comuns para obter mais informações):
CCS_BOTTOM Se posicionar na parte inferior da área de cliente da janela pai do controle e define a largura seja o mesmo sistema autônomo largura da janela pai.
CCS_NODIVIDER Impede que um realce dois pixels que está sendo desenhado na parte superior do controle.
CCS_NOMOVEY Faz o controle para redimensionar e mover-se horizontalmente, mas não verticalmente, em resposta a uma WM_SIZE mensagem. Se o CCS_NORESIZE estilo é usado, não se aplica este estilo. Por padrão, controles de cabeçalho têm esse estilo.
CCS_NOPARENTALIGN Evita que o controle movam automaticamente para a parte superior ou inferior da janela pai. Em vez disso, o controle mantém sua posição dentro da janela pai apesar das alterações para o dimensionar da janela pai.Se o CCS_TOP ou CCS_BOTTOM estilo também é usado, a altura é ajustada para o padrão, mas a posição e a largura permanecerão inalterados.
CCS_NORESIZE Impede que o controle usando a largura padrão e a altura ao definir o dimensionar inicial ou um novo dimensionar. Em vez disso, o controle usa a largura e altura especificada na solicitação de criação ou dimensionamento.
CCS_TOP Se posicionar na parte superior da área de cliente da janela pai do controle e define a largura seja o mesmo pai largura da janela.
Você também pode aplicar os seguintes estilos de janela a um controle de cabeçalho (consulte Estilos de janela para obter mais informações):
WS_CHILD Cria uma janela filho.Não pode ser usado com o WS_POPUP estilo.
WS_VISIBLE Cria uma janela que está visível inicialmente.
WS_DISABLED Cria uma janela inicialmente desabilitado.
WS_GROUP Especifica o primeiro controle de um agrupar de controles em que o usuário pode mover de um controle para o próximo com as teclas de direção.Todos os controles definidos com o WS_GROUP estilo após o primeiro controle pertencer ao agrupar do mesmo.O próximo controle com o WS_GROUP estilo termina o agrupar de estilos e começa o próximo agrupar (ou seja, termina um agrupar em que o próximo começa).
WS_guiaSTOP Especifica um número de controles por meio do qual o usuário pode mover usando o tecla guia.A tecla guia move o usuário para o próximo controle especificado pelo WS_TABSTOP estilo.
Se você quiser usar estilos estendidos janelas com seu controle telefonar CreateEx em vez de Criar.
Exemplo
// 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
Cabeçalho: afxcmn.h