TextureBrush：：ScaleTransform 方法 (gdiplusbrush.h)

發行項
03/14/2023

TextureBrush：：ScaleTransform方法會以本身乘積和縮放矩陣來更新此紋理筆刷目前的轉換矩陣。

語法

Status ScaleTransform(
  [in] REAL        sx,
  [in] REAL        sy,
  [in] MatrixOrder order
);

參數

[in] sx

類型： REAL

指定以 X 方向縮放的金額的實數。

[in] sy

類型： REAL

實數，指定要以 Y 方向縮放的數量。

[in] order

類型： MatrixOrder

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

傳回值

類型：狀態

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

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

備註

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

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

範例

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

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

   Image image(L"HouseAndTree.Gif");
   TextureBrush textureBrush(&image);
   textureBrush.RotateTransform(30);                      // first rotate
   textureBrush.ScaleTransform(3, 1, MatrixOrderAppend);  // then scale
   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