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

Artículo
12/22/2023

Crea una interfaz IXpsOMSolidColorBrush , que especifica un pincel de un único color sólido.

Sintaxis

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

Parámetros

[in] color

Estructura XPS_COLOR que especifica el color del pincel.

[in] colorProfile

Interfaz IXpsOMColorProfileResource . A menos que el tipo de color sea XPS_COLOR_TYPE_CONTEXT, este valor debe ser NULL.

[out, retval] solidColorBrush

Puntero a la nueva interfaz IXpsOMSolidColorBrush .

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen, entre otros, los de la tabla siguiente. Para obtener información sobre los valores devueltos de la API de documentos XPS que no aparecen en esta tabla, vea Errores del documento XPS.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
E_POINTER	color o solidColorBrush es NULL.
XPS_E_MISSING_COLORPROFILE	colorProfile es NULL cuando se espera un perfil de color. Se requiere un perfil de color cuando se XPS_COLOR_TYPE_CONTEXT el tipo de color.
XPS_E_NO_CUSTOM_OBJECTS	colorProfile no apunta a una implementación de interfaz reconocida. No se admite la implementación personalizada de interfaces de LA API de documentos XPS.
XPS_E_UNEXPECTED_COLORPROFILE	colorProfile contiene un perfil de color cuando no se espera uno. Solo se requiere un perfil de color cuando el tipo de color es XPS_COLOR_TYPE_CONTEXT.

Comentarios

En el ejemplo de código siguiente se muestra cómo se usa este método para crear una nueva interfaz.


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
}

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008 [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	xpsobjectmodel.h