Función SelectPalette (wingdi.h)

Artículo
08/27/2023

La función SelectPalette selecciona la paleta lógica especificada en un contexto de dispositivo.

Sintaxis

HPALETTE SelectPalette(
  [in] HDC      hdc,
  [in] HPALETTE hPal,
  [in] BOOL     bForceBkgd
);

Parámetros

[in] hdc

Identificador del contexto del dispositivo.

[in] hPal

Identificador de la paleta lógica que se va a seleccionar.

[in] bForceBkgd

Especifica si se obliga a que la paleta lógica sea una paleta de fondo. Si este valor es TRUE, la función RealizePalette hace que la paleta lógica se asigne a los colores que ya están en la paleta física de la mejor manera posible. Esto siempre se hace, incluso si la ventana para la que se realiza la paleta pertenece a un subproceso sin foco activo.

Si este valor es FALSE, RealizePalette hace que la paleta lógica se copie en la paleta de dispositivos cuando la aplicación se encuentra en primer plano. (Si el parámetro hdc es un contexto de dispositivo de memoria, este parámetro se omite).

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es un identificador de la paleta lógica anterior del contexto del dispositivo.

Si la función no se realiza correctamente, el valor devuelto es NULL.

Comentarios

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

Una aplicación puede seleccionar una paleta lógica en más de un contexto de dispositivo solo si los contextos de dispositivo son compatibles. De lo contrario , se produce un error en SelectPalette . Para crear un contexto de dispositivo compatible con otro contexto de dispositivo, llame a CreateCompatibleDC con el primer contexto de dispositivo como parámetro. Si se selecciona una paleta lógica en más de un contexto de dispositivo, los cambios en la paleta lógica afectarán a todos los contextos de dispositivo para los que está seleccionado.

Una aplicación podría llamar a la función SelectPalette con el parámetro bForceBackground establecido en TRUE si las ventanas secundarias de una ventana de nivel superior se dan cuenta de sus propias paletas. Sin embargo, solo la ventana secundaria que necesita darse cuenta de su paleta debe establecer bForceBackground en TRUE; otras ventanas secundarias deben establecer este valor en FALSE.

Requisitos

Requisito	Value
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