CHeaderCtrl::Create
Cria um controle de cabeçalho e anexá-la a um objeto de CHeaderCtrl .
virtual BOOL Create(
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID
);
Parâmetros
dwStyle
Especifica o estilo de controle header.Para obter uma descrição de estilos de controle de cabeçalho, consulte Estilos de controle header em Windows SDK.rect
Especifica o tamanho e a posição de controle header.Pode ser um objeto de CRect ou uma estrutura de RECT .pParentWnd
Especifica a janela pai de controle de cabeçalho, geralmente CDialog.Não deve ser NULO.nID
Especifica a identificação de controle header
Valor de retorno
Diferente de zero se a inicialização tenha êxito; se não zero.
Comentários
Você constrói um objeto de CHeaderCtrl em duas etapas.Primeiro, o construtor e então chame Criar, que cria o controle de cabeçalho e o anexar para o objeto de CHeaderCtrl .
Além dos estilos de controle de cabeçalho, você pode usar os seguintes estilos de controle comum para determinar como o controle de cabeçalho posiciona e se redimensiona (consulte Estilos de controle comum para obter mais informações):
CCS_BOTTOM faz com que o controle posicione-se na parte inferior da área cliente da janela pai e defina a largura para ser o mesmo que a largura da janela pai.
CCS_NODIVIDER impede que um realce de dois pixel é desenhado na parte superior do controle.
CCS_NOMOVEY faz com que o controle redimensiona e vá horizontalmente, mas não verticalmente, em resposta a uma mensagem de WM_SIZE .Se o estilo de CCS_NORESIZE é usado, esse estilo não se aplica.Controles de cabeçalho têm esse estilo por padrão.
CCS_NOPARENTALIGN impede que o controle automaticamente move para a parte superior ou para a parte inferior da janela pai.Em vez de isso, o controle tem sua posição na janela pai independentemente das alterações no tamanho da janela pai.Se o estilo de CCS_TOP ou de CCS_BOTTOM também é usado, a altura é definida como padrão, mas a posição e largura permanecem inalterados.
CCS_NORESIZE impede que o controle use a largura e altura padrão para definir o tamanho inicial ou um novo tamanho.Em vez de isso, o controle usa a largura e altura especificada na solicitação para a criação ou dimensionamento.
CCS_TOP faz com que o controle posicione-se na parte superior da área cliente da janela pai e defina a largura para ser o mesmo que a largura da janela pai.
Você também pode aplicar os seguintes estilos de janela para 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 estilo de WS_POPUP .
WS_VISIBLE cria uma janela que é inicialmente visível.
WS_DISABLED cria uma janela que é desativada inicialmente.
WS_GROUP especifica o primeiro controle de um grupo de controles em que o usuário pode mover de um controle para o seguinte com as teclas de direção.Todos os controles definidos pelo estilo de WS_GROUP após o primeiro controle pertencem ao mesmo grupo.O próximo controle com o estilo de WS_GROUP termina o grupo de estilo e enfia o grupo seguir (isto é, um grupo termina onde o exemplo a seguir inicia).
Especifica umWS_TABSTOP de qualquer número de controles através do qual o usuário pode mover usando a tecla TAB.A tecla TAB o usuário move para o próximo controle especificado pelo estilo de WS_TABSTOP .
Se você desejar usar estilos estendidos do windows com o controle, chame 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