Partilhar via


Mensagem SETRGBSTRING

O procedimento de gancho de uma caixa de diálogo Cor , CCHookProc, pode enviar a mensagem registrada SETRGBSTRING para a caixa de diálogo para definir a seleção de cores atual.

#define SETRGBSTRING TEXT("commdlg_SetRGBColor")

Parâmetros

wParam

Este parâmetro não é usado.

lParam

O valor RGB da cor a ser selecionada na caixa de diálogo Cor . Você pode usar a macro RGB para especificar as intensidades vermelha, verde e azul de um valor de cor RGB.

Valor retornado

Esta mensagem não tem nenhum valor retornado.

Comentários

Se lParam corresponder a uma das cores básicas ou uma das 16 cores personalizadas, o procedimento da caixa de diálogo selecionará essa cor. O procedimento da caixa de diálogo também atualiza todos os controles na extensão de cor personalizada da caixa de diálogo Cor , se ela estiver aberta.

Se lParam não corresponder a uma cor básica ou personalizada, o procedimento da caixa de diálogo não alterará a seleção de cores atual, mas atualizará os controles de cores personalizados, se eles estiverem visíveis.

Exemplos

O código de exemplo a seguir obtém o identificador de mensagem SETRGBSTRING e define a seleção de cores como azul.

UINT uiSetRGB;

uiSetRGB = RegisterWindowMessage(SETRGBSTRING);

SendMessage(hdlg, uiSetRGB, 0, (LPARAM) RGB(0, 0, 255)); 

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho
Commdlg.h (inclua Windows.h)
Nomes Unicode e ANSI
SETRGBSTRINGW (Unicode) e SETRGBSTRINGA (ANSI)

Confira também

Referência

Registerwindowmessage

RGB

Sendmessage

Conceitual

Biblioteca de caixas de diálogo comuns