D2D1_DASH_STYLE 枚举 (d2d1.h)

描述笔划中短划线和间隙的序列。

语法

typedef enum D2D1_DASH_STYLE {
  D2D1_DASH_STYLE_SOLID = 0,
  D2D1_DASH_STYLE_DASH = 1,
  D2D1_DASH_STYLE_DOT = 2,
  D2D1_DASH_STYLE_DASH_DOT = 3,
  D2D1_DASH_STYLE_DASH_DOT_DOT = 4,
  D2D1_DASH_STYLE_CUSTOM = 5,
  D2D1_DASH_STYLE_FORCE_DWORD = 0xffffffff
} ;

常量

D2D1_DASH_STYLE_SOLID 值： 0 无分隔符的实线。
D2D1_DASH_STYLE_DASH 值：1 短划线，后跟长度相等的间隙。 短划线和间隙的长度是笔划粗细的两倍。 D2D1_DASH_STYLE_DASH的等效短划线数组为 {2， 2}。
D2D1_DASH_STYLE_DOT 值： 2 一个点，后跟一个较长的间距。 D2D1_DASH_STYLE_DOT的等效短划线数组为 {0， 2}。
D2D1_DASH_STYLE_DASH_DOT 值： 3 一个短划线，后跟一个间隙，后跟一个点，然后是另一个间隙。 D2D1_DASH_STYLE_DASH_DOT的等效短划线数组为 {2， 2， 0， 2}。
D2D1_DASH_STYLE_DASH_DOT_DOT 值： 4 破折号，后跟一个间隙，后跟一个点，后跟另一个间隙，后跟另一个点，然后是另一个间距。 D2D1_DASH_STYLE_DASH_DOT_DOT的等效短划线数组为 {2， 2， 0， 2， 0， 2}。
D2D1_DASH_STYLE_CUSTOM 值： 5 短划线模式由浮点值数组指定。
D2D1_DASH_STYLE_FORCE_DWORD 值： 0xffffffff

备注

下图显示了几种可用的短划线样式。

示例

以下示例创建使用自定义短划线模式的笔划。

// 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、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器	Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用]
标头	d2d1.h