Antarmuka ID2D1GradientStopCollection (d2d1.h)

Artikel
08/22/2023

Mewakili kumpulan objek D2D1_GRADIENT_STOP untuk kuas gradien linier dan radial.

Warisan

Antarmuka ID2D1GradientStopCollection mewarisi dari ID2D1Resource. ID2D1GradientStopCollection juga memiliki jenis anggota berikut:

Metode

Metode

Antarmuka ID2D1GradientStopCollection memiliki metode ini.


ID2D1GradientStopCollection::GetColorInterpolationGamma Menunjukkan ruang gamma tempat pemberhentian gradien diinterpolasi.
ID2D1GradientStopCollection::GetExtendMode Menunjukkan perilaku gradien di luar rentang gradien yang dinormalisasi.
ID2D1GradientStopCollection::GetGradientStopCount Mengambil jumlah pemberhentian gradien dalam koleksi.
ID2D1GradientStopCollection::GetGradientStops Menyalin perhentian gradien dari koleksi ke dalam array struktur D2D1_GRADIENT_STOP.

Keterangan

Membuat Objek ID2D1GradientStopCollection

Untuk membuat ID2D1GradientStopCollection, gunakan metode ID2D1RenderTarget::CreateGradientStopCollection .

Koleksi penghentian gradien adalah sumber daya yang bergantung pada perangkat: aplikasi Anda harus membuat koleksi penghentian gradien setelah menginisialisasi target render yang akan digunakan pengumpulan penghentian gradien, dan membuat ulang koleksi penghentian gradien setiap kali target render perlu dibuat ulang. (Untuk informasi selengkapnya tentang sumber daya, lihat Gambaran Umum Sumber Daya.)

Contoh

Contoh berikut membuat array pemberhentian gradien, lalu menggunakannya untuk membuat ID2D1GradientStopCollection.

// Create an array of gradient stops to put in the gradient stop
// collection that will be used in the gradient brush.
ID2D1GradientStopCollection *pGradientStops = NULL;

D2D1_GRADIENT_STOP gradientStops[2];
gradientStops[0].color = D2D1::ColorF(D2D1::ColorF::Yellow, 1);
gradientStops[0].position = 0.0f;
gradientStops[1].color = D2D1::ColorF(D2D1::ColorF::ForestGreen, 1);
gradientStops[1].position = 1.0f;
// Create the ID2D1GradientStopCollection from a previously
// declared array of D2D1_GRADIENT_STOP structs.
hr = m_pRenderTarget->CreateGradientStopCollection(
    gradientStops,
    2,
    D2D1_GAMMA_2_2,
    D2D1_EXTEND_MODE_CLAMP,
    &pGradientStops
    );

Contoh kode berikutnya menggunakan ID2D1GradientStopCollection untuk membuat ID2D1LinearGradientBrush.

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

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

Lihat juga

ID2D1Resource

Bagikan melalui