Sdílet prostřednictvím

Implementace stránek vlastností

  • Článek

Průvodce stránkou vlastností ATL není v sadě Visual Studio 2019 a novější k dispozici.

Stránky vlastností jsou objekty MODELU COM, které implementují IPropertyPage rozhraní.IPropertyPage2 ATL poskytuje podporu pro implementaci stránek vlastností prostřednictvím Průvodce stránkou vlastností ATL v dialogovém okně Přidat třídu.

Vytvoření stránky vlastností pomocí knihovny ATL:

  • Vytvořte nebo otevřete serverový projekt knihovny ATL Dynamic-Link (DLL).

  • Otevřete dialogové okno Přidat třídu a vyberte Stránku vlastností KNIHOVNY ATL.

  • Ujistěte se, že je stránka vlastnosti ve vláknech bytu (protože má uživatelské rozhraní).

  • Nastavte název, popis (Řetězec dokumentu) a soubor nápovědy, který se má přidružit k vaší stránce.

  • Přidejte ovládací prvky do vygenerovaného prostředku dialogového okna tak, aby fungovaly jako uživatelské rozhraní stránky vlastností.

  • Reagujte na změny v uživatelském rozhraní stránky a proveďte ověření, aktualizujte web stránky nebo aktualizujte objekty přidružené k vaší stránce. Konkrétně volání IPropertyPageImpl::SetDirty když uživatel provede změny na stránce vlastnosti.

  • Volitelně můžete metody přepsat IPropertyPageImpl pomocí následujících pokynů.

    Metoda IPropertyPageImpl Přepsat, když chcete... Notes
    Objekty SetObjects Proveďte základní kontroly sanity pro počet objektů, které se předávají na vaši stránku, a rozhraní, která podporují. Před voláním implementace základní třídy spusťte vlastní kód. Pokud objekty nastavené neodpovídají vašim očekáváním, měli byste volání co nejdříve selhat.
    Aktivovat Inicializace uživatelského rozhraní stránky (například nastavení ovládacích prvků dialogového okna s aktuálními hodnotami vlastností z objektů, dynamické vytváření ovládacích prvků nebo provádění jiných inicializací) Před kódem zavolejte implementaci základní třídy, aby základní třída získala možnost vytvořit okno dialogového okna a všechny ovládací prvky, než se je pokusíte aktualizovat.
    Použít Ověřte nastavení vlastnosti a aktualizujte objekty. Není nutné volat implementaci základní třídy, protože nedělá nic kromě trasování volání.
    Deaktivovat Vyčistěte položky související s oknem. Implementace základní třídy zničí dialogové okno představující stránku vlastností. Pokud potřebujete vyčistit před zničením dialogového okna, měli byste před voláním základní třídy přidat kód.

Příklad implementace stránky vlastností naleznete v tématu Příklad: Implementace stránky vlastností.

Poznámka:

Pokud chcete hostovat ovládací prvky ActiveX na stránce vlastností, budete muset změnit odvození třídy generované průvodcem. Nahraďte CDialogImpl CYourClass> cAxDialogImpl< CYourClass> v seznamu základních tříd.<

Viz také

Stránky vlastností
Ukázka ATLPages