Escrever um procedimento de propriedade

  • Artigo

Um procedimento de propriedade é uma série de instruções do Visual Basic que permitem que um programador crie e manipule propriedades personalizadas.

  • Os procedimentos de propriedade podem ser usados para criar propriedades somente leitura para formulários, módulos padrão e módulos de classe.

  • Os procedimentos de propriedade devem ser usados em vez de variáveis públicas no código que devem ser executadas quando o valor da propriedade é definido.

  • Ao contrário das variáveis públicas , os procedimentos de propriedade podem ter cadeias de caracteres de ajuda atribuídas a elas no Navegador de Objetos.

Quando você cria um procedimento de propriedade, ele se torna uma propriedade do módulo que contém o procedimento. O Visual Basic fornece os três tipos de procedimentos de propriedade a seguir.

Procedimento Descrição
Property Let Um procedimento que define o valor de uma propriedade.
Property Get Um procedimento que retorna o valor de uma propriedade.
Property Set Um procedimento que define uma referência a um objeto.

A sintaxe para declarar um procedimento de propriedade é a seguinte.

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

Os procedimentos de propriedade geralmente são usados em pares: Property Let with Property Get e Property Set with Property Get. Declarar um procedimento de Obtenção de Propriedade sozinho é como declarar uma propriedade somente leitura. Usar todos os três tipos de procedimento de propriedade juntos só é útil para variáveis Variant , pois apenas uma Variant pode conter um objeto ou outras informações de tipo de dados. O Conjunto de Propriedades destina-se a ser usado com objetos; Propriedade Let não é.

Os argumentos necessários em declarações de procedimento de propriedade são mostrados na tabela a seguir.

Procedimento Sintaxe de declaração
Property Get Propriedade Obterpropname (1, ..., n) Comotipo
Property Let Propriedade Letpropname (1, ...,,,, n, n +1)
Property Set Propnamedo Conjunto de Propriedades (1, ..., n, n +1)

O primeiro argumento por meio do último argumento (1, ..., n) deve compartilhar os mesmos nomes e tipos de dados em todos os procedimentos de propriedade com o mesmo nome.

Uma declaração de procedimento de Obtenção de Propriedade usa um argumento a menos do que as declarações de Conjunto de Propriedades e Desativação de Propriedades relacionadas. O tipo de dados do procedimento Property Get deve ser o mesmo que o tipo de dados do último argumento (n +1) nas declarações de Let e Property Set relacionadas. Por exemplo, se você declarar o seguinte procedimento Property Let , a declaração Property Get deverá usar argumentos com o mesmo nome e tipo de dados que os argumentos no procedimento 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

O tipo de dados do argumento final em uma declaração do Conjunto de Propriedades deve ser um tipo de objeto ou uma Variant.

Confira também

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.