UserProperties.Add, méthode (Outlook)
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
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.