Interfaccia IXpsOMLinearGradientBrush (xpsobjectmodel.h)
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.
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 |