Pen：：GetDashPattern 方法 (gdipluspen.h)

發行項
08/24/2023

Pen：：GetDashPattern方法會取得此Pen物件目前設定的自訂虛線和空格陣列。

語法

Status GetDashPattern(
  [out] REAL *dashArray,
  [in]  INT  count
);

參數

[out] dashArray

類型： REAL*

陣列的指標，該陣列會接收自訂虛線中的虛線和空格長度。

[in] count

類型： INT

整數，指定 dashArray 陣列中的專案數目。

傳回值

類型：狀態

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

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

備註

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

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

範例

下列範例會建立實數和 Pen 物件的陣列、設定虛線圖樣，並繪製自訂虛線。然後，程式碼會取得目前為手寫筆設定的虛線圖樣。

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

   // Create a custom dashed pen, and use it to draw a line.
   REAL dashVals[4] = {5, 2, 15, 4};
   Pen pen(Color(255, 0, 0, 0), 5);
   pen.SetDashPattern(dashVals, 4);
   graphics.DrawLine(&pen, 5, 20, 405, 200);

   // Obtain information about the pen.
   INT count = 0;
   REAL* dashValues = NULL;

   count = pen.GetDashPatternCount();
   dashValues = new REAL[count];
   pen.GetDashPattern(dashValues, count);

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

需求


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