IXpsOMVisualBrush::GetVisual-Methode (xpsobjectmodel.h)

Artikel
08/28/2023

Ruft einen Zeiger auf die Schnittstelle des aufgelösten Visuals ab, das als Quelle für den Pinsel verwendet werden soll.

Syntax

HRESULT GetVisual(
  [out, retval] IXpsOMVisual **visual
);

Parameter

[out, retval] visual

Ein Zeiger auf die IXpsOMVisual-Schnittstelle des aufgelösten visuellen Objekts, das als Quelle für den Pinsel verwendet wird. Wenn kein Visual festgelegt wurde, wird ein NULL-Zeiger zurückgegeben.

Der in diesem Parameter zurückgegebene Wert hängt davon ab, welche Methode zuletzt aufgerufen wurde, um das visuelle Objekt festzulegen.

Neueste Methode namens	Objekt, das in visual zurückgegeben wird
SetVisualLocal	Das Visual, das von SetVisualLocal festgelegt wird.
SetVisualLookup	Das Visual, das abgerufen wird, mit einem Suchschlüssel, der dem schlüssel entspricht, der von SetVisualLookup festgelegt wird, aus dem Ressourcenverzeichnis.
Weder SetVisualLocal noch SetVisualLookup wurden noch aufgerufen.	NULL-Zeiger .

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	visual ist NULL.
XPS_E_LOOKUP_INVALID_TYPE	Der von SetStrokeBrushLookup festgelegte Nachschlageschlüsselname verweist auf ein Objekt, das kein Pinsel ist.
XPS_E_LOOKUP_NOT_FOUND	Es konnte kein Objekt mit einem Schlüsselnamen gefunden werden, der dem Nachschlagewert entsprach.

Hinweise

Diese Methode gibt einen IXpsOMVisual-Schnittstellenzeiger zurück. Allerdings kann das
die zurückgegebene Schnittstelle kann eine beliebige Schnittstelle sein, die von IXpsOMVisual erbt, z. B. IXpsOMCanvas, IXpsOMPath und IXpsOMGlyphen.

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