Compartilhar via


CreatePalette (GDI)

Windows Mobile SupportedWindows Embedded CE Supported

9/9/2008

Essa função cria um paleta de cores lógico.

Syntax

HPALETTE CreatePalette( 
  CONST LOGPALETTE* lplgpl
);

Parameters

  • lplgpl
    [no] Ponteiro longo para um LOGPALETTE estrutura que contém informações sobre as cores da paleta lógica.

Return Value

Um identificador que identifica uma paleta lógica indica sucesso. NULL Indica falha. Para informações de erro estendidas get, chamar GetLastError.

Remarks

Um aplicativo pode determinar se um dispositivo oferece suporte a operações paleta por chamado de GetDeviceCaps função e especificando a constante RASTERCAPS.

Depois que um aplicativo cria uma paleta lógica, ele pode selecionar que paleta em um contexto dispositivo, chamado de SelectPalette função. Uma paleta selecionada em um contexto dispositivo pode ser realizada por chamado de RealizePalette função.

Quando você mais necessário a paleta, chamar o ExcluirObjeto função para excluí-lo.

Porque Windows Embedded CE não arbitrate entre as paletas da primeiro plano e segundo plano aplicativos, as paletas não são automaticamente preenchidos com cores sistema Windows. Portanto, o número de entradas cor na paleta criada por essa função é sempre igual a palNumEntriesmembro das LOGPALETTE estrutura*.*

Requirements

Header windows.h
Library coredll.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

DeleteObject
GetDeviceCaps
RealizePalette
SelectPalette
LOGPALETTE
GDI Functions