Table of contents
TOC
Recolher sumário
Expandir sumário

Declaração Dim

office 365 dev account|Última Atualização: 04/10/2017
|
1 Colaborador

Declara variáveis e aloca espaço de armazenamento.

Syntax

Dim [ WithEvents ] varname [ ( [ subscritos ] ) ] [ As [ New ] tipo ] [ , [ WithEvents ] varname [ ( [ subscritos ] ) ] [ As [ New ] tipo ]] . . .

A sintaxe da instrução Dim inclui três partes:

ParteDescrição
WithEventsOpcional. A palavra-chave que especifica se o varname é uma variável do objeto usada para responder a eventos acionados por um objeto ActiveX . WithEvents só será válido em módulos de classe. Você poderá declarar quantas variáveis individuais desejar usando a declaração WithEvents, mas não é possível criar matrizes com WithEvents. Não é possível usar New com WithEvents.
varnameObrigatório. Nome da variável; segue as convenções de nomenclatura padrão para variáveis.
subscritosOpcional. Dimensões de uma variável de matriz; podem ser declaradas até 60 dimensões múltiplas. O argumento subscripts utiliza a seguinte sintaxe:[ mais baixopara ] mais alto [ , [ mais baixoPara ] mais alto ] . . . Quando não for declarado explicitamente em mais baixo , o limite mais baixo de uma matriz será controlado pela instrução OptemBase. O limite mais baixo da matriz será zero, se nenhuma instrução OpçãoBase estiver presente.
NewOpcional. Palavra-chave que permite a criação implícita de um objeto. Se usar New ao declarar a variável de um objeto, a nova instância do objeto será criada na primeira referência a ele; por tanto, não é necessário usar a instrução SET para atribuir a referência do objeto. A palavra-chave New não poderá ser utilizada para declarar variáveis de quaisquer tipos de dados intrínsecos, para declarar instâncias de objetos dependentes e não pode ser usada com WithEvents.
tipoOpcional. Tipos de dados da variável; podem ser Byte, Booliano, Inteiro, Longo, Moeda, Único, Duplo, Decimal (sem suporte no momento), Data, Cadeia de caracteres (para cadeia de caracteres de tamanho variável), Cadeia de caracteres * comprimento (para cadeia de caracteres de comprimento fixo), Objeto, Variante, um tipo definido pelo usuário ou um tipo de objeto. Use uma cláusula separada typeAs para cada variável que declarar.

Remarks

As variáveis declaradas com Dim ao nível de módulo estão disponíveis para todos os procedimentos dentro do módulo. Ao nível de procedimento, as variáveis estão disponíveis somente dentro de procedimentos.

Use a instrução Dim em nível de módulo ou de procedimento para declarar o tipo de dados de uma variável. Por exemplo, a seguinte instrução declara uma variável como um Integer.

Dim NumberOfEmployees As Integer

Use também uma instrução Dim para declarar o tipo de objeto de uma variável. A seguinte instrução declara uma variável para a nova instância de uma planilha.

Dim X As New Worksheet

Se a palavra-chave New não for usada ao declarar a variável de um objeto, a variável referente ao objeto deverá ser atribuída a um objeto existente usando a instrução SET, antes de ser utilizada. Até que seja atribuída a um objeto, a variável declarada terá o valor especial Nada, o que indica que ela não se refere a qualquer instância específica de um objeto.

É possível usar também a instrução Dim com parênteses vazios para declarar uma matriz dinâmica. Após declarar uma matriz, use a instrução ReDim dentro de um procedimento para definir o número de dimensões e elementos de uma matriz. Se tentar declarar novamente a dimensão de uma variável de matriz, cujo tamanho foi explicitamente determinado em uma instrução Private, Public ou Dim, vai ocorrer um erro.

Caso não especifique o tipo de dados ou o tipo de objeto, e se não houver uma instrução do typeDEF no módulo, a variável será Variante por padrão.

Ao inicializar as variáveis, uma variável numérica será inicializada em 0, uma cadeia de caracteres de comprimento variável será inicializada em uma cadeia de comprimento zero (""), e uma cadeia de comprimento fixo será preenchida com zeros. As variáveis Variante serão inicializadas em Vazio. Cada elemento de uma variável de tipo definido pelo usuário é inicializado como se fosse uma variável separada.

Observação Ao utilizar a instrução Dim em um procedimento, normalmente se coloca a Dim no início do procedimento.

Exemplo

Esse exemplo mostra a instrução Dim usada para declarar variáveis. Também mostra a Dim usada para declarar matrizes. O limite subscrito mais baixo da matriz será 0 por padrão e poderá ser substituído ao nível do módulo usando a instrução Option Base.

' AnyValue and MyValue are declared as Variant by default with values
' set to Empty.
Dim AnyValue, MyValue

' Explicitly declare a variable of type Integer.
Dim Number As Integer

' Multiple declarations on a single line. AnotherVar is of type Variant
' because its type is omitted.
Dim AnotherVar, Choice As Boolean, BirthDate As Date

' DayArray is an array of Variants with 51 elements indexed, from
' 0 thru 50, assuming Option Base is set to 0 (default) for
' the current module.
Dim DayArray(50)

' Matrix is a two-dimensional array of integers.
Dim Matrix(3, 4)As Integer

' MyMatrix is a three-dimensional array of doubles with explicit
' bounds.
Dim MyMatrix(1 To 5, 4 To 9, 3 To 5)As Double

' BirthDay is an array of dates with indexes from 1 to 10.
Dim BirthDay(1 To 10)As Date

' MyArray is a dynamic array of variants.
Dim MyArray()
© 2018 Microsoft