6.3 動画/音声再生コントロールのメソッド

メソッド 機能 V2.0追加
AboutBox バージョン情報を表示します。  
CanPlay データが再生可能か調べます。  
CopyToClipboard クリップボードに動画の1フレームをコピーします。
Forward 現在位置を前方へ移動します。  
GetCurrentPos 現在位置を取得します。  
GetDIB 動画の1フレームをDIBとして取得します。
GetErrorCode 直前のメソッドのエラー情報を取得します。  
GetSourceRect 描画する矩形を取得します。  
Pause 音声/動画データの再生を一時停止します。  
Play 音声/動画データの再生を開始します。  
Refresh 再描画を行います。  
Reverse 現在位置を後方へ移動します。  
Seek 現在位置を指定位置へ移動します。  
SetMemHandle 動画/音声データを格納したメモリを設定します。  
SetSourceRect 描画する矩形を指定します。  
Stop 音声/動画データの再生を停止します。  

AboutBoxメソッド

[機能]

コントロールのバージョン情報を表示します。

[書式]

C/C++ void AboutBox();
Visual Basic [form.]object.AboutBox

[パラメータ]

なし

[復帰値]

なし


CanPlayメソッド

[機能]

データが再生可能か調べます。

[書式]

C/C++ BOOL CanPlay(BSTR FileName);
Visual Basic form.]object.CanPlay(FileName$)

[パラメータ]

パラメータ 説明
FileName 文字列型 ファイル名文字列を指定します。通常のファイルのほかに、UNCファイル名やURL名も指定できます。

[復帰値]

ブール型
True 再生可能
False 再生不可

CopyToClipboardメソッド

[機能]

クリップボードに動画の1フレームをコピーします。

[書式]

C/C++ BOOL CopyToClipboard(long Pos);
Visual Basic [form.]object.CopyToClipboard(Pos&)

[パラメータ]

パラメータ 説明
Pos 長整数型 クリップボードにコピーする位置を設定します。

[復帰値]

ブール型
True 正常
False 異常

[備考]

[参照]

UnitプロパティGetCurrentPosメソッド


Forwardメソッド

[機能]

現在位置を前方に移動します。

[書式]

C/C++ BOOL Forward(short Amount);
Visual Basic form.]object.Forward(Amount%)

[パラメータ]

パラメータ 設定値 説明
Amount 整数型 cwmSeekAmount5 5 全体の1/5
cwmSeekAmount10 10 全体の1/10
cwmSeekAmount20 20 全体の1/20

[復帰値]

ブール型
True 正常
False 異常

[備考]

再生中の場合、移動後に再生を再開します。

[参照]

Reverseメソッド


GetCurrentPosメソッド

[機能]

現在位置を取得します。

[書式]

C/C++ long GetCurrentPos();
Visual Basic form.]object.GetCurrentPos

[パラメータ]

なし

[復帰値]

長整数型
現在位置 正常
-1 異常

[備考]

返却する現在位置の単位はUnitプロパティに準じます。

[参照]

UnitプロパティCopyToClipboardメソッドGetDIBメソッド


GetDIBメソッド

[機能]

動画の1フレームをWindowsのデバイス独立型ビットマップ(DIB)として取得します。

[書式]

C/C++ OLE_HANDLE GetDIB(long Pos);
Visual Basic [form.]object.GetDIB(Pos&)

[パラメータ]

パラメータ 説明
Pos 長整数型 DIBとして取得する位置を設定します。

[復帰値]

長整数型
0以外 取得したDIBのハンドルです。
0 取得に失敗しました。

[備考]

[参照]

UnitプロパティGetCurrentPosメソッド


GetErrorCodeメソッド

[機能]

メソッドのエラーコードを取得します。

[書式]

C/C++ short GetErrorCode();
Visual Basic [form.]object.GetErrorCode

[復帰値]

整数型
エラーコード

GetSourceRectメソッド

[機能]

動画の原画上で、描画対象となる矩形を取得します。

[書式]

C/C++ BOOL GetSourceRect(short *Left,short *Top,short *Width,short *Height);
Visual Basic [form.]object.GetSourceRect(Left%,Top%,Width%,Height%)

[パラメータ]

パラメータ 説明
Left 整数型 矩形の左上点のx座標
Top 整数型 矩形の左上点のy座標
Width 整数型 矩形の幅
Height 整数型 矩形の高さ

[復帰値]

ブール型
True 正常
False 異常

[備考]

本メソッドを実行していない場合、以下の値となります。なお、音声の場合は、すべて0となります。

Left 0
Top 0
Width 動画の原画の幅
Height 動画の原画の高さ

[参照]

SetSourceRectメソッド


Pauseメソッド

[機能]

再生を一時停止します。現在位置は一時停止した位置となります。

[書式]

C/C++ BOOL Pause();
Visual Basic form.]object.Pause

[パラメータ]

なし

[復帰値]

ブール型
True 正常
False 異常

[備考]

再度、Playメソッドを実行した場合、その時点より再生が開始されます。

[参照]

Playメソッド


Playメソッド

[機能]

Fromプロパティの位置から、Toプロパティの位置まで、再生を行います。

[書式]

C/C++ BOOL Play();
Visual Basic form.]object.Play

[パラメータ]

なし

[復帰値]

ブール型
True 正常
False 異常

[備考]

現在位置がToプロパティで指定した位置と同じ場合は、Fromプロパティの位置より再生が開始されます。

[参照]

FromプロパティToプロパティ


Refreshメソッド

[機能]

コントロールの再描画を行います。

[書式]

C/C++ void Refresh();
Visual Basic [form.]object.Refresh

[パラメータ]

なし

[復帰値]

なし


Reverseメソッド

[機能]

現在位置を後方に移動します。

[書式]

C/C++ BOOL Reverse(short Amount);
Visual Basic form.]object.Reverse(Amount%)

[パラメータ]

パラメータ 設定値 説明
Amount 整数型 cwmSeekAmount5 5 全体の1/5
cwmSeekAmount10 10 全体の1/10
cwmSeekAmount20 20 全体の1/20

[復帰値]

ブール型
True 正常
False 異常

[備考]

再生中の場合、移動後に再生を再開します。

[参照]

Forwardメソッド


Seekメソッド

[機能]

現在位置を指定位置へ移動します。

[書式]

C/C++ BOOL Seek(longTo);
Visual Basic form.]object.Seek(To&)

[パラメータ]

パラメータ 説明
To 長整数型 移動先の位置を指定します。

[復帰値]

ブール型
True 正常
False 異常

[備考]

[参照]

Unitプロパティ


SetMemHandleメソッド

[機能]

メモリに格納した動画/音声データを再生用のデータとして設定します。

[書式]

C/C++ BOOL SetMemHandle(OLE_HANDLE MemHandle,long MemSize);
Visual Basic [form.]object.SetMemHandle(MemHandle&,MemSize&)

[パラメータ]

パラメータ 説明
MemHandle 長整数型 メモリのハンドルを設定します。
MemSize 長整数型 メモリのサイズを設定します。

[復帰値]

ブール型
True 正常
False 異常

[備考]

[参照]

AutoPlayプロパティFileNameプロパティ


SetSourceRectメソッド

[機能]

動画の原画上で、描画対象とする矩形を設定します。

[書式]

C/C++ BOOL SetSourceRect(short Left,shortTop,short Width,short Height);
Visual Basic form.]object.SetSourceRect(Left%,Top%,Width%,Height%)

[パラメータ]

パラメータ 説明
Left 整数型 矩形の左上点のx座標
Top 整数型 矩形の左上点のy座標
Width 整数型 矩形の幅
Height 整数型 矩形の高さ

[復帰値]

ブール型
True 正常
False 異常

[備考]

動画の原画の内、一部分の矩形を切り取って再生する場合に使用します。

[参照]

GetSourceRectメソッド


Stopメソッド

[機能]

再生を停止し、再生位置を先頭に戻します。

[書式]

C/C++ BOOL Stop();
Visual Basic form.]object.Stop

[パラメータ]

なし

[復帰値]

ブール型
True 正常
False 異常

[参照]

Pauseメソッド