IXpsOMPage::GetDictionary メソッド (xpsobjectmodel.h)

このページに関連付けられている解決済みの IXpsOMDictionary インターフェイスへのポインターを取得します。

構文

HRESULT GetDictionary(
  [out, retval] IXpsOMDictionary **resourceDictionary
);

[out, retval] resourceDictionary

このページに関連付けられている解決済みの IXpsOMDictionary インターフェイスへのポインター。

このパラメーターで返される値は、ディクショナリを設定するために最後に呼び出されたメソッドによって異なります。

呼び出された最新のメソッド	resourceDictionary で返されるオブジェクト
SetDictionaryLocal	SetDictionaryLocal によって設定されるローカルディクショナリリソース。
SetDictionaryResource	SetDictionaryResource によって設定されるディクショナリリソース内の共有ディクショナリ。
SetDictionaryLocal も SetDictionaryResource もまだ呼び出されていません。	NULL ポインター。

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

リターンコード	説明
S_OK	メソッドが成功しました。
E_POINTER	resourceDictionary は NULL です。
XPS_E_LOOKUP_INVALID_TYPE	SetStrokeBrushLookup によって設定された参照キー名は、ブラシではないオブジェクトを参照します。
XPS_E_LOOKUP_NOT_FOUND	参照値に一致するキー名を持つオブジェクトが見つかりませんでした。ルックアップで渡された値と一致するキー名を持つオブジェクトが見つかりませんでした。

ディクショナリがローカルであるか、リモートディクショナリリソース内に含まれているかにかかわらず、このメソッドは IXpsOMDictionary インターフェイスポインターを返します。 GetOwner は、ディクショナリがリモートであるかどうかを判断します。

ページにリモートディクショナリが含まれている場合、 GetDictionary はディクショナリを逆シリアル化します。ページに無効なリモートディクショナリが含まれている場合、 GetDictionary は逆シリアル化エラーコードを返す可能性があります。

リソースを XPS OM に読み込んで解析した後、このメソッドは別のリソースに適用されるエラーを返す可能性があります。これは、リソースが読み込まれるときにすべてのリレーションシップが解析されるために発生します。

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