Instrução Property Set
Declara o nome, argumentos e código que formam o corpo de um procedimentode Propriedade, que define uma referência a um objeto.
Sintaxe
[ Público | Privado | Amigo ] [ Estático ] Nome do Conjunto de Propriedades( [arglist ], referência )
[instruções]
[ Propriedade de Saída ]
[instruções]
End Property
A sintaxe da instrução Conjunto de Propriedades tem as seguintes partes:
| Sair | Descrição |
|---|---|
| Opcional | Opcional. Indica que o argumento pode ou não ser fornecido pelo autor da chamada. |
| Public | Opcional. Indica que o procedimento Conjunto de Propriedades está acessível a todos os outros procedimentos em todos os módulos. Se usado em um módulo que contém uma instrução Option Private, o procedimento não está disponível fora do projeto. |
| Private | Opcional. Indica que o procedimento Conjunto de Propriedades está acessível apenas a outros procedimentos no módulo onde é declarado. |
| Amigo | Opcional. Usado somente em um módulo de classe. Indica que o procedimento Conjunto de Propriedades está visível em todo o projeto, mas não é visível para um controlador de uma instância de um objeto. |
| Static | Opcional. Indica que as variáveis locais do procedimento Conjunto de Propriedades são preservadas entre chamadas. O atributo Estático não afeta as variáveis declaradas fora do procedimento Conjunto de Propriedades , mesmo que sejam utilizadas no procedimento. |
| name | Obrigatório. Nome do procedimento Conjunto de Propriedades ; segue as convenções de nomenclatura de variáveis padrão, exceto que o nome pode ser o mesmo que um procedimento Property Get ou Property Let no mesmo módulo. |
| listadeargumentos | Obrigatório. Lista de variáveis que representam argumentos que são transmitidos para o procedimento Conjunto de Propriedades quando é chamado. Vários argumentos são separados por vírgulas. |
| reference | Obrigatório. Variável que contém a referência de objeto utilizada no lado direito da atribuição de referência de objeto. |
| instruções | Opcional. Qualquer grupo de instruções a executar no corpo do procedimento Propriedade . |
O argumento listadeargumentos tem as seguintes sintaxe e partes:
[ Optional ] [ ByVal | ByRef ] [ ParamArray ] varname [()] [ Comotype ] [ =defaultValue ]
| Sair | Descrição |
|---|---|
| Opcional | Opcional. Indica se um argumento não é obrigatório. Se for usado, todos os argumentos subsequentes em arglist também deverão ser opcionais e declarados usando a palavra-chave Optional. Tenha em atenção que não é possível que o lado direito de uma expressãodo Conjunto de Propriedades seja Opcional. |
| ByVal | Opcional. Indica se o argumento será passado por valor. |
| ByRef | Opcional. Indica se o argumento será passado por referência. ByRef é a predefinição no VBA, ao contrário do Visual Basic .NET. |
| ParamArray | Opcional. Utilizado apenas como o último argumento em arglist para indicar que o argumento final é uma matriz Opcional de elementos Variante . A palavra-chave ParamArray permite que você forneça um número aleatório de argumentos. Não pode ser utilizado com ByVal, ByRef ou Opcional. |
| nomedavariável | Obrigatório. Nome da variável que representa o argumento passado; segue as convenções de nomenclatura de variável padrão. |
| tipo | Opcional. Tipo de dados do argumento transmitido ao procedimento; podem ser Byte, Booleano, Número Inteiro, Longo, Conversor de Moedas, Único, Duplo, Decimal (não suportado atualmente), Data, Cadeia (apenas comprimento de variável), Objeto, Variante ou um tipo de objeto específico. Se o parâmetro não for Optional, um tipo definido pelo usuário também poderá ser especificado. |
| valorpadrão | Opcional. Qualquer expressão constante ou constante. Válido somente para parâmetros Optional. Se o tipo for um Objeto, um valor predefinido explícito só pode ser Nada. |
Observação
Cada instrução Conjunto de Propriedades tem de definir, pelo menos, um argumento para o procedimento que define. Esse argumento (ou o último argumento, se existir mais do que um) contém a referência de objeto real para a propriedade quando o procedimento definido pela instrução Conjunto de Propriedades é invocado. É referida como referência na sintaxe anterior. Não pode ser Opcional.
Comentários
Se não for explicitamente especificado através da utilização de Procedimentos de PropriedadePública, Privada ou Amigo, os procedimentos de Propriedade são públicos por predefinição. Se Static não for usado, o valor de variáveis locais não será preservado entre chamadas.
A palavra-chave Friend só pode ser usada em módulos de classe. No entanto, procedimentos Friend podem ser acessados por procedimentos em qualquer módulo de um projeto. Um procedimento Friend não aparece na biblioteca de tipos de sua classe pai, e um procedimento Friend não ser pode associado tardiamente.
Todo código executável deve estar em procedimentos. Não pode definir um procedimento conjunto de propriedades dentro de outro procedimento de Propriedade, Sub ou Função .
A instrução Exit Property provoca uma saída imediata de um procedimento conjunto de propriedades . A execução do programa continua com a instrução a seguir à instrução que chamou o procedimento Conjunto de Propriedades . Qualquer número de instruções Exit Property pode aparecer em qualquer lugar num procedimento conjunto de propriedades .
Tal como um procedimento Get de Função e Propriedade , um procedimento Conjunto de Propriedades é um procedimento separado que pode utilizar argumentos, executar uma série de instruções e alterar o valor dos respetivos argumentos. No entanto, ao contrário de um procedimento Function e Property Get , ambos devolvem um valor, só pode utilizar um procedimento Conjunto de Propriedades no lado esquerdo de uma atribuição de referência de objeto ou instrução Definir .
Exemplo
Este exemplo utiliza a instrução Conjunto de Propriedades para definir um procedimento de propriedade que define uma referência a um objeto.
' The Pen property may be set to different Pen implementations.
Property Set Pen(P As Object)
Set CurrentPen = P ' Assign Pen to object.
End Property
Confira também
- Procedimentos de propriedade de chamadas
- Executar código ao definir propriedades
- Escrever um procedimento de propriedade
- Tipos de dados
- Instruções
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.