EXTCHKBOX-Struktur (compstui.h)
Die EXTCHKBOX Struktur wird von CPSUI-Anwendungen (einschließlich Druckerschnittstellen-DLLs) zum Angeben eines erweiterten Kontrollkästchens verwendet, das einer Eigenschaftenblattseitenoption hinzugefügt werden kann.
Syntax
typedef struct _EXTCHKBOX {
WORD cbSize;
WORD Flags;
LPTSTR pTitle;
LPTSTR pSeparator;
LPTSTR pCheckedName;
ULONG_PTR IconID;
WORD wReserved[4];
ULONG_PTR dwReserved[2];
} EXTCHKBOX, *PEXTCHKBOX;
Angehörige
cbSize
Größe der EXTCHKBOX- Struktur in Byte.
Flags
Bit-Flags, die eine der folgenden Sein können:
ECBF_CHECKNAME_AT_FRONT
Wenn festgelegt, zeigt CPSUI Zeichenfolgen in der Reihenfolge "pCheckedName pSeparator SelectName", wobei SelectName- die Zeichenfolge ist, die dem ausgewählten Wert der Option zugeordnet ist.
Wenn nicht festgelegt, zeigt CPSUI Zeichenfolgen in der Reihenfolge "SelectName pSeparator pCheckedName" an.
ECBF_CHECKNAME_ONLY_ENABLED
Wenn festgelegt, zeigt CPSUI die pCheckedName-Zeichenfolge nur an, wenn die Option aktiviert und aktiviert ist (d. h., OPTIF_ECB_CHECKED festgelegt ist und OPTIF_DISABLED in der OPTITEM Struktur deaktiviert ist).
Wenn nicht festgelegt, zeigt CPSUI immer die pCheckedName-Zeichenfolge an, wenn die Option aktiviert ist (d. h. OPTIF_ECB_CHECKED wird in der OPTITEM Struktur festgelegt), auch wenn die Option deaktiviert ist.
ECBF_ICONID_AS_HICON
Wenn festgelegt, enthält das IconID- Mitglied ein Symbolhandle.
Wenn nicht festgelegt, enthält das IconID- Mitglied einen Symbolressourcenbezeichner.
ECBF_OVERLAY_ECBICON_IF_CHECKED
Wenn festgelegt und das Kontrollkästchen aktiviert ist (d. h., OPTIF_ECB_CHECKED in der OPTITEM Struktur festgelegt ist), überlagert CPSUI das symbol, das durch die IconID Mitglied auf das dem Optionselement zugeordnete Symbol identifiziert wird.
ECBF_OVERLAY_NO_ICON
Wenn festgelegt, überlagert CPSUI das IDI_CPSUI_NO Symbol auf das Symbol, das durch das IconID Mitglied identifiziert wird.
ECBF_OVERLAY_STOP_ICON
Falls festgelegt, überlagert CPSUI das IDI_CPSUI_STOP-Symbol auf das symbol, das durch das IconID- Mitglied identifiziert wird.
ECBF_OVERLAY_WARNING_ICON
Wenn festgelegt, überlagert CPSUI das IDI_CPSUI_WARNING-Symbol auf das symbol, das durch das IconID Mitglied identifiziert wird.
pTitle
Zeichenfolgenbezeichner, der den Titel des Kontrollkästchens darstellt. Dies kann ein 32-Bit-Zeiger auf eine NULL-beendete Zeichenfolge sein, oder es kann sich um einen 16-Bit-Zeichenfolgenressourcenbezeichner mit HIWORD-Wert 0 handeln.
pSeparator
Zeichenfolgenbezeichner, der ein Trennzeichen darstellt, das zwischen der überprüften Namenszeichenfolge und der ausgewählten Optionszeichenfolge angezeigt werden soll. Dabei kann es sich um einen 32-Bit-Zeiger auf eine NULL-beendete Zeichenfolge handeln, oder es kann sich um einen 16-Bit-Zeichenfolgenressourcenbezeichner mit HIWORD-Wert 0 handeln.
pCheckedName
Zeichenfolgenbezeichner, der den Text darstellt, der angezeigt werden soll, wenn das Kontrollkästchen aktiviert ist. Dies kann ein 32-Bit-Zeiger auf eine NULL-beendete Zeichenfolge sein, oder es kann sich um einen 16-Bit-Zeichenfolgenressourcenbezeichner mit HIWORD-Wert 0 handeln.
IconID
Einer der folgenden Symbolbezeichner:
Ein Symbolressourcenbezeichner. Dies kann anwendungsdefiniert sein, oder es kann sich um einen der von CPSUI bereitgestellten, IDI_CPSUI-Präfix-Symbolressourcenbezeichner handeln.
Ein Symbolziehpunkt. Wenn ein Handle angegeben ist, muss ECBF_ICONID_AS_HICON im Flags Member festgelegt werden.
Wenn dieser Wert null ist, wird kein Symbol angezeigt.
wReserved[4]
Reserviert, muss auf Null initialisiert werden.
dwReserved[2]
Reserviert, muss auf Null initialisiert werden.
Bemerkungen
Ein erweitertes Kontrollkästchen ist ein CPSUI-definierter Kontrollkästchentyp, der einer OPTITEM- Struktur zugeordnet werden kann. Eine OPTITEM- Struktur kann ein erweitertes Kontrollkästchen oder eine erweiterte Knopfdruck-Struktur zugeordnet sein.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | compstui.h (include Compstui.h) |