Compartilhar via

DLGTEMPLATEEX

  • Artigo

Windows Mobile SupportedWindows Embedded CE Supported

9/9/2008

Essa estrutura não está definida no qualquer padrão arquivo cabeçalho. A definição estrutura é fornecida aqui para explicar o formato de um estendido modelo para uma caixa diálogo.

Um estendido modelo caixa diálogo começa com um DLGTEMPLATEEX cabeçalho que descreve a caixa diálogo e especifica o número de controles na caixa de diálogo. Para cada controle em uma caixa diálogo, um estendido modelo caixa diálogo possui um bloco de dados que usa o DLGITEMTEMPLATEEX formato para descrever o controle.

Syntax

typedef struct { 
  WORD dlgVer; 
  WORD signature; 
  DWORD helpID; 
  DWORD exStyle; 
  DWORD style; 
  WORD cDlgItems; 
  short x; 
  short y; 
  short cx; 
  short cy; 
  sz_Or_Ord menu; 
  sz_Or_Ord windowClass; 
  WCHAR title[titleLen]; 
  short pointsize; 
  short weight; 
  short bItalic; 
  WCHAR font[fontLen];
} DLGTEMPLATEEX;

Os membros

  • dlgVer
    Especifica o número versão do estendido modelo caixa diálogo. Este membro deve especificar 1.
  • assinatura
    Indica se um modelo é um estendido modelo caixa diálogo. Um valor de 0xFFFF indica um estendido modelo caixa diálogo. Neste maiúsculas e minúsculas, o dlgVer membro especifica o número versão modelo. Se assinatura é qualquer valor diferente 0xffff, este é um padrão modelo que usa o DLGTEMPLATE e DLGITEMTEMPLATE estruturas.
  • helpID
    Especifica a identificador de contexto de ajuda para a janela caixa diálogo.
  • exStyle
    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.

  • estilo
    Especifica o estilo da caixa de diálogo. Esse membro pode ser uma combinação de valores estilo janela (como WS_CAPTION) e um ou mais dos valores estilo de caixa diálogo mostrados a seguinte tabela.

    Valor Descrição

    DS_3DLOOK

    Fornece a uma fonte nonbold caixa de diálogo e tridimensional desenha bordas ao redor janelas controle caixa de diálogo.

    DS_CENTER

    Centraliza o caixa de diálogo na área de trabalho; that is, a área não obscurecida por bandeja.

    DS_CONTROL

    Cria uma caixa diálogo que funciona bem como um janela filho de caixa de diálogo outro, bem como uma página em um folha de propriedades. Esse estilo permite que o usuário para guia entre as janelas controle de uma caixa diálogo filho, use suas teclas acelerador e SO on.

    DS_MODALFRAME

    Cria uma caixa diálogo com um restrito diálogo-quadro caixa que pode ser combinada com um menu janela e barra de título, especificando os estilos WS_CAPTION e WS_SYSMENU.

    DS_SETFONT

    Indica que o DLGTEMPLATEEX cabeçalho do estendido modelo caixa diálogo contém quatro (membros adicionaispointsize, Peso, bItalic, e fonte) que descrevem a fonte a ser usado para o texto a área cliente e os controles de caixa de diálogo. Se possível, o sistema cria uma fonte de acordo com os valores especificados nesses membros. Em seguida, o sistema passa o identificador da fonte para caixa de diálogo e para cada controle enviando-lhes a mensagem WM_SETFONT.

    Se esse estilo não for especificado, o estendido modelo caixa diálogo não inclui o pointsize, Peso, bItalic, e fonte Os membros.

    DS_SETFOREGROUND

    Faz com que o sistema para usar o SetForegroundWindow função para trazer a caixa diálogo para o primeiro plano.
  • cDlgItems
    Especifica o número de controles 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.
  • menu
    Não suportado.
  • windowClass
    Especifica uma matriz variable-length de 16-bit elementos que identifica a classe janela da caixa de diálogo. 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.
  • Título
    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.
  • pointsize
    Especifica o tamanho apontar da fonte a ser usado para o texto na caixa de diálogo e seus controles. O pointsize, Peso, bItalic, e fonte Membros estão presentes em um estendido diálogo caixa modelo Somente se o estilo membro especifica o estilo DS_SETFONT.
  • Peso
    Especifica o peso da fonte no intervalo de 0 a 1000. Isso pode ser qualquer um dos valores listados para o lfWeight membro das LOGFONT estrutura. Este membro está presente somente se o estilo membro especifica DS_SETFONT.
  • bItalic
    Indica se a fonte é itálico. Se esse valor for TRUE, a fonte é itálico. Este membro está presente somente se o estilo membro especifica DS_SETFONT.
  • fonte
    Especifica um seqüência de caracteres Unicode NULL-Terminated que contém o nome do face de tipos para a fonte. Este membro está presente somente se o estilo membro especifica DS_SETFONT.

Remarks

Você pode usar um estendido modelo caixa diálogo instead of um padrão modelo caixa diálogo in a CreateDialogIndirectParam e DialogBoxIndirectParam funções e o CreateDialogIndirect e DialogBoxIndirect As macros. Um padrão caixa de diálogo modelo usa o DLGTEMPLATE e DLGITEMTEMPLATE estruturas.

Seguindo a DLGTEMPLATEEX cabeçalho em um estendido modelo caixa diálogo é um ou mais DLGITEMTEMPLATEEX estruturas que descrevem os controles de caixa de diálogo. O cDlgItems Especifica o número de membro DLGITEMTEMPLATEEX Estruturas de modelo.

Cada DLGITEMTEMPLATEEX estrutura no modelo deve ser alinhada em um DWORD limite. Se a pasta estilo membro especifica o estilo DS_SETFONT, o primeiro DLGITEMTEMPLATEEX estrutura começa no primeiro DWORD limite após o fonte seqüência de caracteres. Se DS_SETFONT não for especificado, a estrutura primeira começa no primeiro DWORD limite após o Título seqüência de caracteres.

O menu, windowClass, Título, e fonte Matrizes devem ser alinhados no Word Os limites.

Se você especificar caractere seqüências de caracteres de windowClass, Título, e fonte 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

Windows Embedded CE não suporte a adição de menus para uma caixa diálogo.

Requirements

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

See Also

Reference

CreateDialogIndirect
CreateDialogIndirectParam
DialogBoxIndirect
DialogBoxIndirectParam
MapDialogRect
WM_SETFONT
DLGITEMTEMPLATE
DLGITEMTEMPLATEEX
DLGTEMPLATE
Dialog Boxes Structures

Other Resources

MultiByteToWideChar
LOGFONT