LinearGradientBrush：：GetTransform 方法 (gdiplusbrush.h)

發行項
08/23/2023

LinearGradientBrush：：GetTransform方法會取得這個線性漸層筆刷的轉換矩陣。

語法

Status GetTransform(
  [out] Matrix *matrix
);

參數

[out] matrix

類型：矩陣*

接收轉換矩陣之 Matrix 物件的指標。

傳回值

類型：狀態

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

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

備註

LinearGradientBrush物件會維護可儲存任何相依轉換的轉換矩陣。當您使用線性漸層筆刷填滿區域時，GDI+ 會根據筆刷的轉換矩陣轉換筆刷的界限線，然後填滿區域。轉換的界限只能在轉譯期間存在;儲存在 LinearGradientBrush 物件的界限不會轉換。

範例

下列範例會建立線性漸層筆刷，並設定其轉換矩陣。接下來，程式碼會取得筆刷的轉換矩陣，並繼續檢查或使用矩陣元素。

VOID Example_GetTransform(HDC hdc)
{
   Graphics myGraphics(hdc);

   // Construct a linear gradient brush, and set its transformation.
   LinearGradientBrush linGrBrush( 
      Point(0, 0),
      Point(200, 0),
      Color(255, 255, 0, 0),    // red
      Color(255, 0, 0, 255));   // blue

   Matrix matrixSet(0, 1, -1, 0, 0, 0);

   linGrBrush.SetTransform(&matrixSet);

   // Obtain information about the linear gradient brush.
   Matrix matrixGet;
   REAL   elements[6];

   linGrBrush.GetTransform(&matrixGet);
   matrixGet.GetElements(elements);  

   for(INT j = 0; j <= 5; ++j)
   {
       // Inspect or use the value in elements[j].
   }
}

需求


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