CPropertySheet

Opis

Obiekty klasy CPropertySheet reprezentują tzw. arkusze właściwości. Arkusz taki wyświetlany jest przez system jako okno dialogowe z widocznymi w górnej części zakładkami umożliwiającymi przechodzenie pomiędzy poszczególnymi stronami składowymi arkusza.

Mimo iż klasa CPropertySheet nie dziedziczy bezpośrednio po klasie CDialog, jej użycie jest podobne. Tak jak klasa CDialog, również klasa CPropertySheet zawiera metody DoModal() oraz Create().

Tak jak w przypadku innych okien dialogowych zwykle tworzy się klasy potomne dla każdej strony arkusza właściwości. Aby utworzyć kompletny arkusz właściwości najpierw należy stworzyć obiekt klasy CPropertySheet, a następnie utworzyć oddzielne obiekty CPropertyPage dla każdej strony. Kolejnym krokiem jest wywołanie metody CPropertySheet::AddPage() dla każdego okna strony właściwości. Wyświetlenie utworzonego w ten sposób okna dialogowego możliwe jest zarówno w postaci modalnej jak i niemodalnej, odpowiednio za pomocą metod CPropertySheet::DoModal() i CPropertySheet::Create().

Odmianą szczególną okna właściwości jest tzw. kreator (ang. wizard). Składa się on, podobnie jak okno właściwości, z szeregu okien podrzędnych. W przypadku kreatora jednak okna te przeglądane są przez użytkownika sekwencyjnie, pozwalając na prowadzenie procesów krokowych takich jak np. instalacja urządzenia lub oprogramowania. Zamiast typowych dla arkusza właściwości przycisków OK, Anuluj i Zastosuj w przypadku kreatora występują przyciski Poprzedni, Następny (lub Zakończ) oraz Anuluj.

Utworzenie okna typu kreator jest identyczne jak tworzenie okna właściwości. Należy jedynie pamiętać o wywołaniu metody SetWizardMode() przed wywołaniem DoModal(). Aby uaktywnić lub ukryć dowolne przyciski wywołuje się metodę SetWizardButtons(). Aby uaktywnić przycisk Zakończ należy wywołać metodę SetFinishText(). Pozwala ona również na ustalenie tekstu na tym przycisku.

Atrybuty

Metody

Konstruowanie

Metody	Opis
CPropertySheet	Tworzy obiekt typu CPropertySheet.
Construct	Tworzy obiekt typu CPropertySheet.

Atrybuty

Metody	Opis
GetActiveIndex	Zwraca indeks aktualnie wyświetlanej strony.
GetPageIndex	Zwraca indeks danej strony.
GetPageCount	Zwraca ilość stron.
GetPage	Zwraca stronę o danym numerze.
GetActivePage	Zwraca aktualnie wyświetlaną stronę.
SetActivePage	Ustawia stronę aktywną. Uwaga: nie działa poprawnie w trybie kreatora.
SetTitle	Ustawia nagłówek określonej strony (tekst w zakładce arkusza właściwości).
GetTabControl	Zwraca wskaźnik do obiektu kontrolki zakładek.
SetFinishText	Ustawia tekst dla przycisku Zakończ.
SetWizardButtons	Włącza odpowiednie przyciski kreatora.
SetWizardMode	Uruchamia tryb kreatora.
EnableStackedTabs

Operacje

Metody	Opis
DoModal	Wyświetla okno właściwości w trybie modalnym.
Create	Wyświetla okno właściwości w trybie niemodalnym.
AddPage	Dodaje stronę do arkusza właściwości (obiekt CPropertyPage).
RemovePage	Usuwa stronę z arkusza właściwości.
PressButton	Symuluje naciśnięcie określonego przycisku.
EndDialog	Kończy dizałanie arkusza właściwości.

Zobacz także

CWnd, CDialog, CPropertyPage

Hierarchia