IObjectWithAppUserModelID インターフェイス (shobjidl_core.h)
カスタム IAssocHandler オブジェクトの実装者が明示的なアプリケーション ユーザー モデル ID (AppUserModelID) へのアクセスを提供できるようにするメソッドを公開します。 この情報は、特定のファイルの種類をアプリケーションのジャンプ リストに追加できるかどうかを判断するために使用されます。
継承
IObjectWithAppUserModelID インターフェイスは、IUnknown インターフェイスから継承されます。 IObjectWithAppUserModelID には、次の種類のメンバーもあります。
メソッド
IObjectWithAppUserModelID インターフェイスには、これらのメソッドがあります。
|
IObjectWithAppUserModelID::GetAppID ファイルの種類ハンドラーの明示的なアプリケーション ユーザー モデル ID (AppUserModelID) を取得します (宣言されている場合)。 |
|
IObjectWithAppUserModelID::SetAppID オブジェクトを特定のファイルの種類のハンドラーとして識別する一意のアプリケーション定義アプリケーション ユーザー モデル ID (AppUserModelID) を指定します。 このメソッドは、動的な AppUserModelID を必要とするアプリケーションで使用されます。 |
注釈
アプリケーションが登録済みハンドラーであるファイルの種類のみが、そのアプリケーションのジャンプ リストに表示されます。 アプリケーションが明示的な AppUserModelID を使用して自身とそのアプリケーションに属するウィンドウとプロセスを識別する場合、そのアプリケーションに関連付けられているものとしてハンドラーが認識されるように、その AppUserModelID もハンドラーの実装で設定する必要があります。 結果として SHAddToRecentDocs が呼び出されるなどのファイルにアプリケーションがアクセスすると、そのアプリケーションのジャンプ リストでファイルを Recent カテゴリまたは Frequent カテゴリ (場合によってはカスタム カテゴリ) に追加しようとします。 アプリケーションがそのファイルの種類の登録済みハンドラーであり、アプリケーションの AppUserModelID と一致するハンドラーの AppUserModelID によってそのように識別される場合、そのファイルはジャンプ リストに追加されます。 そうでない場合は、フィルター処理され、表示されません。
実装するタイミング
このインターフェイスの実装は、Windows で提供されます。 アプリケーションのジャンプ リストで許可されているファイルを決定するためにシステムが必要とする関連付けハンドラー列挙を公開するカスタム シェル フォルダーを作成するアプリケーションは、独自のバージョンを実装する必要があります。使用するタイミング
このオブジェクトは、アプリケーションで明示的な AppUserModelIDs を使用している場合にのみ必要です。 明示的な AppUserModelID を公開しないと、このオブジェクトは必要ありません。IObjectWithAppUserModelID は、明示的な AppUserModelID を使用し、その情報をシステムに公開する大規模なオブジェクトの一部として常に使用されます。
システムは、ハンドラーに実装されている IObjectWithAppUserModelID::GetAppID メソッドを呼び出して、アプリケーションがファイル型の登録済みハンドラーであるかどうかを判断します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | shobjidl_core.h (Shobjidl.h を含む) |