Klasa CSnapInPropertyPageImpl
Ta klasa udostępnia metody implementowania obiektu strony właściwości przystawki.
Ważne
Tej klasy i jej składowych nie można używać w aplikacjach wykonywanych w środowisko wykonawcze systemu Windows.
Składnia
CSnapInPropertyPageImpl : public CDialogImplBase
Elementy członkowskie
Konstruktory publiczne
Nazwa/nazwisko | opis |
---|---|
CSnapInPropertyPageImpl::CSnapInPropertyPageImpl | Konstruktor. |
Metody publiczne
Nazwa/nazwisko | opis |
---|---|
CSnapInPropertyPageImpl::CancelToClose | Zmienia stan przycisków OK i Anuluj . |
CSnapInPropertyPageImpl::Create | Inicjuje nowo utworzony CSnapInPropertyPageImpl obiekt. |
CSnapInPropertyPageImpl::OnApply | Wywoływana przez platformę, gdy użytkownik kliknie przycisk Zastosuj teraz podczas korzystania z arkusza właściwości typu kreatora. |
CSnapInPropertyPageImpl::OnHelp | Wywoływana przez platformę, gdy użytkownik kliknie przycisk Pomoc podczas korzystania z arkusza właściwości typu kreatora. |
CSnapInPropertyPageImpl::OnKillActive | Wywoływana przez platformę, gdy bieżąca strona nie jest już aktywna. |
CSnapInPropertyPageImpl::OnQueryCancel | Wywoływana przez platformę, gdy użytkownik kliknie przycisk Anuluj i przed anulowaniem. |
CSnapInPropertyPageImpl::OnReset | Wywoływana przez platformę, gdy użytkownik kliknie przycisk Resetuj podczas korzystania z arkusza właściwości typu kreatora. |
CSnapInPropertyPageImpl::OnSetActive | Wywoływana przez platformę, gdy bieżąca strona stanie się aktywna. |
CSnapInPropertyPageImpl::OnWizardBack | Wywoływana przez platformę, gdy użytkownik kliknie przycisk Wstecz podczas korzystania z arkusza właściwości typu kreatora. |
CSnapInPropertyPageImpl::OnWizardFinish | Wywoływana przez platformę, gdy użytkownik kliknie przycisk Zakończ podczas korzystania z arkusza właściwości typu kreatora. |
CSnapInPropertyPageImpl::OnWizardNext | Wywoływana przez platformę, gdy użytkownik kliknie przycisk Dalej podczas korzystania z arkusza właściwości typu kreatora. |
CSnapInPropertyPageImpl::QuerySiblings | Przekazuje bieżący komunikat do wszystkich stron arkusza właściwości. |
CSnapInPropertyPageImpl::SetModified | Wywołaj polecenie , aby aktywować lub dezaktywować przycisk Zastosuj teraz . |
Publiczne elementy członkowskie danych
Nazwa/nazwisko | opis |
---|---|
CSnapInPropertyPageImpl::m_psp | Struktura systemu Windows PROPSHEETPAGE używana przez CSnapInPropertyPageImpl obiekt . |
Uwagi
CSnapInPropertyPageImpl
Udostępnia podstawową implementację obiektu strony właściwości przystawki. Podstawowe funkcje strony właściwości przystawki są implementowane przy użyciu kilku różnych interfejsów i typów map.
Hierarchia dziedziczenia
CDialogImplBase
CSnapInPropertyPageImpl
Wymagania
Nagłówek: atlsnap.h
CSnapInPropertyPageImpl::CancelToClose
Wywołaj tę funkcję po wprowadzeniu nieodwracalnej zmiany danych na stronie modalnego arkusza właściwości.
void CancelToClose();
Uwagi
Ta funkcja zmieni przycisk OK na Zamknij i wyłączy przycisk Anuluj. Ta zmiana ostrzega użytkownika, że zmiana jest trwała, a modyfikacje nie mogą zostać anulowane.
Funkcja CancelToClose
składowa nie wykonuje nic w arkuszu właściwości bez moderowania, ponieważ domyślnie nie ma przycisku Anuluj .
CSnapInPropertyPageImpl::CSnapInPropertyPageImpl
CSnapInPropertyPageImpl
Tworzy obiekt.
CSnapInPropertyPageImpl(LPCTSTR lpszTitle = NULL);
Parametry
lpszTitle
[in] Tytuł strony właściwości.
Uwagi
Aby zainicjować strukturę bazową, wywołaj metodę CSnapInPropertyPageImpl::Create.
CSnapInPropertyPageImpl::Create
Wywołaj tę funkcję, aby zainicjować podstawową strukturę strony właściwości.
HPROPSHEETPAGE Create();
Wartość zwracana
Uchwyt do PROPSHEETPAGE
struktury zawierającej atrybuty nowo utworzonego arkusza właściwości.
Uwagi
Przed wywołaniem tej funkcji należy najpierw wywołać metodę CSnapInPropertyPageImpl::CSnapInPropertyPageImpl .
CSnapInPropertyPageImpl::m_psp
m_psp
jest strukturą, której składowe przechowują cechy .PROPSHEETPAGE
PROPSHEETPAGE m_psp;
Uwagi
Użyj tej struktury, aby zainicjować wygląd strony właściwości po jej utworzeniu.
Aby uzyskać więcej informacji na temat tej struktury, w tym listy jej elementów członkowskich, zobacz PROPSHEETPAGE w zestawie Windows SDK.
CSnapInPropertyPageImpl::OnApply
Ta funkcja składowa jest wywoływana, gdy użytkownik kliknie przycisk OK lub przycisk Zastosuj teraz .
BOOL OnApply();
Wartość zwracana
Niezerowe, jeśli zmiany są akceptowane; w przeciwnym razie 0.
Uwagi
Aby OnApply
można było wywołać strukturę, należy wywołać SetModified
parametr i ustawić jego parametr na wartość TRUE. Spowoduje to aktywowanie przycisku Zastosuj teraz , gdy tylko użytkownik dokona zmiany na stronie właściwości.
Zastąpi tę funkcję składową, aby określić, jaką akcję podejmuje program, gdy użytkownik kliknie przycisk Zastosuj teraz . Podczas zastępowania funkcja powinna zwracać wartość TRUE, aby zaakceptować zmiany i wartość FALSE, aby zapobiec wprowadzeniu zmian.
Domyślna implementacja OnApply
zwraca wartość TRUE.
CSnapInPropertyPageImpl::OnHelp
Ta funkcja składowa jest wywoływana, gdy użytkownik kliknie przycisk Pomoc dla strony właściwości.
void OnHelp();
Uwagi
Zastąpi tę funkcję składową, aby wyświetlić pomoc dotyczącą strony właściwości.
CSnapInPropertyPageImpl::OnKillActive
Ta funkcja składowa jest wywoływana, gdy strona nie jest już aktywną stroną.
BOOL OnKillActive();
Wartość zwracana
Niezerowe, jeśli dane zostały pomyślnie zaktualizowane; w przeciwnym razie 0.
Uwagi
Zastąpij tę funkcję składową, aby wykonywać specjalne zadania weryfikacji danych.
CSnapInPropertyPageImpl::OnQueryCancel
Ta funkcja składowa jest wywoływana, gdy użytkownik kliknie przycisk Anuluj i przed podjęciem akcji anulowania.
BOOL OnQueryCancel();
Wartość zwracana
Bez zera, aby zezwolić na operację anulowania; w przeciwnym razie 0.
Uwagi
Zastąpi tę funkcję składową, aby określić akcję wykonywaną przez program, gdy użytkownik kliknie przycisk Anuluj .
Domyślna implementacja OnQueryCancel
zwraca wartość TRUE.
CSnapInPropertyPageImpl::OnReset
Ta funkcja składowa jest wywoływana, gdy użytkownik kliknie przycisk Anuluj .
void OnReset();
Uwagi
Po wywołaniu tej funkcji zostaną odrzucone wszystkie strony właściwości wprowadzone przez użytkownika, które wcześniej kliknęły przycisk Zastosuj teraz , a arkusz właściwości zachowuje fokus.
Zastąpi tę funkcję składową, aby określić, jaką akcję podejmuje program, gdy użytkownik kliknie przycisk Anuluj .
CSnapInPropertyPageImpl::OnSetActive
Ta funkcja składowa jest wywoływana, gdy strona jest wybierana przez użytkownika i staje się aktywną stroną.
BOOL OnSetActive();
Wartość zwracana
Niezerowe, jeśli strona została pomyślnie ustawiona jako aktywna; w przeciwnym razie 0.
Uwagi
Zastąpi tę funkcję składową, aby wykonywać zadania po aktywowaniu strony. Zastąpienie tej funkcji składowej powinno wywołać domyślną wersję przed wykonaniem jakiegokolwiek innego przetwarzania.
Domyślna implementacja zwraca wartość TRUE.
CSnapInPropertyPageImpl::OnWizardBack
Ta funkcja składowa jest wywoływana, gdy użytkownik kliknie przycisk Wstecz w kreatorze.
BOOL OnWizardBack();
Wartość zwracana
0, aby automatycznie przejść do poprzedniej strony.
-1, aby zapobiec zmianie strony.
Aby przejść do strony innej niż następna, zwróć identyfikator okna dialogowego do wyświetlenia.
Uwagi
Zastąpi tę funkcję składową, aby określić akcję, która użytkownik musi wykonać po kliknięciu przycisku Wstecz .
CSnapInPropertyPageImpl::OnWizardFinish
Ta funkcja składowa jest wywoływana, gdy użytkownik kliknie przycisk Zakończ w kreatorze.
BOOL OnWizardFinish();
Wartość zwracana
Niezero, jeśli arkusz właściwości zostanie zniszczony po zakończeniu działania kreatora; w przeciwnym razie zero.
Uwagi
Zastąpi tę funkcję składową, aby określić akcję, która użytkownik musi wykonać po kliknięciu przycisku Zakończ .
CSnapInPropertyPageImpl::OnWizardNext
Ta funkcja składowa jest wywoływana, gdy użytkownik kliknie przycisk Dalej w kreatorze.
BOOL OnWizardNext();
Wartość zwracana
0, aby automatycznie przejść do następnej strony.
-1, aby zapobiec zmianie strony.
Aby przejść do strony innej niż następna, zwróć identyfikator okna dialogowego do wyświetlenia.
Uwagi
Zastąpi tę funkcję składową, aby określić akcję, która użytkownik musi wykonać po kliknięciu przycisku Dalej .
CSnapInPropertyPageImpl::QuerySiblings
Wywołaj tę funkcję składową, aby przekazać komunikat do każdej strony w arkuszu właściwości.
LRESULT QuerySiblings(WPARAM wParam, LPARAM lParam);
Parametry
wParam
[in] Określa dodatkowe informacje zależne od komunikatów.
lParam
[in] Określa dodatkowe informacje zależne od komunikatów.
Wartość zwracana
Nonzero, jeśli komunikat nie powinien być przekazywany do następnej strony właściwości; w przeciwnym razie zero.
Uwagi
Jeśli strona zwraca wartość niezerową, arkusz właściwości nie wysyła komunikatu do kolejnych stron.
CSnapInPropertyPageImpl::SetModified
Wywołaj tę funkcję składową, aby włączyć lub wyłączyć przycisk Zastosuj teraz , na podstawie tego, czy ustawienia na stronie właściwości powinny być stosowane do odpowiedniego obiektu zewnętrznego.
void SetModified(BOOL bChanged = TRUE);
Parametry
bChanged
[in] WARTOŚĆ TRUE wskazująca, że ustawienia strony właściwości zostały zmodyfikowane od czasu ostatniego zastosowania; FAŁSZ wskazuje, że ustawienia strony właściwości zostały zastosowane lub powinny być ignorowane.
Uwagi
Arkusz właściwości śledzi strony "brudne", czyli strony właściwości, dla których nazwano SetModified( TRUE )
. Przycisk Zastosuj teraz będzie zawsze włączony, jeśli wywołasz SetModified( TRUE )
jedną ze stron. Przycisk Zastosuj teraz zostanie wyłączony po wywołaniu SetModified( FALSE )
jednej ze stron, ale tylko wtedy, gdy żadna z pozostałych stron nie jest "zanieczyszczona".