Función SelectPalette (wingdi.h)
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 |