comando window

Il comando window controlla la finestra di visualizzazione. È possibile usare questo comando per modificare le caratteristiche di visualizzazione della finestra o fornire una finestra di destinazione da usare per il driver al posto della finestra di visualizzazione predefinita. I dispositivi digital-video e video-overlay riconoscono questo comando.

Per inviare questo comando, chiamare la funzione mciSendString con il set di parametri lpszCommand come indicato di seguito.

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

Parametri

lpszDeviceID

Identificatore di un dispositivo MCI. Questo identificatore o alias viene assegnato all'apertura del dispositivo.

lpszWindowFlags

Contrassegno per il controllo della finestra di visualizzazione. Nella tabella seguente sono elencati i tipi di dispositivo che riconoscono il comando window e i flag usati da ogni tipo.

Valore	Significato	Significato
digitalvideo	handle hwnd state hidestate minimizestate restorestate showshow ingrandita	show minimizedshow min noactiveshow nashow noactivateshow normaltext didascalia
overlay	fixedhandle defaulthandle hwnd state hidestate iconicstate maximizedstate minimizedstatestate ridotta a iconastate senza actionstate noactivatestate normal	state restorestate showshow maximizedshow minimizedshow min noactiveshow nashow noactivateshow normalstretchtext didascalia

Nella tabella seguente sono elencati i flag che possono essere specificati nel parametro lpszWindowFlags e i relativi significati.

Valore	Significato
fixed	Disabilita l'estensione dell'immagine.
handle default	Specifica che il dispositivo deve ripristinare la finestra di visualizzazione sulla finestra predefinita creata durante l'operazione di apertura . Per i dispositivi di sovrapposizione video, specifica che il dispositivo deve creare e gestire la propria finestra di destinazione.
handle hwnd	Specifica l'handle della finestra di destinazione da utilizzare anziché la finestra predefinita. Il parametro hwnd contiene l'equivalente numerico ASCII dell'handle di finestra restituito dalla funzione CreateWindow . Due istanze del dispositivo possono usare lo stesso handle di finestra a condizione che ogni istanza aggiorni i pixel video e immagine nella finestra come se l'altra istanza non esistesse. Quando l'output video è disabilitato con setvideo "off", un comando di aggiornamento renderà il rettangolo di destinazione un colore a tinta unita.
mostra ingrandita	Ingrandisce la finestra di destinazione.
mostra min noactive	Visualizza la finestra di destinazione come icona.
mostra ridotta a icona	Riduce al minimo la finestra di destinazione.
show na	Visualizza la finestra di destinazione nello stato corrente; la finestra attualmente attiva rimane attiva.
show noactivate	Visualizza la finestra di destinazione nella dimensione e nella posizione più recenti; la finestra attualmente attiva rimane attiva.
mostra normale	Attiva e visualizza la finestra di destinazione nella dimensione e nella posizione originali. Si tratta dello stesso flag di ripristino dello stato.
state hide	Nasconde la finestra di destinazione.
icona dello stato	Visualizza la finestra di destinazione come icona.
stato ingrandita	Ingrandisce la finestra di destinazione.
riduzione dello stato	Riduce a icona la finestra di destinazione e attiva la finestra di primo livello nell'elenco di Window Manager.
stato ridotto a icona	Riduce al minimo la finestra di destinazione.
stato nessuna azione	Visualizza la finestra di destinazione nello stato corrente. La finestra attualmente attiva rimane attiva.
state noactivate	Visualizza la finestra di destinazione nella dimensione e nello stato più recenti. La finestra attiva rimane attiva.
stato normale	Attiva e visualizza la finestra di destinazione nella dimensione e nella posizione originali.
ripristino dello stato	Attiva e visualizza la finestra di destinazione nella dimensione e nella posizione originali.
state show	Mostra la finestra di destinazione.
adattamento	Abilita l'estensione dell'immagine.
testo didascalia	Specifica il didascalia per la finestra di destinazione. Se il testo contiene spazi vuoti incorporati, l'intero didascalia deve essere racchiuso tra virgolette. Il didascalia predefinito per la finestra predefinita è vuoto.

lpszFlags

Può essere "wait", "notify" o entrambi. Per i dispositivi digital-video, è anche possibile specificare "test". Per altre informazioni su questi flag, vedere Flag di attesa, notifica e test.

Valore restituito

Restituisce zero se l'operazione ha esito positivo o un errore in caso contrario.

Commenti

I dispositivi di sovrapposizione video creano e visualizzano in genere una finestra all'apertura. Se l'applicazione fornisce una finestra al driver, l'applicazione è responsabile della gestione dei messaggi inviati alla finestra.

Poiché è possibile usare il comando status per recuperare l'handle nella finestra di visualizzazione del driver, è anche possibile usare le funzioni di gestione finestre standard (ad esempio ShowWindow) per modificare la finestra.

Esempio

Il comando seguente visualizza e imposta la didascalia per la finestra di riproduzione "movie".

window movie text "Welcome to the Movies" state show

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]

Vedi anche

MCI

Stringhe di comando MCI

open

Giocare

setvideo

update