Pen：：SetDashOffset 方法 (gdipluspen.h)

Pen：：SetDashOffset 方法會將從線條開頭到虛線中第一個虛線開頭的距離。

語法

Status SetDashOffset(
  [in] REAL dashOffset
);

參數

[in] dashOffset

類型： REAL

實數，指定在虛線中移動空格的次數。 每個班次都等於虛線中空格的長度。

傳回值

類型： 狀態

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

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

備註

正 dashOffset 值會沿著路徑往前移動第一個 虛線，負 dashOffset 值會沿著第一個虛線往前移動路徑的起點。

範例

下列範例會建立 Pen 對象、設定虛線樣式，並繪製線條。 然後程式代碼會設定手寫筆的位移值，並繪製第二行。

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

   // Create a Pen object, set the dash style, and draw a line.
   Pen pen(Color(255, 0, 0, 255), 15);
   pen.SetDashStyle(DashStyleDash);
   graphics.DrawLine(&pen, 0, 50, 400, 50);

   // Set the dash offset value for the pen, and draw a second line.
   pen.SetDashOffset(10);
   graphics.DrawLine(&pen, 0, 80, 400, 80);
}

規格需求

另請參閱

繪製自定義虛線

筆

Pen：：GetDashOffset

Pen：：GetDashPattern

Pen：：GetDashPatternCount

Pen：：GetDashStyle

Pen：：SetDashCap

Pen：：SetDashPattern

Pen：：SetDashStyle

畫筆、線條和矩形