Função wglSetLayerPaletteEntries (wingdi.h)

Artigo
08/27/2023

Define as entradas de paleta em um determinado plano de camada de índice de cores para um contexto de dispositivo especificado.

Sintaxe

int wglSetLayerPaletteEntries(
  HDC            unnamedParam1,
  int            unnamedParam2,
  int            unnamedParam3,
  int            unnamedParam4,
  const COLORREF *unnamedParam5
);

Parâmetros

unnamedParam1

Tipo: HDC

O contexto do dispositivo de uma janela cuja paleta de camadas deve ser definida.

unnamedParam2

Tipo: int

Uma sobreposição ou plano de sobreposição. Os valores positivos de iLayerPlane identificam planos de sobreposição, em que 1 é o primeiro plano de sobreposição sobre o plano main, 2 é o segundo plano de sobreposição sobre o primeiro plano de sobreposição e assim por diante. Valores negativos identificam planos de subposição, em que 1 é o primeiro plano de base sob o plano main, 2 é o segundo plano de sobreposição sob o primeiro plano de sobreposição e assim por diante. O número de planos de sobreposição e de subposição é fornecido no membro bReserved da estrutura PIXELFORMATDESCRIPTOR .

unnamedParam3

Tipo: int

A primeira entrada de paleta a ser definida.

unnamedParam4

Tipo: int

O número de entradas de paleta a serem definidas.

unnamedParam5

Tipo: const COLORREF*

Um ponteiro para o primeiro membro de uma matriz de estruturas cEntries que contêm informações de cor RGB.

Valor retornado

Tipo: int

Se a função for bem-sucedida, o valor retornado será o número de entradas que foram definidas na paleta no plano de camada especificado da janela. Se a função falhar ou nenhum formato de pixel for selecionado, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Cada plano de índice de cores em uma janela tem uma paleta com um tamanho 2^n, em que n é o número de planos de bits no plano de camada. Não é possível modificar o índice transparente de uma paleta.

Use a função wglRealizeLayerPalette para realizar a paleta de camadas. Inicialmente, a paleta de camadas contém apenas entradas para branco.

A função wglSetLayerPaletteEntries não define as entradas de paleta da paleta de planos main. Para atualizar a paleta de planos main, use funções de paleta GDI.

Requisitos


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]
Plataforma de Destino	Windows
Cabeçalho	wingdi.h
Biblioteca	Opengl32.lib
DLL	Opengl32.dll