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

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

Sintaxe do método Activate

objeto de teste. Ativar

Na sintaxe do método Activate , a palavra itálico "objeto" é um espaço reservado para as informações fornecidas — nesse caso, o código que retorna um objeto. As palavras em negrito devem ser digitadas exatamente como aparecem. Por exemplo, o procedimento a seguir ativa a segunda janela no documento ativo.

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

Sintaxe da função CaixaDeMensagem

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

Na sintaxe da função CaixaDeMensagem , as palavras em itálico são nomeadas como argumentos da função. Os argumentos entre colchetes são opcionais. (Não digite os colchetes no código do Visual Basic.) Para a função MsgBox , o único argumento que você deve fornecer é o texto do prompt.

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

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

Para especificar um argumento por nome, use o nome do argumento seguido por dois-pontos e um sinal de igual (:=) e o valor do argumento. Você pode especificar argumentos nomeados 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. Essas funções e métodos retornam valores, portanto, você deve colocar os argumentos entre parênteses para atribuir o valor a uma variável. Se você ignorar o valor de retorno ou se não passar argumentos, não inclua os parênteses. Métodos que não retornam valores não precisam de seus argumentos entre parênteses. Essas diretrizes se aplicam se você estiver usando argumentos posicionais ou argumentos nomeados.

No exemplo a seguir, o valor retornado da função CaixaDeMensagem é um número indicando o botão selecionado que está armazenado na variável myVar. Como o valor retornado é usado, parênteses são necessários. Outra caixa de mensagem exibe 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 Option Compare

option compare { | binarytext | database }

Na sintaxe da instrução Option Compare , as chaves e a barra vertical indicam uma escolha obrigatória entre três itens. (Não digite as chaves na instrução Visual Basic). Por exemplo, a instrução a seguir especifica que, dentro do módulo, as cadeias de caracteres serão comparadas em uma ordem de classificação que não diferencia maiúsculas de minúsculas.

Option Compare Text

Sintaxe da instrução Dim

Dimvarname [([ subscritos ])] [ Comotipo, ] [ varname [([ subscritos ])] [ 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 instrução a seguir cria três variáveis: myVar, nextVare thirdVar. Elas são declaradas automaticamente como variáveis Variant .

Dim myVar, nextVar, thirdVar

O exemplo a seguir declara uma variável como uma String. A inclusão de um tipo de dados economiza memória e pode ajudar você a encontrar erros no código.

Dim myAnswer As String

Para declarar várias variáveis em uma instrução, inclua o tipo de dados para cada variável. Variáveis declaradas sem um tipo de dados são automaticamente declaradas como Variant.

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

Na instrução a seguir, x e y são atribuídos ao tipo de dados Variant . Somente z o tipo de dados Integer é atribuído.

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 você estiver declarando uma variável de matriz , deverá incluir parênteses. Os subscritos são opcionais. A instrução a seguir 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.

  • Last updated on