PidTagControlFlags (kanonische Eigenschaft)
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 |
Verwandte Ressourcen
Headerdateien
Mapidefs.h
Stellt Datentypdefinitionen bereit.
Mapitags.h
Enthält Definitionen von Eigenschaften, die als alternative Namen aufgeführt sind.
Siehe auch
MAPI (kanonische Eigenschaften)