Compartilhar via


Comando window

O comando de janela controla a janela de exibição. Você pode usar esse comando para alterar as características de exibição da janela ou fornecer uma janela de destino para o driver usar no lugar da janela de exibição padrão. Os dispositivos de vídeo digital e sobreposição de vídeo reconhecem esse comando.

Para enviar esse comando, chame a função mciSendString com o parâmetro lpszCommand definido da seguinte maneira.

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

Parâmetros

lpszDeviceID

Identificador de um dispositivo MCI. Esse identificador ou alias é atribuído quando o dispositivo é aberto.

lpszWindowFlags

Sinalizador para controlar a janela de exibição. A tabela a seguir lista os tipos de dispositivo que reconhecem o comando de janela e os sinalizadores usados por cada tipo.

Valor Significado Significado
digitalvideo handle hwnd state hidestate minimizestate restorestate showshow maximized show minimizedshow min noactiveshow nashow noactivateshow normaltext legenda
overlay fixedhandle defaulthandle hwnd state hidestate iconicstate maximizedstate minimizestate minimizeedstate no actionstate noactivatestate normal state restorestate showshow maximizedshow minimizedshow min noactiveshow nashow noactivateshow normalstretchtext legenda

A tabela a seguir lista os sinalizadores que podem ser especificados no parâmetro lpszWindowFlags e seus significados.

Valor Significado
fixo Desabilita o alongamento da imagem.
identificador padrão Especifica que o dispositivo deve definir a janela de exibição de volta para a janela padrão criada durante a operação aberta . Para dispositivos de sobreposição de vídeo, especifica que o dispositivo deve criar e gerenciar sua própria janela de destino.
identificador hwnd Especifica o identificador da janela de destino a ser usada em vez da janela padrão. O parâmetro hwnd contém o equivalente numérico ASCII do identificador de janela retornado pela função CreateWindow . Duas instâncias de dispositivo podem usar o mesmo identificador de janela, desde que cada instância atualize os pixels de vídeo e imagem na janela como se a outra instância não existisse. Quando a saída de vídeo estiver desabilitada com setvideo "off", um comando de atualização tornará o retângulo de destino uma cor sólida.
mostrar maximizado Maximiza a janela de destino.
mostrar min noactive Exibe a janela de destino como um ícone.
mostrar minimizado Minimiza a janela de destino.
mostrar na Exibe a janela de destino em seu estado atual; a janela que está ativa no momento permanece ativa.
mostrar não ativar Exibe a janela de destino em seu tamanho e posição mais recentes; a janela que está ativa no momento permanece ativa.
mostrar normal Ativa e exibe a janela de destino em seu tamanho e posição originais. (Isso é o mesmo que o sinalizador de "restauração de estado".)
ocultar estado Oculta a janela de destino.
estado icônico Exibe a janela de destino como um ícone.
estado maximizado Maximiza a janela de destino.
state minimize Minimiza a janela de destino e ativa a janela de nível superior na lista do gerenciador de janelas.
estado minimizado Minimiza a janela de destino.
estado nenhuma ação Exibe a janela de destino em seu estado atual. A janela que está ativa no momento permanece ativa.
state noactivate Exibe a janela de destino em seu tamanho e estado mais recentes. A janela ativa no momento permanece ativa.
estado normal Ativa e exibe a janela de destino em seu tamanho e posição originais.
restauração de estado Ativa e exibe a janela de destino em seu tamanho e posição originais.
state show Mostra a janela de destino.
Esticar Habilita o alongamento da imagem.
legenda de texto Especifica o legenda da janela de destino. Se esse texto contiver espaços em branco inseridos, todo o legenda deverá estar entre aspas. O legenda padrão para a janela padrão está em branco.

lpszFlags

Pode ser "wait", "notify" ou ambos. Para dispositivos de vídeo digital, "teste" também pode ser especificado. Para obter mais informações sobre esses sinalizadores, consulte Os Sinalizadores de Espera, Notificação e Teste.

Valor Retornado

Retornará zero se tiver êxito ou um erro, caso contrário.

Comentários

Os dispositivos de sobreposição de vídeo normalmente criam e exibem uma janela quando abertos. Se o aplicativo fornecer uma janela para o driver, seu aplicativo será responsável por gerenciar as mensagens enviadas para a janela.

Como você pode usar o comando status para recuperar o identificador para a janela de exibição do driver, você também pode usar as funções padrão do gerenciador de janelas (como ShowWindow) para manipular a janela.

Exemplos

O comando a seguir exibe e define o legenda da janela de reprodução "filme".

window movie text "Welcome to the Movies" state show

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows 2000 Server [somente aplicativos da área de trabalho]

Confira também

MCI

Cadeias de caracteres de comando MCI

open

jogar

setvideo

update