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 表示スタイル

Appearanceプロパティ

[機能]

コントロールの境界線の3D表示の有無を設定します。

[書式]

C/C++ short Appearance;
Visual Basic [form.]object.Appearance[=Appearance%]

[データ型]

整数型

[設定値]

設定値 説明
0 フラット(デフォルト)
1 3D

[用法]

設計時 設定、参照

実行時 設定、参照

[参照]

BorderStyleプロパティ


AutoPlayプロパティ

[機能]

動画/音声データの再生を自動的に行うかを設定します。

[書式]

C/C++ BOOL AutoPlay;
Visual Basic [form.]object.AutoPlay[={True|False }]

[データ型]

ブール型

[設定値]

設定値 説明
True 自動再生されます。
False 自動再生されません。(デフォルト)

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

本プロパティは、FileNameプロパティ更新時、SetMemHandleメソッド実行時に参照されます。

[参照]

FileNameプロパティSetMemHandleメソッドPlayメソッド


BackColorプロパティ

[機能]

コントロールの背景色を設定します。

[書式]

C/C++ OLE_COLOR BackColor;
VisualBasic [form.]object.BackColor[=BackColor&]

[データ型]

長整数型

[設定値]

設定値 説明
Red値、Green値、Blue値 RGB値を設定します。デフォルトは、アプリケーションの背景色です。

[用法]

設計時 設定、参照

実行時 設定、参照


BitsPerPelプロパティ

[機能]

動画データの色数をビット数で参照します。

[書式]

C/C++ short BitsPerPel;
Visual Basic [form.]object.BitsPerPel

[データ型]

整数型

[参照値]

参照値 説明
ビット数 動画データが読み込まれていない場合は、cwmUnknown(-1)となります。

[用法]

設計時 なし

実行時 参照


BitsPerSampleプロパティ

[機能]

動画データの音声部分、音声データの量子化ビット数を参照します。

[書式]

C/C++ short BitsPerSample;
Visual Basic [form.]object.BitsPerSample

[データ型]

整数型

[参照値]

参照値 説明
cwmAudioNone 0 音声なし
cwmBitsPerSample8 8 8ビット
cwmBitsPerSample16 16 16ビット
cwmUnknown -1 動画/音声データが読み込まれていません。

[用法]

設計時 なし

実行時 参照

[備考]

量子化ビット数とは、音声をデジタル化する際に使用するパラメータの一つです。8ビットより、16ビットの方が原音に近くなります。


BorderStyleプロパティ

[機能]

コントロールの境界線のスタイルを設定します。

[書式]

C/C++ short BorderStyle;
Visual Basic [form.]object.BorderStyle[=BorderStyle%]

[データ型]

整数型

[設定値]

設定値 説明
0 なし(デフォルト)
1 実線

[用法]

設計時 設定、参照

実行時 設定、参照

[参照]

Appearanceプロパティ


Channelsプロパティ

[機能]

動画に含まれる音声データのチャンネル数、音声データのチャンネル数を参照します。

[書式]

C/C++ short Channels;
Visual Basic [form.]object.Channels

[データ型]

整数型

[参照値]

参照値 説明
cwmChannelsMono 1 モノラル
cwmChannelsStereo 2 ステレオ
cwmAudioNone 0 音声なし
cwmUnknown -1 動画/音声データが読み込まれていません。

[用法]

設計時 なし

実行時 参照


ControlBarプロパティ

[機能]

再生や停止などを制御するコントロールバーを表示するかを設定します。

[書式]

C/C++ BOOL ControlBar;
Visual Basic [form.]object.ControlBar[={True|False }]

[データ型]

ブール型

[設定値]

設定値 説明
True 表示されます。(デフォルト)
False 表示されません。

[用法]

設計時 設定、参照

実行時 設定、参照

[参照]

ControlBarStyleプロパティStatusBarプロパティTrackBarプロパティ


ControlBarStyleプロパティ

[機能]

コントロールバーの表示スタイルを設定します。

[書式]

C/C++ short ControlBarStyle;
Visual Basic [form.]object.ControlBarStyle[=ControlBarStyle%]

[データ型]

整数型

[設定値]

設定値 説明
cwmControlBarStandard 0 再生、停止、リセット、早送り、巻き戻しの各ボタンが表示されます。(デフォルト)
cwmControlBarSimple 1 再生、停止の各ボタンが表示されます。

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

音声データの場合は、cwmControlBarSimple(1)となります。

[参照]

ControlBarプロパティ


FileNameプロパティ

[機能]

再生する動画/音声データのファイル名を設定します。

[書式]

C/C++ BSTR FileName;
Visual Basic [form.]object.FileName[=FileName$]

[データ型]

文字列型

[設定値]

設定値 説明
動画/音声データのファイル名文字列 通常のファイル名のほかに、UNCファイル名、URL名が設定できます。デフォルトは空文字列です。

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

FileNameプロパティにファイル名を設定すると、AutoPlayプロパティがTrueの場合は、自動で再生が開始されます。

[参照]

AutoPlayプロパティSetMemHandleメソッド


Fromプロパティ

[機能]

再生を開始する位置を設定します。

[書式]

C/C++ long From;
Visual Basic [form.]object.From[=From&]

[データ型]

長整数型

[設定値]

設定値 説明
再生開始位置 0〜Lengthプロパティの範囲で指定します。デフォルトは0です。

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

位置の単位は、Unitプロパティに準じます。

[参照]

UnitプロパティLengthプロパティ


Lengthプロパティ

[機能]

動画/音声データの長さを参照します。

[書式]

C/C++ long Length;
Visual Basic [form.]object.Length

[データ型]

長整数型

[参照値]

参照値 説明
動画/音声データの長さ 動画/音声データが読み込まれていない場合は0です。

[用法]

設計時 なし

実行時 参照

[備考]

長さの単位は、Unitプロパティに準じます。

[参照]

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


MediaFormatプロパティ

[機能]

動画/音声データの種類を参照します。

[書式]

C/C++ short MediaFormat;
Visual Basic [form.]object.MediaFormat

[データ型]

整数型

[参照値]

参照値 説明
cwmFileWAVE 201 WAVE
cwmFileMIDI 202 MIDI
cwmFileAVI 301 AVI
cwmFileMPEG 302 MPEG1
cwmUnknown -1 動画/音声データが読み込まれていません。

[用法]

設計時 なし

実行時 参照


MovieHeightプロパティ

[機能]

動画の高さを参照します。

[書式]

C/C++ short MovieHeight;
Visual Basic [form.]object.MovieHeight

[データ型]

整数型

[参照値]

参照値 説明
動画の高さ 動画データが読み込まれていない場合は0です。

[用法]

設計時 なし

実行時 参照

[参照]

MovieWidthプロパティ


MovieWidthプロパティ

[機能]

動画の幅を参照します。

[書式]

C/C++ short MovieWidth;
Visual Basic [form.]object.MovieWidth

[データ型]

整数型

[参照値]

参照値 説明
動画の幅 動画データが読み込まれていない場合は0です。

[用法]

設計時 なし

実行時 参照

[参照]

MovieHeightプロパティ


PlayCountプロパティ

[機能]

再生する回数を設定します。

[書式]

C/C++ short PlayCount;
Visual Basic [form.]object.PlayCount[=PlayCount%]

[データ型]

整数型

[設定値]

設定値 説明
再生回数 デフォルトは1です。0を設定した場合は、無制限に再生を繰り返します。

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

PlayCountプロパティは、再生開始時に参照します。

[参照]

AutoPlayプロパティPlayメソッド


ReadyStateプロパティ

[機能]

コントロールの現在の状態を参照します。

[書式]

C/C++ short ReadyState;
Visual Basic [form.]object.ReadyState

[データ型]

整数型

[参照値]

参照値 説明
0 初期化状態
1 データを読み込み中
2 初期化済
4 データの読み込みを完了

[用法]

設計時 なし

実行時 参照のみ

[備考]

ReadyStateChangeイベント内で、本プロパティを参照することにより、コントロールの状態を参照することができます。

[参照]

ReadyStateChangeイベント


SamplesPerSecondプロパティ

[機能]

動画の音声データのサンプリング周波数、音声データのサンプリング周波数を参照します。

[書式]

C/C++ long SamplesPerSecond;
Visual Basic [form.]object.SamplesPerSecond

[データ型]

長整数型

[参照値]

参照値 説明
サンプリング周波数 単位はHz(ヘルツ)です。
0 音声なしの動画データです。
-1 動画/音声データが読み込まれていません。

[用法]

設計時 なし

実行時 参照

[備考]

サンプリング周波数とは、音声をデジタル化する際に使用するパラメータ値のひとつです。周波数値が高いほど、原音に近くなります。


Speedプロパティ

[機能]

動画データの再生速度を設定します。

[書式]

C/C++ double Speed;
Visual Basic [form.]object.Speed[=Speed#]

[データ型]

倍精度浮動小数点型

[設定値]

設定値 説明
再生速度の比率 0.5〜2.0の間で設定します。デフォルトは1.0で、通常の再生速度です。

[用法]

設計時 設定、参照

実行時 設定、参照

[参照]

Playメソッド


StatusBarプロパティ

[機能]

現在位置とデータの総量、現在の状態を表示するステータスバーを表示するかを設定します。

[書式]

C/C++ BOOL StatusBar;
Visual Basic [form.]object.StatusBar[={True|False }]

[データ型]

ブール型

[設定値]

設定値 説明
True 表示されます。(デフォルト)
False 表示されません。

[用法]

設計時 設定、参照

実行時 設定、参照

[参照]

ControlBarプロパティTrackBarプロパティ


Toプロパティ

[機能]

再生を終了する位置を設定します。

[書式]

C/C++ long To;
Visual Basic [form.]object.To[=To&]

[データ型]

長整数型

[設定値]

設定値 説明
再生終了位置 0〜Lengthプロパティの範囲で設定します。デフォルトは0で、終端を意味します。

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

位置の単位は、Unitプロパティに準じます。

[参照]

UnitプロパティLengthプロパティFromプロパティ


TrackBarプロパティ

[機能]

データの総量と現在位置を表すトラックバー(目盛りとつまみで構成)を表示するかを設定します。

[書式]

C/C++ BOOL TrackBar;
Visual Basic [form.]object.TrackBar[={True|False }]

[データ型]

ブール型

[設定値]

設定値 説明
True 表示されます。(デフォルト)
False 表示されません。

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

ControlBarプロパティがTrueの場合に有効です。

[参照]

ControlBarプロパティStatusBarプロパティ


Unitプロパティ

[機能]

動画/音声データの位置の単位を設定します。

[書式]

C/C++ short Unit;
Visual Basic [form.]object.Unit[=Unit%]

[データ型]

整数型

[設定値]

設定値 説明
cwmUnitMilliSec 0 ミリ秒(デフォルト)
cwmUnitFrame 1 フレーム

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

[参照]

FromプロパティLengthプロパティToプロパティGetCurrentPosメソッドSeekメソッド


ViewStyleプロパティ

[機能]

動画データを表示するスタイルを設定します。

[書式]

C/C++ short ViewStyle;
Visual Basic [form.]object.ViewStyle[=ViewStyle%]

[データ型]

整数型

[設定値]

設定値 説明
cwmViewNormal 0 メディアを拡大/縮小せずに表示されます。(デフォルト)
cwmViewAdjust 1 縦と横の比率を守って、コントロールサイズに合わせます。
cwmVewStretch 2 縦と横の比率を守らずに、コントロールサイズに合わせます。
cwmViewAutosize 3 動画のサイズに合わせて、コントロールサイズが変化します。

[用法]

設計時 設定、参照

実行時 設定、参照