ObjectModel コントロールパターン

メソッドに関する情報を含め、 IObjectModelProvider を実装するためのガイドラインと規則について説明します。 ObjectModel コントロールパターンは、ドキュメントの基になるオブジェクトモデルへのポインターを公開するために使用されます。

多くのアプリケーションでは、Microsoft UI オートメーションが提供する価値を超える価値を追加するリッチオブジェクトモデルを実装しています。このコントロールパターンを使用すると、クライアントはUI オートメーション要素から基になるオブジェクトモデルに移動できます。

このトピックは、次のセクションで構成されています。

実装のガイドラインと規則

ObjectModel コントロールパターンを実装する場合は、次のガイドラインと規則に注意してください。

IObjectModelProvider::GetUnderlyingObjectModel メソッドは、ソース UI 要素にできるだけ近いオブジェクトへのポインターを返す必要があります。たとえば、Web ブラウザーでは、1 つの要素のUI オートメーションプロバイダーは、要素のオブジェクトモデルポインターを返す必要があります。ドキュメントルートのオブジェクトモデルポインターを返す方が、はるかに役に立ちません。
ObjectModel コントロールパターンのクライアントには、探しているインターフェイスの IID が必要です。そのため、単純な IUnknown ポインターを返すのに十分です。
UI オートメーションはクライアントプロセスへのポインターをマーシャリングするため、プロバイダーはクライアントが標準のコンポーネントオブジェクトモデル (COM) プラクティスを使用してオブジェクトモデルにアクセスすることを想定している必要があります。

IObjectModelProvider インターフェイスを実装するために、次のメソッドが必要です。

必須メンバー	メンバーの型	メモ
GetUnderlyingObjectModel	メソッド	基になるオブジェクトモデルへの COM ポインターを返します。クライアントは、特定のオブジェクトモデルポインターを取得するために IUnknown::QueryInterface メソッドを呼び出す必要があります。

このコントロールパターンには、関連するイベントがありません。