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

  • Artigo

A sintaxe em um tópico do Visual Basic Help 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.

Ativar a sintaxe do método

objeto. Ativar

Na sintaxe do método Ativar , a palavra itálica "objeto" é um espaço reservado para informações fornecidas, nesse caso, 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 MsgBox

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

Na sintaxe da função MsgBox , as palavras itálicas são argumentos nomeados 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 para o prompt.

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, use o nome do argumento seguido por um ponto e um sinal 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 incluir os argumentos em parênteses para atribuir o valor a uma variável. Se você ignorar o valor retornado 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 fechados em parênteses. Essas diretrizes se aplicam se você está usando argumentos posicionais ou argumentos nomeados.

No exemplo a seguir, o valor retornado da função MsgBox é um número que indica o botão selecionado armazenado na variável myVar. Como o valor retornado é usado, parênteses são necessários. Em seguida, 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 de instrução De comparação de opções

Opção Comparar {Banco de Dados deTexto | Binário | }

Na sintaxe De comparação de opções, 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

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 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 a 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 subscripts 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.