comando window
El comando window controla la ventana de presentación. Puede usar este comando para cambiar las características de visualización de la ventana o proporcionar una ventana de destino para que el controlador la use en lugar de la ventana de visualización predeterminada. Los dispositivos digitales de vídeo y superposición de vídeo reconocen este comando.
Para enviar este comando, llame a la función mciSendString con el parámetro lpszCommand establecido de la siguiente manera.
_stprintf_s(
lpszCommand,
TEXT("window %s %s %s"),
lpszDeviceID,
lpszWindowFlags,
lpszFlags
);
Parámetros
-
lpszDeviceID
-
Identificador de un dispositivo MCI. Este identificador o alias se asigna cuando se abre el dispositivo.
-
lpszWindowFlags
-
Marca para controlar la ventana de presentación. En la tabla siguiente se enumeran los tipos de dispositivo que reconocen el comando de ventana y las marcas usadas por cada tipo.
Valor Significado Significado digitalvideo handle hwnd state hidestate minimizestate restorestate showshow maximized show minimizedshow min noactiveshow noactivateshow normaltext subtítulo overlay fixedhandle defaulthandle hwnd state hidestate iconicstate maximizedstate minimizestate minimizedstate no actionstate no actionstate noactivatestate normal state restorestate muestrahow maximizedshow minimizedshow min noactiveshow nashow noactivateshow normalstretchtext subtítulo En la tabla siguiente se enumeran las marcas que se pueden especificar en el parámetro lpszWindowFlags y sus significados.
Valor Significado fijo Deshabilita el ajuste de la imagen. handle default Especifica que el dispositivo debe volver a establecer la ventana de presentación en la ventana predeterminada creada durante la operación de apertura . En el caso de los dispositivos de superposición de vídeo, especifica que el dispositivo debe crear y administrar su propia ventana de destino. handle hwnd Especifica el identificador de la ventana de destino que se va a usar en lugar de la ventana predeterminada. El parámetro hwnd contiene el equivalente numérico ASCII del identificador de ventana devuelto por la función CreateWindow . Dos instancias de dispositivo pueden usar el mismo identificador de ventana siempre que cada instancia actualice los píxeles de vídeo e imagen en la ventana como si la otra instancia no existiera. Cuando la salida de vídeo está deshabilitada con setvideo "off", un comando de actualización hará que el rectángulo de destino sea un color sólido. mostrar maximizado Maximiza la ventana de destino. mostrar min noactive Muestra la ventana de destino como un icono. mostrar minimizado Minimiza la ventana de destino. show na Muestra la ventana de destino en su estado actual; la ventana que está activa actualmente permanece activa. show noactivate Muestra la ventana de destino en su tamaño y posición más recientes; la ventana que está activa actualmente permanece activa. mostrar normal Activa y muestra la ventana de destino en su tamaño y posición originales. (Es lo mismo que la marca de "restauración de estado") ocultación de estado Oculta la ventana de destino. icono de estado Muestra la ventana de destino como un icono. estado maximizado Maximiza la ventana de destino. minimizar el estado Minimiza la ventana de destino y activa la ventana de nivel superior en la lista del administrador de ventanas. estado minimizado Minimiza la ventana de destino. state no action Muestra la ventana de destino en su estado actual. La ventana que está activa actualmente permanece activa. state noactivate Muestra la ventana de destino en su tamaño y estado más recientes. La ventana activa actualmente permanece activa. state normal Activa y muestra la ventana de destino en su tamaño y posición originales. restauración de estado Activa y muestra la ventana de destino en su tamaño y posición originales. state show Muestra la ventana de destino. ajustar Habilita el ajuste de la imagen. texto subtítulo Especifica el subtítulo para la ventana de destino. Si este texto contiene espacios en blanco incrustados, toda la subtítulo debe incluirse entre comillas. El subtítulo predeterminado de la ventana predeterminada está en blanco. -
lpszFlags
-
Puede ser "wait", "notify" o ambos. En el caso de los dispositivos de vídeo digital, también se puede especificar "prueba". Para obtener más información sobre estas marcas, vea Las marcas Wait, Notify y Test.
Valor devuelto
Devuelve cero si es correcto o si se produce un error de lo contrario.
Observaciones
Los dispositivos de superposición de vídeo suelen crear y mostrar una ventana cuando se abre. Si la aplicación proporciona una ventana al controlador, la aplicación es responsable de administrar los mensajes enviados a la ventana.
Dado que puede usar el comando status para recuperar el identificador de la ventana de visualización del controlador, también puede usar las funciones estándar del administrador de ventanas (como ShowWindow) para manipular la ventana.
Ejemplos
El siguiente comando muestra y establece el subtítulo para la ventana de reproducción "movie".
window movie text "Welcome to the Movies" state show
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows 2000 Server [solo aplicaciones de escritorio] |