IWICPalette::InitializePredefined-Methode (wincodec.h)
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 |