Méthode IXpsOMSolidColorBrush ::SetColor (xpsobjectmodel.h)

Article
12/22/2023

Définit la valeur de couleur et le profil de couleur du pinceau.

Syntaxe

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

Paramètres

[in] color

Valeur de couleur du pinceau.

Si la valeur du champ colorType dans la structure XPS_COLOR passée dans ce paramètre est XPS_COLOR_TYPE_CONTEXT, un profil de couleur valide doit être fourni dans le paramètre colorProfile .

[in] colorProfile

Profil de couleur à utiliser avec la couleur.

Un profil de couleur est requis lorsque la valeur du champ colorType dans la structure XPS_COLOR passée dans le paramètre de couleur est XPS_COLOR_TYPE_CONTEXT. Si la valeur du champ colorType n’est pas XPS_COLOR_TYPE_CONTEXT, ce paramètre doit avoir la valeur NULL.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles incluent, sans s’y limiter, celles de la table qui suit. Pour plus d’informations sur les valeurs de retour de l’API de document XPS qui ne sont pas répertoriées dans ce tableau, consultez Erreurs de document XPS.

Code de retour	Description
S_OK	S_OK
E_POINTER	la couleur a la valeur NULL.
XPS_E_MISSING_COLORPROFILE	colorProfile a la valeur NULL lorsqu’un profil de couleur est attendu. Un profil de couleur est requis lorsque le type de couleur est XPS_COLOR_TYPE_CONTEXT.
XPS_E_UNEXPECTED_COLORPROFILE	colorProfile a un profil de couleur quand aucun n’est attendu. Un profil de couleur n’est autorisé que lorsque le type de couleur est XPS_COLOR_TYPE_CONTEXT.
XPS_E_NO_CUSTOM_OBJECTS	colorProfile ne pointe pas vers une implémentation d’interface reconnue. L’implémentation personnalisée des interfaces d’API document XPS n’est pas prise en charge.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2, Windows Server 2008 avec SP2 et Mise à jour de plateforme pour Windows Server 2008 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	xpsobjectmodel.h

Voir aussi

IXpsOMColorProfileResource

IXpsOMSolidColorBrush

XML Paper Specification

Erreurs de document XPS

XPS_COLOR

Partager via