Pen：：SetDashPattern 方法 (gdipluspen.h)

發行項
08/24/2023

Pen：：SetDashPattern方法會設定這個Pen物件的自訂虛線和空格陣列。

語法

Status SetDashPattern(
  [in] const REAL *dashArray,
  [in] INT        count
);

參數

[in] dashArray

類型： const REAL*

指定自訂虛線和空格長度之實數陣列的指標。陣列中的所有元素都必須是正實數。

[in] count

類型： INT

整數，指定 dashArray 陣列中的專案數目。整數必須大於 0，且不能大於陣列中的元素總數。

傳回值

類型：狀態

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

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

備註

這個方法會將這個Pen物件的DashStyle列舉設定為DashStyleCustom。

dashArray陣列中的元素會設定虛線圖樣中每個虛線和空格的長度。第一個專案會設定虛線的長度、第二個元素會設定空格的長度、第三個元素設定虛線的長度等等。

虛線圖樣中每個虛線和空格的長度是陣列中的元素值乘積，以及 Pen 物件的寬度。

範例

下列範例會建立實數的陣列。然後程式碼會建立 Pen 物件、根據陣列設定虛線圖樣，然後繪製自訂虛線。

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

   // Create and set an array of real numbers.
   REAL dashVals[4] = {
      5.0f,   // dash length 5
      2.0f,   // space length 2
      15.0f,  // dash length 15
      4.0f};  // space length 4

   // Create a Pen object.
   Pen pen(Color(255, 0, 0, 0), 5);

   // Set the dash pattern for the custom dashed line.
   pen.SetDashPattern(dashVals, 4);

   // Draw the custom dashed line.
   graphics.DrawLine(&pen, 5, 20, 405, 200); 
}

需求


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