AdjustableArrowCap::SetMiddleInset メソッド (gdipluslinecaps.h)

AdjustableArrowCap::SetMiddleInset メソッドは、ベースの中間点が頂点に向かってシフトする単位数を設定します。

構文

Status SetMiddleInset(
  [in] REAL middleInset
);

パラメーター

[in] middleInset

種類: REAL

ベースの中間点が頂点に向かってシフトする単位数を指定する実数。

戻り値

種類: 状態

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

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

注釈

中央のインセットは、ベースの中間点が頂点に向かってシフトする単位の数です。 0 の中間インセットではシフトが発生しません。ベースは直線で、矢印に三角形の図形が表示されます。 正の (0 より大きい) 中間インセットを使用すると、指定した単位数が頂点に向かってシフトします。ベースは頂点を指す矢印図形であり、矢印キャップに V 字形が付きます。 負 (0 未満) の中間インセットでは、指定した単位数が頂点から離れた位置にシフトします。ベースは頂点から離れた方向の図形になり、矢印にひし形 (中間インセットの絶対値が高さと等しい場合) または歪んだひし形になります。 中央のインセットが矢印キャップの高さ以上の場合、キャップはまったく表示されません。 中央のインセットの値は、矢印キャップが塗りつぶされている場合にのみ矢印キャップに影響します。 AdjustableArrowCap オブジェクトが構築されると、中央の inset は既定で 0 になります。

例

次の例では、 AdjustableArrowCap オブジェクト myArrow を作成し、キャップの中央のインセットを 5 ピクセルに設定します。 次に、 Pen オブジェクトを作成し、 myArrow をこの Pen オブジェクトの終了行のキャップとして割り当てます。 次に、コードは上限付きの行を描画します。

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

   // Create an AdjustableArrowCap, and set the middle inset to 5.
   AdjustableArrowCap myArrow(10, 10, true);
   myArrow.SetMiddleInset(5.0f);

   // Create a Pen, and assign myArrow as the end cap.
   Pen arrowPen(Color(255, 0, 0, 0));
   arrowPen.SetCustomEndCap(&myArrow);

   // Draw a line using arrowPen.
   graphics.DrawLine(&arrowPen, Point(0, 0), Point(100, 100));
}

要件

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