Udostępnij za pośrednictwem

Wzorzec kontrolki ObjectModel

  • Artykuł

Opisuje wytyczne i konwencje implementowania IObjectModelProvider, w tym informacje o metodach. Wzorzec kontrolki ObjectModel służy do uwidaczniania wskaźnika do bazowego modelu obiektów dokumentu.

Wiele aplikacji implementuje zaawansowane modele obiektów, które dodają wartość poza tym, co zapewnia usługa Microsoft UI Automation. Ten wzorzec kontrolki umożliwia klientowi przechodzenie z elementu automatyzacji interfejsu użytkownika do bazowego modelu obiektów.

Ten temat zawiera następujące sekcje.

Wytyczne i konwencje implementacji

Podczas implementowania wzorca sterowania ObjectModel należy pamiętać o następujących wytycznych i konwencjach:

  • Metoda IObjectModelProvider::GetUnderlyingObjectModel powinna zwrócić wskaźnik do obiektu znajdującego się jak najbliżej elementu źródłowego interfejsu użytkownika. Na przykład w przeglądarce internetowej dostawca automatyzacji interfejsu użytkownika dla jednego elementu powinien zwrócić wskaźnik modelu obiektów dla elementu. Zwracanie wskaźnika modelu obiektów dla katalogu głównego dokumentu byłoby znacznie mniej przydatne.
  • Klient wzorca kontrolki ObjectModel powinien mieć identyfikator IID dla szukanego interfejsu, dlatego wystarczy zwrócić prosty wskaźnik IUnknown.
  • Ponieważ automatyzacja interfejsu użytkownika marshaluje wskaźnik do procesu klienta, dostawca powinien oczekiwać, że klient będzie uzyskiwał dostęp do modelu obiektów przy użyciu standardowych rozwiązań modelu obiektów składników (COM).

Wymagane elementy członkowskie IObjectModelProvider

Poniższa metoda jest wymagana do zaimplementowania interfejsuIObjectModelProvider.

Wymagane elementy członkowskie Typ elementu członkowskiego Notatki
GetUnderlyingObjectModel Metoda Zwraca wskaźnik COM do bazowego modelu obiektów. Oczekuje się, że klient wywoła metodę IUnknown::QueryInterface, aby pobrać określone wskaźniki modelu obiektów.

 

Ten wzorzec kontrolki nie ma skojarzonych zdarzeń.

typów kontrolek i ich obsługiwanych wzorców kontrolek

Wzorce kontrolek automatyzacji interfejsu użytkownika — omówienie

Omówienie drzewa automatyzacji interfejsu użytkownika