IPreviewHandler::D oPreview メソッド (shobjidl_core.h)

前の Initialize メソッド呼び出しで指定されたソースからデータを読み込み、プレビューアー ウィンドウへのレンダリングを開始するようにプレビュー ハンドラーに指示します。

構文

HRESULT DoPreview();

戻り値

型: HRESULT

このメソッドは、これらの値のいずれかを返すことができます。

リターン コード	形容
S_OK	操作が正常に完了しました。
E_PREVIEWHANDLER_DRM_FAIL	デジタル著作権管理によってブロックされます。
E_PREVIEWHANDLER_NOAUTH	ファイルのアクセス許可によってブロックされます。
E_PREVIEWHANDLER_NOTFOUND	アイテムが見つかりませんでした。
E_PREVIEWHANDLER_CORRUPT	アイテムが破損しています。

備考

プレビューアー ウィンドウがまだ作成されていない場合は、このメソッドが呼び出された後に作成する必要があります。 プレビュー ハンドラーは、IPreviewHandler::SetWindow または IPreviewHandler::SetRectで指定された領域を描画します。 プレビュー ハンドラーのレンダリング中にこれらのメソッドを呼び出す場合は、アイテムのレンダリングを停止または再起動せずに、ウィンドウの親の変更/サイズ変更を行う必要があります。

このメソッドは、IPreviewHandler::SetWindow 呼び出された後でのみ呼び出す必要があります。

さらに、このメソッドは、IInitializeWithItem::Initialize 、IInitializeWithStream::Initialize、または IInitializeWithFile::Initialize が呼び出された後にのみ呼び出す必要があります。

注 このメソッドが呼び出されるまで、プレビューアー ウィンドウを実際に作成しないでください。

 

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista、Windows XP [デスクトップ アプリのみ]
サポートされる最小サーバー	Windows Server 2003 [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	shobjidl_core.h (Shobjidl.h を含む)
再頒布可能パッケージの	Windows Search 4 以降