Méthode IXpsOMGradientBrush ::GetTransformLookup (xpsobjectmodel.h)

Article
08/28/2023

Obtient le nom de la clé de recherche de l’interface de transformation de matrice partagée qui doit être utilisée pour le pinceau.

Le nom de clé identifie une ressource partagée dans un dictionnaire de ressources.

Syntaxe

HRESULT GetTransformLookup(
  [out, retval] LPWSTR *key
);

Paramètres

[out, retval] key

Nom de la clé de recherche de l’interface de transformation de matrice partagée qui doit être utilisée pour le pinceau. Si le nom de la clé de recherche n’a pas été défini ou si la transformation de la matrice locale a été définie, un pointeur NULL est retourné.

La valeur retournée dans ce paramètre dépend de la méthode la plus récente appelée pour définir la clé de recherche ou la transformation.

Méthode la plus récente appelée	Chaîne retournée dans la clé
SetTransformLocal	Pointeur NULL .
SetTransformLookup	Clé définie par SetTransformLookup.
Ni SetTransformLocal ni SetTransformLookup n’ont encore été appelés.	Pointeur NULL .

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles incluent, sans s’y limiter, celles du tableau 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 clé est NULL.

Remarques

Cette méthode ne retourne pas de pointeur d’interface IXpsOMMatrixTransform ; pour récupérer ce pointeur à partir du dictionnaire, appelez IXpsOMDictionary ::GetByKey.

La transformation détermine la façon dont le dégradé est transformé. La partie visible du dégradé qui est finalement rendue dans l’image est déterminée par le tracé, le trait ou le glyphe qui utilise le pinceau dégradé.

Cette méthode alloue la mémoire utilisée par la chaîne retournée dans la clé. Si la clé n’est pas NULL, utilisez la fonction CoTaskMemFree pour libérer la mémoire.

Configuration requise


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 Platform Update pour Windows Server 2008 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	xpsobjectmodel.h