Função CxMsg

Nota: Queremos fornecer-lhe os conteúdos de ajuda mais recentes o mais rapidamente possível e no seu idioma. Esta página foi traduzida automaticamente e pode conter erros gramaticais ou imprecisões. O nosso objetivo é que estes conteúdos lhe sejam úteis. Pode informar-nos se as informações foram úteis no final desta página? Eis o artigo em inglês para referência.

No ambiente de trabalho base de dados Access, a função CxMsg mostra uma mensagem na caixa de diálogo, espera para o utilizador clicar num botão e devolve um número inteiro que indica qual o utilizador clicou o botão.

Sintaxe

Caixa de mensagem linha de comandos do ([botões ] [título ] [, ficheiro de ajuda ] [contexto ] )

A sintaxe da função CxMsg tem os seguintes argumentos:

Argumento

Descrição

linha de comandos

Obrigatório. Expressão de cadeia apresentada como a mensagem na caixa de diálogo. O comprimento máximo de linha de comandos é aproximadamente 1024 caracteres, consoante a largura de carateres utilizados. Se o pedido é constituída por mais do que uma linha, pode separar as linhas, utilizando um carácter de retorno (Chr(13)), um caráter de avanço de linha (Chr(10)) ou CR – caráter de avanço de linha combinação (Chr(13) & Chr(10)) entre cada linha.

botões

Opcional. expressão numérica que é a soma dos valores especificando o número e o tipo de botões a apresentar, o estilo do ícone para utilizar, a identidade do botão predefinido e a modalidade da caixa de mensagem. Se for omitido, o valor predefinido para os botões é 0.

título

Opcional. Expressão de cadeia apresentada na barra de título da caixa de diálogo. Se omitir título, o nome da aplicação é colocado na barra de título.

ficheiro de ajuda

Opcional. Expressão de cadeia que identifica o ficheiro de ajuda para utilizar para fornecer ajuda sensível ao contexto para a caixa de diálogo. Se o ficheiro de ajuda é fornecido, contexto também tem de ser fornecido.

contexto

Opcional. Expressão numérica que é o número de contexto de ajuda atribuído para o tópico de ajuda adequado pelo autor da ajuda. Se o contexto for fornecido, ficheiro de ajuda também tem de ser fornecido.


Definições

As definições deargumentobotõessão:

Constante

Valor

Descrição

vbOKOnly

0

Apresentar apenas a botão OK .

vbOKCancel

1

Apresentar botões OK e Cancelar .

vbAbortRetryIgnore

2

Apresentar botões Cancelar, volte a tentare Ignorar .

vbYesNoCancel

3

Apresentar botões Sim, ne Cancelar .

vbYesNo

4

Apresentar botões Sim e não .

vbRetryCancel

5

Apresentar botões Repetir e Cancelar .

vbCritical

16

Apresenta o ícone de Mensagem crítica .

vbQuestion

32

Apresenta o ícone de Aviso de consulta    .

vbExclamation

48

Apresenta o ícone de Mensagem de aviso    .

vbInformation

64

Apresenta o ícone de Mensagem de informações .

vbDefaultButton1

0

Primeiro botão é predefinido.

vbDefaultButton2

256

Segundo botão é predefinido.

vbDefaultButton3

512

Terceiro botão é predefinido.

vbDefaultButton4

768

Quarto botão é predefinido.

vbApplicationModal

0

Aplicação modal; o utilizador tem de responder à caixa de mensagem antes de continuar a trabalhar na aplicação actual.

vbSystemModal

4096

Sistema modal; todas as aplicações são suspensa até o utilizador responde à caixa de mensagem.

vbMsgBoxHelpButton

16384

Adiciona o botão Ajuda para a caixa de mensagem

VbMsgBoxSetForeground

65536

Especifica a janela da caixa de mensagem como a janela de primeiro plano

vbMsgBoxRight

524288

Texto é alinhado à direita

vbMsgBoxRtlReading

1048576

Especifica texto deve ser apresentado como direita para a esquerda de leitura no sistemas hebraico e Árabe


Sugestão: No Access 2010, o Construtor de Expressões tem IntelliSense, para que possa ver que argumentos a sua expressão necessita. 

O primeiro grupo de valores (0 – 5) descreve o número e o tipo de botões apresentados na caixa de diálogo; o segundo grupo (16, 32, 48, 64) descreve o estilo do ícone; o terceiro grupo (0, 256, 512) determina qual o botão é a predefinição; e o quarto grupo (0, 4096) determina a modalidade da caixa de mensagem. Quando adicionar números para criar um valor para o argumento de botões final, utilize apenas um número de cada grupo.

Nota: Estes constantes são especificadas pela Visual Basic for Applications. Como resultado, os nomes podem ser utilizados em qualquer lugar no seu código em vez dos valores reais.

Valores Devolvidos

Constante

Valor

Descrição

vbOK

1

OK

vbCancel

2

Cancelar

vbAbort

3

Cancelar

vbRetry

4

Voltar a tentar

vbIgnore

5

Ignorar

vbYes

6

Sim

vbNo

7

Não


Observações

Quando são fornecidos o ficheiro de ajuda e o contexto , o utilizador pode premir F1 (Windows) ou da ajuda (Macintosh) para ver o tópico de ajuda correspondente ao contexto. Algumas aplicações de anfitrião, por exemplo, o Microsoft Excel, adicione também automaticamente um botão Ajuda para a caixa de diálogo.

Se a caixa de diálogo apresenta um botão Cancelar , ao premir a tecla ESC tem o mesmo efeito que clicar em Cancelar. Se a caixa de diálogo contiver um botão Ajuda , ajuda sensível ao contexto é fornecida para a caixa de diálogo. No entanto, não é devolvido nenhum valor até dos outros botões é clicada.

Nota: Para especificar mais do que o primeiro argumento com nome, tem de utilizar CxMsg uma expressão. Para omitir alguns argumentos posicionais, tem de incluir o delimitador vírgula correspondente.

Exemplo

Nota: Exemplos que se seguem demonstram a utilização desta função no Visual Basic para módulo Applications (VBA).

Este exemplo utiliza a função CxMsg para apresentar uma mensagem de erro crítico numa caixa de diálogo com os botões Sim e não. O botão não é especificado como a resposta predefinida. Valor devolvido pela função CxMsg depende do botão escolhido pelo utilizador. Este exemplo assume que DEMO.HLP é um ficheiro de ajuda que contém um tópico com um número de contexto de ajuda igual a 1000.

Dim Msg, Style, Title, Help, Ctxt, Response, MyString
Msg = "Do you want to continue?"
Style = vbYesNo + vbCritical + vbDefaultButton2
Title = "MsgBox Demonstration"
Help = "DEMO.HLP"
Ctxt = 1000
Response = MsgBox(Msg, Style, Title, Help, Ctxt)
If Response = vbYes Then ' User chose Yes.
MyString = "Yes" ' Perform some action.
Else ' User chose No.
MyString = "No" ' Perform some action.
End If
Aumente os seus conhecimentos do Office
Explore as formações
Seja o primeiro a obter novas funcionalidades
Adira ao Office Insider

As informações foram úteis?

Obrigado pelos seus comentários!

Obrigado pelo seu feedback! Parece que poderá ser benéfico reencaminhá-lo para um dos nossos agentes de suporte do Office.

×