Méthode IDirectManipulationViewport::SetViewportTransform (directmanipulation.h)

Article
08/23/2023

Spécifie la transformation du système de coordonnées de la fenêtre en système de coordonnées du client de fenêtre.

Syntaxe

HRESULT SetViewportTransform(
  [in] const float *matrix,
  [in] DWORD       pointCount
);

Paramètres

[in] matrix

Matrice de transformation, dans l’ordre des lignes : _11, _12, _21, _22, _31, _32.

[in] pointCount

Taille de la matrice de transformation. Cette valeur est toujours 6, car une matrice 3x2 est utilisée pour toutes les transformations de manipulation directe.

Valeur retournée

Si la méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Notes

Appelez cette fonction pour spécifier la position, la mise à l’échelle et l’orientation de la fenêtre d’affichage à l’écran. La position, la mise à l’échelle, l’orientation et la taille de la fenêtre d’affichage sont déterminées de manière unique par la transformation de la fenêtre d’affichage et le rectangle de la fenêtre d’affichage. L’application peut spécifier la transformation de la fenêtre d’affichage à l’aide de cette méthode, et le rectangle de fenêtre d’affichage à l’aide de SetViewportRect.

Le rectangle de fenêtre d’affichage (la zone rectangulaire à l’intérieur du contenu visible par l’utilisateur) est spécifié dans les coordonnées de la fenêtre d’affichage. Si le point supérieur gauche du rectangle de fenêtre d’affichage est (0,0), le rectangle de la fenêtre d’affichage est positionné exactement à l’origine du système de coordonnées de la fenêtre d’affichage. Le décalage des fenêtres d’affichage par rapport à l’origine du système de coordonnées de la fenêtre d’affichage peut être spécifié de deux manières :

Via le rectangle de fenêtre d’affichage en haut à gauche
Via le composant de traduction de transformation de fenêtre d’affichage (_31, _32)

La transformation de la fenêtre d’affichage convertit le système de coordonnées de la fenêtre en système de coordonnées du client de fenêtre. La manipulation directe ignore la propriété RTL de la fenêtre, de sorte que l’origine de la zone cliente est toujours le point supérieur gauche. Les transformations sont appliquées dans l’ordre suivant :

Décalage du rectangle de fenêtre d’affichage
Transformation de la fenêtre d’affichage (de la fenêtre d’affichage au système de coordonnées client)
Mappage de client à écran (du client au système de coordonnées d’écran)

Spécifications


Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	directmanipulation.h

Voir aussi

IDirectManipulationViewport

Partager via