DLGITEMTEMPLATE

9/9/2008

Essa estrutura Define as dimensões e estilo de um controle em uma caixa diálogo. Um ou mais dessas estruturas são combinados com um DLGTEMPLATE estrutura para um modelo caixa diálogo forma.

Syntax

typedef struct { 
  DWORD style; 
  DWORD dwExtendedStyle; 
  short x; 
  short y; 
  short cx; 
  short cy; 
  WORD id; 
} DLGITEMTEMPLATE; 

Os membros

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

• dwExtendedStyle
  Especifica estendido estilos para uma janela. Este membro não é usado para criar controles no diálogo caixas, 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, da upper-left corner do controle. Este coordenar é sempre relativo para o upper-left corner da área cliente da caixa de diálogo.

• y
  Especifica o y-coordenar, em unidades caixa diálogo, da upper-left corner do controle. Este coordenar é sempre relativo para o upper-left corner da área 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.

• ID
  Especifica o identificador controle.

Remarks

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

Cada DLGITEMTEMPLATE estrutura no modelo deve ser alinhada em um DWORD limite. A classe e matrizes de título devem ser alinhados no Word Os limites. A matriz dados de criação deve ser alinhado em um Word limite.

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 um 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 um dos valores de átomo mostrados a seguinte tabela.

Valor	Descrição
0x0080	Botão
0x0081	Editar
0x0082	Estático
0x0083	Caixa Lista
0x0084	SCROLL barra
0x0085	Caixa de combinação

Seguindo a matriz classe é uma matriz de título que contém o identificador de texto ou recurso inicial do controle. Se o primeiro elemento desta matriz é 0xffff, a matriz tem um elemento adicional que especifica um ordinal valor de um recurso, such as um ícone, em um arquivo executável. Você pode usar um identificador recurso para controles, como controles ícone estática, que carregar e exibir um ícone ou outro recurso vez de texto. Se o primeiro elemento for qualquer valor Other Than 0xffff, o sistema trata a matriz como um 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 de 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 interpretar os dados. Quando o sistema cria o controle, ele passa um ponteiro para este dados na lParam parâmetro da mensagem WM_CREATE que ele envia para o controle.

Se você especificar caractere seqüências em de classe e matrizes de título, você deve usar seqüências de caracteres Unicode. Para criar codificar que funciona no Windows_95/98 e Windows NT, use o MultiByteToWideChar função para gerar esses seqüências Unicode.

O x, y, CX, e CY Membros especificar valores em unidades caixa diálogo. Você pode converter esses valores para unidades Tela (pixels) usando o MapDialogRect função.

Requirements

Header	winuser.h
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

CreateDialogIndirect
CreateDialogIndirectParam
CreateWindowEx
DialogBoxIndirect
DialogBoxIndirectParam
MapDialogRect
DLGTEMPLATE
Dialog Boxes Structures

Other Resources

MultiByteToWideChar