WM_NCACTIVATE Nachricht

Wird an ein Fenster gesendet, wenn dessen Nichtclientbereich geändert werden muss, um einen aktiven oder inaktiven Zustand anzugeben.

Ein Fenster empfängt diese Nachricht über seine WindowProc-Funktion .

#define WM_NCACTIVATE                   0x0086

Parameter

wParam

Gibt an, wann eine Titelleiste oder ein Symbol geändert werden muss, um einen aktiven oder inaktiven Zustand anzugeben. Wenn eine aktive Titelleiste oder ein aktives Symbol gezeichnet werden soll, ist der wParam-ParameterTRUE. Wenn eine inaktive Titelleiste oder ein inaktives Symbol gezeichnet werden soll, ist wParamFALSE.

lParam

Wenn ein visueller Stil für dieses Fenster aktiv ist, wird dieser Parameter nicht verwendet.

Wenn ein visueller Stil für dieses Fenster nicht aktiv ist, ist dieser Parameter ein Handle für einen optionalen Aktualisierungsbereich für den Nichtclientbereich des Fensters. Wenn dieser Parameter auf -1 festgelegt ist, streicht DefWindowProc den Nichtclientbereich nicht neu, um die Zustandsänderung widerzuspiegeln.

Rückgabewert

Typ: LRESULT

Wenn der wParam-ParameterFALSE ist, sollte eine Anwendung TRUE zurückgeben, um anzugeben, dass das System mit der Standardverarbeitung fortfahren soll, oder es sollte FALSE zurückgeben, um die Änderung zu verhindern. Wenn wParamtrue ist, wird der Rückgabewert ignoriert.

Bemerkungen

Die Verarbeitung von Nachrichten im Zusammenhang mit dem Nichtclientbereich eines Standardfensters wird nicht empfohlen, da die Anwendung in der Lage sein muss, alle erforderlichen Teile des Nichtclientbereichs für das Fenster zu zeichnen. Wenn eine Anwendung diese Nachricht verarbeitet, muss sie TRUE zurückgeben, damit das System die Änderung des aktiven Fensters abschließen kann. Wenn das Fenster beim Empfang dieser Nachricht minimiert wird, sollte die Anwendung die Nachricht an die Funktion DefWindowProc übergeben.

Die DefWindowProc-Funktion zeichnet den Titelleisten- oder Symboltitel in den aktiven Farben, wenn der wParam-ParameterTRUE ist, und in seinen inaktiven Farben, wenn wParamFALSE ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Winuser.h (einschließlich Windows.h)

Siehe auch

Referenz

DefWindowProc

Konzept

Windows