Classe CMFCColorPickerCtrl

La CMFCColorPickerCtrl classe fornisce funzionalità per un controllo utilizzato per selezionare i colori.

Sintassi

class CMFCColorPickerCtrl : public CButton

Membri

Costruttori pubblici

Nome	Descrizione
CMFCColorPickerCtrl::CMFCColorPickerCtrl	Costruisce un oggetto CMFCColorPickerCtrl.

Metodi pubblici

Nome	Descrizione
CMFCColorPickerCtrl::GetColor	Recupera il colore selezionato dall'utente.
CMFCColorPickerCtrl::GetHLS	Recupera i valori di tonalità, luminanza e saturazione del colore selezionato dall'utente.
CMFCColorPickerCtrl::GetHue	Recupera il componente tonalità del colore selezionato dall'utente.
CMFCColorPickerCtrl::GetLuminance	Recupera il componente di luminanza del colore selezionato dall'utente.
CMFCColorPickerCtrl::GetSaturation	Recupera il componente di saturazione del colore selezionato dall'utente.
CMFCColorPickerCtrl::SelectCellHexagon	Imposta il colore corrente sul colore definito dai componenti di colore RGB specificati o dall'esagono di cella specificato.
CMFCColorPickerCtrl::SetColor	Imposta il colore corrente sul valore di colore RGB specificato.
CMFCColorPickerCtrl::SetHLS	Imposta il colore corrente sul valore di colore HLS specificato.
CMFCColorPickerCtrl::SetHue	Modifica il componente tonalità del colore attualmente selezionato.
CMFCColorPickerCtrl::SetLuminance	Modifica il componente di luminanza del colore attualmente selezionato.
CMFCColorPickerCtrl::SetLuminanceBarWidth	Imposta la larghezza della barra di luminanza nel controllo selezione colori.
CMFCColorPickerCtrl::SetOriginalColor	Imposta il colore selezionato iniziale.
CMFCColorPickerCtrl::SetPalette	Imposta la tavolozza dei colori corrente.
CMFCColorPickerCtrl::SetSaturation	Modifica il componente di saturazione del colore attualmente selezionato.
CMFCColorPickerCtrl::SetType	Imposta il tipo di controllo selezione colori da visualizzare.

Metodi protetti

Nome	Descrizione
CMFCColorPickerCtrl::DrawCursor	Chiamato dal framework prima che venga visualizzato un cursore che punta al colore selezionato.

Osservazioni:

I colori standard vengono selezionati da una tavolozza dei colori esagonali e i colori personalizzati vengono selezionati da una barra di dominanza in cui i colori vengono specificati utilizzando notazione rosso/verde/blu o notazione tonalità/saturazione/luminanza.

La figura seguente illustra diversi CMFCColorPickerCtrl oggetti.

CMFCColorPickerCtrl supporta due coppie di stili. Gli HEX stili e HEX_GREYSCALE sono appropriati per la selezione dei colori standard. Gli PICKER stili e LUMINANCE sono appropriati per la selezione dei colori personalizzata.

Seguire questa procedura per incorporare il CMFCColorPickerCtrl controllo nella finestra di dialogo:

1. Se si usa ClassWizard, inserire un nuovo controllo pulsante nel modello della CButton finestra di dialogo , perché la CMFCColorPickerCtrl classe viene ereditata dalla classe .

2. Inserire una variabile membro associata al nuovo controllo pulsante nella classe della finestra di dialogo. Modificare quindi il tipo di variabile da CButton a CMFCColorPickerCtrl.

3. Inserire il WM_INITDIALOG gestore messaggi per la classe della finestra di dialogo. Nel gestore impostare il tipo, la tavolozza e il colore selezionato iniziale del CMFCColorPickerCtrl controllo.

Gerarchia di ereditarietà

CObject
CCmdTarget
CWnd
CButton
CMFCColorPickerCtrl

Requisiti

Intestazione: afxcolorpickerctrl.h

CMFCColorPickerCtrl::CMFCColorPickerCtrl

Costruisce un oggetto CMFCColorPickerCtrl.

CMFCColorPickerCtrl();

Valore restituito

Osservazioni:

CMFCColorPickerCtrl::DrawCursor

Chiamato dal framework prima che venga visualizzato un cursore che punta al colore selezionato.

virtual void DrawCursor(
    CDC* pDC,
    const CRect& rect);

Parametri

pDC
[in] Puntatore a un contesto di dispositivo.

rect
[in] Specifica un'area rettangolare intorno al colore selezionato.

Osservazioni:

Eseguire l'override di questo metodo quando è necessario modificare la forma del cursore che punta al colore selezionato.

CMFCColorPickerCtrl::GetColor

Recupera il colore selezionato dall'utente.

COLORREF GetColor() const;

Valore restituito

Valore RGB del colore selezionato.

Osservazioni:

CMFCColorPickerCtrl::GetHLS

Recupera i valori di tonalità, luminanza e saturazione del colore selezionato dall'utente.

void GetHLS(
    double* hue,
    double* luminance,
    double* saturation);

Parametri

hue
[out] Puntatore a una variabile di tipo double che riceve informazioni sulla tonalità.

luminance
[out] Puntatore a una variabile di tipo double che riceve informazioni sulla dominanza.

saturation
[out] Puntatore a una variabile di tipo double che riceve informazioni sulla saturazione.

Osservazioni:

CMFCColorPickerCtrl::GetHue

Recupera il componente tonalità del colore selezionato dall'utente.

double GetHue() const;

Valore restituito

Componente della tonalità del colore selezionato.

Osservazioni:

CMFCColorPickerCtrl::GetLuminance

Recupera il componente di luminanza del colore selezionato dall'utente.

double GetLuminance() const;

Valore restituito

Componente di luminanza del colore selezionato.

Osservazioni:

CMFCColorPickerCtrl::GetSaturation

Recupera il valore di saturazione del colore selezionato dall'utente.

double GetSaturation() const;

Valore restituito

Componente di saturazione del colore selezionato.

Osservazioni:

CMFCColorPickerCtrl::SelectCellHexagon

Imposta il colore corrente sul colore definito dai componenti di colore RGB specificati o dall'esagono di cella specificato.

void SelectCellHexagon(
    BYTE R,
    BYTE G,
    BYTE B);

BOOL SelectCellHexagon(
    int x,
    int y);

Parametri

R
[in] Componente colore rosso.

G
[in] Componente colore verde.

B
[in] Componente colore blu.

x
[in] Coordinata x del cursore, che punta a un esagono cella.

y
[in] Coordinata y del cursore, che punta a un esagono cella.

Valore restituito

Il secondo overload di questo metodo restituisce sempre FALSE.

Osservazioni:

Il primo overload di questo metodo imposta il colore corrente sul colore che corrisponde ai componenti di colore rosso, verde e blu specificati del controllo di selezione colori.

Il secondo overload di questo metodo imposta il colore corrente sul colore dell'esagono della cella a cui punta la posizione del cursore specificata.

CMFCColorPickerCtrl::SetColor

Imposta il colore corrente sul valore di colore RGB specificato.

void SetColor(COLORREF Color);

Parametri

Color
[in] Valore di colore RGB.

Osservazioni:

CMFCColorPickerCtrl::SetHLS

Imposta il colore corrente sul valore di colore HLS specificato.

void SetHLS(
    double hue,
    double luminance,
    double saturation,
    BOOL bInvalidate=TRUE);

Parametri

hue
[in] Valore di tonalità.

luminance
[in] Valore di luminanza.

saturation
[in] Valore di saturazione.

bInvalidate
[in] TRUE per forzare l'aggiornamento immediato della finestra al nuovo colore; in caso contrario, FALSE. Il valore predefinito è TRUE.

Osservazioni:

CMFCColorPickerCtrl::SetHue

Modifica la tonalità del colore attualmente selezionato.

void SetHue(double Hue);

Parametri

Hue
[in] Valore di tonalità.

Osservazioni:

CMFCColorPickerCtrl::SetLuminance

Modifica la luminanza del colore attualmente selezionato.

void SetLuminance(double Luminance);

Parametri

Luminance
[in] Valore di luminanza.

Osservazioni:

CMFCColorPickerCtrl::SetLuminanceBarWidth

Imposta la larghezza della barra di luminanza nel controllo selezione colori.

void SetLuminanceBarWidth(int w);

Parametri

w
[in] Larghezza della barra di luminanza misurata in pixel.

Osservazioni:

Utilizzare questo metodo per ridimensionare la barra di luminanza, che si trova nella scheda Personalizzata del controllo selezione colori. Il w parametro specifica la nuova larghezza della barra di luminanza. Il valore di larghezza viene ignorato se supera tre quarti della larghezza dell'area client.

CMFCColorPickerCtrl::SetOriginalColor

Imposta il colore selezionato iniziale.

void SetOriginalColor(COLORREF ref);

Parametri

ref
[in] Valore di colore RGB.

Osservazioni:

Chiamare questo metodo quando viene inizializzato il controllo selezione colori.

CMFCColorPickerCtrl::SetPalette

Imposta la tavolozza dei colori corrente.

void SetPalette(CPalette* pPalette);

Parametri

pPalette
[in] Puntatore a una tavolozza dei colori.

Osservazioni:

La tavolozza dei colori definisce la matrice di colori presentata nel controllo selezione colori.

CMFCColorPickerCtrl::SetSaturation

Modifica la saturazione del colore attualmente selezionato.

void SetSaturation(double Saturation);

Parametri

Saturation
[in] Valore di saturazione.

Osservazioni:

CMFCColorPickerCtrl::SetType

Imposta il tipo di controllo selezione colori da visualizzare.

void SetType(COLORTYPE colorType);

Parametri

colorType
[in] Tipo di controllo selezione colori.

I tipi sono definiti dall'enumerazione CMFCColorPickerCtrl::COLORTYPE . I tipi possibili sono LUMINANCE, PICKERHEX e HEX_GREYSCALE. Il tipo predefinito è PICKER.

Osservazioni:

Per specificare un tipo di controllo selezione colori, chiamare questo metodo prima che venga creato il controllo Windows.

Vedi anche

Grafico della gerarchia
Classi
CMFCColorDialog Classe