Microsoft DirectX 8.0

MSWebDVD イベント

MSWebDVD Microsoft® ActiveX® コントロールは、各種の内部イベントが発生したときや、ディスク上に特定の情報が見つかったときに、アプリケーションに通知する。

イベントの大半は、ユーザー操作 (UOP) コントロールに関連する。DVD の作成者は、任意の DVD コマンド (PlayForwardsPauseShowMenu など) をいつでも無効にできるようにディスクをエンコードできる。たとえば、多くのディスクでは、FBI による通告の再生中には早回しやメニュー表示ができないが、通告が済むとできるようになっている。アプリケーションでは、UOP イベントを処理し、ユーザー インターフェイスを更新することによって、現在そのディスクに実行できるコマンドをユーザーに知らせることができる。通常、これにはボタンの有効/無効を切り替える。たとえば、bEnabledFALSE にセットされた PlayForwards イベントを受け取ったら [再生] ボタンを無効にし、bEnabledTRUE にセットされた PlayForwards イベントを受け取ったら [再生] ボタンをもう一度有効にする。

UOP コントロールに関連しないイベントは 3 つある。DVDNotify イベントは、DVD に関連する各種の通知をアプリケーションに通知する。イベントは EventCode パラメータで識別する。イベントによっては、Param1 パラメータおよび Param2 パラメータに追加情報が渡される。ReadyStateChange イベントは、ActiveX コントロールすべてに共通のプロパティである MSWebDVD ReadyState プロパティの変化を、アプリケーションに通知する。UpdateOverlay イベントは、ウィンドウレス モードで MSWebDVD のホストとなっているアプリケーションにのみ送られる。アプリケーションでは、フルスクリーン モードでビデオ矩形上にフローティング ボタンを表示している場合にのみ、このイベントに応答すればよい。

参照

イベントの処理方法を示すサンプル コードについては、「DVD イベント通知の処理」を参照すること。

MSWebDVD オブジェクト

イベント

イベント説明
ChangeCurrentAngleディスクでアングルの変更が有効または無効になると送信される。
ChangeCurrentAudioStreamディスクでオーディオ ストリームの変更が有効または無効になると送信される。
ChangeCurrentSubpictureStreamChangeCurrentSubpictureStream コマンドが有効または無効になると送信される。
DVDNotify各種の DVD イベントおよびディスク関連命令をアプリケーションに通知する。
PauseOnPause コマンドが有効または無効になると送信される。
PlayAtTimePlayAtTime コマンドが有効または無効になると送信される。
PlayAtTimeInTitlePlayAtTimeInTitle コマンドが有効または無効になると送信される。
PlayBackwardsPlayBackwards コマンドが有効または無効になると送信される。
PlayChapterPlayChapter コマンドが有効または無効になると送信される。
PlayChapterInTitlePlayChapterInTitle コマンドが有効または無効になると送信される。
PlayForwardsPlayForwards コマンドが有効または無効になると送信される。
PlayNextChapterPlayNextChapter コマンドが有効または無効になると送信される。
PlayPrevChapterPlayPrevChapter コマンドが有効または無効になると送信される。
PlayTitleReturnFromSubmenu コマンドが有効または無効になると送信される。
ReadyStateChangeMSWebDVD コントロールの ReadyState プロパティが変化すると送信される。
ReplayChapterReplayChapter コマンドが有効または無効になると送信される。
ResumeResume コマンドが有効または無効になると送信される。
ReturnFromSubmenuReturnFromSubmenu コマンドが有効または無効になると送信される。
SelectOrActivatButtonディスクでメニュー ボタンのアクティブが有効または無効になると送信される。
ShowMenuディスクでメニューの表示が有効または無効になると送信される。
StillOffStillOff コマンドが有効または無効になると送信される。
StopStop コマンドが有効または無効になると送信される。
UpdateOverlayオーバーレイ サーフェスが移動またはサイズ変更されるか、またはそのカラー キーが変化すると送信される。

ChangeCurrentAngle

MSWebDVD イベント

ディスクでアングルの変更が有効または無効になると送信される。

構文

ChangeCurrentAngle(bEnabled)

パラメータ

bEnabled 処理が有効か無効かどうかを示すブール型の値。

ChangeCurrentAudioStream

MSWebDVD イベント

ディスクでオーディオ ストリームの変更が有効または無効になると送信される。

構文

ChangeCurrentAudioStream(bEnabled)

パラメータ

bEnabled 処理が有効か無効かどうかを示すブール型の値。

ChangeCurrentSubpictureStream

MSWebDVD イベント

ディスクでサブピクチャ ストリームの変更が有効または無効になると送信される。

構文

ChangeCurrentSubpictureStream(bEnabled)

パラメータ

bEnabled 処理が有効か無効かどうかを示すブール型の値。

DVDNotify

MSWebDVD イベント

各種の DVD イベントおよびディスク関連命令をアプリケーションに通知する。

構文

DVDNotify(EventCode, Param1, Param2)

パラメータ

EventCode DVD イベントを指定する。
Param1 イベントに関連する追加情報が入ることがある。
param2 イベントに関連する追加情報が入ることがある。

参照

DVD イベント通知コードとそのパラメータの完全な一覧については、「DVD イベント通知コード」を参照すること。

PauseOn

MSWebDVD イベント

PauseOn コマンドが有効または無効になると送信される。

構文

PauseOn(bEnabled)

パラメータ

bEnabled 処理が有効か無効かどうかを示すブール型の値。

PlayAtTime

MSWebDVD イベント

PlayAtTime コマンドが有効または無効になると送信される。

構文

PlayAtTime(bEnabled)

パラメータ

bEnabled 処理が有効か無効かどうかを示すブール型の値。

PlayAtTimeInTitle

MSWebDVD イベント

PlayAtTimeInTitle コマンドが有効または無効になると送信される。

構文

PlayAtTimeInTitle(bEnabled)

パラメータ

bEnabled 処理が有効か無効かどうかを示すブール型の値。

PlayBackwards

MSWebDVD イベント

PlayBackwards コマンドが有効または無効になると送信される。

構文

PlayBackwards(bEnabled)

パラメータ

bEnabled 処理が有効か無効かどうかを示すブール型の値。

PlayChapter

MSWebDVD イベント

PlayChapter コマンドが有効または無効になると送信される。

構文

PlayChapter(bEnabled)

パラメータ

bEnabled 処理が有効か無効かどうかを示すブール型の値。

PlayChapterInTitle

MSWebDVD イベント

PlayChapterInTitle コマンドが有効または無効になると送信される。

構文

PlayChapterInTitle(bEnabled)

パラメータ

bEnabled 処理が有効か無効かどうかを示すブール型の値。

PlayForwards

MSWebDVD イベント

PlayForwards コマンドが有効または無効になると送信される。

構文

PlayForwards(bEnabled)

パラメータ

bEnabled 処理が有効か無効かどうかを示すブール型の値。

PlayNextChapter

MSWebDVD イベント

PlayNextChapter コマンドが有効または無効になると送信される。

構文

PlayNextChapter(bEnabled)

パラメータ

bEnabled 処理が有効か無効かどうかを示すブール型の値。

PlayPrevChapter

MSWebDVD イベント

PlayPrevChapter コマンドが有効または無効になると送信される。

構文

PlayPrevChapter(bEnabled)				

パラメータ

bEnabled 処理が有効か無効かどうかを示すブール型の値。

PlayTitle

MSWebDVD イベント

PlayTitle コマンドが有効または無効になると送信される。

構文

PlayTitle(bEnabled)		

パラメータ

bEnabled 処理が有効か無効かどうかを示すブール型の値。

ReadyStateChange

MSWebDVD イベント

MSWebDVD コントロールの ReadyState プロパティが変化すると送信される。

構文

ReadyStateChange(ReadyState) 

パラメータ

ReadyState ReadyState プロパティの新しい値を示す。可能な値は、READYSTATE_UNINITIALIZED = 0、READYSTATE_LOADING = 1、READYSTATE_LOADED = 2、READYSTATE_INTERACTIVE = 3、READYSTATE_COMPLETE = 4 のいずれか。

ReplayChapter

MSWebDVD イベント

ReplayChapter コマンドが有効または無効になると送信される。

構文

ReplayChapter(bEnabled)

パラメータ

bEnabled 処理が有効か無効かどうかを示すブール型の値。

Resume

MSWebDVD イベント

Resume コマンドが有効または無効になると送信される。

構文

Resume(bEnabled)

パラメータ

bEnabled 処理が有効か無効かどうかを示すブール型の値。

ReturnFromSubmenu

MSWebDVD イベント

ReturnFromSubmenu コマンドが有効または無効になると送信される。

構文

ReturnFromSubmenu(bEnabled)

パラメータ

bEnabled 処理が有効か無効かどうかを示すブール型の値。

SelectOrActivatButton

MSWebDVD イベント

ディスクでメニュー ボタンのアクティブが有効または無効になると送信される。

構文

SelectOrActivatButton(bEnabled)

パラメータ

bEnabled 処理が有効か無効かどうかを示すブール型の値。

ShowMenu

MSWebDVD イベント

ディスクでメニューの表示が有効または無効になると送信される。

構文

ShowMenu(DVDMenuIDConstants, bEnabled)

パラメータ

DVDMenuIDConstants 有効または無効になったメニューを示す数値。可能な値は次のいずれかである。
2タイトル
3ルート
4サブピクチャ
5オーディオ
6アングル
7チャプター
bEnabled 処理が有効か無効かどうかを示すブール型の値。

StillOff

MSWebDVD イベント

StillOff コマンドが有効または無効になると送信される。

構文

StillOff(bEnabled)

パラメータ

bEnabled 処理が有効か無効かどうかを示すブール型の値。

Stop

MSWebDVD イベント

Stop コマンドが有効または無効になると送信される。

構文

Stop(bEnabled)

パラメータ

bEnabled 処理が有効か無効かどうかを示すブール型の値。

UpdateOverlay

MSWebDVD イベント

オーバーレイ サーフェスが移動またはサイズ変更されるか、またはそのカラー キーが変化すると送信される。

構文

UpdateOverlay()

注意

アプリケーションでは、サイズ変更または移動されるオーバーレイ サーフェスを気にしてはならない。それはすべて内部的に処理される。このイベントはカラー キーが変化したときにも送られる。つまり、ウィンドウのないコントロールとして MSWebDVD のホストとなっているアプリケーションでは、フルスクリーン モードでビデオ サーフェス上にフローティング ボタンを表示している場合、ボタンを正しく表示するには、ColorKey プロパティの新しい値を取得してこのイベントに応答しなければならない。