Informationen zu Fenstereigenschaften

  • Artikel

Eine Window-Eigenschaft sind alle Daten, die einem Fenster zugewiesen sind. Eine Window-Eigenschaft ist in der Regel ein Handle der fensterspezifischen Daten, aber es kann ein beliebiger Wert sein. Jede Fenstereigenschaft wird durch einen Zeichenfolgennamen identifiziert. Es gibt mehrere Funktionen, mit denen Anwendungen Fenstereigenschaften verwenden können. In dieser Übersicht werden die folgenden Themen erläutert:

Vorteile der Verwendung von Fenstereigenschaften

Fenstereigenschaften werden in der Regel verwendet, um Daten einem unterklassigen Fenster oder einem Fenster in einer MDI-Anwendung (Multiple Document Interface) zuzuordnen. In beiden Fällen ist es aus den folgenden zwei Gründen nicht sinnvoll, die zusätzlichen Bytes zu verwenden, die in der CreateWindow-Funktion oder Klassenstruktur angegeben sind:

  • Eine Anwendung weiß möglicherweise nicht, wie viele zusätzliche Bytes verfügbar sind oder wie der Speicherplatz verwendet wird. Mithilfe von Fenstereigenschaften kann die Anwendung Einem Fenster Daten zuordnen, ohne auf die zusätzlichen Bytes zuzugreifen.
  • Eine Anwendung muss mithilfe von Offsets auf die zusätzlichen Bytes zugreifen. Auf Fenstereigenschaften wird jedoch über deren Zeichenfolgenbezeichner zugegriffen, nicht über Offsets.

Weitere Informationen zur Unterklassenerstellung finden Sie unter Window Procedure Subclassing. Weitere Informationen zu MDI-Fenstern finden Sie unter Schnittstelle für mehrere Dokumente.

Zuweisen von Fenstereigenschaften

Die SetProp-Funktion weist einem Fenster eine Fenstereigenschaft und deren Zeichenfolgenbezeichner zu. Die GetProp-Funktion ruft die durch die angegebene Zeichenfolge identifizierte Window-Eigenschaft ab. Die RemoveProp-Funktion zerstört die Zuordnung zwischen einem Fenster und einer Fenstereigenschaft, aber nicht die Daten selbst. Um die Daten selbst zu zerstören, verwenden Sie die entsprechende Funktion, um das von RemoveProp zurückgegebene Handle freizugeben.

Auflisten von Fenstereigenschaften

Die Funktionen EnumProps und EnumPropsEx listen alle Eigenschaften eines Fensters mithilfe einer anwendungsdefinierten Rückruffunktion auf. Weitere Informationen zur Rückruffunktion finden Sie unter PropEnumProc.

EnumPropsEx enthält einen zusätzlichen Parameter für anwendungsdefinierte Daten, die von der Rückruffunktion verwendet werden. Weitere Informationen zur Rückruffunktion finden Sie unter PropEnumProcEx.