Pen：：SetDashPattern 方法 (gdipluspen.h)

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); 
}

需求

另請參閱

繪製自訂虛線

筆

Pen：：GetDashPattern

Pen：：GetDashPatternCount

畫筆、線條和矩形