LinearGradientBrush：：GetRectangle (Rect*) 方法 (gdiplusbrush.h)

發行項
08/23/2023

LinearGradientBrush：：GetRectangle方法會取得定義漸層界限的矩形。

語法

Status GetRectangle(
  [out] Rect *rect
);

參數

[out] rect

類型： Rect*

Rect物件的指標，該物件會接收定義漸層界限的矩形。例如，如果線性漸層筆刷是以 (20、50) 的起點和 (60、110) 的結束點建構，則定義矩形的左上角點 (20、50) 、寬度為 40，高度為 60。

傳回值

類型：狀態

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

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

備註

矩形會以下列方式定義漸層的界限：矩形的右邊和左側形成水準漸層的界限。頂端和底部會形成垂直漸層的界限。兩個對角對角的邊角位於對角漸層的界限上。在這些案例中，任一側/邊角可能會位於起始界限上，視起點和結束點傳遞至建構函式的方式而定。

範例

下列範例會建立線性漸層筆刷。然後程式碼會取得筆刷的矩形並繪製它。

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

   // Create a linear gradient brush.
   LinearGradientBrush linGrBrush( 
      Point(20, 10),
      Point(60, 110),
      Color(255, 0, 0, 0),     // black
      Color(255, 0, 0, 255));  // blue

   // Obtain information about the linear gradient brush.
   Rect rect;
   linGrBrush.GetRectangle(&rect);

   // Draw the retrieved rectangle.
   Pen myPen(Color(255, 0, 0, 0));
   myGraphics.DrawRectangle(&myPen, rect);
}

需求


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