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

フォント リソースへの IStream インターフェイスを提供する IXpsOMFontResource インターフェイスを作成します。

構文

HRESULT CreateFontResource(
  [in]          IStream            *acquiredStream,
  [in]          XPS_FONT_EMBEDDING fontEmbedding,
  [in]          IOpcPartUri        *partUri,
  [in]          BOOL               isObfSourceStream,
  [out, retval] IXpsOMFontResource **fontResource
);

パラメーター

[in] acquiredStream

このフォント リソースに関連付ける読み取り専用 IStream インターフェイス。 このパラメーターは NULL にすることはできません。

[in] fontEmbedding

ストリーム の 埋め込みオプションを指定するXPS_FONT_EMBEDDING値。

[in] partUri

このリソースに割り当てるパーツ名を含む IOpcPartUri インターフェイス。 このパラメーターは NULL にすることはできません。

[in] isObfSourceStream

acquiredStream によって参照されるストリームが難読化されているかどうかを示すブール値。

[out, retval] fontResource

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

戻り値

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

注釈

isObfSourceStream の値は、フォント リソースが作成された時点での acquiredStream 参照ストリームの状態を表します。 GetStream または SetContent に対する後続のすべての呼び出しは、難読化されていないバージョンの IStream に対して動作します。

isObfSourceStream が TRUE に設定され、fontEmbedding がXPS_FONT_EMBEDDING_NORMALに設定されている場合、または partUri によって参照される名前が難読化ストリームの構文に準拠していない場合は、エラーが返されます。

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

IXpsOMFontResource    *newInterface;
IOpcPartUri           *partUri;

// 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))
{
    // The partUriString and acquiredStream variables 
    //   are defined outside of this example.
    hr = xpsFactory->CreatePartUri(partUriString, &partUri);
    if (SUCCEEDED(hr))
    {
        hr = xpsFactory->CreateFontResource (
            acquiredStream, 
            XPS_FONT_EMBEDDING_NORMAL,    // normal
            partUri, 
            FALSE,                        // not obfuscated
            &newInterface);
        if (SUCCEEDED(hr))
        {
            // use newInterface

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

要件

こちらもご覧ください

IOpcPartUri

IXpsOMFontResource

IXpsOMObjectFactory

XML Paper Specification

XPS ドキュメント エラー

XPS_FONT_EMBEDDING