GraphicsPath：：AddPath 方法 (gdipluspath.h)

發行項
02/26/2024

GraphicsPath：：AddPath 方法會將路徑新增至此路徑。

語法

Status AddPath(
  [in] const GraphicsPath *addingPath,
  [in] BOOL               connect
);

參數

[in] addingPath

類型： const GraphicsPath*

要加入之路徑的指標。

[in] connect

類型： BOOL

BOOL 值，指定新增路徑中的第一個圖是否為這個路徑中最後一個圖的一部分。

TRUE

指定 (如果可能的話，) 新增路徑中的第一個圖是這個路徑中最後一個圖的一部分。

false

指定新增路徑中的第一個圖與這個路徑的最後一個圖不同。

傳回值

類型：狀態

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

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

備註

即使 connect 參數的值為 TRUE，這個方法可能無法使這個路徑最後一個圖中加入路徑部分的第一個圖形。如果其中一個圖表已關閉，則它們必須維持個別的圖表。

範例

下列範例會建立兩個 GraphicsPath 物件： path1 和 path2。程式代碼會將由弧形和 Bézier 曲線組成的開啟圖新增至每個路徑。程序代碼會呼叫 path1 的 GraphicsPath：：AddPath 方法，將 path2 新增至 path1。第二個自變數為 TRUE，指定這四個專案 (兩個弧線和兩個 Bézier 曲線) 屬於相同的圖表。

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

   GraphicsPath path1;
   path1.AddArc(10, 10, 50, 20, 0.0f, 150.0f);
   path1.AddBezier(10, 50, 60, 50, 10, 80, 60, 80);
   
   GraphicsPath path2;
   path2.AddArc(10, 110, 50, 20, 0.0f, 150.0f);
   path2.AddBezier(10, 150, 60, 150, 10, 180, 60, 180);
 
   path1.AddPath(&path2, TRUE);

   Pen pen(Color(255, 0, 0, 255));
   graphics.DrawPath(&pen, &path1);
}

規格需求

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