D2D1_DASH_STYLE enumeração (d2d1.h)

  • Artigo

Descreve a sequência de traços e lacunas em um traço.

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
Uma linha sólida sem quebras.
D2D1_DASH_STYLE_DASH
Valor: 1
Um traço seguido por uma lacuna de comprimento igual. O traço e a lacuna são duas vezes mais longos que a espessura do traço.

A matriz de traços equivalente para D2D1_DASH_STYLE_DASH é {2, 2}.
D2D1_DASH_STYLE_DOT
Valor: 2
Um ponto seguido por uma lacuna mais longa.

A matriz de traços equivalente para D2D1_DASH_STYLE_DOT é {0, 2}.
D2D1_DASH_STYLE_DASH_DOT
Valor: 3
Um traço, seguido por uma lacuna, seguido por um ponto, seguido por outra lacuna.

A matriz de traços equivalente para D2D1_DASH_STYLE_DASH_DOT é {2, 2, 0, 2}.
D2D1_DASH_STYLE_DASH_DOT_DOT
Valor: 4
Um traço, seguido por uma lacuna, seguido por um ponto, seguido por outra lacuna, seguido por outro ponto, seguido por outra lacuna.

A matriz de traços equivalente para D2D1_DASH_STYLE_DASH_DOT_DOT é {2, 2, 0, 2, 0, 2}.
D2D1_DASH_STYLE_CUSTOM
Valor: 5
O padrão de traço é especificado por uma matriz de valores de ponto flutuante.
D2D1_DASH_STYLE_FORCE_DWORD
Valor: 0xffffffff

Comentários

A ilustração a seguir mostra vários estilos de traço disponíveis.

Ilustração dos estilos de traço disponíveis

Exemplos

O exemplo a seguir cria um traço que usa um padrão de traço 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
        );
}

O próximo exemplo usa o estilo de traço ao desenhar uma linha.

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

Requisitos

   
Cliente mínimo com suporte Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2, Windows Server 2008 com SP2 e Atualização de Plataforma para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Cabeçalho d2d1.h