Animate_OpenEx マクロ (commctrl.h)

  • [アーティクル]

指定したモジュール内のリソースから AVI クリップを開き、アニメーション コントロールにその最初のフレームを表示します。 このマクロを使用することも、 ACM_OPEN メッセージを明示的に送信することもできます。

構文

void Animate_OpenEx(
   hwnd,
   hInst,
   szName
);

パラメーター

hwnd

種類: HWND

アニメーション コントロールへのハンドル。

hInst

種類: HINSTANCE

リソースの読み込み元となるモジュールへのインスタンス ハンドル。 この値が NULL の場合、リソースはアニメーション コントロールを作成したモジュールから読み込まれます。

szName

種類: LPTSTR

AVI ファイルのパスまたは AVI リソースの名前を含むバッファーへのポインター。 または、このパラメーターは LOWORD の AVI リソース識別子と HIWORD の 0 で構成できます。 この値を作成するには、 MAKEINTRESOURCE マクロを使用します。 コントロールは 、hinst によって指定されたモジュールから AVI リソースを読み込みます。 lpszName で指定された AVI ファイルまたはリソースにオーディオを含めてはいけません。

このパラメーターが NULL の場合、指定したアニメーション コントロールに対して以前に開いていた AVI ファイルが閉じられます (存在する場合)。

戻り値

なし

解説

サイレント AVI クリップのみを開くことができます。 lpszName でサウンドを含む AVI クリップが指定されている場合、ACM_OPENとAnimate_Openは失敗します。

Animate_Closeを使用して、指定したアニメーション コントロールに対して以前に開いた AVI ファイルまたは AVI リソースを閉じます。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー commctrl.h