D2D1_DASH_STYLE列舉 (d2d1.h)

描述筆劃中的虛線和間距序列。

Syntax

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 Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
標頭 d2d1.h