enumeración D2D1_DASH_STYLE (d2d1.h)

Describe la secuencia de guiones y huecos en un trazo.

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

Constantes

D2D1_DASH_STYLE_SOLID Valor: 0 Una línea sólida sin saltos.
D2D1_DASH_STYLE_DASH Valor: 1 Guión seguido de un intervalo de igual longitud. El guión y la brecha son cada dos veces más largos que el grosor del trazo. La matriz de guiones equivalente para D2D1_DASH_STYLE_DASH es {2, 2}.
D2D1_DASH_STYLE_DOT Valor: 2 Un punto seguido de un intervalo más largo. La matriz de guiones equivalente para D2D1_DASH_STYLE_DOT es {0, 2}.
D2D1_DASH_STYLE_DASH_DOT Valor: 3 Un guión, seguido de un hueco, seguido de un punto, seguido de otra brecha. La matriz de guiones equivalente para D2D1_DASH_STYLE_DASH_DOT es {2, 2, 0, 2}.
D2D1_DASH_STYLE_DASH_DOT_DOT Valor: 4 Un guión, seguido de un hueco, seguido de un punto, seguido de otra brecha, seguido de otro punto, seguido de otro punto, seguido de otra brecha. La matriz de guiones equivalente para D2D1_DASH_STYLE_DASH_DOT_DOT es {2, 2, 0, 2, 0, 2}.
D2D1_DASH_STYLE_CUSTOM Valor: 5 El patrón de guiones se especifica mediante una matriz de valores de punto flotante.
D2D1_DASH_STYLE_FORCE_DWORD Valor: 0xffffffff

Comentarios

En la ilustración siguiente se muestran varios estilos de guiones disponibles.

Ejemplos

En el ejemplo siguiente se crea un trazo que usa un patrón de guion personalizado.

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

En el ejemplo siguiente se usa el estilo de trazo al dibujar una línea.

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

Requisitos

Cliente mínimo compatible	Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008 [aplicaciones de escritorio | Aplicaciones para UWP]
Encabezado	d2d1.h