Función RealizePalette (wingdi.h)

La función RealizePalette asigna entradas de paleta de la paleta lógica actual a la paleta del sistema.

Sintaxis

UINT RealizePalette(
  [in] HDC hdc
);

Parámetros

[in] hdc

Identificador del contexto del dispositivo en el que se ha seleccionado una paleta lógica.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es el número de entradas de la paleta lógica asignada a la paleta del sistema.

Si se produce un error en la función, el valor devuelto es GDI_ERROR.

Comentarios

Una aplicación puede determinar si un dispositivo admite operaciones de paleta llamando a la función GetDeviceCaps y especificando la constante RASTERCAPS.

La función RealizePalette modifica la paleta del dispositivo asociado al contexto de dispositivo especificado. Si el contexto del dispositivo es un controlador de dominio de memoria, se modifica la tabla de colores del mapa de bits seleccionado en el controlador de dominio. Si el contexto del dispositivo es un controlador de dominio de pantalla, se modifica la paleta física de ese dispositivo.

Una paleta lógica es un búfer entre aplicaciones de uso intensivo de colores y el sistema, lo que permite a estas aplicaciones usar tantos colores como sea necesario sin interferir con los colores mostrados por otras ventanas.

Cuando la ventana de una aplicación tiene el foco y llama a la función RealizePalette , el sistema intenta obtener la mayor cantidad de colores solicitados posible. Lo mismo también es cierto para las aplicaciones con ventanas inactivas.

Requisitos

Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wingdi.h (incluye Windows.h)
Library	Gdi32.lib
Archivo DLL	Gdi32.dll

Consulte también

Funciones de color

Introducción a los colores

CreatePalette

GetDeviceCaps

SelectPalette