window コマンド

  • [アーティクル]

ウィンドウ コマンドは、表示ウィンドウを制御します。 このコマンドを使用すると、ウィンドウの表示特性を変更したり、ドライバーが既定の表示ウィンドウの代わりに使用する宛先ウィンドウを指定したりできます。 デジタル ビデオおよびビデオ オーバーレイ デバイスは、このコマンドを認識します。

このコマンドを送信するには、lpszCommand パラメーターを次のように設定して mciSendString 関数を呼び出します。

_stprintf_s(
  lpszCommand, 
  TEXT("window %s %s %s"), 
  lpszDeviceID, 
  lpszWindowFlags, 
  lpszFlags
);

パラメーター

lpszDeviceID

MCI デバイスの識別子。 この識別子またはエイリアスは、デバイスを開いたときに割り当てられます。

lpszWindowFlags

表示ウィンドウを制御するためのフラグ。 次の表に、ウィンドウ コマンドを認識するデバイスの種類と、各種類で使用されるフラグを示します。

値 説明 説明
digitalvideo handle hwnd state hidestate minimizestate restorestate showshow maximized show minimizedshow min noactiveshow nashow noactivateshow normaltext キャプション
overlay fixedhandle defaulthandle hwnd state hidestate iconicstate maximizedstate minimizeedstate no actionstate noactivatestate normal state restorestate showshow maximizedshow minimizedshow min noactiveshow nashow noactivateshow normalstretchtext キャプション

次の表に、 lpszWindowFlags パラメーターで指定できるフラグとその意味を示します。

値 説明
固定 イメージのストレッチを無効にします。
ハンドルの既定値 開 いている操作中 に作成された既定のウィンドウにデバイスが表示ウィンドウを戻す必要があることを指定します。 ビデオ オーバーレイ デバイスの場合は、デバイスが独自の宛先ウィンドウを作成および管理する必要があることを指定します。
handle hwnd 既定のウィンドウの代わりに使用する移動先ウィンドウのハンドルを指定します。 hwnd パラメーターには、CreateWindow 関数によって返されるウィンドウ ハンドルに相当する ASCII 数値が含まれています。 2 つのデバイス インスタンスで同じウィンドウ ハンドルを使用できます。各インスタンスが、他のインスタンスが存在しないかのようにウィンドウ内のビデオピクセルと画像ピクセルを更新します。 setvideo "off" でビデオ出力が無効になっている場合、更新コマンドを実行すると、変換先の四角形が単色になります。
最大化表示 変換先ウィンドウを最大化します。
show min noactive 移動先ウィンドウをアイコンとして表示します。
最小化表示 宛先ウィンドウを最小化します。
show na 移動先ウィンドウを現在の状態で表示します。現在アクティブなウィンドウはアクティブなままになります。
show noactivate 宛先ウィンドウを最新のサイズと位置で表示します。現在アクティブなウィンドウはアクティブなままになります。
通常の表示 コピー先ウィンドウをアクティブにし、元のサイズと位置で表示します。 (これは"状態の復元" フラグと同じです)。
状態非表示 移動先ウィンドウを非表示にします。
state iconic 移動先ウィンドウをアイコンとして表示します。
最大化された状態 変換先ウィンドウを最大化します。
state minimize コピー先ウィンドウを最小化し、ウィンドウ マネージャーの一覧で最上位ウィンドウをアクティブにします。
最小化された状態 宛先ウィンドウを最小化します。
state no action 移動先ウィンドウを現在の状態で表示します。 現在アクティブなウィンドウはアクティブなままになります。
state noactivate 宛先ウィンドウを最新のサイズと状態で表示します。 現在アクティブなウィンドウはアクティブなままです。
state normal コピー先ウィンドウをアクティブにし、元のサイズと位置で表示します。
状態の復元 コピー先ウィンドウをアクティブにし、元のサイズと位置で表示します。
state show 宛先ウィンドウを表示します。
伸縮 イメージのストレッチを有効にします。
text キャプション 移動先ウィンドウのキャプションを指定します。 このテキストに空白が埋め込まれている場合は、キャプション全体を引用符で囲む必要があります。 既定のウィンドウの既定のキャプションは空白です。

lpszFlags

"wait"、"notify"、またはその両方を指定できます。 デジタル ビデオ デバイスの場合は、"テスト" を指定することもできます。 これらのフラグの詳細については、「 待機、通知、およびテスト フラグ」を参照してください。

戻り値

成功した場合は 0 を返し、それ以外の場合はエラーを返します。

解説

ビデオ オーバーレイ デバイスは、通常、開いたときにウィンドウを作成して表示します。 アプリケーションがドライバーにウィンドウを提供する場合、アプリケーションはウィンドウに送信されるメッセージを管理する役割を担います。

status コマンドを使用してドライバーの表示ウィンドウへのハンドルを取得できるため、標準のウィンドウ マネージャー関数 (ShowWindow など) を使用してウィンドウを操作することもできます。

例

次のコマンドは、"ムービー" 再生ウィンドウのキャプションを表示および設定します。

window movie text "Welcome to the Movies" state show

要件

要件 値
サポートされている最小のクライアント
 Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows 2000 Server [デスクトップ アプリのみ]

関連項目

Mci

MCI コマンド文字列

open

play

setvideo

update