DLGTEMPLATE

9/9/2008

Essa estrutura Define as dimensões e estilo de uma caixa diálogo. Essa estrutura, sempre o primeiro em um modelo caixa diálogo, também especifica o número de controles na caixa de diálogo e, portanto, especifica o número de subseqüentes DLGITEMTEMPLATE Estruturas de modelo.

Syntax

typedef struct {
  DWORD style; 
  DWORD dwExtendedStyle; 
  WORD cdit; 
  short x; 
  short y; 
  short cx; 
  short cy; 
} DLGTEMPLATE; 

Os membros

• estilo
  Especifica o estilo da caixa de diálogo. Ele pode ser uma combinação de valores estilo janela (como WS_CAPTION) e um ou mais do seguinte diálogo estilo de caixa Valores.

  Valor	Descrição
  DS_CENTER	Centraliza o caixa de diálogo na área de trabalho; that is, a área não obscurecida pela bandeja
  DS_LOCALEDIT	Aplica-se a 16-bit somente aplicativos. Esse estilo direciona editar controles na caixa de diálogo alocar memória a partir do Segmento dados aplicativo. Caso contrário, editar controles alocar armazenamento de um objeto memória global.
  DS_MODALFRAME	Cria uma caixa diálogo com um restrito diálogo-quadro caixa que pode ser combinada com um barra de título e janela menu especificando os estilos WS_CAPTION e WS_SYSMENU.
  DS_SETFONT	Indica que o cabeçalho do modelo caixa de diálogo contém dados adicionais especificando a fonte para texto na área cliente e controles de caixa de diálogo. Os dados fonte começa na Word limite que segue a matriz de título. Ele especifica um 16-bit apontar valor tamanho e uma fonte Unicode nome seqüência de caracteres. Se possível, o sistema cria uma fonte de acordo com os valores especificados. E o sistema passa o identificador da fonte para a caixa diálogo cada controle e enviando-lhes a WM_SETFONT mensagem. Se esse estilo não for especificado, o modelo caixa diálogo não inclui os dados fonte. Você não pode definir a fonte dentro de caixas diálogo em Windows CE 1.0 1.01, mas poderá em Windows CE 2.0 e posterior.
  DS_SETFOREGROUND	Faz com que o sistema para usar o SetForegroundWindow função para trazer a caixa diálogo para o primeiro plano.

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

• cdit
  Especifica o número de itens na caixa de diálogo.

• x
  Especifica o x-coordenar, em unidades caixa diálogo, da upper-left corner de caixa de diálogo.

• y
  Especifica a y-coordenar, em unidades caixa diálogo, da upper-left corner de caixa de diálogo.

• CX
  Especifica a largura, em unidades caixa diálogo, da caixa de diálogo.

• CY
  Especifica a altura, em unidades caixa diálogo, da caixa de diálogo.

Remarks

Ao posicionamento usar como padrão get, use o estilo DS_CENTER.

Em um padrão modelo para uma caixa diálogo, o DLGTEMPLATE estrutura é sempre seguida por três de comprimento variável matriz que especificar o menu, classe e Título para caixa de diálogo. Quando o estilo DS_SETFONT for fornecido, esses matrizes são também seguidos de 16-bit valor especificando tamanho apontar e outra matriz variable-length especificando um nome face de tipos. Cada matriz consiste de um ou mais 16-bit elementos. O menu, classe, título e matrizes fonte devem ser alinhados no Word Os limites.

Imediatamente seguinte a DLGTEMPLATE estrutura é uma matriz menu que, em área de trabalho Windows-Based plataformas, identifica um recurso menu para caixa de diálogo. Windows Embedded CE, no entanto, não suporte a adição de menus para uma caixa diálogo.

Após a primeira matriz é uma matriz classe que identifica a classe janela do controle. Se o primeiro elemento da matriz for 0x0000, o sistema usa a classe caixa diálogo predefinidas para caixa de diálogo e a matriz tem há outros elementos. Se o primeiro elemento é 0xffff, a matriz tem um elemento adicional que especifica o ordinal valor de uma classe janela sistema predefinidos. Se o primeiro elemento tiver qualquer outro valor, o sistema trata a matriz como um seqüência de caracteres Unicode NULL-Terminated que especifica o nome de uma classe de janela registrado.

Seguindo a matriz classe é uma matriz de título que especifica um seqüência de caracteres Unicode NULL-Terminated que contém o título da caixa de diálogo. Se o primeiro elemento dessa matriz for 0x0000, caixa de diálogo não tem um título e a matriz tem há outros elementos.

O 16-bit apontar valor tamanho e a matriz face de tipos seguem a matriz de título, mas somente se o estilo membro especifica o estilo DS_SETFONT. O valor tamanho apontar especifica o tamanho apontar da fonte a ser usado para o texto a caixa de diálogo e seus controles. A matriz face de tipos é um seqüência de caracteres Unicode NULL-Terminated especificando o nome do face de tipos para a fonte. Quando esses valores são designados, o sistema cria uma fonte ter o tamanho especificado e face de tipos (if possible) e envia uma mensagem WM_SETFONT para o procedimento caixa de diálogo e os procedimentos janela controle como ele cria a caixa diálogo e controles.

Seguindo a DLGTEMPLATE cabeçalho em um padrão modelo caixa diálogo são um ou mais DLGITEMTEMPLATE estruturas que definem as dimensões e estilo dos controles na caixa de diálogo. O cdit Especifica o número de membro DLGITEMTEMPLATE Estruturas de modelo. Esses DLGITEMTEMPLATE Estruturas devem ser alinhadas no DWORD Os limites.

Se você especificar caractere seqüências de caracteres na classe, título ou face de tipos matrizes, você deve usar seqüências de caracteres Unicode. 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.

O seguinte dwStyle Os sinalizadores não são com suporte para diálogo caixas:

• DS_ABSALIGN
• DS_CENTERMOUSE
• DS_CONTEXTHELP
• DS_FIXEDSYS
• DS_NOFAILCREATE
• DS_NOIDLEMSG
• DS_SYSMODAL

Requirements

See Also

Reference

CreateDialog
CreateDialogIndirect
CreateDialogIndirectParam
DialogBox
DialogBoxIndirect
DialogBoxIndirectParam
MapDialogRect
SetForegroundWindow
WM_SETFONT
DLGITEMTEMPLATE
Dialog Boxes Structures

Other Resources

MultiByteToWideChar