Auf Englisch lesen

Freigeben über


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