UserProperties.Add-Methode (Outlook)
Erstellt eine neue Benutzereigenschaft in der UserProperties-Auflistung .
Syntax
Ausdruck. Add (Name, Type, AddToFolderFields, DisplayFormat)
Ausdruck Eine Variable, die ein UserProperties-Objekt darstellt.
Parameter
| Name | Erforderlich/Optional | Datentyp | Beschreibung |
|---|---|---|---|
| Name | Erforderlich | String | Der Name der Eigenschaft. Die Höchstlänge beträgt 64 Zeichen. Die Zeichen , ' [', ']', '_' und '#', sind im Namen nicht zulässig. |
| Typ | Erforderlich | OlUserPropertyType | Der Typ der neuen Eigenschaft. |
| AddToFolderFields | Optional | Boolean | True, wenn die Eigenschaft dem Ordner, in dem sich das Element befindet, als benutzerdefiniertes Feld hinzugefügt werden soll. Dieses Feld kann in der Ordneransicht angezeigt werden. False, wenn die Eigenschaft als benutzerdefiniertes Feld zum Element hinzugefügt wird, jedoch nicht zum Ordner. Der Standardwert ist True. |
| DisplayFormat | Optional | Long | Gibt an, wie die Eigenschaft auf der Outlook-Benutzeroberfläche angezeigt wird. Dieser Parameter kann auf einen Wert aus einer mehrere verschiedene Enumerationen, anhand der in der Type -Parameter angegebenen OlUserPropertyType -Konstante festgelegt werden. Weitere Informationen dazu, wie Typ und DisplayFormat interagieren, finden Sie unter DisplayFormat-Eigenschaft. |
Rückgabewert
Ein UserProperty-Objekt , das die neue Eigenschaft darstellt.
Hinweise
Sie können benutzerdefinierte Eigenschaften definieren, indem Sie entweder die UserProperties.Add-Methode für ein Outlook-Element oder einen Outlook-Ordner oder die UserDefinedProperties.Add-Methode für einen Ordner aufrufen.
Sie können eine Eigenschaft eines Typs, der durch die OlUserPropertyType -Aufzählung, außer für die folgenden Typen definierten erstellen: olEnumeration, olOutlookInternalund olSmartFrom.
Um zum ersten Mal eine Eigenschaft festzulegen, die von der UserProperties.Add-Methode erstellt wurde, verwenden Sie die UserProperty.Value-Eigenschaft anstelle der SetProperties - und SetProperty-Methoden des PropertyAccessor-Objekts .
Wenn Sie eine benutzerdefinierte Eigenschaft eines Elements anzeigen möchten, müssen Sie diese Eigenschaft mithilfe der UserProperties.Add-Methode erstellen. Von PropertyAccessor erstellte benutzerdefinierte Eigenschaften werden in einer benutzerdefinierten Ansicht nicht unterstützt.
Sie können Office-Dokumentelementen wie Word-, Excel- oder PowerPoint-Dateien keine benutzerdefinierten Eigenschaften hinzufügen. Sie erhalten eine Fehlermeldung, wenn Sie versuchen, einem DocumentItem-Objekt programmgesteuert ein benutzerdefiniertes Feld hinzuzufügen.
Beispiel
In diesem VBA-Beispiel wird ein neues ContactItem-Objekt erstellt und "LastDateSpokenWith" als benutzerdefinierte Eigenschaft hinzugefügt.
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
In diesem VBA-Beispiel wird ein neues ContactItem-Objekt erstellt und „Details“ als Benutzereigenschaft hinzugefügt. Der Wert wird durch das Ändern der Eigenschaft Wert des UserProperty-Objekts festgelegt.
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
Siehe auch
Support und Feedback
Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.