IProgressDialog::SetAnimation メソッド (shlobj_core.h)

[このメソッドは、Windows Vista 以降のバージョンではサポートされていません。]

ダイアログ ボックスで実行 Audio-Video インターリーブ (AVI) クリップを指定します。

構文

HRESULT SetAnimation(
  [in, optional] HINSTANCE hInstAnimation,
                 UINT      idAnimation
);

パラメーター

[in, optional] hInstAnimation

種類: HINSTANCE

AVI リソースの読み込み元となるモジュールへのインスタンス ハンドル。

idAnimation

型: UINT

AVI リソース識別子。 この値を作成するには、 MAKEINTRESOURCE マクロを使用します。 コントロールは、 hInstAnimation で指定されたモジュールから AVI リソースを読み込みます。

戻り値

型: HRESULT

成功 した場合はS_OK 、それ以外の場合はエラー値を返します。 Windows Vista 以降のバージョンでは、常に S_OK を返します。

解説

進行状況ダイアログが表示される前に、IProgressDialog::SetAnimation を呼び出すことはできません。 表示されるまで、進行状況ダイアログには有効な HWND がありません。 その HWND の存在を使用して、 IProgressDialog::SetAnimation を呼び出すことができるかどうかを判断できます。

このメソッドは 、hInstAnimation で指定されたインスタンス ハンドルを受け取り、 アニメーション コントロール を使用してサイレント AVI クリップを開いて実行します。 使用できる AVI クリップの種類には、次のようないくつかの制限があります。

• クリップにサウンドを含めることはできません。
• AVI クリップのサイズは 272 x 60 ピクセルを超えることはできません。 小さい四角形は使用できますが、正しく中央に配置されていない可能性があります。
• AVI クリップは、圧縮されていないか、実行長 (BI_RLE8) エンコードで圧縮する必要があります。 サポートされていない圧縮の種類を使用しようとすると、アニメーションは表示されません。

要件

サポートされている最小のクライアント	Windows 2000 Professional、Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	shlobj_core.h
[DLL]	Shell32.dll (バージョン 5.0 以降)

関連項目

IProgressDialog