Dim (Instrucción)

       

Declara variables y les asigna espacio de almacenamiento.

Sintaxis

Dim [WithEvents] nombre_variable[([subíndices])] [As [New] tipo] [, [WithEvents] nombre_variable[([subíndices])] [As [New] tipo]] . . .

La sintaxis de la instrucción Dim consta de las siguientes partes:

Parte	Descripción
WithEvents	Opcional. Palabra clave que especifica que nombre_variable es una variable de objeto utilizada para responder a eventos desencadenados por un objeto ActiveX. WithEvents solamente es válido en módulos de clase. Puede declarar tantas variables individuales como desee mediante WithEvents, pero no puede crear matrices con WithEvents. No puede utilizar New con WithEvents.
nombre_ variable	Requerido. Nombre de la variable; sigue las convenciones estándar de nombre de variable.
subíndices	Opcional. Dimensiones de la variable de matriz; se pueden declarar hasta 60 dimensiones múltiples. El argumento subíndices utiliza la sintaxis siguiente: [inferior To] superior [, [inferior To] superior] . . . Cuando no se declara específicamente en inferior, el límite inferior de una matriz se controla mediante la instrucción Option Base. Este límite inferior es cero si no hay ninguna instrucción Option Base.
New	Opcional. Palabra clave que habilita la creación implícita de un objeto. Si utiliza New cuando declara la variable de objeto, se crea una nueva instancia del objeto como primera referencia, de forma que no tiene que utilizar la instrucción Set para asignar la referencia del objeto. La palabra clave New no se puede utilizar para declarar variables de cualquier tipo de datos, intrínseco, para declarar instancias de objetos dependientes ni con WithEvents.
tipo	Opcional. Tipo de datos de la variable; puede ser Byte, Boolean, Integer, Long, Currency, Single, Double, Decimal (actualmente no admitida), Date, String (para cadenas de longitud variable), String * length (para cadenas de longitud fija), Object, Variant, un tipo definido por el usuario, o un tipo de objeto. Utilice una cláusula distinta As tipo para cada variable que defina.

Comentarios

Las variables declaradas con Dim en el nivel de módulo están disponibles para todos los procedimientos disponibles sólo dentro de ese módulo. En el nivel de procedimiento, las variables sólo están disponibles dentro de ese procedimiento.

Utilice la instrucción Dim en el nivel de módulo o de procedimiento para declarar el tipo de datos de una variable. Por ejemplo, la siguiente instrucción declara una variable como Integer.

Dim NúmeroDeEmpleados As Integer

También puede utilizar una instrucción Dim para declarar el tipo de objeto de una variable. La siguiente línea declara una variable para una nueva instancia de una hoja de cálculo.

Dim X As New Worksheet

Si no utiliza la palabra clave New al declarar una variable de objeto, la variable que se refiere al objeto debe asignarse a un objeto existente mediante la instrucción Set antes de su uso. Hasta que se le asigne un objeto, la variable de objeto declarada tiene el valor especial Nothing, el cual indica que no se refiere a ninguna instancia en particular de un objeto.

También puede utilizar la instrucción Dim con paréntesis vacíos para declarar matrices dinámicas. Después de declarar una matriz dinámica, use la instrucción ReDim dentro de un procedimiento para definir el número de dimensiones y elementos de la matriz. Si intenta volver a declarar una dimensión para una variable de matriz cuyo tamaño se ha especificado explícitamente en una instrucción Private, Public o Dim, ocurrirá un error.

Si no especifica un tipo de datos o un tipo de objeto y no existe ninguna instrucción Deftipo en el módulo, la variable predeterminada será Variant.

Cuando se inicializan variables, una variable numérica se inicializa con 0, una cadena de longitud variable se inicializa con una cadena de longitud 0 ("") y una cadena de longitud fija se llena con ceros. Las variables Variant se inicializan con Empty. Cada elemento de una variable de un tipo definido por el usuario se inicializa como si fuera una variable distinta.

Nota   Cuando utiliza la instrucción Dim en un procedimiento, generalmente pone la instrucción Dim al principio del mismo.