ITaskbarList2::MarkFullscreenWindow-Methode (shobjidl_core.h)
Markiert ein Fenster als Vollbild.
Syntax
HRESULT MarkFullscreenWindow(
[in] HWND hwnd,
[in] BOOL fFullscreen
);
Parameter
[in] hwnd
Typ: HWND
Das Handle des zu markierenden Fensters.
[in] fFullscreen
Typ: BOOL
Ein boolescher Wert, der die gewünschte Vollbild-status des Fensters markiert.
Rückgabewert
Typ: HRESULT
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Wenn der Wert von fFullscreen auf TRUE festgelegt wird, behandelt die Shell dieses Fenster als Vollbildfenster, und die Taskleiste wird nach unten in der Z-Reihenfolge verschoben, wenn dieses Fenster aktiv ist. Wenn Sie den Wert von fFullscreen auf FALSE festlegen, wird die Vollbildmarkierung entfernt, aber nicht dazu führen, dass die Shell das Fenster so behandelt, als wäre es definitiv nicht im Vollbildmodus. Mit einem FALSEfFullscreen-Wert hängt die Shell von ihrer automatischen Erkennungsfunktion ab, um anzugeben, wie das Fenster behandelt werden soll. Möglicherweise wird das Fenster weiterhin als Vollbild gekennzeichnet.
Rufen Sie SetProp(hwnd, L”NonRudeHWND”, reinterpret_cast<HANDLE>(TRUE))seit Windows 7 auf, bevor ein Fenster angezeigt wird, um der Shell mitzuteilen, dass das Fenster nicht als Vollbildmodus behandelt werden soll. Dadurch wird sichergestellt, dass sich die Taskleiste nicht in z-Reihenfolge unterhalb des Fensters befindet. Dies ähnelt der Ausnahme, ITaskbarList2::MarkFullscreenWindow(FALSE) dass die Shell kein Fallback auf die automatische Erkennungsfunktion einnimmt und das Fenster nicht als Vollbild behandelt.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | shobjidl_core.h (shobjidl.h einschließen) |
| DLL | Shell32.dll |