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-

Der Ziehpunkt des zu markierenden Fensters.

[in] fFullscreen

Typ: BOOL-

Ein boolescher Wert, der den gewünschten Vollbildstatus des Fensters markiert.

Rückgabewert

Typ: HRESULT-

Wenn diese Methode erfolgreich ist, wird S_OKzurückgegeben. Andernfalls wird ein HRESULT- Fehlercode zurückgegeben.

Bemerkungen

Wenn Sie den Wert von fFullscreen auf TRUE festlegen, behandelt die Shell dieses Fenster als Vollbildfenster, und die Taskleiste wird an den unteren Rand der Z-Reihenfolge verschoben, wenn dieses Fenster aktiv ist. Wenn Sie den Wert von fFullscreen auf FALSE festlegen, wird die Vollbildmarkierung entfernt, die Shell jedoch nicht dazu veranlasst, das Fenster so zu behandeln, als wäre es definitiv nicht vollbildig. Bei 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.

Since Windows 7, rufen Sie SetProp(hwnd, L"NonRudeHWND", reinterpret_cast<HANDLE>(TRUE)) auf, bevor ein Fenster angezeigt wird, um der Shell anzuzeigen, dass das Fenster nicht als Vollbildmodus behandelt werden soll. Dadurch wird sichergestellt, dass sich die Taskleiste nicht so anpasst, dass sie sich unter dem Fenster in der Z-Reihenfolge befindet. Dies ist vergleichbar mit der Ausnahme, ITaskbarList2::MarkFullscreenWindow(FALSE) dass die Shell nicht auf seine automatische Erkennungseinrichtung zurückweicht und das Fenster nicht als Vollbildmodus behandelt.

Requirements

Siehe auch

ITaskbarList

ITaskbarList2

SetPropA

SetPropW