команда window

Статья
06/13/2023

Команда window управляет окном отображения. С помощью этой команды можно изменить характеристики отображения окна или предоставить целевое окно для использования драйвером вместо окна отображения по умолчанию. Устройства цифрового видео и наложения видео распознают эту команду.

Чтобы отправить эту команду, вызовите функцию mciSendString с параметром lpszCommand , как показано ниже.

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

Параметры

lpszDeviceID

Идентификатор устройства MCI. Этот идентификатор или псевдоним назначается при открытии устройства.

lpszWindowFlags

Флаг управления окном отображения. В следующей таблице перечислены типы устройств, которые распознают команду окна и флаги, используемые каждым типом.

Значение	Значение	Значение
digitalvideo	handle hwnd state hidestate minimizestatestate restorestate показывает, как развернуть	show minimizedshow min noactiveshow nashow noactivateshow normaltext подпись
overlay	fixedhandle defaulthandle hwnd state hidestate iconicstate maximizedstate minimizedstate no actionstate noactivatestate normal	state restorestate показывает, развернутыепоказать свертываниепоказать min noactiveshow nashow noactivateshow normalstretchtext подпись

В следующей таблице перечислены флаги, которые можно указать в параметре lpszWindowFlags , и их значения.

Значение	Значение
fixed	Отключает растяжение изображения.
дескриптор по умолчанию	Указывает, что устройство должно вернуть окно отображения в окно по умолчанию, созданное во время операции открытия . Для устройств с наложением видео указывает, что устройство должно создавать собственное целевое окно и управлять им.
ручка висится	Указывает дескриптор целевого окна, который будет использоваться вместо окна по умолчанию. Параметр hwnd содержит числовой эквивалент ASCII дескриптора окна, возвращаемого функцией CreateWindow . Два экземпляра устройства могут использовать один и тот же дескриптор окна при условии, что каждый экземпляр обновляет пиксели видео и изображения в окне, как если бы другой экземпляр не существовал. Если вывод видео отключен с параметром setvideo "off", команда обновления сделает прямоугольник назначения сплошным цветом.
показать развернутый	Разворачивает целевое окно.
show min noactive	Отображает окно назначения в виде значка.
показать свернутый	Свертывание окна назначения.
show na	Отображает окно назначения в текущем состоянии; Активное в данный момент окно остается активным.
show noactivate	Отображает целевое окно в его последнем размере и положении; Активное в данный момент окно остается активным.
Показать нормальное	Активирует и отображает окно назначения в исходном размере и положении. (Это то же самое, что и флаг "восстановление состояния".)
скрыть состояние	Скрывает целевое окно.
состояние знаковых	Отображает окно назначения в виде значка.
состояние развернуто	Разворачивает целевое окно.
Сведение состояния к минимуму	Свертывание целевого окна и активация окна верхнего уровня в списке диспетчера окон.
состояние свернуто	Свертывание окна назначения.
состояние без действия	Отображает окно назначения в текущем состоянии. Активное в данный момент окно остается активным.
state noactivate	Отображает окно назначения в его последнем размере и состоянии. Активное в данный момент окно остается активным.
нормальное состояние	Активирует и отображает окно назначения в исходном размере и положении.
восстановление состояния	Активирует и отображает окно назначения в исходном размере и положении.
отображение состояния	Отображает окно назначения.
растяжение	Включает растяжение изображения.
текстовые подпись	Задает подпись для окна назначения. Если этот текст содержит внедренные пробелы, весь подпись должен быть заключен в кавычки. Подпись по умолчанию для окна по умолчанию является пустым.

lpszFlags

Может иметь значение "wait", "notify" или и то, и другое. Для цифровых видеоустройств также можно указать "test". Дополнительные сведения об этих флагах см. в разделе Флаги ожидания, уведомления и тестирования.

Возвращаемое значение

Возвращает ноль в случае успешного выполнения или ошибку в противном случае.

Устройства с наложением видео обычно создают и отображают окно при открытии. Если приложение предоставляет драйверу окно, оно отвечает за управление сообщениями, отправленными в окно.

Так как для получения дескриптора в окно отображения драйвера можно использовать команду состояния , для управления окном можно также использовать стандартные функции оконного диспетчера (например , ShowWindow).

Примеры

Следующая команда отображает и задает подпись для окна воспроизведения фильма.

window movie text "Welcome to the Movies" state show

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]

См. также раздел

MCI
Командные строки MCI
open
играть
setvideo
update