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

Siehe auch

EXTPUSH-