Méthode IXpsOMObjectFactory ::CreateSolidColorBrush (xpsobjectmodel.h)

Article
12/22/2023

Crée une interface IXpsOMSolidColorBrush , qui spécifie un pinceau d’une seule couleur unie.

Syntaxe

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

Paramètres

[in] color

Structure XPS_COLOR qui spécifie la couleur du pinceau.

[in] colorProfile

Interface IXpsOMColorProfileResource . Sauf si le type de couleur est XPS_COLOR_TYPE_CONTEXT, cette valeur doit être NULL.

[out, retval] solidColorBrush

Pointeur vers la nouvelle interface IXpsOMSolidColorBrush .

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles incluent, sans s’y limiter, celles du tableau qui suit. Pour plus d’informations sur les valeurs de retour de l’API de document XPS qui ne sont pas répertoriées dans ce tableau, consultez Erreurs de document XPS.

Code de retour	Description
S_OK	S_OK
E_POINTER	color ou solidColorBrush a la valeur NULL.
XPS_E_MISSING_COLORPROFILE	colorProfile a la valeur NULL lorsqu’un profil de couleur est attendu. Un profil de couleur est requis lorsque le type de couleur est XPS_COLOR_TYPE_CONTEXT.
XPS_E_NO_CUSTOM_OBJECTS	colorProfile ne pointe pas vers une implémentation d’interface reconnue. L’implémentation personnalisée des interfaces d’API document XPS n’est pas prise en charge.
XPS_E_UNEXPECTED_COLORPROFILE	colorProfile contient un profil de couleur quand il n’est pas attendu. Un profil de couleur n’est requis que lorsque le type de couleur est XPS_COLOR_TYPE_CONTEXT.

Remarques

L’exemple de code qui suit illustre la façon dont cette méthode est utilisée pour créer une interface.


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
}

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2, Windows Server 2008 avec SP2 et Platform Update pour Windows Server 2008 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	xpsobjectmodel.h