Freigeben über


ModifyWorldTransform-Funktion (wingdi.h)

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

Weitere Informationen

Koordinatenraum und Transformationsfunktionen

Übersicht über Koordinatenräume und Transformationen

GetWorldTransform

SetGraphicsMode

SetWorldTransform

XFORM