DLGITEMTEMPLATEEX

A estrutura DLGITEMTEMPLATEEX não está definida em qualquer arquivo de cabeçalho padrão. A definição de estrutura é fornecida aqui para explicar o formato de um modelo para uma caixa de diálogo estendido.

Para cada Controlarar em uma caixa de diálogo, um modelo de caixa de diálogo estendida tem um bloco de dados que usa o formato DLGITEMTEMPLATEEX para descrever o controle. Para obter uma descrição do formato de um modelo de caixa de diálogo estendida, consulte DLGTEMPLATEEX.

typedef struct {DWORD helpID; 
    ExStyle DWORD; 
    Estilo de DWORD; 
    x curto; 
    y curto; 
    cx curto; 
    cy curto; 
    PALAVRA de identificação; 
    windowClass sz_Or_Ord; / / nome ou ordinal de uma classe de janela
    título do sz_Or_Ord;       / / título seqüência de caracteres ou ordinal de um recurso
    PALAVRA extraCount;     / / bytes de sequência de dados de criação
} DLGITEMTEMPLATEEX 

 

Membros

helpID

Especifica o identificador de contexto de ajuda para o Controlarar. Quando o sistema envia um WM_HELP mensagem, ele passa o valor de helpID o dwContextId membro do estrutura HELPINFO.

dwExtendedStyle

Especifica estendido estilos para uma janela. Este membro não é usado para criar controles em caixas de diálogo, mas os aplicativos que usam modelos caixa de diálogo podem usá-lo para criar outros tipos de janelas.

estilo

Especifica o estilo do Controlarar. Esse membro pode ser uma combinação de valores estilo janela (como WS_BORDER) e um ou mais dos valores de estilo de Controlarar (como BS_PUSHBUTTON e ES_LEFT).

x

Especifica o x-coordenar, em unidades caixa diálogo, do canto superior esquerdo do controle. Este coordenar é sempre relativo para o canto superior esquerdo da área de cliente da caixa de diálogo.

y

Especifica a y-coordenar, em unidades caixa diálogo, do canto superior esquerdo do controle. Este coordenar é sempre relativo para o canto superior esquerdo da área de cliente da caixa de diálogo.

cx

Especifica a largura, em unidades caixa diálogo, do controle.

cy

Especifica a altura, em unidades caixa diálogo, do controle.

identificação

Especifica o identificador de Controlarar.

windowClass

Especifica uma matriz de comprimento variável de elementos de 16 bits que identifica a classe janela do controle. Se o primeiro elemento desta matriz é qualquer valor other than 0xFFFF, o sistema trata a matriz como uma seqüência de caracteres Unicode null-terminated que especifica o nome de uma classe de janela registrado.

Se o primeiro elemento é 0xFFFF, a matriz tem um elemento adicional que especifica o ordinal valor de uma classe sistema predefinidos. O ordinal pode ser uma do seguinte valores de átomo.

Valor	Significado
0x0080	Botão
0x0081	Editar
0x0082	Estático
0x0083	Caixa de listagem
0x0084	Barra de rolagem
0x0085	Caixa de combinação

título

Especifica uma matriz de comprimento variável de elementos de 16 bits que contém o identificador de texto ou recurso inicial do Controlarar. Se o primeiro elemento desta matriz é 0xFFFF, a matriz tem um elemento adicional que especifica um ordinal valor que identifica um recurso, such as um ícone em um arquivo executável. Você pode usar um identificador de recurso de controles, como controles ícone estática, que carregar e exibam um ícone ou outro recurso em vez de texto.

Se o primeiro elemento for qualquer valor other than 0xFFFF, o sistema trata a matriz como uma seqüência de caracteres Unicode null-terminated que especifica o texto inicial.

extraCount

Especifica o número de bytes de dados de criação que seguem esse membro. Se esse valor for maior que zero, os dados de criação começam no próximo limite de palavra . Este dados de criação podem ser de qualquer tamanho e formato. Janela procedimento do controle deve ser capaz de interpretar os dados. Quando o sistema cria o controle, ele passa um ponteiro para dados na lParam parâmetro da mensagem WM_CREATE que ele envia para o controle.

Observações

Um modelo estendido para uma caixa de diálogo consiste de um cabeçalho DLGTEMPLATEEX seguido por uma estrutura DLGITEMTEMPLATEEX para cada Controlarar na caixa de diálogo.

Cada estrutura DLGITEMTEMPLATEEX deve ser alinhada em um DWORD limite. As comprimento variável windowClass e matrizes de título devem ser alinhadas no WORD os limites. A matriz dados de criação, se houver, deve ser alinhado em um limite de palavra.

Se você especificar seqüências de caracteres nas matrizes windowClass e título , você deve usar seqüências de caracteres Unicode. Para criar código que funciona em Windows e Windows NT, use o MultiByteToWideChar função para gerar esses seqüências Unicode.

Os x, y, cxe cy Membros especificar valores em unidades de caixa de diálogo. Você pode converter esses valores para unidades tela (pixels) usando o MapDialogRect função.

QuickInfo

nbsp; Windows &NT: requer versão 3.51 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Não suportado.

Ver também

Visão geral de caixas de diálogo, estruturas de caixa de diálogo, CreateDialogIndirect, CreateDialogIndirectParam, CreateWindowEx, DialogBoxIndirect, DialogBoxIndirectParam, DLGITEMTEMPLATE, DLGTEMPLATE, DLGTEMPLATEEX, MapDialogRect, MultiByteToWideChar

Index