Escribir un procedimiento de propiedad

  • Artículo

Un procedimiento de propiedad es una serie de instrucciones de Visual Basic que permiten a un programador crear y manipular propiedades personalizadas.

  • Los procedimientos de Property se pueden usar para crear propiedades de solo lectura para formularios, módulos estándar y módulos de clase.

  • Los procedimientos de Property se deben usar en lugar de las variables Public en código que se debe ejecutar cuando se establece el valor de la propiedad.

  • A diferencia de las variables públicas , los procedimientos de propiedad pueden tener cadenas de Ayuda asignadas en el Explorador de objetos.

Al crear un procedimiento de propiedad, se convierte en una propiedad del módulo que contiene el procedimiento. Visual Basic proporciona los tres tipos siguientes de procedimientos de propiedad.

Procedure Descripción
Propiedad Let Procedimiento que establece el valor de una propiedad.
Propiedad Get Procedimiento que devuelve el valor de una propiedad.
Propiedad Set Procedimiento que establece una referencia a un objeto.

La sintaxis para declarar un procedimiento de propiedad es la siguiente.

[ Público | Privado ] [ Estático ] Propiedad { Get | Let | Set } propertyname [( arguments )] [ Astype ] statementsEnd Property

Los procedimientos de propiedad se suelen usar en pares: Property Let con Property Get y Property Set con Property Get. La declaración de un procedimiento Property Get solo es como declarar una propiedad de solo lectura. El uso conjunto de los tres tipos de procedimiento de propiedad solo es útil para las variables Variant , ya que solo un variant puede contener un objeto u otra información de tipo de datos. Property Set está pensado para usarlo con objetos, no así Property Let.

Los argumentos necesarios en las declaraciones de procedimiento de propiedad se muestran en la tabla siguiente.

Procedure Sintaxis de declaración
Propiedad Get Propiedad Getpropname (1, ..., n) Comotipo
Propiedad Let Propiedad Letpropname (1, ...,,,, n, n +1)
Propiedad Set Propiedad Setpropname (1, ..., n, n +1)

El primer argumento del siguiente al último argumento (1, ..., n) debe compartir los mismos nombres y tipos de datos en todos los procedimientos de propiedad con el mismo nombre.

Una declaración de procedimiento Property Get toma un argumento menos que las declaraciones Property Let y Property Set relacionadas. El tipo de datos del procedimiento Property Get debe ser el mismo que el tipo de datos del último argumento (n +1) en las declaraciones Property Let y Property Set relacionadas. Por ejemplo, si declara el siguiente procedimiento Property Let, la declaración Property Get debe usar argumentos con el mismo nombre y tipo de datos que los argumentos del procedimiento Property Let.

Property Let Names(intX As Integer, intY As Integer, varZ As Variant) 
 ' Statement here. 
End Property 
 
Property Get Names(intX As Integer, intY As Integer) As Variant 
 ' Statement here. 
End Property

El tipo de datos del argumento final de una declaración Property Set debe ser un tipo de objeto o una Variant.

Vea también

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.