Partilhar via


Recurso DIALOGEX

Define uma caixa de diálogo. A instrução define a posição e as dimensões da caixa de diálogo na tela, bem como o estilo da caixa de diálogo. Ele também define o seguinte:

  • IDs de ajuda na caixa de diálogo em si, bem como em controles dentro da caixa de diálogo.
  • Uso da instrução EXSTYLE para a própria caixa de diálogo, bem como em controles dentro da caixa de diálogo.
  • Espessura da fonte e configurações em itálico para a fonte a ser usada na caixa de diálogo.
  • Dados específicos do controle para controles dentro da caixa de diálogo.
  • Uso dos nomes de classe de sistema predefinidos BEDIT, IEDIT e HEDIT .
nameID DIALOGEX x, y, width, height [ , helpID] [optional-statements]  {control-statements}

Parâmetros

nameID

Nome exclusivo ou um valor inteiro sem sinal exclusivo de 16 bits que identifica a caixa de diálogo.

X

Local na tela do lado esquerdo da caixa de diálogo, em unidades de diálogo.

Y

Local na tela da parte superior da caixa de diálogo, em unidades de diálogo.

Largura

Largura da caixa de diálogo, em unidades de diálogo.

Altura

Altura da caixa de diálogo, em unidades de diálogo.

helpID

Expressão numérica que indica a ID usada para identificar a caixa de diálogo durante WM_HELP processamento.

instruções opcionais

Opções para a caixa de diálogo. Isso pode ser zero ou mais das instruções a seguir.

Instrução Descrição
LEGENDA "text" Legenda da caixa de diálogo se ela tiver uma barra de título. Para obter mais informações, consulte Instrução CAPTION.
Dword CHARACTERISTICS Valor DWORD definido pelo usuário para uso pelas ferramentas de recurso. Esse valor não é usado pelo sistema. Para obter mais informações, consulte Instrução CHARACTERISTICS.
Classe CLASS Um inteiro sem sinal de 16 bits ou uma cadeia de caracteres, entre aspas duplas ("), que identifica a classe da caixa de diálogo. Para obter mais informações, consulte Instrução CLASS.
EXSTYLE= estilos estendidos Estilo de janela estendido da caixa de diálogo. Para obter mais informações, consulte Instrução EXSTYLE.
FONTpointsize, "typeface", weight, itálico, charset Tamanho do ponto e face de tipo para a fonte. Para peso, use os valores FW_* definidos em WinGDI.h. Para itálico, especifique TRUE para usar uma fonte itálica; caso contrário, FALSE. Para charset, use o valor definido no membro lfCharSet da estrutura LOGFONT . Para obter a fonte definitiva de uma caixa de diálogo, um aplicativo deve especificar o conjunto de caracteres junto com outras propriedades de fonte. Para obter mais informações, consulte Instrução FONT.
IDIOMA,sublanguagem Idioma da caixa de diálogo. Para obter mais informações, consulte Instrução LANGUAGE.
MENUmenuname Menu a ser usado. Esse valor é o nome do menu ou seu identificador inteiro. Para obter mais informações, consulte Instrução MENU.
Estilos de ESTILO Estilos da caixa de diálogo. Para obter mais informações, consulte Instrução STYLE.
VERSIONdword Valor DWORD definido pelo usuário. Essa instrução destina-se ao uso por ferramentas de recursos adicionais e não é usada pelo sistema. Para obter mais informações, consulte Instrução VERSION.

 

instruções control

O corpo do recurso DIALOGEX é composto por qualquer número de instruções de controle. Há quatro famílias de instruções de controle: genérico, estático, botão e edição. Para obter mais informações, consulte Comentários.

Determinados atributos também têm suporte para compatibilidade com versões anteriores. Para obter mais informações, consulte Atributos de recurso comuns.

Comentários

As operações válidas que podem estar contidas em qualquer uma das expressões numéricas nas instruções de DIALOGEX são as seguintes:

  • Adicionar ('+')
  • Subtrair ('-')
  • Subtração unária ('-')
  • UNARY NOT ('~')
  • AND (''&)
  • OR ('|')

O corpo do recurso é composto por instruções genéricas, estáticas, de botão e de controle de edição. Embora cada uma dessas famílias de instruções use uma sintaxe diferente para definir recursos específicos de seus controles, todas elas compartilham uma sintaxe comum para definir a posição, o tamanho, os estilos estendidos, o número de identificação de ajuda e os dados específicos do controle. Para obter mais informações, consulte Parâmetros de controle comuns.

Instruções de controle genéricas

CONTROL controlText, id, className, style

Controltext

Texto da janela para o controle. Para obter mais informações, consulte Parâmetros de controle comuns.

Id

Identificador do controle. Para obter mais informações, consulte Parâmetros de controle comuns.

Classname

Nome da classe. Pode ser uma cadeia de caracteres entre aspas duplas (") ou uma das seguintes classes de sistema predefinidas: BUTTON, STATIC, EDIT, LISTBOX, SCROLLBAR ou COMBOBOX.

Estilo

Os estilos de janela (valores de estilo explícitos WS_*, BS_*, SS_*, ES_*, LBS_*, SBS_*e CBS_* definidos em Winuser.H podem ser usados adicionando um include ao arquivo .rc: #include "winuser.h"). Para obter mais informações, consulte Estilos de Janelas.

Instruções de controle estático

staticClass controlText, id

staticClass

LTEXT, RTEXT ou CTEXT.

Controltext

Texto da janela para o controle. Para obter mais informações, consulte Parâmetros de controle comuns.

Id

Identificador do controle. Para obter mais informações, consulte Parâmetros de controle comuns.

Instruções de controle de botão

buttonClass controlText, id

buttonClass

AUTO3STATE, AUTOCHECKBOX, AUTORADIOBUTTON, CHECKBOX, PUSHBOX, PUSHBUTTON, RADIOBUTTON, STATE3 ou USERBUTTON.

Controltext

Texto da janela para o controle. Para obter mais informações, consulte Parâmetros de controle comuns.

Id

Identificador do controle. Para obter mais informações, consulte Parâmetros de controle comuns.

Editar instruções de controle

editClass id

editClass

EDITTEXT, BEDIT, HEDIT ou IEDIT.

Id

Identificador do controle. Para obter mais informações, consulte Parâmetros de controle comuns.

Confira também

Usando caixas de diálogo

ACELERADORES

CARACTERÍSTICAS

CONTROLE

Createdialog

Createwindow

Dialogbox

Getdialogbaseunits

LÍNGUA

LOGFONT

MENU

RCDATA

STRINGTABLE

VERSÃO