Używanie arkuszy właściwości w aplikacji

Aby użyć arkusza właściwości w aplikacji, wykonaj następujące kroki:

1. Utwórz zasób szablonu okna dialogowego dla każdej strony właściwości. Należy pamiętać, że użytkownik może przełączać się z jednej strony na inną, więc należy określić poszczególne strony tak spójnie, jak to możliwe.

   Szablony okien dialogowych dla wszystkich stron nie muszą mieć tego samego rozmiaru. Struktura używa rozmiaru największej strony, aby określić ilość miejsca do przydzielenia w arkuszu właściwości dla stron właściwości.

   Podczas tworzenia zasobu szablonu okna dialogowego dla strony właściwości należy określić następujące style w arkuszu właściwości okna dialogowego:

   • Ustaw pole Edytuj podpis na stronie Ogólne na tekst, który chcesz wyświetlić na karcie tej strony.

   • Ustaw pole listy Styl na stronie Style na wartość Podrzędne.

   • Ustaw pole listy Obramowanie na stronie Style na Wartość Cienka.

   • Upewnij się, że na stronie Style jest zaznaczone pole wyboru Pasek tytułu.

   • Upewnij się, że pole wyboru Wyłączone na stronie Więcej stylów jest zaznaczone.

2. Utwórz klasę pochodną CPropertyPage odpowiadającą każdemu szablonowi okna dialogowego strony właściwości. Zobacz Dodawanie klasy. Wybierz CPropertyPage jako klasę bazową.

3. Utwórz zmienne członkowskie, aby przechowywać wartości dla tej strony właściwości. Proces dodawania zmiennych składowych do strony właściwości jest dokładnie taki sam jak dodawanie zmiennych składowych do okna dialogowego, ponieważ strona właściwości jest wyspecjalizowanym oknom dialogowym. Aby uzyskać więcej informacji, zobacz Definiowanie zmiennych składowych dla kontrolek okien dialogowych.

4. Skonstruuj obiekt CPropertySheet w kodzie źródłowym. Zazwyczaj obiekt jest konstruowany CPropertySheet w procedurze obsługi dla polecenia, które wyświetla arkusz właściwości. Ten obiekt reprezentuje cały arkusz właściwości. Jeśli tworzysz modalny arkusz właściwości z funkcją DoModal , platforma dostarcza domyślnie trzy przyciski poleceń: OK, Anuluj i Zastosuj. Struktura nie tworzy przycisków poleceń dla arkuszy właściwości bez moderowania utworzonych za pomocą funkcji Create . Nie musisz tworzyć klasy z CPropertySheet , chyba że chcesz dodać inne kontrolki (takie jak okno podglądu) lub wyświetlić arkusz właściwości bez moderowania. Ten krok jest niezbędny w przypadku arkuszy właściwości bez moderowania, ponieważ nie zawierają żadnych domyślnych kontrolek, których można użyć do zamknięcia arkusza właściwości.

5. Dla każdej strony, która ma zostać dodana do arkusza właściwości, wykonaj następujące czynności:

   • Skonstruuj jeden obiekt dla każdej CPropertyPageklasy pochodnej utworzonej wcześniej w tym procesie.

   • Wywołaj metodę CPropertySheet::AddPage dla każdej strony.

   Zazwyczaj obiekt tworzący obiekt tworzy CPropertySheetCPropertyPage również obiekty w tym kroku. Jednak w przypadku zaimplementowania klasy pochodnej można osadzić CPropertyPage obiekty w CPropertySheet obiekcie i wywołać AddPage dla każdej strony z konstruktora klasy pochodnej CPropertySheet.CPropertySheet AddPageCPropertyPage Dodaje obiekt do listy stron arkusza właściwości, ale w rzeczywistości nie tworzy okna dla tej strony. W związku z tym nie trzeba czekać, aż zostanie utworzone okno arkusza właściwości, aby wywołać AddPageAddPage metodę z konstruktora arkusza właściwości.

   Domyślnie jeśli arkusz właściwości ma więcej kart niż zmieści się w jednym wierszu arkusza właściwości, karty będą stosowane w wielu wierszach. Aby wyłączyć tworzenie stosu, wywołaj metodę CPropertySheet::EnableStackedTabs z parametrem ustawionym na FALSE. Podczas tworzenia arkusza właściwości należy wywołać metodę EnableStackedTabs .

6. Wywołaj metodę CPropertySheet::D oModal lub Utwórz , aby wyświetlić arkusz właściwości. Wywołaj metodę DoModal , aby utworzyć arkusz właściwości jako modalne okno dialogowe. Wywołaj metodę Utwórz , aby utworzyć arkusz właściwości jako okno dialogowe bez moderowania.

7. Wymiana danych między stronami właściwości a właścicielem arkusza właściwości. Zostało to wyjaśnione w artykule Wymiana danych.

Przykład użycia arkuszy właściwości można znaleźć w przykładzie PROPDLG przykładu MFC General.

Zobacz też

Arkusze właściwości