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] |