Freigeben über


CBaseWindow.ActivateWindow-Methode

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die ActivateWindow -Methode größent das Fenster entsprechend den Anforderungen der abgeleiteten Klasse.

Syntax

virtual HRESULT ActivateWindow();

Parameter

Diese Methode hat keine Parameter.

Rückgabewert

Gibt einen der in der folgenden Tabelle dargestellten HRESULT-Werte zurück.

Rückgabecode Beschreibung
S_FALSE
Fenster wurde bereits aktiviert.
S_OK
Erfolg.

Bemerkungen

Diese Methode ruft die CBaseWindow::GetDefaultRect-Methode auf, um die Fenstergröße zu bestimmen. Die abgeleitete Klasse sollte GetDefaultRect überschreiben, um die Größe der angezeigten Bilder zurückzugeben.

Wenn das Fenster bereits aktiv ist, verschiebt der Aufruf ActivateWindow das Fenster an den anfang der Z-Reihenfolge, ändert jedoch die Größe des Fensters nicht. Das gleiche gilt, wenn das Fenster über ein übergeordnetes Element verfügt.

Anforderungen

Anforderung Wert
Header
Winutil.h (streams.h einschließen)
Bibliothek
Strmbase.lib (Einzelhandelsbuilds);
Strmbasd.lib (Debugbuilds)

Siehe auch

CBaseWindow-Klasse