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 が呼び出された後にのみ呼び出す必要があります。

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

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

要件

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