Metodo IXpsOMGradientStop::SetColor (xpsobjectmodel.h)

Articolo
03/05/2024

Imposta il valore del colore e il profilo di colore dell'arresto sfumatura.

Sintassi

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

Parametri

[in] color

Valore del colore da impostare in corrispondenza dell'arresto sfumatura.

Se il valore del campo colorType nella struttura XPS_COLOR passata in questo parametro è XPS_COLOR_TYPE_CONTEXT, è necessario specificare un profilo di colore valido nel parametro colorProfile .

[in] colorProfile

Profilo di colore da usare con il colore.

È necessario un profilo di colore quando il valore del campo colorType nella struttura XPS_COLOR passata nel parametro colore è XPS_COLOR_TYPE_CONTEXT. Se il valore del campo colorType non è XPS_COLOR_TYPE_CONTEXT, questo parametro deve essere impostato su NULL.

Valore restituito

Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a quelli della tabella che segue. Per informazioni sui valori restituiti dall'API documento XPS non elencati in questa tabella, vedere Errori del documento XPS.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_POINTER	il colore è NULL.
XPS_E_MISSING_COLORPROFILE	colorProfile è NULL quando è previsto un profilo di colore. È necessario un profilo di colore quando il tipo di colore è XPS_COLOR_TYPE_CONTEXT.
XPS_E_NO_CUSTOM_OBJECTS	colorProfile non punta a un'implementazione dell'interfaccia riconosciuta. L'implementazione personalizzata delle interfacce API documento XPS non è supportata.
XPS_E_UNEXPECTED_COLORPROFILE	colorProfile contiene un profilo di colore quando non è previsto. Un profilo di colore è consentito solo quando il tipo di colore è XPS_COLOR_TYPE_CONTEXT.

Commenti

È necessario un profilo di colore solo quando il tipo di colore è XPS_COLOR_TYPE_CONTEXT.

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

Vedi anche

IXpsOMColorProfileResource

IXpsOMGradientStop

XML Paper Specification

Errori del documento XPS

XPS_COLOR

Condividi tramite