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

Confira também

Referência

Createdialogindirect

Createdialogindirectparam

Createwindowex

Dialogboxindirect

Dialogboxindirectparam

DLGTEMPLATEEX

MapDialogRect

WM_CREATE

Conceitual

Caixas de diálogo

Outros recursos

MultiByteToWideChar

WM_HELP