Public (Instrucción)

       

Se usa en el nivel de módulo para declarar variables públicas y asignarles espacio para almacenamiento.

Sintaxis

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

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

Parte	Descripción
WithEvents	Opcional. La palabra clave especifica que varname es una variable de objeto utilizada para responder a los eventos desencadenados por un objeto ActiveX. WithEvents es válido solamente 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 nombres de variable.
Subíndices	Opcional. Dimensiones de una variable de matriz; se pueden declarar hasta 60 dimensiones múltiples. El argumento subíndices usa la sintaxis siguiente: [inferior To] superior [,[inferior To] superior] . . . Cuando no se declara explícitamente en inferior, el límite inferior de una matriz se controla mediante la instrucción Option Base. El límite inferior es cero si no hay ninguna instrucción Option Base.
New	Opcional. Palabra clave que permite 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 de objeto. La palabra clave New no se puede utilizar para declarar variables de cualquier tipo de datos intrínseco, no se puede utilizar para declarar instancias de objetos dependientes y no se puede utilizar con WithEvents.
tipo	Opcional. Tipo de datos de la variable; puede ser Byte, Boolean, Integer, Long, Currency, Single, Double, Decimal (no admitida actualmente), 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. Use una cláusula As tipo distinta para cada variable que se defina.

Comentarios

Las variables declaradas mediante la instrucción Public están disponibles para todos los procedimientos en todos los módulos de todas las aplicaciones, a menos que Option Private Module esté en efecto; en este caso, las variables sólo son públicas dentro del proyecto en el que residen.

Precaución   La instrucción Public no se puede usar en un módulo de clase para declarar una variable de cadena de longitud fija.

Use la instrucción Public para declarar el tipo de datos de una variable. Por ejemplo, la instrucción siguiente declara una variable como de tipo Integer:

Public NúmeroDeEmpleados As Integer

Utilice también la instrucción Public para declarar el tipo de objeto de una variable. La instrucción siguiente declara una variable para una nueva instancia de una hoja de cálculo.

Public X As New Worksheet

Si no utiliza la palabra clave New al declarar una variable de objeto, la variable que se refiere a un objeto debe asignarse a un objeto existente mediante la instrucción Set antes de que se pueda usar. 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 una instrucción Public 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 un dimensión para una 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 una instrucción Deftipo en el módulo, la variable es Variant de manera predeterminada.

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