Compartilhar via


CDC::SelectPalette

Seleciona a paleta lógica que é especificado por pPalette como o objeto selecionado de paleta o contexto de dispositivo.

CPalette* SelectPalette(
   CPalette* pPalette,
   BOOL bForceBackground 
);

Parâmetros

  • pPalette
    Identifica a lógica paleta seja selecionada.Esta paleta já deve ter sido criada com a função de membro CreatePalettede CPalette .

  • bForceBackground
    Especifica se a paleta lógica é forçada para ser uma paleta em segundo plano.Se bForceBackground é diferente de zero, a paleta selecionada é sempre uma paleta em segundo plano, independentemente da janela tem o foco de entrada.Se bForceBackground é 0 e o contexto de dispositivo está conectado a uma janela, a paleta lógica é uma paleta de primeiro plano quando a janela tem o foco de entrada.

Valor de retorno

Um ponteiro para um objeto de CPalette que identifica a lógica paleta substituída pela paleta especificada por pPalette.É NULO se houver um erro.

Comentários

A nova paleta torna-se o objeto de paleta usado por GDI cores de controle exibidas no contexto de dispositivo e substitui a paleta anterior.

Um aplicativo pode selecionar uma paleta lógica em mais de um contexto de dispositivo.Em o entanto, as alterações a uma paleta lógica afetará todos os contextos de dispositivo para que está selecionada.Se um aplicativo seleciona uma paleta em mais de um contexto de dispositivo, todos os contextos de dispositivo deve pertencer ao mesmo dispositivo físico.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

CDC Class

Gráfico de hierarquia

CDC::RealizePalette

Classe de CPalette

SelectPalette