Model ovládacího prvku ObjectModel
Popisuje pokyny a konvence pro implementaci IObjectModelProvider, včetně informací o metodách. Vzor ovládacího prvku ObjectModel slouží k zveřejnění ukazatele na podkladový objektový model dokumentu.
Mnoho aplikací implementuje bohaté objektové modely, které přidávají hodnotu nad rámec toho, co Microsoft UI Automation poskytuje. Tento vzor ovládacího prvku umožňuje klientovi přejít z prvku Automatizace uživatelského rozhraní do základního objektového modelu.
Toto téma obsahuje následující části.
Pokyny a konvence implementace
Při implementaci modelu ObjectModel ovládacích prvků si všimněte následujících pokynů a konvencí:
- IObjectModelProvider::GetUnderlyingObjectModel metoda by měla vrátit ukazatel na objekt, který je co nejblíže ke zdrojovému prvku uživatelského rozhraní. Například ve webovém prohlížeči by poskytovatel automatizace uživatelského rozhraní pro jeden prvek měl vrátit ukazatel objektového modelu prvku. Vrácení ukazatele objektového modelu pro kořen dokumentu by bylo mnohem méně užitečné.
- Klient modelu ObjectModel má mít identifikátor IID pro rozhraní, které hledají, což je důvod, proč stačí vrátit jednoduchý IUnknown ukazatel.
- Vzhledem k tomu, že automatizace uživatelského rozhraní zařadí ukazatel na proces klienta, měl by zprostředkovatel očekávat, že klient bude přistupovat k objektového modelu pomocí standardních postupů modelu COM (Component Object Model).
Požadované členy pro IObjectModelProvider
Následující metoda je vyžadována pro implementaci IObjectModelProvider rozhraní.
| Požadované členy | Typ členu | Poznámky |
|---|---|---|
| GetUnderlyingObjectModel | Metoda | Vrátí ukazatel modelu COM na základní objektový model. Očekává se, že klient zavolá metodu IUnknown::QueryInterface pro načtení konkrétních ukazatelů modelu objektu. |
Tento vzor ovládacího prvku nemá žádné přidružené události.
Související témata
-
typy ovládacích prvků a jejich podporované vzory ovládacích prvků
-
Přehled vzorů ovládacích prvků automatizace uživatelského rozhraní