Informacje o właściwościach okna

Właściwość okna to wszystkie dane przypisane do okna. Właściwość okna jest zwykle uchwytem danych specyficznych dla okna, ale może to być dowolna wartość. Każda właściwość okna jest identyfikowana przez nazwę ciągu. Istnieje kilka funkcji, które umożliwiają aplikacjom korzystanie z właściwości okna. W tym omówieniu omówiono następujące tematy:

• zalety używania właściwości okna
• przypisywanie właściwości okna
• Enumeracja Właściwości Okna

Zalety korzystania z właściwości okna

Właściwości okna są zwykle używane do kojarzenia danych z podklasą okna lub okna w aplikacji interfejsu wielu dokumentów (MDI). W obu przypadkach nie jest wygodne używanie dodatkowych bajtów określonych w CreateWindow funkcji lub struktury klas z następujących dwóch powodów:

• Aplikacja może nie wiedzieć, ile dodatkowych bajtów jest dostępnych lub jak jest używane miejsce. Za pomocą właściwości okna aplikacja może skojarzyć dane z oknem bez uzyskiwania dostępu do dodatkowych bajtów.
• Aplikacja musi uzyskać dostęp do dodatkowych bajtów przy użyciu przesunięć. Jednak właściwości okna są dostępne przez ich identyfikatory tekstowe, a nie przez przesunięcia.

Aby uzyskać więcej informacji na temat podklasy, zobacz Window Procedure Subclassing. Aby uzyskać więcej informacji na temat okien MDI, zobacz Interfejs wielu dokumentów.

Przypisywanie właściwości okna

Funkcja SetProp przypisuje właściwość okna i jej identyfikator ciągu do okna. Funkcja GetProp pobiera właściwość okna zidentyfikowaną przez określony ciąg. Funkcja RemoveProp niszczy skojarzenie między oknem a właściwością okna, ale nie niszczy samych danych. Aby zniszczyć same dane, użyj odpowiedniej funkcji, aby zwolnić uchwyt zwracany przez RemoveProp.

Wyliczanie właściwości okna

Funkcje EnumProps i EnumPropsEx wyliczają wszystkie właściwości okna przy użyciu funkcji wywołania zwrotnego zdefiniowanego przez aplikację. Aby uzyskać więcej informacji na temat funkcji wywołania zwrotnego, zobacz PropEnumProc.

EnumPropsEx zawiera dodatkowy parametr dla danych zdefiniowanych przez aplikację używanych przez funkcję wywołania zwrotnego. Aby uzyskać więcej informacji na temat funkcji wywołania zwrotnego, zobacz PropEnumProcEx.