ModifyWorldTransform-Funktion (wingdi.h)

Artikel
08/27/2023

Die Funktion ModifyWorldTransform ändert die Welttransformation für einen Gerätekontext im angegebenen Modus.

Syntax

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

Parameter

[in] hdc

Ein Handle für den Gerätekontext.

[in] lpxf

Ein Zeiger auf eine XFORM-Struktur , die zum Ändern der Welttransformation für den jeweiligen Gerätekontext verwendet wird.

[in] mode

Gibt an, wie die Transformationsdaten die aktuelle Welttransformation ändern. Dieser Parameter muss einen der folgenden Werte aufweisen.

Wert	Bedeutung
MWT_IDENTITY	Setzt die aktuelle Welttransformation mithilfe der Identitätsmatrix zurück. Wenn dieser Modus angegeben wird, wird die XFORM-Struktur ignoriert, auf die von lpXform verwiesen wird.
MWT_LEFTMULTIPLY	Multipliziert die aktuelle Transformation mit den Daten in der XFORM-Struktur . (Die Daten in der XFORM-Struktur werden zum linken Multiplizierer, und die Daten für die aktuelle Transformation werden zum rechten Multiplizierer.)
MWT_RIGHTMULTIPLY	Multipliziert die aktuelle Transformation mit den Daten in der XFORM-Struktur . (Die Daten in der XFORM-Struktur werden zum rechten Multiplizierer, und die Daten für die aktuelle Transformation werden zum linken Multiplizierten.)

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

Die ModifyWorldTransform-Funktion schlägt fehl, es sei denn, der Grafikmodus für den angegebenen Gerätekontext wurde auf GM_ADVANCED festgelegt, indem zuvor die SetGraphicsMode-Funktion aufgerufen wurde. Ebenso ist es nicht möglich, den Grafikmodus für den Gerätekontext auf den Standardmodus GM_COMPATIBLE zurückzusetzen, es sei denn, die Welttransformation wurde zuerst durch Aufrufen von SetWorldTransform oder ModifyWorldTransform auf die Standardidentitätstransformation zurückgesetzt.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wingdi.h (einschließlich Windows.h)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll