Antarmuka IXpsOMLinearGradientBrush (xpsobjectmodel.h)

Artikel
12/22/2023

Menentukan gradien linier, yang merupakan gradien warna di sepanjang vektor.

Warisan

Antarmuka IXpsOMLinearGradientBrush mewarisi dari IXpsOMGradientBrush. IXpsOMLinearGradientBrush juga memiliki jenis anggota berikut:

Metode

Antarmuka IXpsOMLinearGradientBrush memiliki metode ini.


IXpsOMLinearGradientBrush::Clone Membuat salinan mendalam antarmuka. (IXpsOMLinearGradientBrush.Clone)
IXpsOMLinearGradientBrush::GetEndPoint Mendapatkan titik akhir gradien.
IXpsOMLinearGradientBrush::GetStartPoint Mendapatkan titik awal gradien.
IXpsOMLinearGradientBrush::SetEndPoint Mengatur titik akhir gradien.
IXpsOMLinearGradientBrush::SetStartPoint Mengatur titik awal gradien.

Keterangan

Dalam ilustrasi yang mengikuti, titik awal dan akhir gradien linier juga merupakan titik awal dan akhir dari jalur gradien, yang merupakan garis lurus yang menghubungkan titik-titik tersebut.

Wilayah gradien gradien gradien adalah area antara dan termasuk titik awal dan akhir dan meluas ke kedua arah pada sudut kanan ke jalur gradien. Area penyebaran adalah area geometri yang terletak di luar wilayah gradien.

Pemberhentian gradien digunakan untuk menentukan warna di lokasi tertentu di sepanjang jalur gradien. Dalam ilustrasi, gradient stop 0 terletak di titik awal jalur gradien, dan gradien stop 1 berada di titik akhir. Metode penyebaran XPS_SPREAD_METHOD_PAD digunakan untuk mengisi area penyebaran.

Gambar yang menunjukkan istilah yang digunakan dalam gradien linier

Contoh kode yang mengikuti menggambarkan cara membuat instans antarmuka ini.


IXpsOMLinearGradientBrush    *newInterface;
// The following values are defined outside of 
// this example.
//  IXpsOMGradientStop       *gradStop1, *gradStop2;
//  XPS_POINT                startPoint, endPoint;

// Note the implicit requirement that CoInitializeEx 
//  has previously been called from this thread.

hr = CoCreateInstance(
    __uuidof(XpsOMObjectFactory),
    NULL,
    CLSCTX_INPROC_SERVER,
    _uuidof(IXpsOMObjectFactory),
    reinterpret_cast<LPVOID*>(&xpsFactory)
    );

if (SUCCEEDED(hr))
{
    hr = xpsFactory->CreateLinearGradientBrush (
        gradStop1,
        gradStop2,
        &startPoint,
        &endPoint,
        &newInterface);

    if (SUCCEEDED(hr))
    {
        // use newInterface

        newInterface->Release();
    }
    xpsFactory->Release();
}
else
{
    // evaluate HRESULT error returned in hr
}

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	xpsobjectmodel.h