Struttura EXTCHKBOX (compstui.h)
La struttura EXTCHKBOX viene utilizzata 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 della finestra 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;
Membri
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 impostata, 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 è impostata, CPSUI visualizza sempre la stringa pCheckedName se l'opzione è 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 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 è selezionata(ovvero, OPTIF_ECB_CHECKED è impostata nella struttura OPTITEM), CPSUI sovrappone l'icona identificata dal membro IconID sull'icona associata all'elemento dell'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. Può trattarsi di 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. Può trattarsi di 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 IDI_CPSUI.
Handle icona. Se viene specificato un handle, ECBF_ICONID_AS_HICON deve essere impostato nel membro flag.
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.
Osservazioni
Una casella di controllo estesa è un tipo di casella di controllo definito da CPSUI che può essere associato a una struttura di OPTITEM. Una struttura OPTITEM può avere una casella di controllo estesa o un pulsante di scelta estesa associato.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | compstui.h (include Compstui.h) |