EXTCHKBOX-Struktur (compstui.h)
Die EXTCHKBOX-Struktur wird von CPSUI-Anwendungen (einschließlich Druckerschnittstellen-DLLs) zum Angeben eines erweiterten Kontrollkästchens verwendet, das einer Eigenschaftenblattseite-Option 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;
Member
cbSize
Größe der EXTCHKBOX-Struktur in Byte.
Flags
Bitflags, die eines der folgenden sein können:
ECBF_CHECKNAME_AT_FRONT
Falls festgelegt, zeigt CPSUI Zeichenfolgen in der Reihenfolge "pCheckedName pSeparator SelectName" an, wobei SelectName die Zeichenfolge ist, die dem ausgewählten Wert der Option zugeordnet ist.
Falls nicht festgelegt, zeigt CPSUI Zeichenfolgen in der Reihenfolge "SelectName pSeparator pCheckedName" an.
ECBF_CHECKNAME_ONLY_ENABLED
Falls festgelegt, zeigt CPSUI die pCheckedName-Zeichenfolge nur an, wenn die Option aktiviert und aktiviert ist (d. OPTIF_ECB_CHECKED festgelegt ist und OPTIF_DISABLED in der OPTITEM-Struktur klar ist).
Wenn nicht festgelegt, zeigt CPSUI immer die pCheckedName-Zeichenfolge an, wenn die Option aktiviert ist (d. h. OPTIF_ECB_CHECKED in der OPTITEM-Struktur festgelegt ist), auch wenn die Option deaktiviert ist.
ECBF_ICONID_AS_HICON
Wenn festgelegt, enthält das IconID-Element ein Symbolhandle.
Wenn nicht festgelegt, enthält das IconID-Element 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 durch das IconID-Element identifizierte Symbol auf dem Symbol, das dem Optionselement zugeordnet ist.
ECBF_OVERLAY_NO_ICON
Falls festgelegt, überlagert CPSUI sein IDI_CPSUI_NO-Symbol mit dem Symbol, das durch das IconID-Element identifiziert wird.
ECBF_OVERLAY_STOP_ICON
Falls festgelegt, überlagert CPSUI das IDI_CPSUI_STOP-Symbol mit dem Symbol, das durch das IconID-Element identifiziert wird.
ECBF_OVERLAY_WARNING_ICON
Falls festgelegt, überlagert CPSUI sein IDI_CPSUI_WARNING-Symbol mit dem Symbol, das durch das IconID-Element identifiziert wird.
pTitle
Zeichenfolgenbezeichner, der den Kontrollkästchentitel darstellt. Dies kann ein 32-Bit-Zeiger auf eine MIT NULL endende Zeichenfolge oder ein 16-Bit-Zeichenfolgenressourcenbezeichner sein, bei dem HIWORD auf Null festgelegt ist.
pSeparator
Zeichenfolgenbezeichner, der ein Trennzeichen darstellt, das zwischen der aktivierten Namenszeichenfolge und der ausgewählten Optionszeichenfolge angezeigt werden soll. Dies kann ein 32-Bit-Zeiger auf eine NULL-beendete Zeichenfolge oder ein 16-Bit-Zeichenfolgenressourcenbezeichner sein, bei dem HIWORD auf Null festgelegt ist.
pCheckedName
Zeichenfolgenbezeichner, der den Text darstellt, der angezeigt werden soll, wenn das Kontrollkästchen aktiviert ist. Dies kann ein 32-Bit-Zeiger auf eine MIT NULL endende Zeichenfolge oder ein 16-Bit-Zeichenfolgenressourcenbezeichner sein, bei dem HIWORD auf Null festgelegt ist.
IconID
Einer der folgenden Symbolbezeichner:
Ein Symbolressourcenbezeichner. Dies kann von der Anwendung definiert sein, oder es kann sich um eine der von CPSUI bereitgestellten Ressourcen-IDs mit IDI_CPSUI Symbol-Präfix sein.
Ein Symbolhandle. Wenn ein Handle angegeben wird, muss ECBF_ICONID_AS_HICON im Flags-Element festgelegt werden.
Wenn dieser Wert 0 ist, wird kein Symbol angezeigt.
wReserved[4]
Reserviert, muss auf 0 (null) initialisiert werden.
dwReserved[2]
Reserviert, muss auf 0 (null) initialisiert werden.
Hinweise
Ein erweitertes Kontrollkästchen ist ein von CPSUI definiertes Kontrollkästchen, das einer OPTITEM-Struktur zugeordnet werden kann. Einer OPTITEM-Struktur kann ein erweitertes Kontrollkästchen oder eine erweiterte Taste zugeordnet sein.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | compstui.h (include Compstui.h) |