IXpsOMLinearGradientBrush-Schnittstelle (xpsobjectmodel.h)

Artikel
08/28/2023

Gibt einen linearen Farbverlauf an, bei dem es sich um den Farbverlauf entlang eines Vektors handelt.

Vererbung

Die IXpsOMLinearGradientBrush-Schnittstelle erbt von IXpsOMGradientBrush. IXpsOMLinearGradientBrush verfügt auch über folgende Arten von Membern:

Methoden

Die IXpsOMLinearGradientBrush-Schnittstelle verfügt über diese Methoden.


IXpsOMLinearGradientBrush::Clone Erstellt eine ausführliche Kopie der Schnittstelle. (IXpsOMLinearGradientBrush.Clone)
IXpsOMLinearGradientBrush::GetEndPoint Ruft den Endpunkt des Farbverlaufs ab.
IXpsOMLinearGradientBrush::GetStartPoint Ruft den Startpunkt des Farbverlaufs ab.
IXpsOMLinearGradientBrush::SetEndPoint Legt den Endpunkt des Farbverlaufs fest.
IXpsOMLinearGradientBrush::SetStartPoint Legt den Startpunkt des Farbverlaufs fest.

Hinweise

In der folgenden Abbildung sind die Anfangs- und Endpunkte eines linearen Farbverlaufs auch die Anfangs- und Endpunkte des Farbverlaufspfads, der geraden Linie, die diese Punkte verbindet.

Der Farbverlaufsbereich eines linearen Farbverlaufs ist der Bereich zwischen und, der den Start- und Endpunkt einschließt und sich in beide Richtungen im rechten Winkel zum Farbverlauf erstreckt. Der Spreizbereich ist der Bereich der Geometrie, der außerhalb des Farbverlaufsbereichs liegt.

Farbverlaufsstopps werden verwendet, um die Farbe an bestimmten Stellen entlang des Farbverlaufspfads zu definieren. In der Abbildung befindet sich der Farbverlaufsstopp 0 am Anfangspunkt des Farbverlaufspfads, und Der Farbverlaufsstopp 1 befindet sich am Endpunkt. Die XPS_SPREAD_METHOD_PAD Spreadmethode wird verwendet, um den Spreadbereich zu füllen.

Abbildung, die die in einem linearen Farbverlauf verwendeten Begriffe zeigt

Im folgenden Codebeispiel wird veranschaulicht, wie Sie eine instance dieser Schnittstelle erstellen.


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
}

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	xpsobjectmodel.h