IDCompositionVisual::SetTransform(constD2D_MATRIX_3X2_F&)-Methode (dcomp.h)

Artikel
01/10/2024

Legt die Transform-Eigenschaft dieses Visuals auf die angegebene 3-by-2-Transformationsmatrix fest.

Syntax

HRESULT SetTransform(
  [in, ref] const D2D_MATRIX_3X2_F & matrix
);

Parameter

[in, ref] matrix

Typ: const D2D_MATRIX_3X2_F

Die 3-mal-2-Transformationsmatrix, die verwendet wird, um das Koordinatensystem dieses Visuals zu ändern.

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben. Eine Liste der Fehlercodes finden Sie unter DirectComposition-Fehlercodes .

Hinweise

Durch Festlegen der Transform-Eigenschaft wird das Koordinatensystem der gesamten visuellen Unterstruktur transformiert, die in diesem Visual verwurzelt ist. Wenn die Clip-Eigenschaft dieses Visuals angegeben wird, wird auch das Cliprechteck transformiert.

Wenn die Transform-Eigenschaft zuvor ein Transformationsobjekt angegeben hat, ersetzt die neu angegebene Transformationsmatrix das Transformationsobjekt.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	dcomp.h
Bibliothek	Dcomp.lib
DLL	Dcomp.dll