DTBLDDLBX
Gilt für: Outlook 2013 | Outlook 2016
Beschreibt ein Dropdownlisten-Steuerelement, das in einem Dialogfeld verwendet wird, das aus einer Anzeigetabelle erstellt wurde.
| Eigenschaft | Wert |
|---|---|
| Headerdatei |
Mapidefs.h |
typedef struct _DTBLDDLBX
{
ULONG ulFlags;
ULONG ulPRDisplayProperty;
ULONG ulPRSetProperty;
ULONG ulPRTableName;
} DTBLDDLBX, FAR *LPDTBLDDLBX;
Members
ulFlags
Reserviert, muss null sein.
ulPRDisplayProperty
Eigenschaftstag für eine Eigenschaft vom Typ PT_TSTRING. Diese Eigenschaft ist eine der Spalten in der Tabelle, die durch das ulPRTableName-Element identifiziert wird. Die Werte für diese Eigenschaft werden in der Liste angezeigt.
ulPRSetProperty
Eigenschaftstag für eine Eigenschaft eines beliebigen Typs. Diese Eigenschaft ist eine der Spalten in der Tabelle, die durch das ulPRTableName-Element identifiziert wird. Wenn der Benutzer der Liste einen Eigenschaftswert für das ulPRDisplayProperty-Element aus den Zeilen der Tabelle auswählt, die durch das ulPRTableName-Element identifiziert werden, wird das entsprechende ulPRSetProperty-Element festgelegt.
ulPRTableName
Eigenschaftstag für eine Tabelleneigenschaft vom Typ PT_OBJECT, die mithilfe eines OpenProperty-Aufrufs geöffnet werden kann. Die Tabelle sollte zwei Spalten aufweisen: ulPRDisplayProperty und ulPRSetProperty. Die Zeilen der Tabelle sollten elementen in der Liste entsprechen.
Hinweise
Eine DTBLDDLBX-Struktur beschreibt ein Dropdownlistensteuerelement, das als einzelnes Element angezeigt wird, bis der Benutzer es erweitert.
Die drei von den Eigenschaftentags identifizierten Eigenschaften arbeiten zusammen, um die Informationen in der Liste anzuzeigen und eine zugehörige Eigenschaft festzulegen. Das ulPRTableName-Element ist ein Tabellenobjekt, auf das über einen Aufruf von IMAPIProp::OpenProperty zugegriffen wird. Die Tabelle enthält zwei Spalten: eine Spalte für die durch den ulPRDisplayProperty-Member identifizierte Eigenschaft und die andere spaltet sich für die eigenschaft, die durch den ulPRSetProperty-Member identifiziert wird.
Die ulPRDisplayProperty-Eigenschaft steuert die Listenanzeige. Wenn ein Benutzer einen der Werte aus der Anzeige auswählt, ruft MAPI IMAPIProp::SetProps auf, um die entsprechende Eigenschaft so festzulegen, wie sie vom ulPRSetProperty-Member identifiziert wird. Dies bedeutet, dass sich die -Eigenschaft in derselben Zeile wie die ausgewählte Anzeigeeigenschaft befindet. Der member ulPRSetProperty kann nicht auf PR_NULL (PidTagNull) festgelegt werden.
Ein Anfangswert wird in der Liste angezeigt, wenn MAPI die durch den ulPRSetProperty-Member dargestellte Eigenschaft durch einen Aufruf von IMAPIProp::GetProps abgerufen und eine Zeile in der Tabelle mit dem Wert für den ulPRSetProperty-Member gefunden hat. Der anfänglich angezeigte Wert ist der Inhalt der ulPRDisplayProperty-Spalte aus dieser Zeile, die mit der -Eigenschaft im ulPRDisplayProperty-Element der -Struktur übereinstimmt. Der von GetProps zurückgegebene Wert für die vom ulPRDisplayProperty-Member identifizierte Eigenschaft wird zum Anfangswert, der angezeigt wird, wenn die Liste zum ersten Mal angezeigt wird.
Eine Übersicht über Anzeigetabellen finden Sie unter Anzeigen von Tabellen. Informationen zum Implementieren einer Anzeigetabelle finden Sie unter Implementieren einer Anzeigetabelle. Informationen zu Eigenschaftentypen finden Sie unter Übersicht über MAPI-Eigenschaftentypen.