Delen via


ObjectModel-besturingselementpatroon

Beschrijft richtlijnen en conventies voor het implementeren van IObjectModelProvider, inclusief informatie over methoden. Het ObjectModel besturingspatroon wordt gebruikt om een aanwijzer beschikbaar te maken voor het onderliggende objectmodel van een document.

Veel toepassingen implementeren uitgebreide objectmodellen die waarde toevoegen buiten wat Microsoft UI Automation biedt. Met dit besturingspatroon kan een client vanuit een UI Automation-element navigeren naar het onderliggende objectmodel.

Dit onderwerp bevat de volgende secties.

Implementatierichtlijnen en conventies

Let bij het implementeren van het ObjectModel besturingspatroon op de volgende richtlijnen en conventies:

  • De methode IObjectModelProvider::GetUnderlyingObjectModel moet een aanwijzer retourneren naar het object dat zich zo dicht mogelijk bij het bron-UI-element bevindt. In een webbrowser moet een UI Automation-provider voor één element bijvoorbeeld een objectmodelaanwijzer voor het element retourneren. Het retourneren van een objectmodelaanwijzer voor de hoofdmap van het document is veel minder nuttig.
  • De client van het ObjectModel controlepatroon heeft naar verwachting de IID voor de interface die ze zoeken. Daarom is het voldoende om een eenvoudige IUnknown- aanwijzer te retourneren.
  • Omdat UI Automation de aanwijzer naar het clientproces verwijst, moet de provider verwachten dat de client toegang heeft tot het objectmodel met behulp van COM-procedures (Standard Component Object Model).

Vereiste leden voor IObjectModelProvider-

De volgende methode is vereist voor het implementeren van de IObjectModelProvider interface.

Vereiste leden Type lid Notities
GetUnderlyingObjectModel- Methode Hiermee wordt een COM-aanwijzer geretourneerd naar het onderliggende objectmodel. De client roept naar verwachting de methode IUnknown::QueryInterface aan om specifieke objectmodelaanwijzers op te halen.

 

Dit besturingspatroon heeft geen gekoppelde gebeurtenissen.

besturingstypen en de ondersteunde besturingspatronen

Overzicht van UI Automation-besturingspatronen

Overzicht van UI Automation Tree