Écriture d’une procédure de propriété

  • Article

Une procédure de propriété est une série d’instructions Visual Basic qui permettent à un programmeur de créer et de manipuler des propriétés personnalisées.

  • Vous pouvez utiliser des procédures Property pour créer des propriétés en lecture seule pour des formulaires, des modules standard et des modules de classe.

  • Vous devez utiliser des procédures Property au lieu des variables Public dans du code qui doit être exécuté lorsque la valeur de la propriété est définie.

  • Contrairement aux variables Publiques , des chaînes d’aide peuvent être affectées aux procédures de propriété dans l’Explorateur d’objets.

Lorsque vous créez une procédure de propriété, elle devient une propriété du module contenant la procédure. Visual Basic fournit les trois types de procédures de propriété suivants.

Procedure Description
Property Let Procédure qui définit la valeur d'une propriété.
Property Get Procédure qui renvoie la valeur d'une propriété.
Property Set Procédure qui définit une référence à un objet.

La syntaxe de déclaration d’une procédure de propriété est la suivante.

[ Public | Privé ] [ Statique ] Property { Get | Let | Set } propertyname [( arguments )] [ Astype ] instructionsEnd Property

Les procédures de propriété sont généralement utilisées dans des paires : Property Let avec Property Get et Property Set avec Property Get. La déclaration d'une procédure Property Get seule revient à la déclaration d'une propriété en lecture seule. L’utilisation des trois types de procédure de propriété n’est utile que pour les variables Variant , car seul un variant peut contenir un objet ou d’autres informations de type de données. La procédure Property Set doit être utilisée avec des objets, ce qui n'est pas le cas de la procédure Property Let.

Les arguments requis dans les déclarations de procédure de propriété sont présentés dans le tableau suivant.

Procedure Syntaxe de déclaration
Property Get Propriété Getpropname (1, ..., n) Astype
Property Let Propriété Letpropname (1, ...,,,, n, n +1)
Property Set Property Setpropname (1, ..., n, n +1)

Le premier argument à l’avant-dernier argument (1, ..., n) doit partager les mêmes noms et types de données dans toutes les procédures de propriété portant le même nom.

Une déclaration de procédure Property Get prend un argument de moins que les déclarations Property Let et Property Set associées. Le type de données de la procédure Property Get doit être identique au type de données du dernier argument (n +1) dans les déclarations Property Let et Property Set associées . Par exemple, si vous déclarez la procédure Property Let suivante, la déclaration Property Get doit utiliser des arguments dont le nom et le type de données sont identiques à ceux des arguments de la procédure 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

Le type de données de l'argument final d'une déclaration Property Set doit être un type d'objet ou une variante.

Voir aussi

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.