Struttura EXTCHKBOX (compstui.h)

La struttura EXTCHKBOX viene usata dalle applicazioni CPSUI (incluse le DLL dell'interfaccia della stampante) per specificare una casella di controllo estesa, che può essere aggiunta a un'opzione della pagina del foglio delle proprietà.

Sintassi

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;

Members

cbSize

Dimensioni, in byte, della struttura EXTCHKBOX .

Flags

Flag di bit, che possono essere uno dei seguenti:

ECBF_CHECKNAME_AT_FRONT

Se impostato, CPSUI visualizza le stringhe nell'ordine "pCheckedName pSeparator SelectName", dove SelectName è la stringa associata al valore selezionato dell'opzione.

Se non è impostato, CPSUI visualizza le stringhe nell'ordine "SelectName pSeparator pCheckedName".

ECBF_CHECKNAME_ONLY_ENABLED

Se impostato, CPSUI visualizza la stringa pCheckedName solo se l'opzione è selezionata e abilitata, ovvero OPTIF_ECB_CHECKED è impostata e OPTIF_DISABLED è deselezionata nella struttura OPTITEM .

Se non è impostato, CPSUI visualizza sempre la stringa pCheckedName se l'opzione viene selezionata , ovvero OPTIF_ECB_CHECKED è impostata nella struttura OPTITEM , anche se l'opzione è disabilitata.

ECBF_ICONID_AS_HICON

Se impostato, il membro IconID contiene un handle di icona.

Se non è impostato, il membro IconID contiene un identificatore di risorsa icona.

ECBF_OVERLAY_ECBICON_IF_CHECKED

Se impostata e se la casella di controllo viene selezionata , ovvero OPTIF_ECB_CHECKED è impostata nella struttura OPTITEM , CPSUI sovrappone l'icona identificata dal membro IconID sull'icona associata all'elemento di opzione.

ECBF_OVERLAY_NO_ICON

Se impostato, CPSUI sovrappone l'icona IDI_CPSUI_NO all'icona identificata dal membro IconID .

ECBF_OVERLAY_STOP_ICON

Se impostato, CPSUI sovrappone l'icona IDI_CPSUI_STOP all'icona identificata dal membro IconID .

ECBF_OVERLAY_WARNING_ICON

Se impostato, CPSUI sovrappone l'icona IDI_CPSUI_WARNING all'icona identificata dal membro IconID .

pTitle

Identificatore stringa, che rappresenta il titolo della casella di controllo. Questo può essere un puntatore a 32 bit a una stringa con terminazione NULL oppure può essere un identificatore di risorsa stringa a 16 bit con HIWORD impostato su zero.

pSeparator

Identificatore stringa, che rappresenta un carattere separatore da visualizzare tra la stringa del nome selezionato e la stringa di opzione selezionata, questo può essere un puntatore a 32 bit a una stringa con terminazione NULL oppure può essere un identificatore di risorsa stringa a 16 bit con HIWORD impostato su zero.

pCheckedName

Identificatore stringa, che rappresenta il testo da visualizzare quando viene selezionata la casella di controllo. Questo può essere un puntatore a 32 bit a una stringa con terminazione NULL oppure può essere un identificatore di risorsa stringa a 16 bit con HIWORD impostato su zero.

IconID

Uno degli identificatori di icona seguenti:

• Identificatore di risorsa icona. Può essere definito dall'applicazione oppure può essere uno degli identificatori di risorsa dell'icona con prefisso CPSUI fornito da IDI_CPSUI CPSUI.

• Handle icona. Se viene specificato un handle, ECBF_ICONID_AS_HICON deve essere impostato nel membro Flags .

Se questo valore è zero, non viene visualizzata un'icona.

wReserved[4]

Riservato, deve essere inizializzato su zero.

dwReserved[2]

Riservato, deve essere inizializzato su zero.

Commenti

Una casella di controllo estesa è un tipo di casella di controllo definito da CPSUI che può essere associato a una struttura OPTITEM . Una struttura OPTITEM può avere una casella di controllo estesa o un pulsante push esteso associato a esso.

Requisiti

Vedi anche

EXTPUSH