Microsoft DirectX 8.0 |
MSWebDVD Microsoft® ActiveX® コントロールは、各種の内部イベントが発生したときや、ディスク上に特定の情報が見つかったときに、アプリケーションに通知する。
イベントの大半は、ユーザー操作 (UOP) コントロールに関連する。DVD の作成者は、任意の DVD コマンド (PlayForwards、Pause、ShowMenu など) をいつでも無効にできるようにディスクをエンコードできる。たとえば、多くのディスクでは、FBI による通告の再生中には早回しやメニュー表示ができないが、通告が済むとできるようになっている。アプリケーションでは、UOP イベントを処理し、ユーザー インターフェイスを更新することによって、現在そのディスクに実行できるコマンドをユーザーに知らせることができる。通常、これにはボタンの有効/無効を切り替える。たとえば、bEnabled が FALSE にセットされた PlayForwards イベントを受け取ったら [再生] ボタンを無効にし、bEnabled が TRUE にセットされた PlayForwards イベントを受け取ったら [再生] ボタンをもう一度有効にする。
UOP コントロールに関連しないイベントは 3 つある。DVDNotify イベントは、DVD に関連する各種の通知をアプリケーションに通知する。イベントは EventCode パラメータで識別する。イベントによっては、Param1 パラメータおよび Param2 パラメータに追加情報が渡される。ReadyStateChange イベントは、ActiveX コントロールすべてに共通のプロパティである MSWebDVD ReadyState プロパティの変化を、アプリケーションに通知する。UpdateOverlay イベントは、ウィンドウレス モードで MSWebDVD のホストとなっているアプリケーションにのみ送られる。アプリケーションでは、フルスクリーン モードでビデオ矩形上にフローティング ボタンを表示している場合にのみ、このイベントに応答すればよい。
参照
イベントの処理方法を示すサンプル コードについては、「DVD イベント通知の処理」を参照すること。
イベント
イベント 説明 ChangeCurrentAngle ディスクでアングルの変更が有効または無効になると送信される。 ChangeCurrentAudioStream ディスクでオーディオ ストリームの変更が有効または無効になると送信される。 ChangeCurrentSubpictureStream ChangeCurrentSubpictureStream コマンドが有効または無効になると送信される。 DVDNotify 各種の DVD イベントおよびディスク関連命令をアプリケーションに通知する。 PauseOn Pause コマンドが有効または無効になると送信される。 PlayAtTime PlayAtTime コマンドが有効または無効になると送信される。 PlayAtTimeInTitle PlayAtTimeInTitle コマンドが有効または無効になると送信される。 PlayBackwards PlayBackwards コマンドが有効または無効になると送信される。 PlayChapter PlayChapter コマンドが有効または無効になると送信される。 PlayChapterInTitle PlayChapterInTitle コマンドが有効または無効になると送信される。 PlayForwards PlayForwards コマンドが有効または無効になると送信される。 PlayNextChapter PlayNextChapter コマンドが有効または無効になると送信される。 PlayPrevChapter PlayPrevChapter コマンドが有効または無効になると送信される。 PlayTitle ReturnFromSubmenu コマンドが有効または無効になると送信される。 ReadyStateChange MSWebDVD コントロールの ReadyState プロパティが変化すると送信される。 ReplayChapter ReplayChapter コマンドが有効または無効になると送信される。 Resume Resume コマンドが有効または無効になると送信される。 ReturnFromSubmenu ReturnFromSubmenu コマンドが有効または無効になると送信される。 SelectOrActivatButton ディスクでメニュー ボタンのアクティブが有効または無効になると送信される。 ShowMenu ディスクでメニューの表示が有効または無効になると送信される。 StillOff StillOff コマンドが有効または無効になると送信される。 Stop Stop コマンドが有効または無効になると送信される。 UpdateOverlay オーバーレイ サーフェスが移動またはサイズ変更されるか、またはそのカラー キーが変化すると送信される。
ディスクでアングルの変更が有効または無効になると送信される。
構文
ChangeCurrentAngle(bEnabled)
パラメータ
bEnabled 処理が有効か無効かどうかを示すブール型の値。
ディスクでオーディオ ストリームの変更が有効または無効になると送信される。
構文
ChangeCurrentAudioStream(bEnabled)
パラメータ
bEnabled 処理が有効か無効かどうかを示すブール型の値。
ディスクでサブピクチャ ストリームの変更が有効または無効になると送信される。
構文
ChangeCurrentSubpictureStream(bEnabled)
パラメータ
bEnabled 処理が有効か無効かどうかを示すブール型の値。
各種の DVD イベントおよびディスク関連命令をアプリケーションに通知する。
構文
DVDNotify(EventCode, Param1, Param2)
パラメータ
EventCode DVD イベントを指定する。 Param1 イベントに関連する追加情報が入ることがある。 param2 イベントに関連する追加情報が入ることがある。
参照
DVD イベント通知コードとそのパラメータの完全な一覧については、「DVD イベント通知コード」を参照すること。
PauseOn コマンドが有効または無効になると送信される。
構文
PauseOn(bEnabled)
パラメータ
bEnabled 処理が有効か無効かどうかを示すブール型の値。
PlayAtTime コマンドが有効または無効になると送信される。
構文
PlayAtTime(bEnabled)
パラメータ
bEnabled 処理が有効か無効かどうかを示すブール型の値。
PlayAtTimeInTitle コマンドが有効または無効になると送信される。
構文
PlayAtTimeInTitle(bEnabled)
パラメータ
bEnabled 処理が有効か無効かどうかを示すブール型の値。
PlayBackwards コマンドが有効または無効になると送信される。
構文
PlayBackwards(bEnabled)
パラメータ
bEnabled 処理が有効か無効かどうかを示すブール型の値。
PlayChapter コマンドが有効または無効になると送信される。
構文
PlayChapter(bEnabled)
パラメータ
bEnabled 処理が有効か無効かどうかを示すブール型の値。
PlayChapterInTitle コマンドが有効または無効になると送信される。
構文
PlayChapterInTitle(bEnabled)
パラメータ
bEnabled 処理が有効か無効かどうかを示すブール型の値。
PlayForwards コマンドが有効または無効になると送信される。
構文
PlayForwards(bEnabled)
パラメータ
bEnabled 処理が有効か無効かどうかを示すブール型の値。
PlayNextChapter コマンドが有効または無効になると送信される。
構文
PlayNextChapter(bEnabled)
パラメータ
bEnabled 処理が有効か無効かどうかを示すブール型の値。
PlayPrevChapter コマンドが有効または無効になると送信される。
構文
PlayPrevChapter(bEnabled)
パラメータ
bEnabled 処理が有効か無効かどうかを示すブール型の値。
PlayTitle コマンドが有効または無効になると送信される。
構文
PlayTitle(bEnabled)
パラメータ
bEnabled 処理が有効か無効かどうかを示すブール型の値。
MSWebDVD コントロールの ReadyState プロパティが変化すると送信される。
構文
ReadyStateChange(ReadyState)
パラメータ
ReadyState ReadyState プロパティの新しい値を示す。可能な値は、READYSTATE_UNINITIALIZED = 0、READYSTATE_LOADING = 1、READYSTATE_LOADED = 2、READYSTATE_INTERACTIVE = 3、READYSTATE_COMPLETE = 4 のいずれか。
ReplayChapter コマンドが有効または無効になると送信される。
構文
ReplayChapter(bEnabled)
パラメータ
bEnabled 処理が有効か無効かどうかを示すブール型の値。
Resume コマンドが有効または無効になると送信される。
構文
Resume(bEnabled)
パラメータ
bEnabled 処理が有効か無効かどうかを示すブール型の値。
ReturnFromSubmenu コマンドが有効または無効になると送信される。
構文
ReturnFromSubmenu(bEnabled)
パラメータ
bEnabled 処理が有効か無効かどうかを示すブール型の値。
ディスクでメニュー ボタンのアクティブが有効または無効になると送信される。
構文
SelectOrActivatButton(bEnabled)
パラメータ
bEnabled 処理が有効か無効かどうかを示すブール型の値。
ディスクでメニューの表示が有効または無効になると送信される。
構文
ShowMenu(DVDMenuIDConstants, bEnabled)
パラメータ
DVDMenuIDConstants 有効または無効になったメニューを示す数値。可能な値は次のいずれかである。
2 タイトル 3 ルート 4 サブピクチャ 5 オーディオ 6 アングル 7 チャプター bEnabled 処理が有効か無効かどうかを示すブール型の値。
StillOff コマンドが有効または無効になると送信される。
構文
StillOff(bEnabled)
パラメータ
bEnabled 処理が有効か無効かどうかを示すブール型の値。
Stop コマンドが有効または無効になると送信される。
構文
Stop(bEnabled)
パラメータ
bEnabled 処理が有効か無効かどうかを示すブール型の値。
オーバーレイ サーフェスが移動またはサイズ変更されるか、またはそのカラー キーが変化すると送信される。
構文
UpdateOverlay()
注意
アプリケーションでは、サイズ変更または移動されるオーバーレイ サーフェスを気にしてはならない。それはすべて内部的に処理される。このイベントはカラー キーが変化したときにも送られる。つまり、ウィンドウのないコントロールとして MSWebDVD のホストとなっているアプリケーションでは、フルスクリーン モードでビデオ サーフェス上にフローティング ボタンを表示している場合、ボタンを正しく表示するには、ColorKey プロパティの新しい値を取得してこのイベントに応答しなければならない。