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

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

Pen::SetAlignment メソッドは、この Pen オブジェクトの直線に対する相対的な配置を設定します。

構文

Status SetAlignment(
  [in] PenAlignment penAlignment
);

パラメーター

[in] penAlignment

種類: PenAlignment

描画される線に対するペンの配置設定を指定する PenAlignment 列挙体の要素。既定値は PenAlignmentCenter です。

戻り値

種類: 状態

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

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

注釈

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

例

次の例では、2 つの Pen オブジェクトを作成し、いずれかのペンの配置を設定します。次に、各ペンを使用して 2 本の線を描画します。

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

   // Create a black and a green pen.
   Pen blackPen(Color(255, 0, 0, 0), 1);
   Pen greenPen(Color(255, 0, 255, 0), 15);

   // Set the alignment of the green pen.
   greenPen.SetAlignment(PenAlignmentInset);

   // Draw two lines using each pen.
   graphics.DrawEllipse(&greenPen, 0, 0, 100, 200);
   graphics.DrawEllipse(&blackPen, 0, 0, 100, 200);
}

要件

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