IWICPalette::InitializePredefined-Methode (wincodec.h)

  • Artikel

Initialisiert die Palette in einer der vordefinierten Paletten, die von WICBitmapPaletteType angegeben werden, und fügt optional eine transparente Farbe hinzu.

Syntax

HRESULT InitializePredefined(
  [in] WICBitmapPaletteType ePaletteType,
  [in] BOOL                 fAddTransparentColor
);

Parameter

[in] ePaletteType

Typ: WICBitmapPaletteType

Der gewünschte vordefinierte Palettentyp.

[in] fAddTransparentColor

Typ: BOOL

Die optionale transparente Farbe, die der Palette hinzugefügt werden soll. Wenn keine transparente Farbe erforderlich ist, verwenden Sie 0. Legen Sie bei der Initialisierung auf eine Graustufen- oder Schwarzweißpalette diesen Parameter auf FALSE fest.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn einer Palette eine transparente Farbe hinzugefügt wird, ist die Palette nicht mehr vordefiniert und wird als WICBitmapPaletteTypeCustom zurückgegeben. Für Paletten mit weniger als 256 Einträgen wird der transparente Eintrag am Ende der Palette hinzugefügt (d. a. eine 16-Farbpalette wird zu einer 17-Farbpalette). Bei Paletten mit 256 Farben ersetzt der Transparente Paletteneintrag den letzten Eintrag in der vordefinierten Palette.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP mit SP2, Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile wincodec.h
Bibliothek Windowscodecs.lib
DLL Windowscodecs.dll