Função wglGetLayerPaletteEntries (wingdi.h)

Artigo
03/13/2024

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

Sintaxe

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

Parâmetros

unnamedParam1

Tipo: HDC

O contexto do dispositivo de uma janela cujos planos de camada devem ser descritos.

unnamedParam2

Tipo: int

A sobreposição ou plano de sobreposição. 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. Os valores negativos identificam planos de subposição, em que 1 é o primeiro plano de sobreposição 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 subposição é fornecido no membro bReserved da estrutura PIXELFORMATDESCRIPTOR .

unnamedParam3

Tipo: int

A primeira entrada de paleta a ser recuperada.

unnamedParam4

Tipo: int

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

unnamedParam5

Tipo: COLORREF*

Uma matriz de estruturas que contêm valores de cor RGB de paleta. A matriz deve conter pelo menos quantas estruturas forem especificadas por cEntries.

Retornar valor

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 quando 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 camada 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 perceber a paleta de camadas. Inicialmente, a paleta de camadas contém apenas entradas para branco.

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