IDCompositionVisual ::SetTransformParent, méthode (dcomp.h)

Définit la propriété TransformParent de ce visuel. La propriété TransformParent établit le système de coordonnées par rapport auquel ce visuel est composé.

Syntaxe

HRESULT SetTransformParent(
  [in, optional] IDCompositionVisual *visual
);

Paramètres

[in, optional] visual

Type : IDCompositionVisual*

Nouveau visuel qui établit le système de coordonnées de base pour ce visuel. Ce paramètre peut être NULL.

Valeur retournée

Type : HRESULT

Si la fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT. Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur DirectComposition .

Remarques

Le système de coordonnées d’un visuel est modifié par les propriétés OffsetX, OffsetY et Transform. Normalement, ces propriétés définissent le système de coordonnées d’un visuel par rapport à son parent immédiat. Cette méthode spécifie le visuel par rapport auquel le système de coordonnées de ce visuel est basé. Le visuel spécifié doit être un ancêtre du visuel actuel. S’il ne s’agit pas d’un ancêtre, le système de coordonnées est basé sur le parent immédiat de ce visuel, comme si la propriété TransformParent était définie sur NULL. Étant donné que les visuels peuvent être réparentés, cette propriété peut prendre effet à nouveau si le visuel spécifié devient un ancêtre du visuel cible par le biais d’une opération de réparentation.

Si le paramètre visuel a la valeur NULL, le système de coordonnées est toujours transformé par rapport au parent immédiat du visuel. Il s’agit du comportement par défaut si cette méthode n’est pas utilisée.

Cette méthode échoue si le paramètre visuel est un pointeur non valide ou s’il n’a pas été créé par la même interface IDCompositionDevice que ce visuel. L’interface ne peut pas être une implémentation personnalisée ; seules les interfaces créées par Microsoft DirectComposition peuvent être utilisées avec cette méthode.

Configuration requise

Voir aussi

IDCompositionVisual