Fonction ModifyWorldTransform (wingdi.h)

Article
08/27/2023

La fonction ModifyWorldTransform modifie la transformation du monde pour un contexte d’appareil à l’aide du mode spécifié.

Syntaxe

BOOL ModifyWorldTransform(
  [in] HDC         hdc,
  [in] const XFORM *lpxf,
  [in] DWORD       mode
);

Paramètres

[in] hdc

Handle dans le contexte de l’appareil.

[in] lpxf

Pointeur vers une structure XFORM utilisée pour modifier la transformation du monde pour le contexte d’appareil donné.

[in] mode

Spécifie la façon dont les données de transformation modifient la transformation mondiale actuelle. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
MWT_IDENTITY	Réinitialise la transformation mondiale actuelle à l’aide de la matrice d’identité. Si ce mode est spécifié, la structure XFORM pointée vers lpXform est ignorée.
MWT_LEFTMULTIPLY	Multiplie la transformation actuelle par les données de la structure XFORM . (Les données de la structure XFORM deviennent le multiplicand gauche, et les données de la transformation actuelle deviennent le multiplicand droit.)
MWT_RIGHTMULTIPLY	Multiplie la transformation actuelle par les données de la structure XFORM . (Les données de la structure XFORM deviennent le multiplicand droit et les données de la transformation actuelle deviennent le multiplicand gauche.)

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro.

Remarques

La fonction ModifyWorldTransform échoue, sauf si le mode graphique du contexte d’appareil spécifié a été défini sur GM_ADVANCED en appelant précédemment la fonction SetGraphicsMode . De même, il ne sera pas possible de réinitialiser le mode graphique pour le contexte de l’appareil au mode GM_COMPATIBLE par défaut, sauf si la transformation du monde a d’abord été réinitialisée à la transformation d’identité par défaut en appelant SetWorldTransform ou ModifyWorldTransform.

Configuration requise


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wingdi.h (inclure Windows.h)
Bibliothèque	Gdi32.lib
DLL	Gdi32.dll