IPreviewHandler インターフェイス (shobjidl_core.h)

リッチ プレビューの表示用のメソッドを公開します。

継承

IPreviewHandler インターフェイスは、IUnknown インターフェイスから継承されます。 IPreviewHandler には、次の種類のメンバーもあります。

メソッド

IPreviewHandler インターフェイスには、これらのメソッドがあります。

IPreviewHandler::D oPreview 以前の Initialize メソッド呼び出しで指定したソースからデータを読み込み、プレビューアー ウィンドウへのレンダリングを開始するようにプレビュー ハンドラーに指示します。
IPreviewHandler::QueryFocus GetFocus 関数の呼び出しから HWND を返すようにプレビュー ハンドラーに指示します。
IPreviewHandler::SetFocus プレビュー ハンドラーにフォーカスを設定するように指示します。
IPreviewHandler::SetRect プレビュー ハンドラーに、描画先の親 hwnd 内の領域を変更するように指示します。
IPreviewHandler::SetWindow プレビューアー ウィンドウの親ウィンドウと、プレビューアー ウィンドウに使用する親内の領域を設定します。
IPreviewHandler::TranslateAccelerator プレビュー ハンドラーが実行されているプロセスのメッセージ ポンプから渡されたキーストロークを処理するようにプレビュー ハンドラーに指示します。
IPreviewHandler::Unload プレビュー ハンドラーに、プレビューのレンダリングを中止し、初期化中に渡された項目に基づいて割り当てられているすべてのリソースを解放するように指示します。

注釈

プレビュー ハンドラーは、マネージド コードに組み込むことができます。 通常、すべてのプレビュー ハンドラーは、prevhost.exe と呼ばれるサロゲート プロセスで一緒にホストされます。 このプロセスには、通常の整合性レベルで実行されているプレビュー ハンドラーのインスタンスと、低整合性レベルで実行されているプレビュー ハンドラーのインスタンスがあります。 マネージド コードでハンドラーを実装する場合は、これらの共有プロセスの内部でハンドラーを実行しないでください。 代わりに、レジストリに新しい AppID エントリを作成し (dllSurrogate 値として prevhost.exe を指定)、ハンドラーのクラス ID のレジストリ値に AppID 値として設定することで、ハンドラーが prevhost.exe の新しいインスタンスを取得するように調整します。 これにより、他のハンドラーで使用される一般的なインスタンスではなく、ハンドラーに対して一意の prevhost.exe インスタンスが作成されます。

要件

要件	値
サポートされている最小のクライアント	Windows Vista、Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	shobjidl_core.h
再頒布可能パッケージ	Windows Search 4 以降