Pen::SetDashOffset メソッド (gdipluspen.h)

[アーティクル]
02/26/2024

Pen::SetDashOffset メソッドは、行の先頭から破線の最初のダッシュの開始までの距離を設定します。

構文

Status SetDashOffset(
  [in] REAL dashOffset
);

パラメーター

[in] dashOffset

種類: REAL

破線内のスペースをシフトする回数を指定する実数。各シフトは、破線内のスペースの長さに等しくなります。

戻り値

種類: 状態

メソッドが成功した場合は、Status 列挙体の要素である Ok を返します。

メソッドが失敗した場合は、 Status 列挙体の他の要素のいずれかを返します。

注釈

正の dashOffset 値を指定すると、パスに沿って最初のダッシュが前方に移動し、負の dashOffset 値を指定すると、パスの開始位置が最初のダッシュに沿って前方にシフトされます。

例

次の例では、 Pen オブジェクトを作成し、破線のスタイルを設定し、線を描画します。次に、ペンのオフセット値を設定し、2 行目を描画します。

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

要件

要件	値
サポートされている最小のクライアント	Windows XP、Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	gdipluspen.h (Gdiplus.h を含む)
Library	Gdiplus.lib
[DLL]	Gdiplus.dll