ID2D1StrokeStyle

ストロークのキャップ、マイター制限、線の結合、破線情報を記述します。(ID2D1StrokeStyle)

ID2D1StrokeStyle オブジェクトの作成

ストロークスタイルはデバイスに依存しないリソースです。一度作成すれば、アプリケーションの存続期間を通じて保持できます。リソースの詳細については、Resources Overview を参照してください。

例

次の例では、カスタム破線パターンを使用するストロークを作成します。

// Dash array for dashStyle D2D1_DASH_STYLE_CUSTOM
float dashes[] = {1.0f, 2.0f, 2.0f, 3.0f, 2.0f, 2.0f};

// Stroke Style with Dash Style -- Custom
if (SUCCEEDED(hr))
{
    hr = m_pD2DFactory->CreateStrokeStyle(
        D2D1::StrokeStyleProperties(
            D2D1_CAP_STYLE_FLAT,
            D2D1_CAP_STYLE_FLAT,
            D2D1_CAP_STYLE_ROUND,
            D2D1_LINE_JOIN_MITER,
            10.0f,
            D2D1_DASH_STYLE_CUSTOM,
            0.0f),
        dashes,
        ARRAYSIZE(dashes),
        &m_pStrokeStyleCustomOffsetZero
        );
}

次の例では、線を描画する際にこのストロークスタイルを使用します。

m_pRenderTarget->DrawLine(
    D2D1::Point2F(0, 310),
    D2D1::Point2F(200, 310),
    m_pCornflowerBlueBrush,
    10.0f,
    m_pStrokeStyleCustomOffsetZero
    );

ストロークの始点に使用される形状の種類を取得します。

型: D2D1_CAP_STYLE

ストロークの始点に使用される形状の種類。

ストロークの終点に使用される形状の種類を取得します。

型: D2D1_CAP_STYLE

ストロークの終点に使用される形状の種類。

各破線の端をどのように描画するかを指定する値を取得します。

型: D2D1_CAP_STYLE

各破線の端をどのように描画するかを指定する値。

マイター長とストローク太さの半分との比率の上限を取得します。

型: FLOAT

マイター長とストローク太さの半分との比率の上限を表す、1.0f 以上の正の数。

図形のアウトラインの頂点で使用される結合の種類を取得します。

型: D2D1_LINE_JOIN

図形のアウトラインの頂点で使用される結合の種類を指定する値。

破線シーケンスのどの位置からストロークを開始するかを指定する値を取得します。

型: FLOAT

破線シーケンスのどの位置からストロークを開始するかを指定する値。

ストロークの破線パターンを表す値を取得します。

型: D2D1_DASH_STYLE

使用される定義済みの破線パターンを表す値。カスタム破線スタイルが使用されている場合は D2D1_DASH_STYLE_CUSTOM。

カスタム破線スタイルが指定されている場合、破線パターンは dashes 配列によって記述され、この配列は GetDashes メソッドを呼び出すことで取得できます。

dashes 配列内のエントリ数を取得します。

型: UINT32

ストロークが破線の場合は dashes 配列内のエントリ数。それ以外の場合は 0。

破線パターンを指定された配列にコピーします。

破線は、ストローク幅の倍数を単位として指定されます。配列の各メンバーは破線と破線間のギャップを順に示します。最初のエントリは塗りつぶされた破線を、2 番目はギャップを、というように交互に表します。