PathGradientBrush：：MultiplyTransform 方法 (gdipluspath.h)

發行項
02/29/2024

PathGradientBrush：：MultiplyTransform 方法會使用本身的乘積和另一個矩陣來更新筆刷的轉換矩陣。

語法

Status MultiplyTransform(
  [in] const Matrix *matrix,
  [in] MatrixOrder  order
);

參數

[in] matrix

類型：矩陣*

將乘以筆刷目前轉換矩陣之矩陣的矩陣指標。

[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 (表示的複合轉換不同，然後旋轉) 。

範例

下列範例會根據三角形路徑建立 PathGradientBrush 物件。此程式代碼會呼叫 PathGradientBrush：：ScaleTransform物件的 PathGradientBrush 方法，以以 3 因數表示水準縮放的元素填滿筆刷的轉換矩陣。然後，程式代碼會呼叫相同 PathGradientBrush 物件的 PathGradientBrush：：MultiplyTransform 方法，將筆刷的現有轉換矩陣乘以代表右轉譯 (10 右、向下 30) 的矩陣。 MatrixOrderAppend 自變數表示乘法是在右側使用轉譯矩陣執行。

乘法之後，筆刷的轉換矩陣代表複合轉換：第一個刻度，然後轉譯。該複合轉換會在呼叫 FillRectangle 期間套用至筆刷的界限路徑，因此它是繪製之轉換路徑內的區域。

VOID Example_MultiplyTransform(HDC hdc)
{
   Graphics graphics(hdc);
   Point pts[] = {Point(0, 0), Point(50, 0), Point(50, 50)};

   // Translate 10 right, 30 down.
   Matrix matrix(1.0f, 0.0f, 0.0f, 1.0f, 10.0f, 30.0f);

   PathGradientBrush pthGrBrush(pts, 3);
   pthGrBrush.ScaleTransform(3.0f, 1.0f);
   pthGrBrush.MultiplyTransform(&matrix, MatrixOrderAppend);

   graphics.FillRectangle(&pthGrBrush, 0, 0, 200, 200);  
}

規格需求

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