RemoveWindowSubclass-Funktion (commctrl.h)

  • Artikel

Entfernt einen Unterklassenrückruf aus einem Fenster.

Syntax

BOOL RemoveWindowSubclass(
  [in] HWND         hWnd,
  [in] SUBCLASSPROC pfnSubclass,
  [in] UINT_PTR     uIdSubclass
);

Parameter

[in] hWnd

Typ: HWND

Das Handle des Fensters, das unterklassiert wird.

[in] pfnSubclass

Typ: SUBCLASSPROC

Ein Zeiger auf eine Fensterprozedur. Dieser Zeiger und die Unterklassen-ID identifizieren diesen Unterklassenrückruf eindeutig. Informationen zum Prototyp der Rückruffunktion finden Sie unter SUBCLASSPROC.

[in] uIdSubclass

Typ: UINT_PTR

Die UINT_PTR Unterklassen-ID. Diese ID und der Rückrufzeiger identifizieren diesen Unterklassenrückruf eindeutig. Hinweis: Bei 64-Bit-Versionen von Windows handelt es sich um einen 64-Bit-Wert.

Rückgabewert

Typ: BOOL

TRUE , wenn der Rückruf der Unterklasse erfolgreich entfernt wurde; andernfalls FALSE.

Hinweise

Rückrufe von Unterklassen werden durch ihre Kombination aus der Rückrufadresse und der vom aufrufenden Prozess definierten Unterklassen-ID identifiziert.

Das SUBCLASS-Modul definiert Hilfsfunktionen, die zum Unterklassen von Fenstern verwendet werden. Der Code verwaltet eine einzelne Eigenschaft im unterklassigen Fenster und sendet nach Bedarf verschiedene Unterklassenrückrufe an seine Clients. Dem Client werden Referenzdaten und eine Standardverarbeitungs-API bereitgestellt.

Für den Rückruf wird keine Verweiszählung durchgeführt. Es kann wiederholt SetWindowSubclass aufrufen, um den Wert des Referenzdatenelements zu ändern.

Warnung Sie können die Hilfsfunktionen für Unterklassen nicht verwenden, um ein Fenster über Threads unterzugliedern.
 

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile commctrl.h
Bibliothek Comctl32.lib
DLL Comctl32.dll (Version 5.8 oder höher)
APIs ext-ms-win-shell-comctl32-window-l1-1-0 (eingeführt in Windows 10, Version 10.0.14393)

Weitere Informationen

DefSubclassProc

GetWindowSubclass

SetWindowSubclass