DIM

Dim

    Instrução para declaração de variáveis e alocação de espaço de memória, que utiliza esta sintaxe:

Dim [WithEvents] Nome [([índices])] [As [New] Tipo] [,WithEvents] Nome ...

Onde os argumentos são:

• WithEvents: Argumento opcional, a instrução WithEvents é válida apenas em módulos Classe, sendo uma palavra-chave que especifica que a variável é uma variável empregada para responder a eventos disparados pelo objeto ActiveX que ela representa. Não é possível declarar variáveis matrizes ou empregar a instrução New com WithEvents;
• Nome: Argumento obrigatório indicando o nome da variável;
• Índices: Argumento opcional, indica a dimensão de uma variável matriz (array). Você pode declarar até 60 dimensões para uma variável, utilizando a seguinte sintaxe:
• MenorDimensão To] MaiorDimensão [, MenorDimensão To] ...

    Quando um argumento MenorDimensão não é explicitamente declarado, a menor dimensão de uma matriz é controlada pela instrução Option Base 9padrão = 0).

• New: Argumento opcional, é uma palavra-chave que permite a criação implícita de um novo exemplar de um objeto na primeira referência feita a ela no seu código (quando uma variável de objeto é declarada As New TipoDeObjeto, não é necessário empregar uma instrução Set variável = New TipoDeObjeto para criá-lo durante  a execução do código). A palavra-chave New não pode ser empregada para: declarar variáveis que não sejam objetos, para criar exemplares d objetos dependentes de outros objetos ou ser empregada com WithEvents;
• Tipo: Argumento opcional, é o tipo de dados do valor retornado por procedimentos Function existentes na DLL, podendo ser Byte, Boolean, Integer, Long, Currency, Single, Double, Date, String (de comprimento variável), Variant, um tipo definido pelo usuário ou um tipo de objeto;

As seguintes considerações são válidas sobre a instrução Dim:

• Variáveis declaradas com Dim ao nível de módulo estão disponíveis para todos os procedimentos existentes no módulo. Caso sejam declaradas dentro de um procedimento, estão disponíveis apenas para o procedimento;
• Quando uma variável declarada com Dim não possui o tipo de dados especificado, ela será definida para o tipo de dados Variant, a menos que se empregue uma das instruções DefType para definir o tipo de dados padrão;
• Não há distinção entre instrução Dim e a instrução Private quando a variável é declarada ao nível de módulo. Porém, recomenda-se que ao n´vel de módulo você empregue a instrução Private, para tornar seu código mais claro;
• É possível declarar múltiplas variáveis com uma única instrução Dim, utilizando uma mesma linha de código. Entretanto, todas as variáveis deverão ter seu tipo de dados explicitamente declarado, ou serão consideradas como Variant;
• A instrução Dim pode ser empregada para declarar variáveis de objeto com ou sem o emprego da palavra-chave New. Quando New não for utilizado para a declaração de uma variável de objeto, você deverá obrigatoriamente utilizar a instrução Set Variável as New Objeto parc criar um novo exemplar do objeto desejado, ou ocorrerá um erro em tempo de execução ao tentar acessar sua interface;
• Quando uma variável de objeto é declarada sem a palavra-chave New, seu valor será a constante Nothing até que a variável seja inicializada com a instrução Set;
• Você pode empregar a instrução Dim Variável () (seguida de parênteses vazios) para declarar uma matriz dinâmica, sem dimensão definida. Dentro do procedimento, empregue a instrução ReDim para redimensionar a matriz para o número de dimensões desejado;
• Quando variáveis de dados são inicializadas, variáveis numéricas possuem o valor zero (0), variáveis String o valor “” (string vazia), e variáveis String de comprimento fixo são preenchidas com zeros. Variáveis Variant são inicializadas com o valor padrão do tipo a ele atribuído;
• É boa norma de programação empregar a declaração de variáveis no início do módulo ou procedimento onde elas se aplicam.

Exemplo: O exemplo que se segue demonstra como empregar a instrução Dim para declarar variáveis numéricas, matrizes e objetos. O valor padrão para o índice inferior de uma matriz é zero (0), a menos que explicitamente alterado por uma instrução Option Base.

‘ Variável Valor1 Valor2 não tem tipo declarado (consideradas Variant)

Dim Valor1, Valor2

‘ Declaração implícita de variáveis Long

Dim Valor As Llong

‘ Múltiplas declarações em uma única linha exigem a declaração de tipo individual

Dim Resultado As Boolean, DataNasc As Date

‘ Dias é uma matriz de 311 elementos pois Option Base = 0, com elementos de 0 a 30

Dim Dias(30)

‘ Matriz1 é bidimensional de 20 elementos do tipo Integer

Dim Matriz1(3,4) As Integer

‘ Matriz2 é tridimensional do tipo Long com dimensões explicitamente declaradas

DimMyMatriz(1 To 6, 3 To 10, 4 To 8) As Long

‘ Matriz3 é uma matriz dinâmica, sem dimensões definidas

Dim Matriz3()

Até a Próxima!!