Estrutura DLGITEMTEMPLATEEX
Um bloco de texto usado por um modelo de caixa de diálogo estendida para descrever a caixa de diálogo estendida. Para obter uma descrição do formato de um modelo de caixa de diálogo estendida, consulte DLGTEMPLATEEX.
Sintaxe
typedef struct {
DWORD helpID;
DWORD exStyle;
DWORD style;
short x;
short y;
short cx;
short cy;
DWORD id;
sz_Or_Ord windowClass;
sz_Or_Ord title;
WORD extraCount;
} DLGITEMTEMPLATEEX;
Membros
-
helpID
-
Tipo: DWORD
-
O identificador de contexto de ajuda para o controle. Quando o sistema envia uma mensagem WM_HELP , ele passa o valor helpID no membro dwContextId da estrutura HELPINFO .
-
Exstyle
-
Tipo: DWORD
-
Os estilos estendidos de uma janela. Esse membro não é usado para criar controles em caixas de diálogo, mas os aplicativos que usam modelos de caixa de diálogo podem usá-lo para criar outros tipos de janelas. Para obter uma lista de valores, consulte Estilos de janela estendidos.
-
style
-
Tipo: DWORD
-
O estilo do controle. Esse membro pode ser uma combinação de valores de estilo de janela (como WS_BORDER) e um ou mais dos valores de estilo de controle (como BS_PUSHBUTTON e ES_LEFT).
-
x
-
Tipo: curto
-
A coordenada x, em unidades da caixa de diálogo, do canto superior esquerdo do controle. Essa coordenada é sempre relativa ao canto superior esquerdo da área do cliente da caixa de diálogo.
-
y
-
Tipo: curto
-
A coordenada y, em unidades de caixa de diálogo, do canto superior esquerdo do controle. Essa coordenada é sempre relativa ao canto superior esquerdo da área do cliente da caixa de diálogo.
-
cx
-
Tipo: curto
-
A largura, em unidades da caixa de diálogo, do controle .
-
cy
-
Tipo: curto
-
A altura, em unidades da caixa de diálogo, do controle .
-
id
-
Tipo: DWORD
-
O identificador de controle.
-
windowClass
-
Tipo: sz_Or_Ord
-
Uma matriz de comprimento variável de elementos de 16 bits que especifica a classe de janela do controle. Se o primeiro elemento dessa matriz for qualquer valor diferente de 0xFFFF, o sistema tratará a matriz como uma cadeia de caracteres Unicode terminada em nulo que especifica o nome de uma classe de janela registrada.
Se o primeiro elemento for 0xFFFF, a matriz terá um elemento adicional que especifica o valor ordinal de uma classe de sistema predefinida. O ordinal pode ser um dos seguintes valores átomos.
Valor Significado - 0x0080
Botão - 0x0081
Editar - 0x0082
Estático - 0x0083
Caixa de listagem - 0x0084
Barra de rolagem - 0x0085
Caixa de combinação -
title
-
Tipo: sz_Or_Ord
-
Uma matriz de comprimento variável de elementos de 16 bits que contém o texto inicial ou o identificador de recurso do controle. Se o primeiro elemento dessa matriz for 0xFFFF, a matriz terá um elemento adicional que especifica o valor ordinal de um recurso, como um ícone, em um arquivo executável. Você pode usar um identificador de recurso para controles, como controles de ícone estático, que carregam e exibem um ícone ou outro recurso em vez de texto. Se o primeiro elemento for qualquer valor diferente de 0xFFFF, o sistema tratará a matriz como uma cadeia de caracteres Unicode terminada em nulo que especifica o texto inicial.
-
extraCount
-
Tipo: WORD
-
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çarão no próximo limite do WORD . Esses dados de criação podem ser de qualquer tamanho e formato. O procedimento de janela do controle deve ser capaz de interpretar os dados. Quando o sistema cria o controle, ele passa um ponteiro para esses dados no parâmetro lParam da mensagem WM_CREATE que ele envia para o controle.
Comentários
Um modelo estendido para uma caixa de diálogo consiste em um cabeçalho DLGTEMPLATEEX seguido por uma estrutura DLGITEMTEMPLATEEX para cada controle na caixa de diálogo.
Cada estrutura DLGITEMTEMPLATEEX deve ser alinhada em um limite DWORD . As matrizes windowClass e title de comprimento variável devem ser alinhadas nos limites do WORD . A matriz de dados de criação, se houver, deve ser alinhada em um limite do WORD .
Se você especificar cadeias de caracteres nas matrizes windowClass e title , deverá usar cadeias de caracteres Unicode. Use a função MultiByteToWideChar para gerar cadeias de caracteres Unicode de cadeias de caracteres ANSI.
Os membros x, y, cx e cy especificam valores em unidades da caixa de diálogo. Você pode converter esses valores em unidades de tela (pixels) usando a função MapDialogRect .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows 2000 Server [somente aplicativos da área de trabalho] |
Confira também
-
Referência
-
Conceitual
-
Outros recursos