IXpsOMObjectFactory::CreateSolidColorBrush メソッド (xpsobjectmodel.h)

[アーティクル]
03/05/2024

単色のブラシを指定する IXpsOMSolidColorBrush インターフェイスを作成します。

構文

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

パラメーター

[in] color

ブラシの色を指定する XPS_COLOR 構造体。

[in] colorProfile

IXpsOMColorProfileResource インターフェイス。色の種類が XPS_COLOR_TYPE_CONTEXTされていない限り、この値は NULL である必要があります。

[out, retval] solidColorBrush

新しい IXpsOMSolidColorBrush インターフェイスへのポインター。

戻り値

このメソッドは HRESULT を返します。使用可能な値には、次の表に含まれる値が含まれますが、これらに限定されません。この表に記載されていない XPS ドキュメント API の戻り値については、「 XPS ドキュメントエラー」を参照してください。

リターンコード	説明
S_OK	メソッドが成功しました。
E_POINTER	color または solidColorBrush が NULL です。
XPS_E_MISSING_COLORPROFILE	カラープロファイルが必要な場合、colorProfile は NULL です。色の種類が XPS_COLOR_TYPE_CONTEXT場合は、カラープロファイルが必要です。
XPS_E_NO_CUSTOM_OBJECTS	colorProfile は、認識されたインターフェイス実装を指していません。 XPS ドキュメント API インターフェイスのカスタム実装はサポートされていません。
XPS_E_UNEXPECTED_COLORPROFILE	colorProfile には、予期しない色プロファイルが含まれます。カラープロファイルは、色の種類が XPS_COLOR_TYPE_CONTEXT場合にのみ必要です。

注釈

次のコード例は、このメソッドを使用して新しいインターフェイスを作成する方法を示しています。


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
}

要件

要件	値
サポートされている最小のクライアント	Windows 7、Windows Vista SP2 と Windows Vista 用プラットフォーム更新プログラム [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップアプリ \|UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	xpsobjectmodel.h