IXpsOMRadialGradientBrush-Schnittstelle (xpsobjectmodel.h)

Artikel
03/13/2024

Gibt einen radialen Farbverlauf an.

Vererbung

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

Methoden

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


IXpsOMRadialGradientBrush:Clone Erstellt eine ausführliche Kopie der Schnittstelle. (IXpsOMRadialGradientBrush.Clone)
IXpsOMRadialGradientBrush::GetCenter Ruft den Mittelpunkt der radialen Farbverlaufsbereichsellipse ab.
IXpsOMRadialGradientBrush::GetGradientOrigin Ruft den Ursprungspunkt des radialen Farbverlaufs ab.
IXpsOMRadialGradientBrush::GetRadiiSizes Ruft die Größen der Radien ab, die die Auslassungspunkte des radialen Farbverlaufsbereichs definieren.
IXpsOMRadialGradientBrush::SetCenter Legt den Mittelpunkt der radialen Farbverlaufsbereichsellipse fest.
IXpsOMRadialGradientBrush::SetGradientOrigin Legt den Ursprungspunkt des radialen Farbverlaufs fest.
IXpsOMRadialGradientBrush::SetRadiiSizes Legt die Größen der Radien fest, die die Ellipse des radialen Farbverlaufsbereichs definieren.

Hinweise

Wie in der folgenden Abbildung dargestellt, ist der Farbverlaufsbereich eines radialen Farbverlaufs der Bereich, der von der Ellipse eingeschlossen ist, die durch den Mittelpunkt und die x- und y-Radien beschrieben wird, die sich vom Mittelpunkt erstrecken. Der Spreizbereich ist der Bereich außerhalb dieser Ellipse. Der Farbverlaufspfad (nicht dargestellt) ist eine radiale Linie, die zwischen dem Farbverlaufsursprung und der Ellipse gezeichnet wird, die den Farbverlaufsbereich begrenzt.

Abbildung, die die in einem radialen Farbverlauf verwendeten Begriffe zeigt

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


IXpsOMRadialGradientBrush    *newInterface;
// The following values are defined outside of 
// this example.
//  IXpsOMGradientStop       *gradStop1, *gradStop2;
//  XPS_POINT                centerPoint, gradientOrigin;
//  XPS_SIZE                 radiiSizes;

// 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->CreateRadialGradientBrush (
        gradStop1,
        gradStop2,
        &centerPoint,
        &gradientOrigin,
        &radiiSizes,
        &newInterface);

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

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

Anforderungen

Anforderung	Wert
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

Weitere Informationen

IXpsOMGradientBrush

IXpsOMLinearGradientBrush

IXpsOMObjectFactory::CreateRadialGradientBrush

Schnittstellen

XML Paper Specification

Freigeben über