Noções básicas sobre a sintaxe do Visual Basic

Artigo
10/25/2024

A sintaxe num tópico da Ajuda do Visual Basic para um método, função ou instrução mostra todos os elementos necessários para utilizar o método, função ou instrução corretamente. Os exemplos neste tópico explicam como interpretar os elementos de sintaxe mais comuns.

Ativar sintaxe do método

objeto. Ativar

Na sintaxe do método Ativar , a palavra itálico "objeto" é um marcador de posição para as informações fornecidas— neste caso, código que devolve um objeto. As palavras a negrito devem ser escritas exatamente como aparecem. Por exemplo, o procedimento seguinte ativa a segunda janela no documento ativo.

Sub MakeActive() 
    Windows(2).Activate 
End Sub

Sintaxe da função MsgBox

CaixaDeMensagem(prompt, [ botões ], [ título ], [ arquivo de ajuda, contexto ])

Na sintaxe da função MsgBox , as palavras em itálico são argumentos nomeados da função. Os argumentos entre parênteses retos são opcionais. (Não escreva os parênteses retos no código do Visual Basic.) Para a função MsgBox , o único argumento que tem de fornecer é o texto do pedido.

Os argumentos para funções e métodos podem ser especificados no código por posição ou pelo nome. Para especificar argumentos por posição, siga a ordem apresentada na sintaxe, separando cada argumento com uma vírgula, por exemplo:

MsgBox "Your answer is correct!",0,"Answer Box"

Para especificar um argumento por nome, utilize o nome do argumento seguido de dois pontos e um sinal de igual (:=) e o valor do argumento. Pode especificar argumentos com nome em qualquer ordem, por exemplo:

MsgBox Title:="Answer Box", Prompt:="Your answer is correct!"

A sintaxe para funções e alguns métodos mostra os argumentos entre parênteses. Estas funções e métodos devolvem valores, pelo que tem de incluir os argumentos entre parênteses para atribuir o valor a uma variável. Se ignorar o valor devolvido ou se não transmitir argumentos, não inclua os parênteses. Os métodos que não devolvem valores não precisam dos respetivos argumentos entre parênteses. Estas diretrizes aplicam-se quer esteja a utilizar argumentos posicionais ou argumentos nomeados.

No exemplo seguinte, o valor devolvido da função MsgBox é um número que indica o botão selecionado armazenado na variável myVar. Uma vez que o valor devolvido é utilizado, são necessários parênteses. Em seguida, outra caixa de mensagem apresenta o valor da variável.

Sub Question() 
    myVar = MsgBox(Prompt:="I enjoy my job.", _ 
        Title:="Answer Box", Buttons:="4") 
    MsgBox myVar 
End Sub

Sintaxe da instrução Comparação de Opções

Opção Comparar {Base de Dados de | Texto | Binário }

Na sintaxe da instrução Comparação de Opções, as chavetas e a barra vertical indicam uma escolha obrigatória entre três itens. (Não escreva as chavetas na instrução Visual Basic). Por exemplo, a seguinte instrução especifica que, dentro do módulo, as cadeias serão comparadas numa sequência de ordenação que não é sensível a maiúsculas e minúsculas.

Option Compare Text

Sintaxe da instrução Dim

Dimvarname [([ subscripts ])] [ Comotipo, ] [ varname [([ subscripts ])] [ Comotipo ]] . . .

Na sintaxe da instrução Dim, a palavra Dim é uma palavra-chave necessária. O único elemento necessário é varname (o nome da variável).

Por exemplo, a seguinte instrução cria três variáveis: myVar, nextVare thirdVar. Estas variáveis são automaticamente declaradas como Variáveis de Variante .

Dim myVar, nextVar, thirdVar

O exemplo seguinte declara uma variável como uma Cadeia. Incluir um tipo de dados guarda memória e pode ajudá-lo a encontrar erros no seu código.

Dim myAnswer As String

Para declarar várias variáveis numa instrução, inclua o tipo de dados para cada variável. As variáveis declaradas sem um tipo de dados são declaradas automaticamente como Variante.

Dim x As Integer, y As Integer, z As Integer

Na seguinte instrução, x é-lhe y atribuído o tipo de dados Variante . Só z é atribuído o tipo de dados Número inteiro .

Dim x, y, z As Integer

A abreviação para declarar x e y como Número Inteiro na declaração acima é:

Dim x%, y%, z as Integer

A abreviação para os tipos é: % -inteiro; & longo; @ -moeda; # -duplo; ! -única; $ -cadeia de caratceres

Se estiver a declarar uma variável de matriz , tem de incluir parênteses. Os índices são opcionais. A instrução seguinte dimensiona uma matriz dinâmica, myArray.

Dim myArray()

Confira também

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.

Compartilhar via