Metode ID2D1RenderTarget::D rawLine (d2d1.h)

  • Artikel

Menggambar garis di antara titik yang ditentukan menggunakan gaya goresan yang ditentukan.

Sintaks

void DrawLine(
                 D2D1_POINT_2F    point0,
                 D2D1_POINT_2F    point1,
  [in]           ID2D1Brush       *brush,
                 FLOAT            strokeWidth,
  [in, optional] ID2D1StrokeStyle *strokeStyle
);

Parameter

point0

Jenis: D2D1_POINT_2F

Titik awal garis, dalam piksel independen perangkat.

point1

Jenis: D2D1_POINT_2F

Titik akhir garis, dalam piksel independen perangkat.

[in] brush

Jenis: ID2D1Brush*

Kuas yang digunakan untuk melukis stroke garis.

strokeWidth

Jenis: FLOAT

Lebar goresan, dalam piksel independen perangkat. Nilai harus lebih besar dari atau sama dengan 0,0f. Jika parameter ini tidak ditentukan, parameter defaultnya adalah 1.0f. Stroke berpusat pada garis.

[in, optional] strokeStyle

Jenis: ID2D1StrokeStyle*

Gaya goresan untuk melukis, atau NULL untuk melukis garis padat.

Mengembalikan nilai

Tidak ada

Keterangan

Metode ini tidak mengembalikan kode kesalahan jika gagal. Untuk menentukan apakah operasi menggambar (seperti DrawLine) gagal, periksa hasil yang dikembalikan oleh metode ID2D1RenderTarget::EndDraw atau ID2D1RenderTarget::Flush .

Contoh

Contoh berikut menggunakan metode DrawLine untuk membuat kisi yang mencakup lebar dan tinggi target render. Informasi lebar dan tinggi disediakan oleh variabel rtSize .

        // Draw a grid background.
        int width = static_cast<int>(rtSize.width);
        int height = static_cast<int>(rtSize.height);

        for (int x = 0; x < width; x += 10)
        {
            m_pRenderTarget->DrawLine(
                D2D1::Point2F(static_cast<FLOAT>(x), 0.0f),
                D2D1::Point2F(static_cast<FLOAT>(x), rtSize.height),
                m_pLightSlateGrayBrush,
                0.5f
                );
        }

        for (int y = 0; y < height; y += 10)
        {
            m_pRenderTarget->DrawLine(
                D2D1::Point2F(0.0f, static_cast<FLOAT>(y)),
                D2D1::Point2F(rtSize.width, static_cast<FLOAT>(y)),
                m_pLightSlateGrayBrush,
                0.5f
                );
        }

Persyaratan

Persyaratan Nilai
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]
Target Platform Windows
Header d2d1.h
Pustaka D2d1.lib
DLL D2d1.dll

Lihat juga

ID2D1RenderTarget