CMFCColorPickerCtrl Class

A CMFCColorPickerCtrl classe fornece funcionalidade para um controlo que é usado para selecionar cores.

Sintaxe

class CMFCColorPickerCtrl : public CButton

Membros

Construtores Públicos

Métodos Públicos

Métodos Protegidos

Observações

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

A ilustração seguinte representa vários CMFCColorPickerCtrl objetos.

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

Execute os seguintes passos para incorporar o controlo CMFCColorPickerCtrl na sua caixa de diálogo:

1. Se usares o ClassWizard, insere um novo controlo de botão no modelo da tua caixa de diálogo (porque a CMFCColorPickerCtrl classe é herdada da CButton classe).

2. Insera uma variável membro associada ao novo controlo de botão na sua classe de caixa de diálogo. Depois altera o tipo de variável de CButton para CMFCColorPickerCtrl.

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

Hierarquia de herança

CObject
CCmdTarget
CWnd
CButton
CMFCColorPickerCtrl

Requerimentos

Cabeçalho:afxcolorpickerctrl.h

CMFCColorPickerCtrl::CMFCColorPickerCtrl

Constrói um CMFCColorPickerCtrl objeto.

CMFCColorPickerCtrl();

Valor de retorno

Observações

CMFCColorPickerCtrl::DrawCursor

Chamado pela estrutura antes de um cursor que aponta para a cor selecionada ser exibido.

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

Parâmetros

pDC
[dentro] Apontador para o contexto de um dispositivo.

rect
[dentro] Especifica uma área retangular em redor da cor selecionada.

Observações

Anule este método quando precisar de mudar a forma do cursor que aponta para a cor selecionada.

CMFCColorPickerCtrl::GetColor

Recupera a cor que o utilizador seleciona.

COLORREF GetColor() const;

Valor de retorno

O valor RGB da cor selecionada.

Observações

CMFCColorPickerCtrl::GetHLS

Recupera os valores de matiz, luminância e saturação da cor que o utilizador seleciona.

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

Parâmetros

hue
[fora] Apontador para uma variável de tipo duplo que recebe informação de matiz.

luminance
[fora] Apontador para uma variável do tipo duplo que recebe informação de luminância.

saturation
[fora] Aponta para uma variável do tipo double que recebe informação de saturação.

Observações

CMFCColorPickerCtrl::GetHue

Recupera o componente de matiz da cor que o utilizador seleciona.

double GetHue() const;

Valor de retorno

O componente de matiz da cor selecionada.

Observações

CMFCColorPickerCtrl::GetLuminance

Recupera o componente de luminância da cor que o utilizador seleciona.

double GetLuminance() const;

Valor de retorno

O componente de luminância da cor selecionada.

Observações

CMFCColorPickerCtrl::GetSaturation

Recupera o valor de saturação da cor que o utilizador seleciona.

double GetSaturation() const;

Valor de retorno

O componente de saturação da cor selecionada.

Observações

CMFCColorPickerCtrl::SelectCellHexagon

Define a cor atual para a cor definida pelos componentes de cor RGB especificados ou pelo hexágono da célula especificada.

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

BOOL SelectCellHexagon(
    int x,
    int y);

Parâmetros

R
[dentro] O componente da cor vermelha.

G
[dentro] O componente de cor verde.

B
[dentro] O componente da cor azul.

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

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

Valor de retorno

A segunda sobrecarga deste método devolve sempre FALSE.

Observações

A primeira sobrecarga deste método define a cor atual para a cor que corresponde aos componentes de cor vermelho, verde e azul especificados pelo controlo de seleção de cor.

A segunda sobrecarga deste método define a cor atual para a cor do hexágono da célula apontada pela localização especificada do cursor.

CMFCColorPickerCtrl::SetColor

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

void SetColor(COLORREF Color);

Parâmetros

Color
[dentro] Um valor de cor RGB.

Observações

CMFCColorPickerCtrl::SetHLS

Define a cor atual para o valor de cor especificado no HLS.

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

Parâmetros

hue
[dentro] Um valor de tonalidade.

luminance
[dentro] Um valor de luminância.

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

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

Observações

CMFCColorPickerCtrl::SetHue

Altera o tom da cor selecionada no momento.

void SetHue(double Hue);

Parâmetros

Hue
[dentro] Um valor de tonalidade.

Observações

CMFCColorPickerCtrl::SetLuminance

Altera a luminância da cor selecionada no momento.

void SetLuminance(double Luminance);

Parâmetros

Luminance
[dentro] Um valor de luminância.

Observações

CMFCColorPickerCtrl::SetLuminanceBarWidth

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

void SetLuminanceBarWidth(int w);

Parâmetros

w
[dentro] A largura da barra de luminância medida em píxeis.

Observações

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

CMFCColorPickerCtrl::SetOriginalColor

Define a cor inicial selecionada.

void SetOriginalColor(COLORREF ref);

Parâmetros

ref
[dentro] Um valor de cor RGB.

Observações

Chame este método quando o controlo do seletor de cor for inicializado.

CMFCColorPickerCtrl::SetPalette

Define a paleta de cores atual.

void SetPalette(CPalette* pPalette);

Parâmetros

pPalette
[dentro] Aponta para uma paleta de cores.

Observações

A paleta de cores define o array de cores apresentado no controlo do seletor de cores.

CMFCColorPickerCtrl::SetSaturation

Altera a saturação da cor atualmente selecionada.

void SetSaturation(double Saturation);

Parâmetros

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

Observações

CMFCColorPickerCtrl::SetType

Define o tipo de controlo do seletor de cor para exibir.

void SetType(COLORTYPE colorType);

Parâmetros

colorType
[dentro] Um tipo de controlo de seletor de cores.

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

Observações

Para especificar um tipo de controlo de seletor de cor, chame este método antes de o controlo Windows ser criado.

Consulte também

Gráfico de Hierarquia
Classes
CMFCColorDialog Classe