Método Bitmap::InitializePalette (gdiplusheaders.h)

Artigo
02/01/2024

O método Bitmap::InitializePalette inicializa uma paleta de cores padrão, ideal ou personalizada.

Sintaxe

Status InitializePalette(
  [in, out] ColorPalette *palette,
  [in]      PaletteType  palettetype,
  [in]      INT          optimalColors,
  [in]      BOOL         useTransparentColor,
  [in]      Bitmap       *bitmap
);

Parâmetros

[in, out] palette

Tipo: ColorPalette*

Ponteiro para um buffer que contém uma estrutura ColorPalette seguida por uma matriz de valores ARGB . Você deve definir os membros Flags e Count da estrutura ColorPalette . O membro Entries de uma estrutura ColorPalette é uma matriz de um valor ARGB . Você deve alocar memória para a estrutura ColorPalette e para os valores ARGB adicionais na paleta. Por exemplo, se a paleta tiver 36 valores ARGB , aloque um buffer da seguinte maneira: malloc(sizeof(ColorPalette) + 35*sizeof(ARGB)).

[in] palettetype

Tipo: PaletteType

Elemento da enumeração PaletteType que especifica o tipo de paleta. A paleta pode ter um dos vários tipos padrão ou pode ser uma paleta personalizada que você define. Além disso, o método Bitmap::InitializePalette pode criar uma paleta ideal com base em um bitmap especificado.

[in] optimalColors

Tipo: INT

Inteiro que especifica o número de cores que você deseja ter em uma paleta ideal com base em um bitmap especificado. Se esse parâmetro for maior que 0, o parâmetro palettetype deverá ser definido como PaletteTypeOptimal e o parâmetro bitmap deverá apontar para um objeto Bitmap . Se você estiver criando uma paleta padrão ou personalizada em vez de uma paleta ideal, defina esse parâmetro como 0.

[in] useTransparentColor

Tipo: BOOL

Valor booliano que especifica se a cor transparente deve ser incluída na paleta. Defina como TRUE para incluir a cor transparente; caso contrário , FALSE.

[in] bitmap

Tipo: Bitmap*

Ponteiro para um objeto Bitmap para o qual uma paleta ideal será criada. Se palettetype for definido como PaletteTypeOptimal e optimalColors for definido como um inteiro positivo, defina esse parâmetro como o endereço de um objeto Bitmap . Caso contrário, defina esse parâmetro como NULL.

Retornar valor

Tipo: Status

Se o método for bem-sucedido, ele retornará Ok, que é um elemento da enumeração Status .

Se o método falhar, ele retornará um dos outros elementos da enumeração Status .

Requisitos


Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	gdiplusheaders.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll

Confira também

Bitmap

Compartilhar via