Cómo: proporcionar la automatización para WindowsHow to: Provide Automation for Windows

Puede proporcionar la automatización para ventanas de herramientas y documentos.You can provide automation for document and tool windows. Al proporcionar automatización es aconsejable siempre que desea que los objetos de automatización estén disponibles en una ventana, y el entorno no proporcione un objeto de automatización listos para su uso, como lo hace con una lista de tareas.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.

Automatización de las ventanas de herramientasAutomation for Tool Windows

El entorno proporciona automatización en una ventana de herramientas devolviendo un estándar Window objeto tal como se describe en el procedimiento siguiente:The environment provides automation on a tool window by returning a standard Window object as explained in the following procedure:

Para proporcionar la automatización de las ventanas de herramientasTo provide automation for tool windows

  1. Llame a la GetProperty método a través del entorno con __VSFPROPID como VSFPROPID para obtener la Window objeto.Call the GetProperty method via the environment with __VSFPROPID as VSFPROPID parameter to get the Window object.

  2. Cuando un llamador solicita un objeto de automatización de VSPackage específico para la ventana de herramientas a través de Object, el entorno llama QueryInterface para IExtensibleObject, IVsExtensibleObject, 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 y IVsExtensibleObject proporcionan un GetAutomationObject método.Both IExtensibleObject and IVsExtensibleObject provide a GetAutomationObject method.

  3. Cuando el entorno, a continuación, llama a la GetAutomationObject método pasando NULL, responden pasando hacer copia de su objeto específico de VSPackage.When the environment then calls the GetAutomationObject method passing NULL, respond by passing back your VSPackage-specific object.

  4. Si una llamada a QueryInterface para IExtensibleObject y IVsExtensibleObject se produce un error, a continuación, el entorno llama QueryInterface para IDispatch.If calling QueryInterface for IExtensibleObject and IVsExtensibleObject fails, then the environment calls QueryInterface for IDispatch.

Automatización de las ventanas de documentoAutomation for Document Windows

Un estándar Document objeto también está disponible en el entorno, aunque un editor puede tener su propia implementación de la Document objeto implementando IExtensibleObject interfaz y responde 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.

Además, un editor puede proporcionar un objeto de automatización específico de VSPackage, recuperado a través de la Object método implementando la IVsExtensibleObject o 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. El muestras de VSSDK contribuye a un objeto de automatización específicas del documento RTF.The VSSDK Samples contributes an RTF document-specific automation object.

Vea tambiénSee Also