|
<< 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 |