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

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

Sintaxe do método Activate

object. Ativar

Na sintaxe do método Activate , a palavra itálico "object" é um espaço reservado para informações fornecidas, nesse caso, o código que retorna um objeto. Palavras em negrito devem ser digitados exatamente como aparecem. Por exemplo, o procedimento a seguir ativa a segunda janela do 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 itálico são denominadas argumentos da função. Argumentos entre colchetes são opcionais. (Não digite os colchetes no código Visual Basic.) Para a função MsgBox, o único argumento que você deve fornecer é o texto do prompt.

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 com 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 de 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. Os métodos que não retornam valores não precisam de seus argumentos entre parênteses. Essas diretrizes se aplicam se você está usando argumentos posicionais ou argumentos nomeados.

No exemplo a seguir, o valor de retorno da função MsgBox é um número que indica o botão selecionado armazenado na variável myVar. Como o valor de retorno é 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 { BinaryTextDatabase | | }

Na sintaxe da instrução Option Compare , as chaves e a barra vertical indicam uma opção 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 é sensível a casos.

Option Compare Text 

Sintaxe de instrução Dim

Dim varname [([ subscripts ])] [ As type, ] [ varname [([ subscripts ])] [ As type ]] . . .

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 cadeia de caracteres. Incluir um tipo de dados salva memória e pode ajudá-lo a encontrar erros em seu 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. As variáveis declaradas sem um tipo de dados são declaradas automaticamente como Variant.

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

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

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.