énumération D2D1_DASH_STYLE (d2d1.h)

Article
08/22/2023

Décrit la séquence de tirets et d’interstices dans un trait.

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` Valeur : 0 Une ligne solide sans ruptures.
`D2D1_DASH_STYLE_DASH` Valeur : 1 Tiret suivi d’un espace de longueur égale. Le tiret et l’écart sont deux fois plus longs que l’épaisseur du trait. Le tableau de tirets équivalent pour D2D1_DASH_STYLE_DASH est {2, 2}.
`D2D1_DASH_STYLE_DOT` Valeur : 2 Point suivi d’un écart plus long. Le tableau de tirets équivalent pour D2D1_DASH_STYLE_DOT est {0, 2}.
`D2D1_DASH_STYLE_DASH_DOT` Valeur : 3 Tiret, suivi d’un écart, suivi d’un point, suivi d’un autre écart. Le tableau de tirets équivalent pour D2D1_DASH_STYLE_DASH_DOT est {2, 2, 0, 2}.
`D2D1_DASH_STYLE_DASH_DOT_DOT` Valeur : 4 Tiret, suivi d’un écart, suivi d’un point, suivi d’un autre écart, suivi d’un autre point, suivi d’un autre écart. Le tableau de tirets équivalent pour D2D1_DASH_STYLE_DASH_DOT_DOT est {2, 2, 0, 0, 2}.
`D2D1_DASH_STYLE_CUSTOM` Valeur : 5 Le modèle de tiret est spécifié par un tableau de valeurs à virgule flottante.
`D2D1_DASH_STYLE_FORCE_DWORD` Valeur : 0xffffffff

Remarques

L’illustration suivante montre plusieurs styles de tiret disponibles.

Illustration des styles de tiret disponibles

Exemples

L’exemple suivant crée un trait qui utilise un motif de tiret personnalisé.

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

L’exemple suivant utilise le style de trait lors du dessin d’une ligne.

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

Configuration requise


Client minimal pris en charge	Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2, Windows Server 2008 avec SP2 et Mise à jour de plateforme pour Windows Server 2008 [applications de bureau \| Applications UWP]
En-tête	d2d1.h

Partager via