DTCTL
Gilt für: Outlook 2013 | Outlook 2016
Beschreibt ein Steuerelement, das in einem Dialogfeld verwendet wird, das aus einer Anzeigetabelle erstellt wurde.
| Eigenschaft | Wert |
|---|---|
| Headerdatei |
Mapidefs.h |
typedef struct
{
ULONG ulCtlType;
ULONG ulCtlFlags;
LPBYTE lpbNotif;
ULONG cbNotif;
LPSTR lpszFilter;
ULONG ulItemID;
union
{
LPVOID lpv;
LPDTBLLABEL lplabel;
LPDTBLEDIT lpedit;
LPDTBLLBX lplbx;
LPDTBLCOMBOBOX lpcombobox;
LPDTBLDDLBX lpddlbx;
LPDTBLCHECKBOX lpcheckbox;
LPDTBLGROUPBOX lpgroupbox;
LPDTBLBUTTON lpbutton;
LPDTBLRADIOBUTTON lpradiobutton;
LPDTBLMVLISTBOX lpmvlbx;
LPDTBLMVDDLBX lpmvddlbx;
LPDTBLPAGE lppage;
} ctl;
} DTCTL, FAR *LPDTCTL;
Members
ulCtlType
Typ des Steuerelements, das im ctl-Member enthalten ist und der eigenschaft PR_CONTROL_TYPE (PidTagControlType) des Steuerelements entspricht. Folgende Werte sind möglich:
DTCT_LABEL
Bezeichnungsfeld-Steuerelement.
DTCT_EDIT
Steuerelement bearbeiten.
DTCT_LBX
Listenfeld-Steuerelement.
DTCT_COMBOBOX
Kombinationsfeld-Steuerelement.
DTCT_DDLBX
Dropdownlistensteuerelement.
DTCT_CHECKBOX
Kontrollkästchen-Steuerelement.
DTCT_GROUPBOX
Gruppenfeld-Steuerelement.
DTCT_BUTTON
Schaltflächensteuerelement.
DTCT_PAGE
Seitensteuerelement im Registerkartenformat.
DTCT_RADIOBUTTON
Optionsfeld-Steuerelement.
DTCT_MVLISTBOX
Mehrwertiges Listensteuerelement.
DTCT_MVDDLBX
Mehrwertiges Dropdownlistensteuerelement.
ulCtlFlags
Bitmaske von Flags, die die Features des Steuerelements beschreibt und der eigenschaft PR_CONTROL_FLAGS (PidTagControlFlags) des Steuerelements entspricht. Diese Flags können nur für Kontrollkästchen, Kombinationsfelder, Listenfelder und Bearbeitungssteuerelemente festgelegt werden. Folgende Werte sind möglich:
DT_ACCEPT_DBCS
Es wird entweder das ANSI- oder das DBCS-Format akzeptiert. Dieses Flag ist nur für Bearbeitungssteuerelemente gültig.
DT_EDITABLE
Ein Benutzer kann den Text im Steuerelement ändern.
DT_MULTILINE
Das Steuerelement kann mehrere Textzeilen enthalten. Dieses Flag ist nur für Bearbeitungssteuerelemente gültig.
DT_PASSWORD_EDIT
Das Steuerelement enthält ein Kennwort. Daher sollte der Inhalt des Steuerelements dem Benutzer nicht angezeigt werden. Dieses Flag ist nur für Bearbeitungssteuerelemente gültig.
DT_REQUIRED
Das Dialogfeld-Steuerelement ist erforderlich. Dieses Flag ist nur für Bearbeitungs- und Kombinationsfeld-Steuerelemente gültig.
DT_SET_IMMEDIATE
Ermöglicht die sofortige Ausgabe eines Werts bei einer Änderung des Steuerelements. Dadurch kann eine Abhängigkeitsbeziehung zwischen zwei Steuerelementen eingerichtet werden.
lpbNotif
Zeiger auf eine Struktur, die aus einer GUID-Struktur besteht, um den Dienstanbieter und einen Bezeichner für das Steuerelement darzustellen. Die Elemente lpbNotif und cbNotif entsprechen der eigenschaft PR_CONTROL_ID (PidTagControlId) des Steuerelements und werden verwendet, um die Benutzeroberfläche zu benachrichtigen, wenn das Steuerelement aktualisiert werden muss.
cbNotif
Anzahl der Bytes in der Struktur, auf die der lpbNotif-Member verweist.
lpszFilter
Zeiger auf eine Zeichenfolge, die beschreibt, welche Zeichen in ein Bearbeitungs- oder Kombinationsfeld-Steuerelement eingegeben werden können. Bei anderen Steuerelementtypen kann der lpszFilter-Member NULL sein. Für Bearbeitungs- und Kombinationsfeld-Steuerelemente sollte es sich um einen regulären Ausdruck handeln, der jeweils für ein einzelnes Zeichen gilt. Derselbe Filter wird auf alle Zeichen im -Steuerelement angewendet. Das Format der Filterzeichenfolge 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 (z. B "[~0-9]"). . |
\ |
Wird verwendet, um eines der vorherigen Symbole anzurufen (z. B. bedeutet, "[\-\\\[\]]" dass -, , Zeichen [und ] zulässig sind). |
ulItemID
Wert, der das Steuerelement in der Dialogfeldressource angibt. Für Registerkartenseitensteuerelemente vom Typ DTCT_PAGE wird optional der ulItemID-Member verwendet, um den Komponentennamen für die Seite aus einer Zeichenfolgenressource zu laden. Positions- und Bezeichnungsinformationen werden aus der Dialogfeldressource gelesen.
Ctl
Eine Struktur, die die Daten für das Steuerelement enthält und der PR_CONTROL_STRUCTURE -Eigenschaft (PidTagControlStructure) des Steuerelements entspricht. Jeder Steuerelementtyp weist eine andere Struktur auf.
Hinweise
Die DTCTL-Struktur beschreibt ein Steuerelement eines beliebigen Typs. Die meisten Member werden verwendet, um Eigenschaften für das Steuerelement festzulegen.
Der ctl-Member ist eine Vereinigung von Strukturen, die sich auf einen bestimmten Steuerelementtyp beziehen. Wenn die DTCTL-Struktur z. B. ein Bearbeitungssteuerelement beschreibt, zeigt der ctl-Member auf eine DTBLEDIT-Struktur . Diese Struktur entspricht der eigenschaft PR_CONTROL_STRUCTURE des Steuerelements. Die Union verfügt als erstes Element über eine Variable vom Typ LPVOID, um die Kompilierzeitinitialisierung der DTCTL-Struktur zu ermöglichen.
Obwohl die BuildDisplayTable-Funktion die DTCTL-Struktur zum Erstellen der Anzeigetabelle aus Steuerelementressourcen verwendet, wird die DTCTL-Struktur nie in der Anzeigetabelle selbst angezeigt. Diese Struktur stellt nur Informationen an BuildDisplayTable bereit.
Im ulCtlFlags-Member DT_ACCEPT_DBCS, DT_EDITABLE DT_MULTILINE_and DT_PASSWORD_EDIT nur Bearbeitungssteuerelemente. Zwei weitere DT_REQUIRED und DT_SET_IMMEDIATE sich auf jedes bearbeitbare Steuerelement auswirken.
Die für ein Dialogfeld verfügbaren Steuerelemente sind Bezeichnung, Textfeld, Freihandtextfeld, Liste, Dropdownliste, Kombinationsfeld, Kontrollkästchen, Gruppenfeld, Schaltfläche, Optionsfeld und Registerkartenseite.
Eine Übersicht über Anzeigetabellen finden Sie unter Anzeigen von Tabellen. Informationen zum Implementieren einer Anzeigetabelle finden Sie unter Implementieren einer Anzeigetabelle.