PidTagControlFlags (kanonische Eigenschaft)

Artikel
04/04/2023

Gilt für: Outlook 2013 | Outlook 2016

Enthält eine Bitmaske von Flags, die das Verhalten eines Steuerelements steuern, das in einem Dialogfeld verwendet wird, das aus einer Anzeigetabelle erstellt wurde.

Eigenschaft	Wert
Zugeordnete Eigenschaften:	PR_CONTROL_FLAGS
Kennung:	0x3F00
Datentyp:	PT_LONG
Bereich:	MAPI-Anzeigetabelle

Hinweise

Mindestens eines der folgenden Flags kann für diese Eigenschaft festgelegt werden:

DT_ACCEPT_DBCS

Das Steuerelement kann Double-Byte Zeichensatzzeichen (DBCS) enthalten. Dieses Flag wird mit Bearbeitungssteuerelementen verwendet. Sie ermöglicht Mehrere-Byte-Zeichensätze.

DT_EDITABLE

Das Steuerelement kann bearbeitet werden. Der dem Steuerelement zugeordnete Wert kann geändert werden. Wenn dieses Flag nicht festgelegt ist, ist das Steuerelement schreibgeschützt. Dieser Wert wird bei Bezeichnungen, Gruppenfeldern, Standard-Drucktasten, mehrwertigen Dropdownlistenfeldern und Listenfeldern ignoriert.

DT_MULTILINE

Das Bearbeitungssteuerelement kann mehrere Zeilen enthalten. Dies bedeutet, dass ein Rückgabezeichen innerhalb des Steuerelements eingegeben werden kann. Dieses Flag ist nur für Bearbeitungssteuerelemente gültig.

DT_PASSWORD_EDIT

Gilt für Bearbeitungssteuerelemente. Das Bearbeitungssteuerelement wird wie ein Kennwort behandelt. Der Wert wird mit Sternchen anstelle der tatsächlich eingegebenen Zeichen angezeigt.

DT_REQUIRED

Wenn das Steuerelement Änderungen zulässt (DT_EDITABLE), muss es über einen Wert verfügen, bevor IMAPIProp::SaveChanges aufgerufen wird.

DT_SET_IMMEDIATE

Ermöglicht das sofortige Festlegen eines Werts; Sobald sich ein Wert im Steuerelement ändert, ruft MAPI die SetProps-Methode für die diesem Steuerelement zugeordnete Eigenschaft auf. Wenn dieses Flag nicht festgelegt ist, werden die Werte festgelegt, wenn das Dialogfeld geschlossen wird.

DT_SET_SELECTION

Wenn eine Auswahl innerhalb des Listenfelds erfolgt, wird die Indexspalte dieses Listenfelds als -Eigenschaft festgelegt. Wird immer mit DT_SET_IMMEDIATE verwendet.

Diese Eigenschaft wird im ulCtlFlags-Member der DTCTL-Struktur eines Steuerelements gespeichert. Die meisten Steuerelementflags gelten für alle Steuerelemente, die Benutzereingaben zulassen. einige gelten nur für das Bearbeitungssteuerelement. Steuerelemente, die keine Benutzereingaben zulassen, z. B. eine Schaltfläche oder eine Bezeichnung, legen 0 für ihre Steuerelementflags fest.

Viele der Flagwerte sind selbsterklärend. Wenn beispielsweise DT_REQUIRED für ein Steuerelement festgelegt ist, muss es einen Wert enthalten, bevor das Dialogfeld geschlossen werden darf. Entweder kann der Dienstanbieter einen Wert über seine IMAPIProp-Implementierung angeben, oder der Benutzer kann einen eingeben. DT_EDITABLE gibt an, dass der Wert für das Steuerelement geändert werden kann. DT_MULTILINE kann der Wert für ein Bearbeitungssteuerelement mehrere Zeilen umfassen.

Einige Steuerelementflags sind in ihrer Bedeutung nicht so offensichtlich. Wenn ein Steuerelement das DT_SET_IMMEDIATE-Flag festlegt, werden alle Änderungen an seinem Wert wirksam, sobald der Benutzer zu einem neuen Steuerelement wechselt. MAPI führt einen einzelnen Aufruf der IMAPIProp::SetProps-Methode der Eigenschaftenschnittstelle für die -Eigenschaft des Steuerelements durch. Dies unterscheidet sich vom Standardverhalten, bei dem Änderungen an Steuerelementwerten erst wirksam werden, wenn der Benutzer die Schaltfläche OK ausgewählt oder das Dialogfeld geschlossen hat. Das DT_SET_IMMEDIATE-Flag wird häufig in Kombination mit Anzeigetabellenbenachrichtigungen verwendet.

In der folgenden Tabelle sind die Typen von Steuerelementen und alle Flagwerte aufgeführt, die für jeden Typ festgelegt werden können.

Control	Gültige Werte für diese Eigenschaft
Schaltfläche	Muss 0 (null) sein
Kontrollkästchen	DT_EDITABLE, DT_SET_IMMEDIATE
Kombinationsfeld	DT_EDITABLE, DT_REQUIRED, DT_SET_IMMEDIATE
Dropdownlistenfeld	DT_EDITABLE, DT_SET_IMMEDIATE
Bearbeiten	DT_ACCEPT_DBCS, DT_MULTILINE, DT_EDITABLE, DT_PASSWORD_EDIT, DT_REQUIRED, DT_SET_IMMEDIATE
Gruppenfeld	Muss 0 (null) sein
Label	Muss 0 (null) sein
Listenfeld	Muss 0 (null) sein
Mehrwertiges Dropdownlistenfeld	Muss 0 (null) sein
Mehrwertiges Listenfeld	Muss 0 (null) sein
Seite im Registerkartenformat	Muss 0 (null) sein
Optionsfeld	Muss 0 (null) sein