Como: fornecer automação para windowsHow to: Provide automation for windows

Você pode fornecer automação para janelas de documento e ferramenta.You can provide automation for document and tool windows. Fornecer automação é recomendável sempre que você deseja disponibilizar os objetos de automação em uma janela, e o ambiente já não fornecem um objeto de automação prontas para uso, como ocorre com uma lista de tarefas.Providing automation is advisable whenever you want to make automation objects available on a window, and the environment does not already provide a ready-made automation object, as it does with a task list.

Automação das janelas de ferramentasAutomation for tool windows

O ambiente fornece automação em uma janela de ferramentas, retornando um padrão Window objeto conforme explicado no procedimento a seguir:The environment provides automation on a tool window by returning a standard Window object as explained in the following procedure:

Fornecer automação para janelas de ferramentasTo provide automation for tool windows

  1. Chame o GetProperty método por meio do ambiente com __VSFPROPID como VSFPROPID para obter o Window objeto.Call the GetProperty method via the environment with __VSFPROPID as VSFPROPID parameter to get the Window object.

  2. Quando um chamador solicita um objeto de automação de VSPackage específico para sua janela da ferramenta por meio Object, as chamadas de ambiente QueryInterface para IExtensibleObject, IVsExtensibleObject, ou o IDispatch interfaces.When a caller requests a VSPackage-specific automation object for your tool window through Object, the environment calls QueryInterface for IExtensibleObject, IVsExtensibleObject, or the IDispatch interfaces. Ambos IExtensibleObject e IVsExtensibleObject fornecem um GetAutomationObject método.Both IExtensibleObject and IVsExtensibleObject provide a GetAutomationObject method.

  3. Quando o ambiente, em seguida, chama o GetAutomationObject método passando NULL, responder, passando de volta o objeto específico do VSPackage.When the environment then calls the GetAutomationObject method passing NULL, respond by passing back your VSPackage-specific object.

  4. Se chamar QueryInterface para IExtensibleObject e IVsExtensibleObject falhar, então, o ambiente chama QueryInterface para IDispatch.If calling QueryInterface for IExtensibleObject and IVsExtensibleObject fails, then the environment calls QueryInterface for IDispatch.

Automação para janelas de documentoAutomation for document windows

Um padrão Document objeto também está disponível no ambiente, embora um editor pode ter sua própria implementação do Document objeto implementando IExtensibleObject interface e respondendo a GetAutomationObject.A standard Document object is also available from the environment, although an editor can have its own implementation of the Document object by implementing IExtensibleObject interface and responding to GetAutomationObject.

Além disso, um editor pode fornecer um objeto de automação específicos de VSPackage, recuperado por meio de Object método, Implementando o IVsExtensibleObject ou IExtensibleObject interfaces.In addition, an editor can provide a VSPackage-specific automation object, retrieved through the Object method, by implementing the IVsExtensibleObject or IExtensibleObject interfaces. O exemplos de VSSDK contribui com um objeto de automação específicos do documento RTF.The VSSDK samples contributes an RTF document-specific automation object.

Consulte tambémSee also

IVsExtensibleObject