Freigeben über


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

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

Weitere Informationen

IDCompositionMatrixTransform

IDCompositionRotateTransform

IDCompositionScaleTransform

IDCompositionSkewTransform

IDCompositionTransform

IDCompositionTranslateTransform

IDCompositionVisual

IDCompositionVisual::SetOffsetX

IDCompositionVisual::SetOffsetY