6.2 動画/音声再生コントロールのプロパティ |
プロパティ | 機能 |
---|---|
Appearance | 境界線の3D表示 |
AutoPlay | 自動再生をする/しない |
BackColorl | 背景色 |
BitsPerPel | 動画データの色数 |
BitsPerSample | 動画データ中の音声部分、または音声データの量子化ビット数 |
BorderStyle | 境界線のスタイル |
Channels | 動画データの音声部分、または音声データのチャンネル数 |
ControlBar | コントロールバーの表示 |
ControlBarStyle | コントロールバーのスタイル |
FileName | 動画/音声データのファイル名 |
From | 再生を開始する位置 |
Length | 動画/音声データの長さ |
MediaFormat | 動画/音声データの形式 |
MovieHeight | 動画データの原画の高さ |
MovieWidth | 動画データの原画の幅 |
PlayCount | リピート再生の回数 |
ReadyState | コントロールの現在の状態 |
SamplesPerSecond | 動画データの音声部分、または音声データのサンプリング周波数 |
Speed | 再生スピード |
StatusBar | ステータスバーの表示 |
To | 再生を終了する位置 |
TrackBar | トラックバーの表示 |
Unit | 位置の単位 |
ViewStyle | 表示スタイル |
[機能]
コントロールの境界線の3D表示の有無を設定します。
[書式]
C/C++ | short | Appearance; |
Visual Basic | [form.]object.Appearance[=Appearance%] |
[データ型]
整数型
[設定値]
設定値 | 説明 |
---|---|
0 | フラット(デフォルト) |
1 | 3D |
[用法]
設計時 設定、参照
実行時 設定、参照
[参照]
[機能]
動画/音声データの再生を自動的に行うかを設定します。
[書式]
C/C++ | BOOL | AutoPlay; |
Visual Basic | [form.]object.AutoPlay[={True|False }] |
[データ型]
ブール型
[設定値]
設定値 | 説明 |
---|---|
True | 自動再生されます。 |
False | 自動再生されません。(デフォルト) |
[用法]
設計時 設定、参照
実行時 設定、参照
[備考]
本プロパティは、FileNameプロパティ更新時、SetMemHandleメソッド実行時に参照されます。
[参照]
FileNameプロパティ、SetMemHandleメソッド、Playメソッド
[機能]
コントロールの背景色を設定します。
[書式]
C/C++ | OLE_COLOR | BackColor; |
VisualBasic | [form.]object.BackColor[=BackColor&] |
[データ型]
長整数型
[設定値]
設定値 | 説明 |
---|---|
Red値、Green値、Blue値 | RGB値を設定します。デフォルトは、アプリケーションの背景色です。 |
[用法]
設計時 設定、参照
実行時 設定、参照
[機能]
動画データの色数をビット数で参照します。
[書式]
C/C++ | short | BitsPerPel; |
Visual Basic | [form.]object.BitsPerPel |
[データ型]
整数型
[参照値]
参照値 | 説明 |
---|---|
ビット数 | 動画データが読み込まれていない場合は、cwmUnknown(-1)となります。 |
[用法]
設計時 なし
実行時 参照
[機能]
動画データの音声部分、音声データの量子化ビット数を参照します。
[書式]
C/C++ | short | BitsPerSample; |
Visual Basic | [form.]object.BitsPerSample |
[データ型]
整数型
[参照値]
参照値 | 値 | 説明 |
---|---|---|
cwmAudioNone | 0 | 音声なし |
cwmBitsPerSample8 | 8 | 8ビット |
cwmBitsPerSample16 | 16 | 16ビット |
cwmUnknown | -1 | 動画/音声データが読み込まれていません。 |
[用法]
設計時 なし
実行時 参照
[備考]
量子化ビット数とは、音声をデジタル化する際に使用するパラメータの一つです。8ビットより、16ビットの方が原音に近くなります。
[機能]
コントロールの境界線のスタイルを設定します。
[書式]
C/C++ | short | BorderStyle; |
Visual Basic | [form.]object.BorderStyle[=BorderStyle%] |
[データ型]
整数型
[設定値]
設定値 | 説明 |
---|---|
0 | なし(デフォルト) |
1 | 実線 |
[用法]
設計時 設定、参照
実行時 設定、参照
[参照]
[機能]
動画に含まれる音声データのチャンネル数、音声データのチャンネル数を参照します。
[書式]
C/C++ | short | Channels; |
Visual Basic | [form.]object.Channels |
[データ型]
整数型
[参照値]
参照値 | 値 | 説明 |
---|---|---|
cwmChannelsMono | 1 | モノラル |
cwmChannelsStereo | 2 | ステレオ |
cwmAudioNone | 0 | 音声なし |
cwmUnknown | -1 | 動画/音声データが読み込まれていません。 |
[用法]
設計時 なし
実行時 参照
[機能]
再生や停止などを制御するコントロールバーを表示するかを設定します。
[書式]
C/C++ | BOOL | ControlBar; |
Visual Basic | [form.]object.ControlBar[={True|False }] |
[データ型]
ブール型
[設定値]
設定値 | 説明 |
---|---|
True | 表示されます。(デフォルト) |
False | 表示されません。 |
[用法]
設計時 設定、参照
実行時 設定、参照
[参照]
ControlBarStyleプロパティ、StatusBarプロパティ、TrackBarプロパティ
[機能]
コントロールバーの表示スタイルを設定します。
[書式]
C/C++ | short | ControlBarStyle; |
Visual Basic | [form.]object.ControlBarStyle[=ControlBarStyle%] |
[データ型]
整数型
[設定値]
設定値 | 値 | 説明 |
---|---|---|
cwmControlBarStandard | 0 | 再生、停止、リセット、早送り、巻き戻しの各ボタンが表示されます。(デフォルト) |
cwmControlBarSimple | 1 | 再生、停止の各ボタンが表示されます。 |
[用法]
設計時 設定、参照
実行時 設定、参照
[備考]
音声データの場合は、cwmControlBarSimple(1)となります。
[参照]
[機能]
再生する動画/音声データのファイル名を設定します。
[書式]
C/C++ | BSTR | FileName; |
Visual Basic | [form.]object.FileName[=FileName$] |
[データ型]
文字列型
[設定値]
設定値 | 説明 |
---|---|
動画/音声データのファイル名文字列 | 通常のファイル名のほかに、UNCファイル名、URL名が設定できます。デフォルトは空文字列です。 |
[用法]
設計時 設定、参照
実行時 設定、参照
[備考]
FileNameプロパティにファイル名を設定すると、AutoPlayプロパティがTrueの場合は、自動で再生が開始されます。
[参照]
AutoPlayプロパティ、SetMemHandleメソッド
[機能]
再生を開始する位置を設定します。
[書式]
C/C++ | long | From; |
Visual Basic | [form.]object.From[=From&] |
[データ型]
長整数型
[設定値]
設定値 | 説明 |
---|---|
再生開始位置 | 0〜Lengthプロパティの範囲で指定します。デフォルトは0です。 |
[用法]
設計時 設定、参照
実行時 設定、参照
[備考]
位置の単位は、Unitプロパティに準じます。
[参照]
[機能]
動画/音声データの長さを参照します。
[書式]
C/C++ | long | Length; |
Visual Basic | [form.]object.Length |
[データ型]
長整数型
[参照値]
参照値 | 説明 |
---|---|
動画/音声データの長さ | 動画/音声データが読み込まれていない場合は0です。 |
[用法]
設計時 なし
実行時 参照
[備考]
長さの単位は、Unitプロパティに準じます。
[参照]
[機能]
動画/音声データの種類を参照します。
[書式]
C/C++ | short | MediaFormat; |
Visual Basic | [form.]object.MediaFormat |
[データ型]
整数型
[参照値]
参照値 | 値 | 説明 |
---|---|---|
cwmFileWAVE | 201 | WAVE |
cwmFileMIDI | 202 | MIDI |
cwmFileAVI | 301 | AVI |
cwmFileMPEG | 302 | MPEG1 |
cwmUnknown | -1 | 動画/音声データが読み込まれていません。 |
[用法]
設計時 なし
実行時 参照
[機能]
動画の高さを参照します。
[書式]
C/C++ | short | MovieHeight; |
Visual Basic | [form.]object.MovieHeight |
[データ型]
整数型
[参照値]
参照値 | 説明 |
---|---|
動画の高さ | 動画データが読み込まれていない場合は0です。 |
[用法]
設計時 なし
実行時 参照
[参照]
[機能]
動画の幅を参照します。
[書式]
C/C++ | short | MovieWidth; |
Visual Basic | [form.]object.MovieWidth |
[データ型]
整数型
[参照値]
参照値 | 説明 |
---|---|
動画の幅 | 動画データが読み込まれていない場合は0です。 |
[用法]
設計時 なし
実行時 参照
[参照]
[機能]
再生する回数を設定します。
[書式]
C/C++ | short | PlayCount; |
Visual Basic | [form.]object.PlayCount[=PlayCount%] |
[データ型]
整数型
[設定値]
設定値 | 説明 |
---|---|
再生回数 | デフォルトは1です。0を設定した場合は、無制限に再生を繰り返します。 |
[用法]
設計時 設定、参照
実行時 設定、参照
[備考]
PlayCountプロパティは、再生開始時に参照します。
[参照]
[機能]
コントロールの現在の状態を参照します。
[書式]
C/C++ | short | ReadyState; |
Visual Basic | [form.]object.ReadyState |
[データ型]
整数型
[参照値]
参照値 | 説明 |
---|---|
0 | 初期化状態 |
1 | データを読み込み中 |
2 | 初期化済 |
4 | データの読み込みを完了 |
[用法]
設計時 なし
実行時 参照のみ
[備考]
ReadyStateChangeイベント内で、本プロパティを参照することにより、コントロールの状態を参照することができます。
[参照]
[機能]
動画の音声データのサンプリング周波数、音声データのサンプリング周波数を参照します。
[書式]
C/C++ | long | SamplesPerSecond; |
Visual Basic | [form.]object.SamplesPerSecond |
[データ型]
長整数型
[参照値]
参照値 | 説明 |
---|---|
サンプリング周波数 | 単位はHz(ヘルツ)です。 |
0 | 音声なしの動画データです。 |
-1 | 動画/音声データが読み込まれていません。 |
[用法]
設計時 なし
実行時 参照
[備考]
サンプリング周波数とは、音声をデジタル化する際に使用するパラメータ値のひとつです。周波数値が高いほど、原音に近くなります。
[機能]
動画データの再生速度を設定します。
[書式]
C/C++ | double | Speed; |
Visual Basic | [form.]object.Speed[=Speed#] |
[データ型]
倍精度浮動小数点型
[設定値]
設定値 | 説明 |
---|---|
再生速度の比率 | 0.5〜2.0の間で設定します。デフォルトは1.0で、通常の再生速度です。 |
[用法]
設計時 設定、参照
実行時 設定、参照
[参照]
[機能]
現在位置とデータの総量、現在の状態を表示するステータスバーを表示するかを設定します。
[書式]
C/C++ | BOOL | StatusBar; |
Visual Basic | [form.]object.StatusBar[={True|False }] |
[データ型]
ブール型
[設定値]
設定値 | 説明 |
---|---|
True | 表示されます。(デフォルト) |
False | 表示されません。 |
[用法]
設計時 設定、参照
実行時 設定、参照
[参照]
[機能]
再生を終了する位置を設定します。
[書式]
C/C++ | long | To; |
Visual Basic | [form.]object.To[=To&] |
[データ型]
長整数型
[設定値]
設定値 | 説明 |
---|---|
再生終了位置 | 0〜Lengthプロパティの範囲で設定します。デフォルトは0で、終端を意味します。 |
[用法]
設計時 設定、参照
実行時 設定、参照
[備考]
位置の単位は、Unitプロパティに準じます。
[参照]
Unitプロパティ、Lengthプロパティ、Fromプロパティ
[機能]
データの総量と現在位置を表すトラックバー(目盛りとつまみで構成)を表示するかを設定します。
[書式]
C/C++ | BOOL | TrackBar; |
Visual Basic | [form.]object.TrackBar[={True|False }] |
[データ型]
ブール型
[設定値]
設定値 | 説明 |
---|---|
True | 表示されます。(デフォルト) |
False | 表示されません。 |
[用法]
設計時 設定、参照
実行時 設定、参照
[備考]
ControlBarプロパティがTrueの場合に有効です。
[参照]
ControlBarプロパティ、StatusBarプロパティ
[機能]
動画/音声データの位置の単位を設定します。
[書式]
C/C++ | short | Unit; |
Visual Basic | [form.]object.Unit[=Unit%] |
[データ型]
整数型
[設定値]
設定値 | 値 | 説明 |
---|---|---|
cwmUnitMilliSec | 0 | ミリ秒(デフォルト) |
cwmUnitFrame | 1 | フレーム |
[用法]
設計時 設定、参照
実行時 設定、参照
[備考]
[参照]
Fromプロパティ、Lengthプロパティ、Toプロパティ、GetCurrentPosメソッド、Seekメソッド
[機能]
動画データを表示するスタイルを設定します。
[書式]
C/C++ | short | ViewStyle; |
Visual Basic | [form.]object.ViewStyle[=ViewStyle%] |
[データ型]
整数型
[設定値]
設定値 | 値 | 説明 |
---|---|---|
cwmViewNormal | 0 | メディアを拡大/縮小せずに表示されます。(デフォルト) |
cwmViewAdjust | 1 | 縦と横の比率を守って、コントロールサイズに合わせます。 |
cwmVewStretch | 2 | 縦と横の比率を守らずに、コントロールサイズに合わせます。 |
cwmViewAutosize | 3 | 動画のサイズに合わせて、コントロールサイズが変化します。 |
[用法]
設計時 設定、参照
実行時 設定、参照