struktur D2D1_LINEAR_GRADIENT_BRUSH_PROPERTIES (d2d1.h)

Berisi titik awal dan titik akhir sumbu gradien untuk ID2D1LinearGradientBrush.

Sintaks

typedef struct D2D1_LINEAR_GRADIENT_BRUSH_PROPERTIES {
  D2D1_POINT_2F startPoint;
  D2D1_POINT_2F endPoint;
} D2D1_LINEAR_GRADIENT_BRUSH_PROPERTIES;

Anggota

startPoint

Jenis: D2D1_POINT_2F

Di ruang koordinat kuas, titik awal sumbu gradien.

endPoint

Jenis: D2D1_POINT_2F

Di ruang koordinat kuas, titik akhir sumbu gradien.

Keterangan

Gunakan metode ini saat membuat objek ID2D1LinearGradientBrush baru dengan metode CreateLinearGradientBrush . Untuk kenyamanan, Direct2D menyediakan fungsi pembantu D2D1::LinearGradientBrushProperties untuk membuat struktur D2D1_LINEAR_GRADIENT_BRUSH_PROPERTIES baru.

Ilustrasi berikut menunjukkan bagaimana gradien linier berubah saat Anda mengubah titik awal dan akhirnya. Untuk gradien pertama, titik awal diatur ke (0,0) dan titik akhir ke (150, 50); ini menciptakan gradien diagonal yang dimulai di sudut kiri atas dan meluas ke sudut kanan bawah area yang dicat. Saat Anda mengatur titik awal ke (0, 25) dan titik akhir ke (150, 25), gradien horizontal dibuat. Demikian pula, mengatur titik awal ke (75, 0) dan titik akhir ke (75, 50) membuat gradien vertikal. Mengatur titik awal ke (0, 50) dan titik akhir ke (150, 0) membuat gradien diagonal yang dimulai di sudut kiri bawah dan meluas ke sudut kanan atas area yang dicat.

Contoh

Contoh berikut menggunakan metode CreateLinearGradientBrush untuk membuat ID2D1LinearGradientBrush (m_pLinearGradientBrush). Ini menggunakan metode pembantu D2D1::LinearGradientBrushProperties untuk membuat struktur D2D1_LINEAR_GRADIENT_BRUSH_PROPERTIES yang berisi titik awal (0, 0) dan titik akhir (150, 150) dan meneruskannya ke metode CreateLinearGradientBrush .

// The line that determines the direction of the gradient starts at
// the upper-left corner of the square and ends at the lower-right corner.

if (SUCCEEDED(hr))
{
    hr = m_pRenderTarget->CreateLinearGradientBrush(
        D2D1::LinearGradientBrushProperties(
            D2D1::Point2F(0, 0),
            D2D1::Point2F(150, 150)),
        pGradientStops,
        &m_pLinearGradientBrush
        );
}

Untuk informasi selengkapnya tentang membuat dan menggunakan kuas gradien linier, lihat topik Cara Membuat Sikat Gradien Linier dan Gambaran Umum Brush.

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]
Header	d2d1.h

Lihat juga

Gambaran Umum Brush

Cara Membuat Sikat Gradien Linier