IDirectManipulationViewport::SetViewportTransform-Methode (directmanipulation.h)

Artikel
08/23/2023

Gibt die Transformation vom Viewportkoordinatensystem zum Fensterclientkoordinatensystem an.

Syntax

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

Parameter

[in] matrix

Die Transformationsmatrix in zeilenweiser Reihenfolge: _11, _12, _21, _22, _31, _32.

[in] pointCount

Die Größe der Transformationsmatrix. Dieser Wert ist immer 6, da eine 3x2-Matrix für alle Transformationen der direkten Bearbeitung verwendet wird.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Rufen Sie diese Funktion auf, um die Viewportposition, Skalierung und Ausrichtung auf dem Bildschirm anzugeben. Viewportposition, Skalierung, Ausrichtung und Größe werden eindeutig durch die Viewporttransformation und das Viewportrechteck bestimmt. Die Anwendung kann die Viewporttransformation mit dieser Methode und das Viewportrechteck mithilfe von SetViewportRect angeben.

Das Viewportrechteck (der rechteckige Bereich innerhalb des Inhalts, der für den Benutzer sichtbar ist) wird in Viewportkoordinaten angegeben. Wenn das Viewportrechteck oben links (0,0) ist, wird das Viewportrechteck genau am Ursprung des Viewportkoordinatensystems positioniert. Der Viewportoffset aus dem Ursprung des Viewportkoordinatensystems kann auf zwei Arten angegeben werden:

Durch das Viewportrechteck oben links
Über die Viewporttransformationsübersetzungskomponente (_31, _32)

Die Viewporttransformation wird vom Viewportkoordinatensystem in das Fensterclientkoordinatensystem konvertiert. Die direkte Bearbeitung ignoriert die Eigenschaft window RTL, sodass der Clientbereichsursprung immer der obere linke Punkt ist. Die Transformationen werden in der folgenden Reihenfolge angewendet:

Viewport-Rechteckoffset
Viewporttransformation (vom Viewport zum Clientkoordinatensystem)
Client-zu-Bildschirmzuordnung (vom Client zum Bildschirmkoordinatensystem)

Anforderungen


Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	directmanipulation.h

Weitere Informationen

IDirectManipulationViewport

Freigeben über