DTBLLBX
Gilt für: Outlook 2013 | Outlook 2016
Beschreibt eine Liste, die in einem Dialogfeld verwendet wird, das aus einer Anzeigetabelle erstellt wird.
| Eigenschaft | Wert |
|---|---|
| Headerdatei |
Mapidefs.h |
typedef struct _DTBLLBX
{
ULONG ulFlags;
ULONG ulPRSetProperty;
ULONG ulPRTableName;
} DTBLLBX, FAR *LPDTBLLBX
Members
ulFlags
Bitmaske von Flags, die verwendet werden, um eine horizontale oder vertikale Bildlaufleiste aus der Liste zu entfernen. Die folgenden Flags können festgelegt werden:
MAPI_NO_HBAR
Es sollte keine horizontale Bildlaufleiste mit der Liste angezeigt werden.
MAPI_NO_VBAR
Es sollte keine vertikale Bildlaufleiste mit der Liste angezeigt werden.
ulPRSetProperty
Eigenschaftstag für eine Eigenschaft eines beliebigen Typs. Diese Eigenschaft ist eine der Spalten in der Tabelle, die durch das ulPRTableTable-Element identifiziert wird.
ulPRTableName
Eigenschaftstag für eine Tabelleneigenschaft vom Typ PT_OBJECT, die mithilfe eines OpenProperty-Aufrufs geöffnet werden kann. Die Anzahl der Spalten, die die Tabelle enthalten sollte, hängt davon ab, ob es sich bei der Liste um eine Einzel- oder eine Mehrfachauswahlliste handelt. Wenn das ulPRSetProperty-Element auf PR_NULL (PidTagNull) festgelegt ist, ermöglicht die Liste die Mehrfachauswahl.
Hinweise
Eine DTBLLBX-Struktur beschreibt eine Liste eines Steuerelements, das verwendet wird, um mehrere Elemente anzuzeigen und einem Benutzer die Auswahl eines oder mehrerer Elemente zu ermöglichen.
Das element ulPRSetProperty und das ulPRTableName-Element arbeiten zusammen. Wenn ein Wert aus der Tabelle ausgewählt wird, wird er zurück in ulPRSetProperty geschrieben, wenn das Dialogfeld geschlossen wird.
Der Flags-Wert gibt an, ob eine horizontale oder vertikale Bildlaufleiste mit der Liste angezeigt werden soll. Standardmäßig werden Bei Bedarf Arten von Bildlaufleisten angezeigt. Dienstanbieter können MAPI_NO_HBAR festlegen, um eine horizontale Bildlaufleiste zu unterdrücken, und MAPI_NO_VBAR, um eine vertikale Bildlaufleiste zu unterdrücken.
Die beiden Eigenschaftentagelemente arbeiten zusammen, um Werte in der Liste anzuzeigen und die entsprechenden Eigenschaften festzulegen, wenn ein Element in der Liste ausgewählt wird. Wenn MAPI die Liste zum ersten Mal anzeigt, ruft sie die OpenProperty-Methode der IMAPIProp-Implementierung auf, um die im ulPRTableName-Member identifizierte Tabelle abzurufen. Die Anzahl der Spalten in der Tabelle hängt vom Wert des ulPRSetProperty-Elements ab. Wenn ulPRSetProperty auf PR_NULL festgelegt ist, ist die Liste eine Mehrfachauswahlliste, die auf einem Objekt basiert, das Empfänger enthält, z. B. einen Adressbuchcontainer, eine Empfängertabelle für eine Nachricht oder eine Inhaltstabelle der Verteilerliste.
Eine Tabelle für eine Mehrfachauswahlliste muss die folgenden Spalten enthalten:
PR_DISPLAY_NAME (PidTagDisplayName)
PR_ENTRYID (PidTagEntryId)
PR_INSTANCE_KEY (PidTagInstanceKey)
PR_DISPLAY_TYPE (PidTagDisplayType) und maximal fünf weitere mehrwertige Zeichenfolgeneigenschaften können ebenfalls mit den drei erforderlichen Spalten angezeigt werden.
Wenn das element ulPRSetProperty nicht auf PR_NULL festgelegt ist, ist die Liste eine einzelne Auswahlliste. Der Anfangswert von ulPRSetProperty bestimmt die erste ausgewählte Zeile. Wenn ein Benutzer eine der Zeilen auswählt, wird der ulPRSetProperty-Member auf den ausgewählten Wert festgelegt, und dieser Wert wird mit einem Aufruf von IMAPIProp::SetProps in die Implementierung der Eigenschaftenschnittstelle zurückgeschrieben.
Eine Übersicht über Anzeigetabellen finden Sie unter Anzeigen von Tabellen. Informationen zum Implementieren einer Anzeigetabelle finden Sie unter Implementieren einer Anzeigetabelle.