IBitmapImage::SetPalette
.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.")
.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
Este método define a paleta de cores associado com um imagem de bitmap.
Syntax
HRESULT SetPalette(
const ColorPalette* palette
);
Parameters
paleta
[no] Um ponteiro para um ColorPalette estrutura contendo dados para novo paleta de cores do imagem de bitmap.O IBitmapImage::SetPalette método faz uma copiar da paleta e anexa-lo para o imagem de bitmap.
Return Value
Se bem-sucedido, esse método Retorna S_OK.
Se ele falhar, esse método deve retornar uma dos seguinte valores de erro:
- IMGERR_OBJECTBUSY
- E_INVALIDARG
- E_OUTOFMEMORY
Para obter mais informações, consulte Códigos de erro para o Imaging API.
Remarks
O seguinte indexados pixel cor formatos são para uma imagem de bitmap que requer um paleta de cores.
- PixelFormat1bppIndexed
- PixelFormat4bppIndexed
- PixelFormat8bppIndexed
Se nenhum formato pixel é especificado para o imagem de bitmap, o IBitmapImage::SetPalette método escolhe um apropriado paleta de cores usar como padrão.
Um paleta de cores é opcional para imagens bitmap em pixel formata diferente dos listados acima.
Se um paleta de cores for fornecido, essa paleta pode ser usada quando o imagem de bitmap é exibida em um contexto de elementos gráficos indexados cor ou quando a imagem é convertida em um formato pixel indexado cor.
Requirements
| Header | imaging.h |
| Library | Imaging.lib |
| Windows Embedded CE | Windows CE 5.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |