EngCreatePalette
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função envia uma solicitação para GDI para criar uma paleta.
Syntax
HPALETTE EngCreatePalette(
ULONG iMode,
ULONG cColors,
ULONG* pulColors,
FLONG flRed,
FLONG flGreen,
FLONG flBlue
);
Parameters
iMode
[no] Valor que especifica como definir a paleta.A seguinte tabela mostra valores possíveis para esse parâmetro.
Valor Descrição PAL_BITFIELDS
Os valores de flRed, flGreen, e flBlue Parâmetros definem a paleta.
PAL_BGR
O dispositivo aceita cores RGB diretamente, com azul como o byte menos significativo.
PAL_CMYK
O dispositivo aceita cores CMYK diretamente, com ciano como o byte menos significativo.
PAL_INDEXED
Os valores de cColors e pulColors Parâmetros fornecem uma matriz de cores RGB.
PAL_RGB
O dispositivo aceita cores RGB diretamente, com vermelho como o byte menos significativo.
- cColors
[no] Se o valor da iMode parâmetro é PAL_INDEXED, número de cores fornecidas a matriz apontado pelos parâmetros pulColors. Caso contrário, definir esse parâmetro para zero.
- pulColors
[no] Se o valor da iMode parâmetro é PAL_INDEXED, ponteiro para o início de uma matriz de valores ULONG. A baixa-ordem 3 bytes de cada ULONG definir as cores RGB na paleta.
- flRed
[no] Se o valor da iMode parâmetro é PAL_BITFIELDS, máscara que mostra quais bits corresponder para vermelho. Cada máscara deve consistir contíguo bits e deve não sobreposição outras máscaras. GDI oferece suporte a todas as combinações de bitfields.
- flGreen
[no] Se o valor da iMode parâmetro é PAL_BITFIELDS, máscara que mostra quais bits corresponder para verde. Cada máscara deve consistir contíguo bits e deve não sobreposição outras máscaras. GDI oferece suporte a todas as combinações de bitfields.
- flBlue
[no] Se o valor da iMode parâmetro é PAL_BITFIELDS, máscara que mostra quais bits corresponder para azul. Cada máscara deve consistir contíguo bits e deve não sobreposição outras máscaras. GDI oferece suporte a todas as combinações de bitfields.
Return Value
Essa função retorna um identificador para a nova paleta se chamar a função é bem-sucedida. Caso contrário, a função retorna zero e faz um código de erro.
Remarks
O driver pode associar a nova paleta com um dispositivo, retornando um ponteiro para a paleta in a DEVINFO estrutura.
Uma paleta PAL_INDEXED associado com o dispositivo deve ter sua primeira entrada índice definida para sua última entrada definido como branco e preto. Defina as cores para as outras entradas para que a cor de cada entrada bastante contrasta com a cor do seu índice complementar. De exemplo, se você definir entrada 0x9 de 16-entrada paleta para verde, definir entrada 0 x 6 para uma cor que contrasta com verde, such as roxo. Se você definir cores de entradas dessa maneira, as operações de varredura XOR se comportam razoável.
Requirements
| Header | winddi.h |
| Library | Ddi_ati_lib.lib, Ddi_flat_lib.lib, Ddi_gx_lib.lib, Ddi_mq200_lib.lib, Ddi_nop_lib.lib, Ddi_rflat_lib.lib, Ddi_rgx_lib.lib, Ddi_tvia5_lib.lib |
| Windows Embedded CE | Windows CE 1.0 and later |