Window-Befehl

Der Fensterbefehl steuert das Anzeigefenster. Mit diesem Befehl können Sie die Anzeigeeigenschaften des Fensters ändern oder ein Zielfenster bereitstellen, das der Treiber anstelle des Standardanzeigefensters verwenden soll. Digitalvideo- und Videoüberlagerungsgeräte erkennen diesen Befehl.

Um diesen Befehl zu senden, rufen Sie die mciSendString-Funktion auf, wobei der parameter lpszCommand wie folgt festgelegt ist.

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

Parameter

lpszDeviceID

Bezeichner eines MCI-Geräts. Dieser Bezeichner oder Alias wird zugewiesen, wenn das Gerät geöffnet wird.

lpszWindowFlags

Flag zum Steuern des Anzeigefensters. In der folgenden Tabelle sind Gerätetypen aufgeführt, die den Fensterbefehl und die von jedem Typ verwendeten Flags erkennen.

Wert	Bedeutung	Bedeutung
digitalvideo	handle hwnd state hidestate minimizestate restorestate showmaximiert	show minimizedshow min noactiveshow nashow noactivateshowshow normaltext Untertitel
overlay	fixedhandle defaulthandle hwnd state hidestate iconicstate maximizedstate minimizestate minimizedstate no actionstate noactivatestate normal	state restorestate showshow maximizedShow minimizedShow min noactiveshow nashow noactivateshow normalstretchtext Untertitel

In der folgenden Tabelle sind die Flags aufgeführt, die im lpszWindowFlags-Parameter angegeben werden können, und ihre Bedeutungen.

Wert	Bedeutung
fixed	Deaktiviert die Dehnung des Bilds.
handle standard	Gibt an, dass das Gerät das Anzeigefenster wieder auf das Standardfenster festlegen soll, das während des Geöffneten Vorgangs erstellt wurde. Gibt für Videoüberlagerungsgeräte an, dass das Gerät ein eigenes Zielfenster erstellen und verwalten soll.
handle hwnd	Gibt das Handle des Zielfensters an, das anstelle des Standardfensters verwendet werden soll. Der hwnd-Parameter enthält die numerische ASCII-Entsprechung des Fensterhandles, das von der CreateWindow-Funktion zurückgegeben wird. Zwei Geräteinstanzen können dasselbe Fensterhandle verwenden, vorausgesetzt, jede instance aktualisiert die Video- und Bildpixel im Fenster so, als ob die andere instance nicht vorhanden wäre. Wenn die Videoausgabe mit setvideo "off" deaktiviert ist, wird das Zielrechteck durch einen Aktualisierungsbefehl in eine Einfarbige Farbe umgewandelt.
maximiert anzeigen	Maximiert das Zielfenster.
min noactive anzeigen	Zeigt das Zielfenster als Symbol an.
minimiert anzeigen	Minimiert das Zielfenster.
show na	Zeigt das Zielfenster im aktuellen Zustand an. das aktuell aktive Fenster bleibt aktiv.
noactivate anzeigen	Zeigt das Zielfenster in seiner neuesten Größe und Position an. das aktuell aktive Fenster bleibt aktiv.
Normal anzeigen	Aktiviert und zeigt das Zielfenster in seiner ursprünglichen Größe und Position an. (Dies ist identisch mit dem Flag "Zustandswiederherstellung".)
Zustand ausblenden	Blendet das Zielfenster aus.
State Iconic	Zeigt das Zielfenster als Symbol an.
Zustand maximiert	Maximiert das Zielfenster.
Zustand minimieren	Minimiert das Zielfenster und aktiviert das Fenster der obersten Ebene in der Liste des Fenster-Managers.
Zustand minimiert	Minimiert das Zielfenster.
Zustand keine Aktion	Zeigt das Zielfenster im aktuellen Zustand an. Das fenster, das aktuell aktiv ist, bleibt aktiv.
status noactivate	Zeigt das Zielfenster in seiner neuesten Größe und dem neuesten Zustand an. Das derzeit aktive Fenster bleibt aktiv.
Zustand normal	Aktiviert und zeigt das Zielfenster in seiner ursprünglichen Größe und Position an.
Zustandswiederherstellung	Aktiviert und zeigt das Zielfenster in seiner ursprünglichen Größe und Position an.
Zustandsshow	Zeigt das Zielfenster an.
strecken	Ermöglicht die Dehnung des Bilds.
text Untertitel	Gibt die Untertitel für das Zielfenster an. Wenn dieser Text eingebettete Leerzeichen enthält, muss die gesamte Untertitel in Anführungszeichen eingeschlossen werden. Die Standardeinstellung Untertitel für das Standardfenster ist leer.

lpszFlags

Kann "warten", "benachrichtigen" oder beides sein. Für Digital-Video-Geräte kann auch "Test" angegeben werden. Weitere Informationen zu diesen Flags finden Sie unter Warte-, Benachrichtigungs- und Testflags.

Rückgabewert

Gibt null zurück, wenn der Vorgang erfolgreich war oder andernfalls ein Fehler.

Bemerkungen

Videoüberlagerungsgeräte erstellen und zeigen in der Regel ein Fenster an, wenn sie geöffnet werden. Wenn Ihre Anwendung dem Treiber ein Fenster bereitstellt, ist Ihre Anwendung für die Verwaltung der an das Fenster gesendeten Nachrichten verantwortlich.

Da Sie den Befehl status verwenden können, um das Handle zum Anzeigefenster des Treibers abzurufen, können Sie auch die Standardfunktionen des Fenster-Managers (z. B. ShowWindow) verwenden, um das Fenster zu bearbeiten.

Beispiele

Mit dem folgenden Befehl wird die Untertitel für das Wiedergabefenster "Film" angezeigt und festgelegt.

window movie text "Welcome to the Movies" state show

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]

Siehe auch

MCI

MCI-Befehlszeichenfolgen

open

play

setvideo

update