Klasa CPropertySheet

Artykuł
02/27/2013

Reprezentuje arkusze właściwości, znany również jako kartę oknach dialogowych.

class CPropertySheet : public CWnd

Członkowie

Publiczne konstruktory

Nazwa	Opis
CPropertySheet::CPropertySheet	Konstrukcje CPropertySheet obiektu.

Metody publiczne

Nazwa	Opis
CPropertySheet::AddPage	Dodaje strony do arkusza właściwości.
CPropertySheet::Construct	Konstrukcje CPropertySheet obiektu.
CPropertySheet::Create	Wyświetla arkusz właściwości niemodalny.
CPropertySheet::DoModal	Wyświetla arkusz właściwości modalny.
CPropertySheet::EnableStackedTabs	Wskazuje, czy arkusz właściwości używa skumulowany lub przewijania kart.
CPropertySheet::EndDialog	Kończy arkusz właściwości.
CPropertySheet::GetActiveIndex	Pobiera indeks aktywnej strony arkusza właściwości.
CPropertySheet::GetActivePage	Zwraca obiekt aktywnej strony.
CPropertySheet::GetPage	Pobiera wskaźnik do określonej strony.
CPropertySheet::GetPageCount	Pobiera numer strony w arkuszu właściwości.
CPropertySheet::GetPageIndex	Pobiera indeks określonej strony arkusza właściwości.
CPropertySheet::GetTabControl	Pobiera wskaźnik do formantu karty.
CPropertySheet::MapDialogRect	Konwertuje jednostek okno dialogowe prostokąt jednostek ekranu.
CPropertySheet::OnInitDialog	Zastąpić uzupełniającej inicjowanie arkusz właściwości.
CPropertySheet::PressButton	Symuluje wybór określonego przycisku w arkuszu właściwości.
CPropertySheet::RemovePage	Usuwa stronę z arkusza właściwości.
CPropertySheet::SetActivePage	Programowo ustawia obiekt aktywnej strony.
CPropertySheet::SetFinishText	Ustawia tekst przycisku Zakończ.
CPropertySheet::SetTitle	Ustawia podpis arkusz właściwości.
CPropertySheet::SetWizardButtons	Włącza przyciski kreatora.
CPropertySheet::SetWizardMode	Włącza tryb kreatora.

Publiczne danych członków

Nazwa	Opis
CPropertySheet::m_psh	Windows PROPSHEETHEADER struktury.Zapewnia dostęp do właściwości podstawowe parametry arkusza.

Uwagi

Arkusz właściwości składa się z CPropertySheet obiektu i jednego lub więcej CPropertyPage obiektów.Ramy wyświetla arkusz właściwości jako okno zestaw wskaźników kartę i zawierającą stronę aktualnie zaznaczonego obszaru.Użytkownik przechodzi do określonej strony przy użyciu odpowiedniej karcie.

CPropertySheetzapewnia obsługę rozwiniętej PROPSHEETHEADER struktury wprowadzone w Windows 98 i Windows NT, 2000.Struktura zawiera dodatkowe flagi i członków obsługujących mapa bitowa tła "znak wodny".

Automatycznie wyświetlić te nowe obrazy w arkuszu właściwości obiektu, należy przekazać w wywołaniu prawidłowe wartości dla obrazów bitmapowych i paleta CPropertySheet::Construct lub CPropertySheet::CPropertySheet.

Mimo że CPropertySheet nie jest pochodną CDialog, zarządzanie CPropertySheet obiektu przypomina zarządzanie CDialog obiektu.Na przykład tworzenie arkusza właściwości wymaga dwóch części budowy: wywołanie konstruktora, a następnie wywołać DoModal na arkuszu właściwości modalny lub Tworzenie na arkuszu właściwości niemodalny.CPropertySheetdwa rodzaje konstruktory: CPropertySheet::Construct i CPropertySheet::CPropertySheet.

Podczas konstruowania CPropertySheet obiektu niektóre Style okien może spowodować wyjątek pierwszej szansy występuje.Wynika to z systemem próby zmiany stylu arkusz właściwości przed utworzeniem arkusza.Aby uniknąć tego wyjątku, upewnij się, ustaw następujące style, podczas tworzenia programu CPropertySheet:

DS_3DLOOK
DS_CONTROL
WS_CHILD
WS_TABSTOP

Następujące style są opcjonalne i nie spowoduje wyjątek pierwszej szansy:

DS_SHELLFONT
DS_LOCALEDIT
WS_CLIPCHILDREN

Inne Window Styles są zakazane i nie należy włączać.

Wymiana danych między CPropertySheet oraz zewnętrznego obiektu jest podobne do wymiany danych z CDialog obiektu.Istotna różnica jest, czy ustawienia arkusza właściwości są zazwyczaj zmiennych CPropertyPage obiekty nie CPropertySheet samego obiektu.

Można utworzyć typ karty okna dialogowego o nazwie Kreator, który składa się z sekwencji stron właściwości, które poprowadzą użytkownika przez kroki operację, na przykład Konfigurowanie urządzenia lub tworzenia biuletynu arkusz właściwości.W oknie dialogowym kreatora typ karty strony właściwości nie mają kart i tylko jednej właściwości strony jest widoczny w czasie.Również zamiast OK i Zastosuj ma okno dialogowe karta Typ Kreatora przycisków, Back przycisku, Dalej lub Zakończ przycisku, Anuluj przycisku i Pomoc przycisk.

Aby utworzyć okno dialogowe Typ kreatora, wykonaj te same czynności, które należy wykonać, aby utworzyć arkusz właściwości standardowych, ale wywołanie SetWizardMode przed wywołaniem DoModal.Aby włączyć przyciski kreatora, należy wywołać SetWizardButtons, aby dostosować wygląd i funkcji.Aby włączyć Zakończ przycisk, call SetFinishText po wprowadzeniu przez użytkownika akcji na ostatniej stronie kreatora.

Aby uzyskać więcej informacji na temat używania CPropertySheet obiektów, zobacz artykuł arkusze właściwości i stron właściwości.Ponadto zobacz artykuł bazy wiedzy Knowledge Base Q146916: HOWTO: tworzenie CPropertySheet niemodalny standardowych przycisków i artykuł Q300606: HOWTO: projektowania Resizable arkusz właściwości MFC.