8.2 マルチメディア表示・再生コントロールのプロパティ

プロパティ 機能
Appearance 境界線の3D表示
AutoPlay 自動再生をする/しない
BackColor 背景色
BorderStyle 境界線のスタイル
ControlBar コントロールバーの表示
Effect 表示エフェクト
FileName メディアデータのファイル名
MediaFormat メディアデータの形式
MediaType メディアの種類
PlayCount 再生回数
ReadyState 現在のコントロールの状態
ScrollBar スクロールバーの表示
StatusBar ステータスバーの表示
TrackBar トラックバーの表示
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値を設定します。デフォルトは、アプリケーションの背景色です。

[用法]

設計時 設定、参照

実行時 設定、参照


BorderStyleプロパティ

[機能]

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

[書式]

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

[データ型]

整数型

[設定値]

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

[用法]

設計時 設定、参照

実行時 設定、参照

[参照]

Appearanceプロパティ


ControlBarプロパティ

[機能]

マルチページイメージのページめくりボタン、および動画/音声の再生と停止を制御するコントロールバーを表示するかを設定します。

[書式]

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

[データ型]

ブール型

[設定値]

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

[用法]

設計時 設定、参照

実行時 設定、参照

[参照]

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


Effectプロパティ

[機能]

イメージを表示する場合のエフェクトを設定します。

[書式]

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

[データ型]

整数型

[設定値]

設定値 説明
cwmEffectNone 0 表示エフェクトなし(デフォルト)
cwmEffectFadeIn 1 画面を背景色でクリアした後、フェードイン
cwmEffectFadeOut 2 画面を背景色でフェードアウトした後、イメージを表示
cwmEffectFadeInOut 3 画面を背景色でフェードアウトした後、新しいイメージをフェードイン
cwmEffectFadeChange 4 前イメージの上に、新しいイメージをフェードイン
cwmEffectClearWipe1 11 画面を背景色でクリアした後、上から下へワイプ
cwmEffectClearWipe2 12 画面を背景色でクリアした後、下から上へワイプ
cwmEffectClearWipe3 13 画面を背景色でクリアした後、左から右へワイプ
cwmEffectClearWipe4 14 画面を背景色でクリアした後、右から左へワイプ
cwmEffectWipe1 21 前イメージを上書きしながら、上から下へワイプ
cwmEffectWipe2 22 前イメージを上書きしながら、下から上へワイプ
cwmEffectWipe3 23 前イメージを上書きしながら、左から右へワイプ
cwmEffectWipe4 24 前イメージを上書きしながら、右から左へワイプ
cwmEffectClearScrollIn1 31 画面を背景色でクリアした後、上から下へスクロールイン
cwmEffectClearScrollIn2 32 画面を背景色でクリアした後、下から上へスクロールイン
cwmEffectClearScrollIn3 33 画面を背景色でクリアした後、左から右へスクロールイン
cwmEffectClearScrollIn4 34 画面を背景色でクリアした後、右から左へスクロールイン
cwmEffectScrollIn1 41 前イメージを上書きしながら、上から下へスクロールイン
cwmEffectScrollIn2 42 前イメージを上書きしながら、下から上へスクロールイン
cwmEffectScrollIn3 43 前イメージを上書きしながら、左から右へスクロールイン
cwmEffectScrollIn4 44 前イメージを上書きしながら、右から左へスクロールイン
cwmEffectScrollOut1 51 上から下へスクロールアウト
cwmEffectScrollOut2 52 下から上へスクロールアウト
cwmEffectScrollOut3 53 左から右へスクロールアウト
cwmEffectScrollOut4 54 右から左へスクロールアウト
cwmEffectSlide1 61 上から下へスライド
cwmEffectSlide2 62 下から上へスライド
cwmEffectSlide3 63 左から右へスライド
cwmEffectSlide4 64 右から左へスライド
cwmEffectRandomWipe1 71 ランダムワイプ(256分割)
cwmEffectRandomWipe2 72 ランダムワイプ(64分割)

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

表示エフェクトが実行されるタイミングは、FileNameプロパティの更新時、マルチページイメージのページめくり時、またはSetMemHandleメソッドの実行時です。

[参照]

FileNameプロパティSetMemHandleメソッド


FileNameプロパティ

[機能]

表示・再生するメディアデータのファイル名を設定します。

[書式]

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

[データ型]

文字列型

[設定値]

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

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

[参照]

AutoPlayプロパティSetMemHandleメソッド


MediaFormatプロパティ

[機能]

メディアデータ形式を参照します。

[書式]

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

[データ型]

整数型

[参照値]

参照値 説明
cwmFileBMP 101 BMP
cwmFileTIFF 102 TIFF
cwmFileJPEG 103 JPEG
cwmFilePCX 104 PCX
cwmFilePNG 106 PNG
cwmFileWAVE 201 WAVE
cwmFileMIDI 202 MIDI
cwmFileAVI 301 AVI
cwmFileMPEG 302 MPEG
cwmUnknown -1 メディアデータが読み込まれていません。(デフォルト)

[用法]

設計時 なし

実行時 参照

[参照]

MediaTypeプロパティ


MediaTypeプロパティ

[機能]

メディアの種類を参照します。

[書式]

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

[データ型]

整数型

[参照値]

参照値 説明
cwmMediaImage 1 イメージメディア
cwmMediaSound 2 音声メディア
cwmMediaMovie 3 動画メディア
cwmUnknown -1 メディアデータが読み込まれていません。(デフォルト)

[用法]

設計時 なし

実行時 参照

[参照]

MediaFormatプロパティ


PlayCountプロパティ

[機能]

動画/音声の再生する回数を設定します。

[書式]

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

[データ型]

整数型

[設定値]

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

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

[参照]

AutoPlayプロパティMediaTypeプロパティPlayメソッド


ReadyStateプロパティ

[機能]

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

[書式]

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

[データ型]

長整数型

[参照値]

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

[用法]

設計時 なし

実行時 参照

[備考]

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

[参照]

ReadyStateChangeイベント


ScrollBarプロパティ

[機能]

スクロールバーを表示するかを設定します。

[書式]

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

[データ型]

ブール型

[設定値]

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

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

[参照]

ViewStyleプロパティMediaTypeプロパティ


StatusBarプロパティ

[機能]

ステータスバーを表示するかを設定します。

[書式]

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

[データ型]

ブール型

[設定値]

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

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

[参照]

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


TrackBarプロパティ

[機能]

トラックバーを表示するかを設定します。

[書式]

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

[データ型]

ブール型

[設定値]

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

[用法]

設計時 設定、参照

実行時 設定、参照

[備考]

[参照]

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


ViewStyleプロパティ

[機能]

表示スタイルを設定します。

[書式]

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

[データ型]

整数型

[設定値]

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

[用法]

設計時 設定、参照

実行時 設定、参照

[参照]

ScrollBarプロパティ