EXTCHKBOX-Struktur (compstui.h)

  • Artikel

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)

Weitere Informationen

EXTPUSH