DTBLCHECKBOX
Gilt für: Outlook 2013 | Outlook 2016
Enthält Informationen zu einem Kontrollkästchen, das in einem Dialogfeld verwendet wird, das aus einer Anzeigetabelle erstellt wurde.
| Eigenschaft | Wert |
|---|---|
| Headerdatei |
Mapidefs.h |
| Verwandtes Makro: |
SizedDtblCheckBox |
typedef struct _DTBLCHECKBOX
{
ULONG ulbLpszLabel;
ULONG ulFlags;
ULONG ulPRPropertyName;
} DTBLCHECKBOX, FAR *LPDTBLCHECKBOX;
Members
ulbLpszLabel
Position der Zeichenfolge, die mit dem Kontrollkästchen angezeigt wird, im Arbeitsspeicher.
ulFlags
Bitmaske von Flags, die verwendet werden, um das Format der Kontrollkästchenbezeichnung festzulegen. Das folgende Flag kann festgelegt werden:
MAPI_UNICODE
Die Bezeichnung weist das Unicode-Format auf. Wenn das MAPI_UNICODE-Flag nicht festgelegt ist, weist die Bezeichnung das ANSI-Format auf.
ulPRPropertyName
Eigenschaftstag für eine Eigenschaft vom Typ PT_BOOLEAN. Der Wert dieser Eigenschaft wird vom Status des Kontrollkästchens beeinflusst.
Hinweise
Eine DTBLCHECKBOX-Struktur beschreibt ein Kontrollkästchen eines Steuerelements, das einen von zwei Zuständen widerspiegelt: aktiviert (ein Kontrollkästchen) oder deaktiviert (ein leeres Feld).
Das element ulPRPropertyName beschreibt eine boolesche Eigenschaft, deren Wert durch Ändern des Zustands des Kontrollkästchens geändert wird. Wenn das Kontrollkästchen zum ersten Mal angezeigt wird, ruft MAPI die GetProps-Methode der IMAPIProp-Implementierung auf, die der Anzeigetabelle zugeordnet ist, um einen Satz von Standardeigenschaften abzurufen. Wenn eine der Eigenschaften dem Eigenschaftstag in der DTBLCHECKBOX-Struktur zugeordnet ist, wird der Wert für diese Eigenschaft als Anfangswert des Kontrollkästchens angezeigt.
Kontrollkästchen-Steuerelemente können geändert werden. Dies ermöglicht es einem Benutzer, seinen Status zu ändern. Änderbare Kontrollkästchen legen das DT_EDITABLE-Flag im ulCtlFlags-Member der DTCTL-Struktur und in der PR_CONTROL_FLAGS -Eigenschaft (PidTagControlFlags) fest. Wenn ein Kontrollkästchen seinen Zustand ändert, ruft MAPI IMAPIProp::SetProps auf, um die im Eigenschaftentagmember der DTBLCHECKBOX-Struktur identifizierte Eigenschaft auf den neuen Zustand festzulegen.
Beispielsweise kann ein Adressbuchanbieter ein änderbares Kontrollkästchen-Steuerelement in sein Konfigurationsdialogfeld einschließen, um die Einstellung der PR_SEND_RICH_INFO-Eigenschaft (PidTagSendRichInfo) eines Empfängers anzupassen. Wenn der Benutzer das Kontrollkästchen auswählt, legt MAPI diese Eigenschaft auf TRUE fest. Wenn das Kontrollkästchen deaktiviert ist, wird die Eigenschaft auf FALSE festgelegt.
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.