Compartilhar via


Recurso DIALOG

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.

Observação

DIALOG é uma ID de recurso obsoleta. Novos aplicativos devem usar DIALOGEX.

 

nameID DIALOG x, y, width, height  [optional-statements] {control-statement  . . . }

Parâmetros

nameID

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

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 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 CARACTERÍSTICAS.
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 CLASS.
EXSTYLE=extended-styles Estilo de janela estendido da caixa de diálogo. Para obter mais informações, consulte EXSTYLE.
FONTpointsize, typeface Tamanho do ponto e face de tipo para a fonte. Para obter mais informações, consulte FONT.
IDIOMA,sublanguagem Idioma da caixa de diálogo. Para obter mais informações, consulte LANGUAGE.
MENUmenuname Menu a ser usado. Esse valor é o nome do menu ou seu identificador inteiro.
Estilos de ESTILO Estilos da caixa de diálogo. Para obter mais informações, consulte 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 VERSÃO.

 

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

A função GetDialogBaseUnits retorna as unidades base da caixa de diálogo em pixels. O significado exato das coordenadas depende do estilo definido pela instrução de opção STYLE . Para caixas de diálogo de estilo filho, as coordenadas são relativas à origem da janela pai, a menos que a caixa de diálogo tenha o estilo DS_ABSALIGN; Nesse caso, as coordenadas são relativas à origem da tela de exibição.

Não use o estilo WS_CHILD com uma caixa de diálogo modal. A função DialogBox sempre desabilita o pai/proprietário da caixa de diálogo recém-criada. Quando uma janela pai é desabilitada, suas janelas filho são implicitamente desabilitadas. Como a janela pai da caixa de diálogo de estilo filho está desabilitada, a caixa de diálogo de estilo filho também está.

Se uma caixa de diálogo tiver o estilo DS_ABSALIGN , as coordenadas da caixa de diálogo para seu canto superior esquerdo serão relativas à origem da tela, em vez de ao canto superior esquerdo da janela pai. Normalmente, você usaria esse estilo quando quisesse que a caixa de diálogo iniciasse em uma parte específica da exibição, independentemente de onde a janela pai possa estar na tela.

O nome DIALOG também pode ser usado como o parâmetro class-name para a função CreateWindow para criar uma janela com atributos de caixa de diálogo.

Exemplos

O seguinte demonstra o uso da instrução DIALOG :

#include <windows.h>

ErrorDialog DIALOG  10, 10, 300, 110
STYLE WS_POPUP | WS_BORDER
CAPTION "Error!" 
{
    CTEXT "Select One:", 1, 10, 10, 280, 12
    PUSHBUTTON "&Retry", 2, 75, 30, 60, 12
    PUSHBUTTON "&Abort", 3, 75, 50, 60, 12
    PUSHBUTTON "&Ignore", 4, 75, 80, 60, 12
}

Confira também

Usando caixas de diálogo

ACELERADORES

CARACTERÍSTICAS

CONTROLE

Createdialog

Createwindow

Dialogbox

Getdialogbaseunits

LÍNGUA

MENU

RCDATA

STRINGTABLE

VERSÃO