Metodo IXpsOMObjectFactory::CreateSolidColorBrush (xpsobjectmodel.h)

Articolo
03/13/2024

Crea un'interfaccia IXpsOMSolidColorBrush , che specifica un pennello di un singolo colore a tinta unita.

Sintassi

HRESULT CreateSolidColorBrush(
  [in]          const XPS_COLOR            *color,
  [in]          IXpsOMColorProfileResource *colorProfile,
  [out, retval] IXpsOMSolidColorBrush      **solidColorBrush
);

Parametri

[in] color

Struttura XPS_COLOR che specifica il colore del pennello.

[in] colorProfile

Interfaccia IXpsOMColorProfileResource . A meno che il tipo di colore non sia XPS_COLOR_TYPE_CONTEXT, questo valore deve essere NULL.

[out, retval] solidColorBrush

Puntatore alla nuova interfaccia IXpsOMSolidColorBrush .

Valore restituito

Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a quelli della tabella che segue. Per informazioni sui valori restituiti dall'API documento XPS non elencati in questa tabella, vedere Errori del documento XPS.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_POINTER	color o solidColorBrush è NULL.
XPS_E_MISSING_COLORPROFILE	colorProfile è NULL quando è previsto un profilo di colore. È necessario un profilo di colore quando il tipo di colore è XPS_COLOR_TYPE_CONTEXT.
XPS_E_NO_CUSTOM_OBJECTS	colorProfile non punta a un'implementazione dell'interfaccia riconosciuta. L'implementazione personalizzata delle interfacce API documento XPS non è supportata.
XPS_E_UNEXPECTED_COLORPROFILE	colorProfile contiene un profilo di colore quando non è previsto. È necessario un profilo di colore solo quando il tipo di colore è XPS_COLOR_TYPE_CONTEXT.

Commenti

L'esempio di codice seguente illustra come viene usato questo metodo per creare una nuova interfaccia.


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

// 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->CreateSolidColorBrush (
        &color,
        colorProfile,
        &newInterface);

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

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

Requisiti

Requisito	Valore
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