CAnimateCtrl::Open

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

AVI クリップを開き、最初のフレームを表示します。

BOOL Open(
   LPCTSTR lpszFileName 
);
BOOL Open(
   UINT nID 
);

パラメータ

lpszFileName
AVI ファイル名または AVI リソース名を持つ CString オブジェクト、または NULL で終わる文字列へのポインタ。このパラメータに NULL を指定すると、アニメーションコントロールに対して以前に開いていた AVI クリップがあれば、システムによって閉じられます。
nID
AVI リソースの識別子。このパラメータに NULL を指定すると、アニメーションコントロールに対して以前に開いていた AVI クリップがあれば、システムによって閉じられます。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

アニメーションコントロールを作成したモジュールから AVI リソースが読み込まれます。

Open 関数では、AVI クリップのサウンドをサポートしていないため、サウンドなしの AVI クリップのみが開かれます。

アニメーションコントロールが ACS_AUTOPLAY スタイルのときは、クリップをオープン直後に自動的に再生を開始します。スレッド実行中は、バックグラウンドでクリップを再生し続けます。クリップの再生が終了すると、自動的に再生を繰り返します。

アニメーションコントロールが ACS_CENTER スタイルのときは、AVI クリップはコントロールの中央に配置され、コントロールのサイズは変更されません。アニメーションコントロールが ACS_CENTER スタイルでないときは、AVI クリップを開いたときに、コントロールのサイズは AVI クリップのイメージのサイズに変更されます。コントロールの左上隅の位置は変更されず、コントロールのサイズのみを変更します。

アニメーションコントロールが ACS_TRANSPARENT スタイルのときは、アニメーションクリップに指定された背景色ではなく、透過な背景で最初のフレームが描画されます。