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.

Ilustración de 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