UserProperties.Add, méthode (Outlook)

Article
04/07/2023

Crée une propriété utilisateur dans la collection UserProperties .

Syntaxe

expression. Add (Name, Type, AddToFolderFields, DisplayFormat)

Expression Variable qui représente un objet UserProperties .

Parameters

Nom	Requis/Facultatif	Type de données	Description
Name	Obligatoire	String	Nom de la propriété. La longueur maximale est de 64 caractères. Les caractères « [ », « ] », « _ » et « # » ne sont pas autorisés dans le nom.
Type	Requis	OlUserPropertyType	Type de la nouvelle propriété.
AddToFolderFields	Facultatif	Boolean	True si la propriété est ajoutée en tant que champ personnalisé au dossier dans lequel se trouve l’élément. Ce champ peut être affiché dans l’affichage du dossier. False si la propriété est ajoutée en tant que champ personnalisé à l’élément, mais pas au dossier. La valeur par défaut est True.
DisplayFormat	Facultatif	Long	Spécifie le mode d’affichage de la propriété dans l’interface utilisateur Outlook. Vous pouvez définir ce paramètre sur une valeur comprise entre une et plusieurs énumérations différentes, déterminées par la constante OlUserPropertyType spécifiée dans le paramètre Type. Pour plus d’informations sur l’interaction entre Type et FormatAffichage, voir DisplayFormat, propriété.

Valeur renvoyée

Objet UserProperty qui représente la nouvelle propriété.

Remarques

Vous pouvez définir des propriétés personnalisées en appelant la méthode UserProperties.Add pour un élément ou un dossier Outlook, ou la méthode UserDefinedProperties.Add pour un dossier.

Vous pouvez créer une propriété d’un type défini par l’énumération OlUserPropertyType , à l’exception des types suivants : olEnumeration, olOutlookInternal et olSmartFrom.

Pour définir pour la première fois une propriété créée par la méthode UserProperties.Add , utilisez la propriété UserProperty.Value au lieu des méthodes SetProperties et SetProperty de l’objet PropertyAccessor .

Si vous souhaitez afficher une propriété personnalisée dans un élément, vous devez utiliser la méthode UserProperties.Add pour créer cette propriété. Les propriétés personnalisées créées par PropertyAccessor ne sont pas prises en charge dans une vue personnalisée.

Vous ne pouvez pas ajouter de propriétés personnalisées dans des éléments de document Microsoft Office comme Word, Excel ou PowerPoint. Vous recevez une erreur lorsque vous essayez d’ajouter par programmation un champ défini par l’utilisateur à un objet DocumentItem .

Exemple

Cet exemple VBA crée un objet ContactItem et ajoute « LastDateSpokenWith » en tant que propriété personnalisée.

Sub AddUserProperty() 
 Dim myItem As Outlook.ContactItem 
 Dim myUserProperty As Outlook.UserProperty 
 
 Set myItem = Application.CreateItem(olContactItem) 
 Set myUserProperty = myItem.UserProperties _ 
 .Add("LastDateSpokenWith", olDateTime) 
 myItem.Display 
End Sub

Cet exemple VBA montre comment créer un objet ContactItem et ajouter « Details » comme propriété utilisateur. La valeur est définie en modifiant la propriété Value de l’objet UserProperty .

Sub AddUserProperty() 
 Dim myItem As Outlook.ContactItem 
 Dim myUserProperty As Outlook.UserProperty 
 
 Set myItem = Application.CreateItem(olContactItem) 
 Set myUserProperty = myItem.UserProperties _ 
 .Add("Details", olText) 
 myUserProperty.Value = "Neighbor" 
 myItem.Display 
End Sub

Voir aussi

UserProperties, objet

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.

Share via