TextureBrush::RotateTransform 方法 (gdiplusbrush.h)

TextureBrush::RotateTransform 方法會以本身乘積和旋轉矩陣來更新此紋理筆刷目前的轉換矩陣。

語法

Status RotateTransform(
  [in] REAL        angle,
  [in] MatrixOrder order
);

參數

[in] angle

類型: REAL

指定旋轉角度的實數。

[in] order

類型: MatrixOrder

選擇性。 MatrixOrder 列舉的元素,指定乘法的順序。 MatrixOrderPrepend 指定旋轉矩陣位於左側, 而 MatrixOrderAppend 指定旋轉矩陣位於右側。 預設值為 MatrixOrderPrepend

傳回值

類型: 狀態

如果方法成功,它會傳回 Ok,這是 Status 列舉的元素。

如果方法失敗,它會傳回 Status 列舉的其他其中一個專案。

備註

單一 3×3 矩陣可以儲存任何一連串的關聯轉換。 如果您有數個 3×3 矩陣,其中每一個矩陣都代表相依轉換,則這些矩陣的乘積是單一 3×3 矩陣,代表整個轉換序列。 由該產品表示的轉換稱為複合轉換。 例如,假設矩陣 R 代表旋轉,而矩陣 T 代表翻譯。 如果矩陣 M 是產品 RT,則矩陣 M 代表複合轉換:先旋轉,然後再轉譯。

矩陣乘法的順序很重要。 一般而言,矩陣產品 RT 與矩陣產品 TR 不同。 在上一個段落中提供的範例中, RT 所代表的復合轉換 (會先旋轉,然後轉譯) 與 TR (表示的複合轉換不同,然後旋轉) 。

範例

下列範例會建立紋理筆刷,並設定筆刷的轉換。 然後,程式代碼會使用轉換的筆刷來填滿矩形。

VOID Example_RotateTransform(HDC hdc)
{
   Graphics graphics(hdc);

   Image image(L"HouseAndTree.Gif");
   TextureBrush textureBrush(&image);
   textureBrush.ScaleTransform(3, 1);                    // first scale
   textureBrush.RotateTransform(30, MatrixOrderAppend);  // then rotate
   graphics.FillRectangle(&textureBrush, 0, 0, 400, 200);
}

規格需求

需求
最低支援的用戶端 Windows XP、Windows 2000 Professional [僅限桌面應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 gdiplusbrush.h (包含 Gdiplus.h)
程式庫 Gdiplus.lib
Dll Gdiplus.dll

另請參閱

筆刷和填滿的圖形

使用漸層筆刷填滿圖形

映像

矩陣

以矩陣來表示轉換

MatrixOrder

TextureBrush

TextureBrush::ScaleTransform

TextureBrush::SetTransform

TextureBrush::TranslateTransform

轉換