ID2D1StrokeStyle インターフェイス

  • [アーティクル]

ストロークのキャップ、マイター リミット、角の形状、および破線に関する情報について記述します。

実装するタイミング

カスタム実装はサポートされません。

メンバー

ID2D1StrokeStyle インターフェイス の継承元は次のとおりです: ID2D1Resource. ID2D1StrokeStyle は次のメンバーも定義します:

  • メソッド

メソッド

ID2D1StrokeStyle インターフェイス は次の項目を定義します: メソッド.

メソッド 説明
GetDashCap

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

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

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

破線シーケンス内でストロークが開始される位置を指定する値を取得します。
GetDashStyle

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

ストロークの終点で使用する図形の種類を取得します。
GetLineJoin

図形の輪郭の頂点で使用する接合の種類を取得します。
GetMiterLimit

マイター長の、ストロークの太さの半分に対する比率について、その上限を取得します。
GetStartCap

ストロークの始点で使用する図形の種類を取得します。

 

解説

ID2D1StrokeStyle オブジェクトの作成

ストローク スタイルを作成するには、ID2D1Factory::CreateStrokeStyle メソッドを使用します。

ストローク スタイルはデバイス非依存のリソースなので、一度作成すると、アプリケーションが有効な間は保持できます。リソースの詳細については、「リソースの概要」を参照してください。

例

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

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

完全なコードについては、「ストローク スタイルの例」を参照してください。

要件

クライアントの最小要件

 Windows 7, Windows Vista SP2 および Windows Vista 用のプラットフォーム更新プログラム

サーバーの最小要件

 Windows Server 2008 R2, Windows Server 2008 SP2 および Windows Server 2008 用のプラットフォーム更新プログラム

ヘッダー

 D2d1.h

ライブラリ

 D2d1.lib

DLL

 D2d1.dll

参照

ID2D1Factory::CreateStrokeStyle

ストローク スタイルの例