MsgBoxEx

<< Clique para Mostrar o Sumário >>

 

MsgBoxEx

MsgBoxEx(prompt, [buttons], [title], [PosX], [PosY])

Este método permite mostrar uma caixa de diálogo padrão do Windows e especificar a posição na tela. Os parâmetros disponíveis neste método são os seguintes:

prompt: Texto a ser mostrado na caixa de diálogo. O tamanho máximo deste texto é de aproximadamente 1024 caracteres, dependendo da largura dos caracteres usados. Para inserir quebras de linha no texto, separe as linhas usando a função Chr do VBScript com os valores 10 (avanço de linha), 13 (retorno de carro) ou uma combinação destes valores entre cada linha

buttons: Uma expressão numérica opcional que representa a soma dos valores especificando a quantidade e o tipo dos botões mostrados, o estilo, o botão padrão e se a caixa de diálogo é modal ou não. O valor padrão deste parâmetro é 0 (zero), ou seja, mostra apenas o botão OK. Consulte a tabela a seguir para mais informações sobre este parâmetro

title: Texto opcional mostrado na barra de título da caixa de diálogo. Se este parâmetro é omitido, a caixa de diálogo não mostra nenhum título

PosX: Indica a posição, em pixels, da caixa de diálogo em relação à margem esquerda da janela. Caso este parâmetro seja omitido, a respectiva coordenada da caixa de diálogo é centralizada na janela

PosY: Indica a posição, em pixels, da caixa de diálogo em relação à margem superior da janela. Caso este parâmetro seja omitido, a respectiva coordenada da caixa de diálogo é centralizada na janela

 

NOTA

Caso os valores indicados nos parâmetros PosX e PosY posicionem a caixa de diálogo fora da área visível da janela, estes valores são ajustados automaticamente para garantir que a caixa de diálogo esteja visível.

 

Os valores possíveis para o parâmetro buttons estão descritos nas tabelas a seguir.

Valores possíveis para tipos de botões

Valor

Descrição

Constante no VBScript

0

Mostra apenas o botão OK

vbOKOnly

1

Mostra os botões OK e Cancelar (Cancel)

vbOKCancel

2

Mostra os botões Abortar (Abort), Repetir (Retry) e Ignorar (Ignore)

vbAbortRetryIgnore

3

Mostra os botões Sim (Yes), Não (No) e Cancelar (Cancel)

vbYesNoCancel

4

Mostra os botões Sim (Yes) e Não (No)

vbYesNo

5

Mostra os botões Repetir (Retry) e Cancelar (Cancel)

vbRetryCancel

 

Valores possíveis para estilos de ícones

Valor

Descrição

Constante no VBScript

16

Mostra um ícone indicando uma mensagem crítica

vbCritical

32

Mostra um ícone indicando uma pergunta

vbQuestion

48

Mostra um ícone indicando uma afirmação

vbExclamation

64

Mostra um ícone indicando uma informação

vbInformation

 

Valores possíveis para botões padrão

Valor

Descrição

Constante no VBScript

0

Indica que o primeiro botão é o padrão de retorno

vbDefaultButton1

256

Indica que o segundo botão é o padrão de retorno

vbDefaultButton2

512

Indica que o terceiro botão é o padrão de retorno

vbDefaultButton3

768

Indica que o quarto botão é o padrão de retorno

vbDefaultButton4

 

Valores possíveis para tipos de janelas modais

Valor

Descrição

Constante no VBScript

0

Indica que o usuário deve responder esta caixa de diálogo antes de continuar trabalhando na aplicação

vbApplicationModal

4096

Indica que todas as aplicações estão suspensas até que o usuário responda esta caixa de diálogo

vbSystemModal

 

Este método retorna um valor numérico que representa o botão clicado na caixa de diálogo, conforme a tabela a seguir.

Valores de retorno do método MsgBoxEx

Valor

Botão

Constante no VBScript

1

OK

vbOK

2

Cancelar (Cancel)

vbCancel

3

Abortar (Abort)

vbAbort

4

Repetir (Retry)

vbRetry

5

Ignorar (Ignore)

vbIgnore

6

Sim (Yes)

vbYes

7

Não (No)

vbNo

Esta página foi útil?