wingdi.h


GetSystemPaletteUse

La función GetSystemPaletteUse recupera el estado actual de la paleta (física) del sistema para el contexto de dispositivo especificado.

Sintaxis

UINT GetSystemPaletteUse(
    HDC hdc  // manipulador de contexto de dispositivo
   );	

Parámetros

hdc: identifica el contexto de dispositivo.

Valor de retorno

Si la función tiene éxito, el valor de retorno es el estado actual de la paleta del sistema. Puede ser cualquiera de los siguientes valores:

Valor Significado
SYSPAL_NOSTATIC La paleta del sistema contiene colores no estáticos, salvo el blanco y el negro.
SYSPAL_STATIC La paleta del sistema contiene colores estáticos que no pueden ser cambiados cuando una aplicación active su paleta lógica.
SYSPAL_ERROR El contexto de dispositivo dado es inválido o no soporta una paleta de colores.

Para obtener mayor información sobre el error, llamar a GetLastError.

Observaciones

Por defecto, la paleta del sistema contiene 20 colores estáticos que no pueden ser modificados cuando la aplicación activa su paleta lógica. Para obtener acceso a más de esos colores mediante la función SetSystemPaletteUse.

El contexto de dispositivo identificado por el parámetro hdc debe representar un dispositivo que soporte paletas de colores.

Para determinar si un dispositivo soporta operaciones de paleta se puede usar la función GetDeviceCaps, especificando la constante RASTERCAPS.