IXpsOMSolidColorBrush::SetColor-Methode (xpsobjectmodel.h)

Artikel
03/13/2024

Legt den Farbwert und das Farbprofil des Pinsels fest.

Syntax

HRESULT SetColor(
  [in] const XPS_COLOR            *color,
  [in] IXpsOMColorProfileResource *colorProfile
);

Parameter

[in] color

Der Farbwert des Pinsels.

Wenn der Wert des Felds colorType in der XPS_COLOR-Struktur , die in diesem Parameter übergeben wird, XPS_COLOR_TYPE_CONTEXT ist, muss im colorProfile-Parameter ein gültiges Farbprofil angegeben werden.

[in] colorProfile

Das Farbprofil, das mit Farbe verwendet werden soll.

Ein Farbprofil ist erforderlich, wenn der Wert des Felds colorType in der XPS_COLOR-Struktur , die im farbparameter übergeben wird , XPS_COLOR_TYPE_CONTEXT wird. Wenn der Wert des Felds colorType nicht XPS_COLOR_TYPE_CONTEXT ist, muss dieser Parameter auf NULL festgelegt werden.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliche Werte sind unter anderem die Werte in der folgenden Tabelle. Informationen zu XPS-Dokument-API-Rückgabewerten, die in dieser Tabelle nicht aufgeführt sind, finden Sie unter XPS-Dokumentfehler.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_POINTER	farbe ist NULL.
XPS_E_MISSING_COLORPROFILE	colorProfile ist NULL , wenn ein Farbprofil erwartet wird. Ein Farbprofil ist erforderlich, wenn der Farbtyp XPS_COLOR_TYPE_CONTEXT ist.
XPS_E_UNEXPECTED_COLORPROFILE	colorProfile verfügt über ein Farbprofil, wenn keines erwartet wird. Ein Farbprofil ist nur zulässig, wenn der Farbtyp XPS_COLOR_TYPE_CONTEXT ist.
XPS_E_NO_CUSTOM_OBJECTS	colorProfile verweist nicht auf eine erkannte Schnittstellenimplementierung. Die benutzerdefinierte Implementierung von XPS-Dokument-API-Schnittstellen wird nicht unterstützt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	xpsobjectmodel.h

Weitere Informationen

IXpsOMColorProfileResource

IXpsOMSolidColorBrush

XML Paper Specification

XPS-Dokumentfehler

XPS_COLOR

Freigeben über