Interfaccia IXpsOMLinearGradientBrush (xpsobjectmodel.h)

Articolo
08/28/2023

Specifica una sfumatura lineare, ovvero la sfumatura di colore lungo un vettore.

Ereditarietà

L'interfaccia IXpsOMLinearGradientBrush eredita da IXpsOMGradientBrush. IXpsOMLinearGradientBrush include anche questi tipi di membri:

Metodi

L'interfaccia IXpsOMLinearGradientBrush include questi metodi.


IXpsOMLinearGradientBrush::Clone Crea una copia completa dell'interfaccia. (IXpsOMLinearGradientBrush.Clone)
IXpsOMLinearGradientBrush::GetEndPoint Ottiene il punto finale della sfumatura.
IXpsOMLinearGradientBrush::GetStartPoint Ottiene il punto iniziale della sfumatura.
IXpsOMLinearGradientBrush::SetEndPoint Imposta il punto finale della sfumatura.
IXpsOMLinearGradientBrush::SetStartPoint Imposta il punto iniziale della sfumatura.

Commenti

Nell'illustrazione che segue, i punti iniziale e finale di una sfumatura lineare sono anche i punti di inizio e di fine del percorso sfumato, ovvero la linea retta che collega tali punti.

L'area del gradiente di una sfumatura lineare è l'area tra e include i punti iniziale e finale e si estende in entrambe le direzioni in corrispondenza di un angolo destro del percorso del gradiente. L'area di diffusione è l'area della geometria che si trova all'esterno dell'area del gradiente.

Le interruzioni sfumature vengono usate per definire il colore in posizioni specifiche lungo il percorso sfumato. Nell'illustrazione, l'interruzione sfumatura 0 si trova nel punto iniziale del percorso sfumato e l'arresto sfumato 1 si trova al punto finale. Il metodo spread XPS_SPREAD_METHOD_PAD viene usato per riempire l'area di distribuzione.

Figura che mostra i termini usati in una sfumatura lineare

L'esempio di codice seguente illustra come creare un'istanza di questa interfaccia.


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
}

Requisiti


Client minimo supportato	Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	xpsobjectmodel.h