CSnapInPropertyPageImpl – třída
Tato třída poskytuje metody pro implementaci objektu stránky vlastností modulu snap-in.
Důležité
Tuto třídu a její členy nelze použít v aplikacích, které se spouští v prostředí Windows Runtime.
Syntaxe
CSnapInPropertyPageImpl : public CDialogImplBase
Členové
Veřejné konstruktory
| Název | Popis |
|---|---|
| CSnapInPropertyPageImpl::CSnapInPropertyPageImpl | Konstruktor |
Veřejné metody
| Název | Popis |
|---|---|
| CSnapInPropertyPageImpl::CancelToClose | Změní stav tlačítek OK a Zrušit . |
| CSnapInPropertyPageImpl::Create | Inicializuje nově vytvořený CSnapInPropertyPageImpl objekt. |
| CSnapInPropertyPageImpl::OnApply | Volá se rozhraním, když uživatel klikne na tlačítko Použít nyní při použití seznamu vlastností typu průvodce. |
| CSnapInPropertyPageImpl::OnHelp | Volá se rozhraním, když uživatel klikne na tlačítko Nápověda při použití seznamu vlastností typu průvodce. |
| CSnapInPropertyPageImpl::OnKillActive | Volá se rozhraním, pokud aktuální stránka již není aktivní. |
| CSnapInPropertyPageImpl::OnQueryCancel | Volá se rozhraním, když uživatel klikne na tlačítko Storno a před provedením zrušení. |
| CSnapInPropertyPageImpl::OnReset | Volá se rozhraním, když uživatel klikne na tlačítko Obnovit při použití seznamu vlastností typu průvodce. |
| CSnapInPropertyPageImpl::OnSetActive | Volá se rozhraním, když se aktuální stránka stane aktivní. |
| CSnapInPropertyPageImpl::OnWizardBack | Volá se rozhraním, když uživatel klikne na tlačítko Zpět při použití seznamu vlastností typu průvodce. |
| CSnapInPropertyPageImpl::OnWizardFinish | Volá se rozhraním, když uživatel klikne na tlačítko Dokončit při použití seznamu vlastností typu průvodce. |
| CSnapInPropertyPageImpl::OnWizardNext | Volá se rozhraním, když uživatel při použití seznamu vlastností typu průvodce klikne na tlačítko Další . |
| CSnapInPropertyPageImpl::QuerySiblings | Přepošla aktuální zprávu na všechny stránky seznamu vlastností. |
| CSnapInPropertyPageImpl::SetModified | Volání pro aktivaci nebo deaktivaci tlačítka Použít nyní |
Veřejné datové členy
| Název | Popis |
|---|---|
| CSnapInPropertyPageImpl::m_psp | Struktura Windows PROPSHEETPAGE používaná objektem CSnapInPropertyPageImpl . |
Poznámky
CSnapInPropertyPageImpl poskytuje základní implementaci objektu stránky vlastností modulu snap-in. Základní funkce stránky vlastností modulu snap-in jsou implementovány pomocí několika různých rozhraní a typů mapování.
Hierarchie dědičnosti
CDialogImplBase
CSnapInPropertyPageImpl
Požadavky
Hlavička: atlsnap.h
CSnapInPropertyPageImpl::CancelToClose
Volání této funkce po neopravitelné změně dat na stránce modálního seznamu vlastností.
void CancelToClose();
Poznámky
Tato funkce změní tlačítko OK na Tlačítko Zavřít a zakáže tlačítko Zrušit. Tato změna upozorní uživatele, že změna je trvalá a změny nelze zrušit.
Členová CancelToClose funkce nedělá nic v seznamu vlastností bez režimu, protože seznam bezmodální vlastnosti nemá ve výchozím nastavení tlačítko Zrušit .
CSnapInPropertyPageImpl::CSnapInPropertyPageImpl
CSnapInPropertyPageImpl Vytvoří objekt.
CSnapInPropertyPageImpl(LPCTSTR lpszTitle = NULL);
Parametry
lpszTitle
[v] Název stránky vlastností.
Poznámky
Chcete-li inicializovat základní strukturu, zavolejte CSnapInPropertyPageImpl::Create.
CSnapInPropertyPageImpl::Create
Voláním této funkce inicializujete základní strukturu stránky vlastností.
HPROPSHEETPAGE Create();
Návratová hodnota
Popisovač PROPSHEETPAGE struktury obsahující atributy nově vytvořeného seznamu vlastností.
Poznámky
Před voláním této funkce byste měli nejprve volat CSnapInPropertyPageImpl::CSnapInPropertyPageImpl .
CSnapInPropertyPageImpl::m_psp
m_psp je struktura, jejíž členy ukládají charakteristiky PROPSHEETPAGE.
PROPSHEETPAGE m_psp;
Poznámky
Tato struktura slouží k inicializaci vzhledu stránky vlastností po jeho vytvoření.
Další informace o této struktuře, včetně výpisu jejích členů, naleznete v propSHEETPAGE v sadě Windows SDK.
CSnapInPropertyPageImpl::OnApply
Tato členová funkce se volá, když uživatel klikne na tlačítko OK nebo Použít nyní .
BOOL OnApply();
Návratová hodnota
Nenulové, pokud jsou změny přijaty; jinak 0.
Poznámky
Než OnApply bude možné volat rozhraním, musíte volat SetModified a nastavit jeho parametr na HODNOTU TRUE. Tím se aktivuje tlačítko Použít nyní , jakmile uživatel provede změnu na stránce vlastností.
Přepsat tuto členovu funkci, aby určil, jakou akci program provede, když uživatel klikne na tlačítko Použít nyní . Při přepsání by funkce měla vrátit hodnotu PRAVDA, aby přijímala změny a NEPRAVDA, aby se změny projevily.
Výchozí implementace OnApply vrátí hodnotu PRAVDA.
CSnapInPropertyPageImpl::OnHelp
Tato členová funkce se volá, když uživatel klikne na tlačítko Nápověda pro stránku vlastností.
void OnHelp();
Poznámky
Přepsat tuto členovou funkci tak, aby zobrazovala nápovědu pro stránku vlastností.
CSnapInPropertyPageImpl::OnKillActive
Tato členová funkce se volá, když stránka již není aktivní stránkou.
BOOL OnKillActive();
Návratová hodnota
Nenulové, pokud byla data úspěšně aktualizována; jinak 0.
Poznámky
Přepište tuto členovu funkci tak, aby prováděla speciální úlohy ověření dat.
CSnapInPropertyPageImpl::OnQueryCancel
Tato členová funkce se volá, když uživatel klikne na tlačítko Zrušit a před provedením akce zrušení.
BOOL OnQueryCancel();
Návratová hodnota
Nenulové povolení operace zrušení; jinak 0.
Poznámky
Přepište tuto členovou funkci tak, aby určil akci, kterou program provede, když uživatel klikne na tlačítko Storno .
Výchozí implementace OnQueryCancel vrátí hodnotu PRAVDA.
CSnapInPropertyPageImpl::OnReset
Tato členová funkce se volá, když uživatel klikne na tlačítko Storno .
void OnReset();
Poznámky
Při zavolání této funkce se zahodí změny všech stránek vlastností, které uživatel provedl dříve kliknutím na tlačítko Použít nyní , a list vlastností zachová fokus.
Přepište tuto členovu funkci a určete, jakou akci program provede, když uživatel klikne na tlačítko Storno .
CSnapInPropertyPageImpl::OnSetActive
Tato členová funkce se volá, když uživatel vybere stránku a stane se aktivní stránkou.
BOOL OnSetActive();
Návratová hodnota
Nenulové, pokud byla stránka úspěšně nastavena jako aktivní; jinak 0.
Poznámky
Tuto členovou funkci přepište, aby prováděla úkoly při aktivaci stránky. Přepsání této členské funkce by mělo před provedením jakéhokoli jiného zpracování volat výchozí verzi.
Výchozí implementace vrátí hodnotu TRUE.
CSnapInPropertyPageImpl::OnWizardBack
Tato členová funkce se volá, když uživatel klikne v průvodci na tlačítko Zpět .
BOOL OnWizardBack();
Návratová hodnota
0 pro automatický přechod na předchozí stránku.
-1, aby se zabránilo změně stránky.
Pokud chcete přejít na jinou stránku než na další, vraťte identifikátor dialogového okna, který se má zobrazit.
Poznámky
Přepište tuto členovu funkci, aby bylo možné určit akci, která musí uživatel provést po kliknutí na tlačítko Zpět .
CSnapInPropertyPageImpl::OnWizardFinish
Tato členová funkce se volá, když uživatel v průvodci klikne na tlačítko Dokončit .
BOOL OnWizardFinish();
Návratová hodnota
Nenulové, pokud je po dokončení průvodce zničen seznam vlastností; jinak nula.
Poznámky
Přepište tuto členovou funkci tak, aby určil, jakou akci musí uživatel provést po kliknutí na tlačítko Dokončit .
CSnapInPropertyPageImpl::OnWizardNext
Tato členová funkce se volá, když uživatel klikne v průvodci na tlačítko Další .
BOOL OnWizardNext();
Návratová hodnota
0, aby se automaticky přechádly na další stránku.
-1, aby se zabránilo změně stránky.
Pokud chcete přejít na jinou stránku než na další, vraťte identifikátor dialogového okna, který se má zobrazit.
Poznámky
Tuto členovu funkci přepište, aby bylo možné určit akci, která uživatel musí provést po kliknutí na tlačítko Další .
CSnapInPropertyPageImpl::QuerySiblings
Voláním této členské funkce přepošlejte zprávu na každou stránku v seznamu vlastností.
LRESULT QuerySiblings(WPARAM wParam, LPARAM lParam);
Parametry
wParam
[v] Určuje další informace závislé na zprávách.
lParam
[v] Určuje další informace závislé na zprávách.
Návratová hodnota
Nenulové, pokud by zpráva neměla být přeposlána na další stránku vlastností; jinak nula.
Poznámky
Pokud stránka vrátí nenulovou hodnotu, seznam vlastností neodešle zprávu na další stránky.
CSnapInPropertyPageImpl::SetModified
Voláním této členské funkce povolíte nebo zakážete tlačítko Použít nyní na základě toho, jestli se má nastavení na stránce vlastností použít u příslušného externího objektu.
void SetModified(BOOL bChanged = TRUE);
Parametry
bChanged
[v] PRAVDA označující, že nastavení stránky vlastností bylo změněno od posledního použití; NEPRAVDA označující, že byla použita nastavení stránky vlastností nebo by se měla ignorovat.
Poznámky
Seznam vlastností sleduje, které stránky jsou "špinavé", to znamená stránky vlastností, pro které jste volali SetModified( TRUE ). Tlačítko Použít nyní bude vždy povoleno, pokud voláte SetModified( TRUE ) jednu ze stránek. Tlačítko Použít nyní bude při volání SetModified( FALSE ) jedné ze stránek zakázané, ale pouze v případě, že žádná z ostatních stránek není "špinavá".