Metodo IXpsOMVisualBrush::GetVisual (xpsobjectmodel.h)

Articolo
03/05/2024

Ottiene un puntatore all'interfaccia dell'oggetto visivo risolto da utilizzare come origine per il pennello.

Sintassi

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

Parametri

[out, retval] visual

Puntatore all'interfaccia IXpsOMVisual dell'oggetto visivo risolto usato come origine per il pennello. Se non è stato impostato un oggetto visivo, viene restituito un puntatore NULL .

Il valore restituito in questo parametro dipende dal metodo che è stato chiamato più di recente per impostare l'oggetto visivo.

Metodo più recente chiamato	Oggetto restituito nell'oggetto visivo
SetVisualLocal	Oggetto visivo impostato da SetVisualLocal.
SetVisualLookup	Oggetto visivo recuperato, con una chiave di ricerca corrispondente alla chiave impostata da SetVisualLookup, dalla directory delle risorse.
Non è stato ancora chiamato SetVisualLocal né SetVisualLookup .	Puntatore NULL .

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non solo, quelli nella tabella che segue. Per informazioni sui valori restituiti dell'API documento XPS non elencati in questa tabella, vedere Errori del documento XPS.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_POINTER	l'oggetto visivo è NULL.
XPS_E_LOOKUP_INVALID_TYPE	Il nome della chiave di ricerca impostato da SetStrokeBrushLookup fa riferimento a un oggetto che non è un pennello.
XPS_E_LOOKUP_NOT_FOUND	Non è possibile trovare alcun oggetto con un nome di chiave corrispondente al valore di ricerca.

Commenti

Questo metodo restituisce un puntatore all'interfaccia IXpsOMVisual . Il cmdlet
l'interfaccia restituita può essere qualsiasi interfaccia che eredita da IXpsOMVisual, ad esempio IXpsOMCanvas, IXpsOMPath e IXpsOMGlyphs.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	xpsobjectmodel.h