PathGradientBrush：：ScaleTransform 方法 (gdipluspath.h)

發行項
08/24/2023

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

語法

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

參數

[in] sx

類型： REAL

指定水準縮放比例的實數。

[in] sy

類型： REAL

指定垂直縮放比例的實數。

[in] order

類型： MatrixOrder

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

傳回值

類型：狀態

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

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

備註

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

範例

下列範例會根據三角形路徑建立 PathGradientBrush 物件。對 PathGradientBrush：：TranslateTransform 和 PathGradientBrush：：ScaleTransform 方法的 呼叫，PathGradientBrush 物件會設定筆刷轉換矩陣的元素，使其代表複合轉換：先轉譯，然後再縮放。程式碼會使用路徑漸層筆刷兩次繪製矩形：設定轉換之前一次，並在設定轉換之後一次。

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

   // Create a path gradient brush based on an array of points.
   Point pts[] = {Point(0, 0), Point(50, 0), Point(50, 50)};
   PathGradientBrush pthGrBrush(pts, 3);

   // Fill an area with the path gradient brush (no transformation).
   graphics.FillRectangle(&pthGrBrush, 0, 0, 500, 500);

   pthGrBrush.TranslateTransform(50.0f, 40.0f);               // translate
   pthGrBrush.ScaleTransform(3.0f, 2.0f, MatrixOrderAppend);  // then scale

   // Fill the same area with the transformed path gradient brush.
   graphics.FillRectangle(&pthGrBrush, 0, 0, 500, 500); 
}

需求


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