Compartilhar via

Classe CMFCColorPickerCtrl

  • Artigo

A classe CMFCColorPickerCtrl fornece funcionalidade para um controle usado para selecionar cores.

Sintaxe

class CMFCColorPickerCtrl : public CButton

Membros

Construtores públicos

Nome Descrição
CMFCColorPickerCtrl::CMFCColorPickerCtrl Constrói um objeto CMFCColorPickerCtrl.

Métodos públicos

Nome Descrição
CMFCColorPickerCtrl::GetColor Recupera a cor selecionada pelo usuário.
CMFCColorPickerCtrl::GetHLS Recupera os valores de matiz, luminância e saturação da cor selecionada pelo usuário.
CMFCColorPickerCtrl::GetHue Recupera o componente matiz da cor selecionada pelo usuário.
CMFCColorPickerCtrl::GetLuminance Recupera o componente de luminância da cor selecionada pelo usuário.
CMFCColorPickerCtrl::GetSaturation Recupera o componente saturação da cor selecionada pelo usuário.
CMFCColorPickerCtrl::SelectCellHexagon Define a cor atual para a cor definida pelos componentes de cor RGB especificados ou o hexágono de célula especificado.
CMFCColorPickerCtrl::SetColor Define a cor atual como o valor de cor RGB especificado.
CMFCColorPickerCtrl::SetHLS Define a cor atual como o valor de cor HLS especificado.
CMFCColorPickerCtrl::SetHue Altera o componente matiz da cor selecionada no momento.
CMFCColorPickerCtrl::SetLuminance Altera o componente de luminância da cor selecionada no momento.
CMFCColorPickerCtrl::SetLuminanceBarWidth Define a largura da barra de luminância no controle seletor de cores.
CMFCColorPickerCtrl::SetOriginalColor Define a cor selecionada inicial.
CMFCColorPickerCtrl::SetPalette Define a paleta de cores atual.
CMFCColorPickerCtrl::SetSaturation Altera o componente de saturação da cor selecionada no momento.
CMFCColorPickerCtrl::SetType Define o tipo de controle de seletor de cores a ser exibido.

Métodos protegidos

Nome Descrição
CMFCColorPickerCtrl::DrawCursor Chamado pela estrutura antes que um cursor que aponte para a cor selecionada seja exibido.

Comentários

As cores padrão são selecionadas em uma paleta de cores hexagonal e as cores personalizadas são selecionadas em uma barra de luminância onde as cores são especificadas usando a notação vermelho/verde/azul ou a notação matiz/saturação/luminância.

A ilustração a seguir ilustra vários objetos CMFCColorPickerCtrl.

Caixa de diálogo CMFCColorPickerCtrl.

O CMFCColorPickerCtrl suporta dois pares de estilos. Os HEX estilos e HEX_GREYSCALE são apropriados para a seleção de cores padrão. Os PICKER estilos e LUMINANCE são apropriados para seleção de cores personalizadas.

Execute as seguintes etapas para incorporar o controle CMFCColorPickerCtrl à caixa de diálogo:

  1. Se você usar o ClassWizard, insira um novo controle de botão no modelo da caixa de diálogo (porque a classe CMFCColorPickerCtrl é herdada da classe CButton).

  2. Insira uma variável de membro associada ao novo controle de botão na classe da caixa de diálogo. Em seguida, altere o tipo de variável de CButton para CMFCColorPickerCtrl.

  3. Insira o manipulador de mensagens WM_INITDIALOG para a classe da caixa de diálogo. No manipulador, defina o tipo, a paleta e a cor inicial selecionada do controle CMFCColorPickerCtrl.

Hierarquia de herança

CObject
CCmdTarget
CWnd
CButton
CMFCColorPickerCtrl

Requisitos

Cabeçalho: afxcolorpickerctrl.h

CMFCColorPickerCtrl::CMFCColorPickerCtrl

Constrói um objeto CMFCColorPickerCtrl.

CMFCColorPickerCtrl();

Valor de retorno

Comentários

CMFCColorPickerCtrl::DrawCursor

Chamado pela estrutura antes que um cursor que aponte para a cor selecionada seja exibido.

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

Parâmetros

pDC
[in] Ponteiro para um contexto de dispositivo.

rect
[in] Especifica uma área retangular em torno da cor selecionada.

Comentários

Substitua esse método quando precisar alterar a forma do cursor que aponta para a cor selecionada.

CMFCColorPickerCtrl::GetColor

Recupera a cor selecionada pelo usuário.

COLORREF GetColor() const;

Valor de retorno

O valor RGB da cor selecionada.

Comentários

CMFCColorPickerCtrl::GetHLS

Recupera os valores de matiz, luminância e saturação da cor selecionada pelo usuário.

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

Parâmetros

hue
[out] Ponteiro para uma variável do tipo duplo que recebe informações de matiz.

luminance
[out] Ponteiro para uma variável do tipo duplo que recebe informações de luminância.

saturation
[out] Ponteiro para uma variável do tipo duplo que recebe informações de saturação.

Comentários

CMFCColorPickerCtrl::GetHue

Recupera o componente matiz da cor selecionada pelo usuário.

double GetHue() const;

Valor de retorno

O componente de matiz da cor selecionada.

Comentários

CMFCColorPickerCtrl::GetLuminance

Recupera o componente de luminância da cor selecionada pelo usuário.

double GetLuminance() const;

Valor de retorno

O componente de luminância da cor selecionada.

Comentários

CMFCColorPickerCtrl::GetSaturation

Recupera o valor de saturação da cor selecionada pelo usuário.

double GetSaturation() const;

Valor de retorno

O componente de saturação da cor selecionada.

Comentários

CMFCColorPickerCtrl::SelectCellHexagon

Define a cor atual para a cor definida pelos componentes de cor RGB especificados ou o hexágono de célula especificado.

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

BOOL SelectCellHexagon(
    int x,
    int y);

Parâmetros

R
[in] O componente de cor vermelha.

G
[in] O componente de cor verde.

B
[in] O componente de cor azul.

x
[in] A coordenada x do cursor, que aponta para um hexágono de célula.

y
[in] A coordenada y do cursor, que aponta para um hexágono de célula.

Valor de retorno

A segunda sobrecarga desse método sempre retorna FALSE.

Comentários

A primeira sobrecarga desse método define a cor atual como a cor que corresponde aos componentes de cor vermelho, verde e azul especificados pelo controle de seleção de cores.

A segunda sobrecarga desse método define a cor atual para a cor do hexágono de célula que é apontado pelo local do cursor especificado.

CMFCColorPickerCtrl::SetColor

Define a cor atual como o valor de cor RGB especificado.

void SetColor(COLORREF Color);

Parâmetros

Color
[in] Um valor de cor RGB.

Comentários

CMFCColorPickerCtrl::SetHLS

Define a cor atual como o valor de cor HLS especificado.

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

Parâmetros

hue
[in] Um valor matiz.

luminance
[in] Um valor de luminância.

saturation
[in] Um valor de saturação.

bInvalidate
[em] TRUE para forçar a janela a atualizar imediatamente para a nova cor; caso contrário, FALSE. O padrão é TRUE.

Comentários

CMFCColorPickerCtrl::SetHue

Altera a matiz da cor selecionada no momento.

void SetHue(double Hue);

Parâmetros

Hue
[in] Um valor matiz.

Comentários

CMFCColorPickerCtrl::SetLuminance

Altera a luminância da cor selecionada no momento.

void SetLuminance(double Luminance);

Parâmetros

Luminance
[in] Um valor de luminância.

Comentários

CMFCColorPickerCtrl::SetLuminanceBarWidth

Define a largura da barra de luminância no controle seletor de cores.

void SetLuminanceBarWidth(int w);

Parâmetros

w
[in] A largura da barra de luminância medida em pixels.

Comentários

Use este método para redimensionar a barra de luminância, que está na guia Personalizado do controle do seletor de cores. O w parâmetro especifica a nova largura da barra de luminância. O valor de largura será ignorado se exceder três quartos da largura da área do cliente.

CMFCColorPickerCtrl::SetOriginalColor

Define a cor selecionada inicial.

void SetOriginalColor(COLORREF ref);

Parâmetros

ref
[in] Um valor de cor RGB.

Comentários

Chame esse método quando o controle do seletor de cores for inicializado.

CMFCColorPickerCtrl::SetPalette

Define a paleta de cores atual.

void SetPalette(CPalette* pPalette);

Parâmetros

pPalette
[in] Ponteiro para uma paleta de cores.

Comentários

A paleta de cores define a matriz de cores que é apresentada no controle do seletor de cores.

CMFCColorPickerCtrl::SetSaturation

Altera a saturação da cor selecionada no momento.

void SetSaturation(double Saturation);

Parâmetros

Saturation
[in] Um valor de saturação.

Comentários

CMFCColorPickerCtrl::SetType

Define o tipo de controle de seletor de cores a ser exibido.

void SetType(COLORTYPE colorType);

Parâmetros

colorType
[in] Um tipo de controle de seletor de cor.

Os tipos são definidos pela enumeração CMFCColorPickerCtrl::COLORTYPE. Os tipos possíveis são LUMINANCE, PICKER, HEX e HEX_GREYSCALE. O tipo padrão é PICKER.

Comentários

Para especificar um tipo de controle de seletor de cores, chame esse método antes que o controle do Windows seja criado.

Confira também

Gráfico da hierarquia
Classes
Classe CMFCColorDialog