D2D1_DASH_STYLE-Enumeration (d2d1.h)

Beschreibt die Sequenz von Bindestrichen und Lücken in einem Strich.

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
} ;

Konstanten

D2D1_DASH_STYLE_SOLID Wert: 0 Eine durchgezogene Linie ohne Umbrüche.
D2D1_DASH_STYLE_DASH Wert: 1 Ein Bindestrich gefolgt von einer Lücke von gleicher Länge. Der Bindestrich und der Spalt sind jeweils doppelt so lang wie die Strichstärke. Das entsprechende Bindestricharray für D2D1_DASH_STYLE_DASH ist {2, 2}.
D2D1_DASH_STYLE_DOT Wert: 2 Ein Punkt gefolgt von einer längeren Lücke. Das entsprechende Bindestricharray für D2D1_DASH_STYLE_DOT ist {0, 2}.
D2D1_DASH_STYLE_DASH_DOT Wert: 3 Ein Strich, gefolgt von einer Lücke, gefolgt von einem Punkt, gefolgt von einer weiteren Lücke. Das entsprechende Bindestricharray für D2D1_DASH_STYLE_DASH_DOT ist {2, 2, 0, 2}.
D2D1_DASH_STYLE_DASH_DOT_DOT Wert: 4 Ein Bindestrich, gefolgt von einer Lücke, gefolgt von einem Punkt, gefolgt von einer weiteren Lücke, gefolgt von einem weiteren Punkt, gefolgt von einer weiteren Lücke. Das entsprechende Bindestricharray für D2D1_DASH_STYLE_DASH_DOT_DOT ist {2, 2, 0, 2, 0, 2}.
D2D1_DASH_STYLE_CUSTOM Wert: 5 Das Bindestrichmuster wird durch ein Array von Gleitkommawerten angegeben.
D2D1_DASH_STYLE_FORCE_DWORD Wert: 0xffffffff

Hinweise

Die folgende Abbildung zeigt mehrere verfügbare Bindestrichstile.

Beispiele

Im folgenden Beispiel wird eine Strich erstellt, die ein benutzerdefiniertes Strichmuster verwendet.

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

Im nächsten Beispiel wird beim Zeichnen einer Linie das Strichformat verwendet.

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

Anforderungen

Unterstützte Mindestversion (Client)	Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps]
Kopfzeile	d2d1.h