ITaskbarList2::MarkFullscreenWindow-Methode (shobjidl_core.h)

Artikel
08/26/2023

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

Weitere Informationen