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

Pen::SetDashCap メソッドは、この Pen オブジェクトのダッシュ キャップ スタイルを設定します。

構文

Status SetDashCap(
  [in] DashCap dashCap
);

パラメーター

[in] dashCap

種類: DashCap

この Pen オブジェクトのダッシュ キャップを指定する DashCap 列挙体の要素。

戻り値

種類: 状態

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

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

解説

Pen オブジェクトの配置を PenAlignmentInset に設定した場合、そのペンを使用して三角形のダッシュ キャップを描画することはできません。

例

次の例では、 Pen オブジェクトを作成し、ダッシュ スタイルとダッシュ キャップを設定し、破線を描画します。

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

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

   // Set the dash style for the pen.
   pen.SetDashStyle(DashStyleDash);

   // Set a triangular dash cap for the pen.
   pen.SetDashCap(DashCapTriangle);

   // Draw a line using the pen.
   graphics.DrawLine(&pen, 20, 20, 200, 100);
}

要件

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

関連項目

ユーザー設定の破線の描画

線のキャップを使用した線の描画

ペン

Pen::GetCustomEndCap

Pen::GetCustomStartCap

Pen::GetDashCap

ペン、直線、および四角形