DLGITEMTEMPLATE

A DLGITEMTEMPLATE estrutura define as dimensões e estilo de um Controlarar em uma caixa de diálogo. Um ou mais dessas estruturas são combinados com uma DLGTEMPLATE estrutura para formar um padrão modelo para uma caixa de diálogo.

typedef struct {/ / estilo DWORD dlit; 
    DWORD dwExtendedStyle; 
    x curto; 
    y curto; 
    cx curto; 
    cy curto; 
    Id do WORD; 
} DLGITEMTEMPLATE 

 

Membros

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).

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.

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.

Observações

Em um padrão modelo para uma caixa de diálogo, a DLGITEMTEMPLATE estrutura é sempre imediatamente seguida de três matrizes de comprimento variável especificando a classe, título e dados de criação para o Controlarar. Cada matriz consiste em um ou mais elementos de 16-bit.

Cada DLGITEMTEMPLATE estrutura no modelo deve ser alinhada em um DWORD limite. As classe e matrizes de título devem ser alinhadas no WORD os limites. A matriz dados de criação deve ser alinhada em um limite de palavra.

Imediatamente seguinte cada DLGITEMTEMPLATE estrutura é uma matriz classe 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.

Seguinte matriz classe é uma matriz de título 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 valor ordinal de 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.

A matriz dados de criação começa no próximo WORD limite após a matriz de título. Este dados de criação podem ser de qualquer tamanho e formato. Se a primeira palavra da matriz de dados criação é diferente de zero, ele indica o tamanho, em bytes, de dados de criação (incluindo a palavra tamanho). 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.

Se você especificar seqüências de caracteres in as classe e matrizes de 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 a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declarado em WinUser. h.

Ver também

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

Index