CPropertyPage

Opis

Obiekty klasy CPropertyPage reprezentują indywidualne strony dialogowe w tzw. arkuszu właściwości. Arkusz taki tworzony i zarządzany jest przez obiekt klasy CPropertySheet.

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.

Atrybuty

Atrybuty	Opis
m_psp	Struktura typu `PROPSHEETPAGE` udostępniająca możliwość zmian podstawowych parametrów.

Metody

Konstruowanie

Metody Opis
CPropertyPage Tworzy obiekt typu CPropertyPage.

Construct Tworzy obiekt typu CPropertyPage. Wykorzystywana w przypadku definiowania struktury w czasie działania programu.

Operacje

Metody Opis
CancelToClose Wyłącza przycisk Anuluj, powodując, iż zamknięcie okienka musi powodować zatwierdzenie zmian.

SetModified Uaktywnia lub wyłącza przycisk Zastosuj.

QuerySiblings Rozsyła komunikat do wszystkich stron w arkuszu.

Metody do pokrycia w klasach potomnych

Metody Opis
OnCancel Wywoływana po naciśnięciu przycisku Anuluj.

OnKillActive Wywoływana automatycznie gdy dana strona traci aktywność. Przydatne do przeprowadzenia sprawdzenia poprawności danych.

OnOK Wywoływana po naciśnięciu przycisku OK.

OnSetActive Wywoływana automatycznie gdy strona uzyskuje aktywność.

OnAply Wywoływana po naciśnięciu przycisku Zastosuj.

OnReset Wywoływana po naciśnięciu przycisku Anuluj.

OnQueryCancel Wywoływana automatycznie po naciśnięciu klawisza Anuluj i przed rozpoczęciem operacji anulowania zmian.

OnWizardBack W trybie kreatora: wywoływana przez środowisko po naciśnięciu klawisza Poprzedni.

OnWizardNext W trybie kreatora: wywoływana przez środowisko po naciśnięciu klawisza Następny.

OnWizardFinish W trybie kreatora: wywoływana przez środowisko po naciśnięciu klawisza Zakończ.

Metody	Opis
CPropertyPage	Tworzy obiekt typu CPropertyPage.
Construct	Tworzy obiekt typu CPropertyPage. Wykorzystywana w przypadku definiowania struktury w czasie działania programu.

Metody	Opis
CancelToClose	Wyłącza przycisk Anuluj, powodując, iż zamknięcie okienka musi powodować zatwierdzenie zmian.
SetModified	Uaktywnia lub wyłącza przycisk Zastosuj.
QuerySiblings	Rozsyła komunikat do wszystkich stron w arkuszu.

Metody	Opis
OnCancel	Wywoływana po naciśnięciu przycisku Anuluj.
OnKillActive	Wywoływana automatycznie gdy dana strona traci aktywność. Przydatne do przeprowadzenia sprawdzenia poprawności danych.
OnOK	Wywoływana po naciśnięciu przycisku OK.
OnSetActive	Wywoływana automatycznie gdy strona uzyskuje aktywność.
OnAply	Wywoływana po naciśnięciu przycisku Zastosuj.
OnReset	Wywoływana po naciśnięciu przycisku Anuluj.
OnQueryCancel	Wywoływana automatycznie po naciśnięciu klawisza Anuluj i przed rozpoczęciem operacji anulowania zmian.
OnWizardBack	W trybie kreatora: wywoływana przez środowisko po naciśnięciu klawisza Poprzedni.
OnWizardNext	W trybie kreatora: wywoływana przez środowisko po naciśnięciu klawisza Następny.
OnWizardFinish	W trybie kreatora: wywoływana przez środowisko po naciśnięciu klawisza Zakończ.

Zobacz także

CWnd, CDialog, CPropertySheet, Kontrolki

Hierarchia