enumerasi D2D1_DASH_STYLE (d2d1.h)

Artikel
03/11/2023

Menjelaskan urutan tanda hubung dan celah dalam goresan.

Sintaks

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

Konstanta


`D2D1_DASH_STYLE_SOLID` Nilai: 0 Garis tebal tanpa hentian.
`D2D1_DASH_STYLE_DASH` Nilai: 1 Tanda hubung diikuti dengan celah dengan panjang yang sama. Tanda hubung dan celah masing-masing dua kali selama ketebalan stroke. Array tanda hubung yang setara untuk D2D1_DASH_STYLE_DASH adalah {2, 2}.
`D2D1_DASH_STYLE_DOT` Nilai: 2 Titik diikuti dengan celah yang lebih panjang. Array tanda hubung yang setara untuk D2D1_DASH_STYLE_DOT adalah {0, 2}.
`D2D1_DASH_STYLE_DASH_DOT` Nilai: 3 Tanda hubung, diikuti oleh celah, diikuti oleh titik, diikuti oleh celah lain. Array tanda hubung yang setara untuk D2D1_DASH_STYLE_DASH_DOT adalah {2, 2, 0, 2}.
`D2D1_DASH_STYLE_DASH_DOT_DOT` Nilai: 4 Tanda hubung, diikuti oleh celah, diikuti oleh titik, diikuti oleh celah lain, diikuti oleh titik lain, diikuti oleh celah lain. Array tanda hubung yang setara untuk D2D1_DASH_STYLE_DASH_DOT_DOT adalah {2, 2, 0, 2, 0, 2}.
`D2D1_DASH_STYLE_CUSTOM` Nilai: 5 Pola tanda hubung ditentukan oleh array nilai floating-point.
`D2D1_DASH_STYLE_FORCE_DWORD` Nilai: 0xffffffff

Keterangan

Ilustrasi berikut ini memperlihatkan beberapa gaya tanda hubung yang tersedia.

Ilustrasi gaya garis putus-putus yang tersedia

Contoh

Contoh berikut membuat goresan yang menggunakan pola tanda hubung kustom.

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

Contoh berikutnya menggunakan gaya goresan saat menggambar garis.

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

Persyaratan


Klien minimum yang didukung	Windows 7, Windows Vista dengan SP2 dan Pembaruan Platform untuk Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 R2, Windows Server 2008 dengan SP2 dan Pembaruan Platform untuk Windows Server 2008 [aplikasi desktop \| Aplikasi UWP]
Header	d2d1.h

Bagikan melalui