DTBLCOMBOBOX

Gilt für: Outlook 2013 | Outlook 2016

Beschreibt ein Kombinationsfeld-Steuerelement, das in einem Dialogfeld verwendet wird, das aus einer Anzeigetabelle erstellt wurde.

Eigenschaft	Wert
Headerdatei	Mapidefs.h
Verwandtes Makro: SizedDtblComboBox

typedef struct _DTBLCOMBOBOX
{
  ULONG ulbLpszCharsAllowed;
  ULONG ulFlags;
  ULONG ulNumCharsAllowed;
  ULONG ulPRPropertyName;
  ULONG ulPRTableName;
} DTBLCOMBOBOX, FAR *LPDTBLCOMBOBOX;

Members

ulbLpszCharsAllowed

Ein Offset vom Anfang der DTBLCOMBOBOX-Struktur zu einem Zeichenfolgenfilter, der ggf. Einschränkungen für die Zeichen beschreibt, die in das Bearbeitungssteuerelement des Kombinationsfelds eingegeben werden können. Der Filter wird nicht als regulärer Ausdruck interpretiert, und derselbe Filter wird auf jedes eingegebene Zeichen angewendet. Das Format des Filters lautet wie folgt:

Zeichen	Beschreibung
*	Jedes Zeichen ist zulässig (z. B "*". ).
[ ]	Definiert einen Satz von Zeichen (z. B "[0123456789]". ).
-	Gibt einen Zeichenbereich an (z. B "[a-z]". ).
~	Gibt an, dass diese Zeichen nicht zulässig sind. (zum Beispiel "[~0-9]").
\	Wird verwendet, um eines der vorherigen Symbole anzurufen (z. B. bedeutet, "[\-\\\[\]]" dass -, , Zeichen [und ] zulässig sind).

ulFlags

Bitmaske von Flags, die zum Festlegen des Formats des Zeichenfolgenfilters verwendet werden. Das folgende Flag kann festgelegt werden:

MAPI_UNICODE

Der Filter weist das Unicode-Format auf. Wenn das MAPI_UNICODE-Flag nicht festgelegt ist, hat der Filter das ANSI-Format.

ulNumCharsAllowed

Maximale Anzahl von Zeichen, die in das Textfeld des Kombinationsfelds eingegeben werden können.

ulPRPropertyName

Eigenschaftstag für eine Eigenschaft vom Typ PT_TSTRING.

ulPRTableName

Eigenschaftstag für eine Eigenschaft vom Typ PT_OBJECT, für die eine IMAPITable-Schnittstelle mithilfe eines OpenProperty-Aufrufs geöffnet werden kann. Die Tabelle muss eine Spalte mit einer Eigenschaft aufweisen, die denselben Typ wie die eigenschaft aufweist, die vom ulPRPropertyName-Element identifiziert wird. Die Zeilen der Tabelle werden verwendet, um die Liste aufzufüllen.

Hinweise

Eine DTBLCOMBOBOX-Struktur beschreibt ein Kombinationsfeld eines Steuerelements, das aus einer Liste und einem Auswahlfeld besteht. Die Liste enthält die Informationen, aus denen ein Benutzer auswählen kann, und das Auswahlfeld zeigt die aktuelle Auswahl an. Das Auswahlfeld ist ein Bearbeitungssteuerelement, das auch zum Eingeben von Text verwendet werden kann, der nicht bereits in der Liste enthalten ist.

Die beiden Eigenschaftentagmember arbeiten zusammen, um die Listenanzeige mit dem Bearbeitungssteuerelement zu koordinieren. Wenn MAPI das Kombinationsfeld zum ersten Mal anzeigt, ruft sie die OpenProperty-Methode der IMAPIProp-Implementierung auf, die der Anzeigetabelle zugeordnet ist, um die tabelle abzurufen, die durch den ulPRTableName-Member dargestellt wird. Diese Tabelle enthält eine Spalte, die Werte für die Eigenschaft enthält, die durch das ulPRPropertyName-Element dargestellt wird. Daher muss diese Spalte denselben Typ wie die ulPRPropertyName-Eigenschaft aufweisen, und beide Spalten müssen Zeichenfolgen sein.

Die Werte für die Spalte werden im Listenabschnitt des Kombinationsfelds angezeigt. Daher ist PR_NULL (PidTagNull) kein gültiges Eigenschaftstag für ulPRPropertyName. Wenn ein Benutzer entweder eine der Zeilen auswählt oder neue Daten in das Textfeld eingibt, wird die ulPRPropertyName-Eigenschaft auf den ausgewählten oder eingegebenen Wert festgelegt.

Um einen Anfangswert für das Bearbeitungssteuerelement anzuzeigen, ruft MAPI IMAPIProp::GetProps auf, um die Eigenschaftswerte für die Anzeigetabelle abzurufen. Wenn eine der abgerufenen Eigenschaften mit der Eigenschaft übereinstimmt, die durch den ulPRPropertyName-Member dargestellt wird, wird ihr Wert zum Anfangswert.

Eine Übersicht über Anzeigetabellen finden Sie unter Anzeigen von Tabellen. Informationen zum Implementieren einer Anzeigetabelle finden Sie unter Implementieren einer Anzeigetabelle.

Siehe auch

DTCTL
MapI-Strukturender kanonischen PidTagControlType-Eigenschaft