ChooseColor

La funzione ChooseColor crea una dialogo comune colore che consente all'utente di selezionare un colore.

(BOOL ChooseColor LPCHOOSECOLOR  lpcc / / puntatore alla struttura con l'inizializzazione / / dati);
 

Parametri

lpcc
Puntatore a una struttura CHOOSECOLOR che contiene le informazioni utilizzate per inizializzare la finestra di dialogo. Quando ChooseColor ritorna, questa struttura contiene informazioni sulla selezione del colore dell'utente.

Valori restituiti

Se l'utente fa clic sul pulsante OK nella finestra di dialogo, il valore restituito è diverso da zero. Il membro rgbResult della struttura CHOOSECOLOR contiene il valore di colore RGB del colore selezionato dall'utente.

Se l'utente annulla o si chiude la finestra di dialogo colore o si verifica un errore, il valore restituito è zero. Per ottenere informazioni sull'errore esteso, chiamare la funzione CommDlgExtendedError , che può restituire uno dei seguenti valori:

CDERR_FINDRESFAILURE CDERR_MEMLOCKFAILURE
CDERR_INITIALIZATION CDERR_NOHINSTANCE
CDERR_LOCKRESFAILURE CDERR_NOHOOK
CDERR_LOADRESFAILURE CDERR_NOTEMPLATE
CDERR_LOADSTRFAILURE CDERR_STRUCTSIZE
CDERR_MEMALLOCFAILURE

Osservazioni

Viene visualizzata la finestra di dialogo colore non supporta tavolozze. Le scelte di colore offerte dalla finestra di dialogo sono limitate ai colori di sistema e retinate versioni di quei colori.

È possibile fornire una routine di hook CCHookProc per una finestra di dialogo colore . La routine di hook in grado di elaborare i messaggi inviati a una finestra di dialogo. Per attivare una procedura di gancio, impostare il flag CC_ENABLEHOOK nel membro Flags della struttura CHOOSECOLOR e specificare l'indirizzo della procedura gancio nel membro lpfnHook.

Descrizione

nbsp; Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Richiede la versione 2.0 o successiva.
Intestazione:Dichiarati in commdlg.h.
Importare librerie:Utilizzare comdlg32.lib.
Unicode:Implementato come versioni Unicode e ANSI su Windows NT.

Vedi anche

Comune di dialogo casella libreria panoramica, funzioni di Box di dialogo comuni, CCHookProc, CHOOSECOLOR, CommDlgExtendedError

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index