Antarmuka IXpsOMGradientStop (xpsobjectmodel.h)

Mewakili satu warna dan lokasi dalam gradien.

Warisan

Antarmuka IXpsOMGradientStop mewarisi dari antarmuka IUnknown . IXpsOMGradientStop juga memiliki jenis anggota berikut:

Metode

Antarmuka IXpsOMGradientStop memiliki metode ini.

IXpsOMGradientStop::Clone Membuat salinan mendalam antarmuka IXpsOMGradientStop.
IXpsOMGradientStop::GetColor Mendapatkan nilai warna dan profil warna pemberhentian gradien.
IXpsOMGradientStop::GetOffset Mendapatkan nilai offset dari pemberhentian gradien.
IXpsOMGradientStop::GetOwner Mendapatkan penunjuk ke antarmuka IXpsOMGradientBrush yang berisi pemberhentian gradien.
IXpsOMGradientStop::SetColor Mengatur nilai warna dan profil warna pemberhentian gradien.
IXpsOMGradientStop::SetOffset Mengatur lokasi offset pemberhentian gradien.

Keterangan

Perhentian gradien adalah warna tertentu yang ditentukan untuk lokasi dalam wilayah gradien. Warna gradien berubah antara pemberhentian gradien gradien. Area dan lokasi absolut gradien ditentukan oleh antarmuka gradien. Offset adalah lokasi relatif dalam wilayah gradien dan diukur antara 0,0 dan 1,0. Offset 0,0 adalah awal gradien dan 1,0 adalah akhir. Pemberhentian gradien dapat ditentukan untuk offset apa pun dalam rentang, termasuk titik akhir. Antarmuka ini menjelaskan satu dan hanya satu stop dalam gradien.

Jalur gradien adalah garis lurus yang menghubungkan titik awal dan titik akhir gradien linier. Wilayah gradien gradien linier terdiri dari area antara titik awal dan titik akhir, termasuk titik-titik tersebut, dan meluas ke kedua arah pada sudut kanan ke jalur gradien. Area penyebaran adalah area di luar wilayah gradien.

Pemberhentian gradien menentukan warna pada lokasi tertentu di sepanjang jalur gradien; warna diinterpolasi di sepanjang jalur gradien antara pemberhentian gradien. Dalam contoh berikut, wilayah gradien mengisi gambar, sehingga tidak ada area penyebaran.

Untuk pemberhentian gradien yang digunakan dalam kuas gradien linier, nilai offset 0,0 sesuai dengan titik awal jalur gradien, dan nilai offset 1,0 sesuai dengan titik akhir. Untuk menentukan lokasi pemberhentian gradien di antara kedua titik ini, nilai offset perantara diinterpolasi di antara keduanya. Ilustrasi berikut menunjukkan dua pemberhentian gradien menengah, satu pada offset 0,25 dan satu lagi di 0,75.

Untuk pemberhentian gradien yang digunakan dalam kuas gradien radial, nilai offset 0,0 sesuai dengan lokasi asal gradien, dan nilai offset 1,0 sesuai dengan lingkar elips yang mengikat gradien. Offset antara 0,0 dan 1,0 menentukan elips yang terinterpolasi antara asal gradien dan elips pembatas. Ilustrasi berikut memiliki satu pemberhentian gradien perantara pada offset 0,50 (Gradien berhenti 1). Gradien menggunakan metode penyebaran XPS_SPREAD_METHOD_REFLECT untuk mengisi ruang di luar wilayah gradien.

Perhitungan yang digunakan untuk merender gradien dijelaskan dalam Spesifikasi Kertas XML.

Contoh kode yang mengikuti menggambarkan cara membuat instans antarmuka ini.

IXpsOMGradientStop    *newInterface;
// The following values are defined outside of 
// this example.
//  XPS_COLOR                    color;
//  IXpsOMColorProfileResource    *colorProfile;
//  FLOAT                        offset;

// 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->CreateGradientStop (
        &color,
        colorProfile,
        offset,
        &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

Lihat juga

IXpsOMGradientBrush

IXpsOMObjectFactory::CreateGradientStop

Antarmuka

Spesifikasi Kertas XML