CHOOSECOLOR

La struttura CHOOSECOLOR contiene informazioni che la funzione ChooseColor viene utilizzata per inizializzare la finestra di dialogo comune colore . Dopo che l'utente chiude la finestra di dialogo, il sistema restituisce informazioni sulla selezione dell'utente in questa struttura.

typedef struct {/ / cc DWORD lStructSize; 
    HWND hwndOwner; 
    HWND hInstance; 
    COLORREF rgbResult; 
    COLORREF * lpCustColors; 
    DWORD Flags; 
    LPARAM lCustData; 
    LPCCHOOKPROC lpfnHook; 
    LPCTSTR lpTemplateName; 
} CHOOSECOLOR 
 

Membri

lStructSize

Specifica la lunghezza in byte, della struttura.

hwndOwner

Identifica la finestra che possiede la finestra di dialogo. Questo membro può essere alcun handle di finestra valido, oppure può essere NULL se la finestra di dialogo non ha alcun proprietario.

hInstance

Se nel membro flag è impostato il flag CC_ENABLETEMPLATEHANDLE, hInstance è l'handle di un oggetto di memoria contenente un modello di finestra di dialogo. Se è impostato il flag CC_ENABLETEMPLATE, hInstance identifica un modulo che contiene un modello di finestra di dialogo denominato dal membro lpTemplateName . Se né CC_ENABLETEMPLATEHANDLE né CC_ENABLETEMPLATE è impostato, questo membro viene ignorato.

rgbResult

Se è impostato il flag CC_RGBINIT, rgbResult specifica il colore inizialmente selezionato quando viene creata la finestra di dialogo. Se il valore del colore specificato non è tra i colori disponibili, il sistema seleziona il colore solido più disponibile. Se rgbResult è zero o CC_RGBINIT non è impostato, il colore selezionato inizialmente è nero. Se l'utente fa clic sul pulsante OK, rgbResult specifica la selezione del colore dell'utente.

lpCustColors

Puntatore a una matrice di 16 valori COLORREF che contengono valori di rossi, verdi, blu (RGB) per il colore personalizzato caselle nella finestra di dialogo. Se l'utente modifica questi colori, il sistema aggiorna la matrice con i nuovi valori RGB. Per mantenere i nuovi colori personalizzati tra le chiamate alla funzione ChooseColor , deve allocare la memoria statica per la matrice.

Bandiere

Un insieme di flag di bit che è possibile utilizzare per inizializzare la finestra di dialogo comune colore . Quando ritorna nella finestra di dialogo, imposta questi flag per indicare l'input dell'utente. Questo membro può essere una combinazione dei seguenti flag:

Bandiera	Significato
CC_ANYCOLOR	La finestra di dialogo visualizzare tutti i colori disponibili nell'insieme dei colori di base.
CC_ENABLEHOOK	Consente la routine di hook specificata nel membro lpfnHook di questa struttura. Questo flag viene utilizzato solo per inizializzare la finestra di dialogo.
CC_ENABLETEMPLATE	Indica che i membri hInstance e lpTemplateName specificano un modello di finestra di dialogo da utilizzare al posto del modello predefinito. Questo flag viene utilizzato solo per inizializzare la finestra di dialogo.
CC_ENABLETEMPLATEHANDLE	Indica che il membro hInstance identifica un blocco di dati che contiene un modello di finestra di dialogo precaricati. Il sistema ignora il membro lpTemplateName se questo flag viene specificato. Questo flag viene utilizzato solo per inizializzare la finestra di dialogo.
CC_FULLOPEN	Provoca la finestra di dialogo visualizzare i controlli aggiuntivi che consentono all'utente di creare colori personalizzati. Se questo flag non è impostato, l'utente deve cliccare il pulsante dicolore personalizzato Definisciper visualizzare i controlli colore personalizzato .
CC_PREVENTFULLOPEN	Disabilita il pulsante dicolori DefineCustom .
CC_RGBINIT	La finestra di dialogo utilizzare il colore specificato nel membro rgbResult come la selezione colore iniziale.
CC_SHOWHELP	Provoca la finestra di dialogo visualizzare il pulsante Help. Il membro hwndOwner deve specificare la finestra per ricevere il HELPMSGSTRING registrati messaggi inviati nella finestra di dialogo quando l'utente fa clic sul pulsante Guida.
CC_SOLIDCOLOR	La finestra di dialogo visualizzare solo i colori solidi nel set dei colori di base.

lCustData

Specifica i dati definiti dall'applicazione che il sistema passa alla routine di hook identificata dal membro lpfnHook . Quando il sistema invia il messaggio WM_INITDIALOG per la routine di hook, parametro lParam del messaggio è che un puntatore alla struttura CHOOSECOLOR specificato quando fu creata la finestra di dialogo. La routine di hook può utilizzare questo puntatore per ottenere il valore di lCustData.

lpfnHook

Puntatore a un CCHookProc gancio procedura che consente di elaborare i messaggi destinati a nella finestra di dialogo. Questo membro viene ignorato a meno che il flag CC_ENABLEHOOK è impostato nel membro flag.

lpTemplateName

Puntatore a una stringa con terminazione null che assegna la risorsa modello di finestra casella nel modulo identificato dal membro hInstance . Questo modello viene sostituito con il modello di finestra di dialogo standard. Per le risorse di casella di dialogo numerati, lpTemplateName può essere un valore restituito dalla macro MAKEINTRESOURCE . Questo membro viene ignorato a meno che il flag CC_ENABLETEMPLATE è impostato nel membro flag.

Descrizione

nbsp; Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Richiede la versione 1.0 o successiva.
Intestazione:Dichiarati in commdlg.h.
Unicode:Definito come strutture di Unicode e ANSI.

Vedi anche

Comune di dialogo casella libreria panoramica, strutture di Box di dialogo comuni, CCHookProc, ChooseColor, MAKEINTRESOURCE, WM_INITDIALOG