Acceso global a objetos en los proyectos de Office
Cuando se crea un proyecto de Office, Visual Studio genera automáticamente una clase denominada Globals en el proyecto.La clase Globals se puede utilizar para obtener acceso en tiempo de ejecución a diversos elementos del proyecto desde cualquier código del proyecto.
Se aplica a: La información de este tema se aplica a los proyectos de nivel de documento y los proyectos de nivel de aplicación para Office 2013 y Office 2010. Vea Características disponibles por aplicación y tipo de proyecto de Office.
Cómo utilizar la clase Globals
Globals es una clase estática que mantiene referencias a determinados elementos del proyecto.Con la clase Globals, se puede obtener acceso en tiempo de ejecución a los siguientes elementos desde cualquier código del proyecto:
Las clases ThisWorkbook y Sheetn de un proyecto de libro o de plantilla de Excel.Puede tener acceso a estos objetos utilizando las propiedades Globals.ThisWorkbook y Sheetn.
La clase ThisDocument de un proyecto de documento o de plantilla de Word.Puede obtener acceso a este objeto mediante la propiedad Globals.ThisDocument.
La clase ThisAddIn de un proyecto de nivel de aplicación.Puede obtener acceso a este objeto mediante la propiedad Globals.ThisAddIn.
Todas las cintas de opciones del proyecto que haya personalizado mediante el Diseñador de la cinta de opciones.Puede obtener acceso a las Cintas mediante la propiedad Globals.Ribbons.Para obtener más información, vea Obtener acceso a la cinta de opciones en tiempo de ejecución.
Todas las áreas de formulario de Outlook en un proyecto de complemento de Outlook.Puede obtener acceso a las áreas del formulario mediante la propiedad Globals.FormRegions.Para obtener más información, vea Obtener acceso a un área de formulario en tiempo de ejecución.
Un objeto generador que permite crear controles de la cinta de opciones, y elementos host en tiempo de ejecución en proyectos destinados .NET Framework 4 o .NET Framework 4.5.Puede obtener acceso a este objeto mediante la propiedad Globals.Factory.Este objeto es una instancia de una clase que implementa una de las siguientes interfaces:
Por ejemplo, se puede utilizar la propiedad Globals.Sheet1 para insertar texto en un control NamedRange de Sheet1 cuando el usuario hace clic en un botón del panel de acciones en un proyecto de nivel de documento para Excel.
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
Handles Button1.Click
Globals.Sheet1.NamedRange1.Value2 = Me.TextBox1.Text
End Sub
private void button1_Click(object sender, EventArgs e)
{
Globals.Sheet1.namedRange1.Value2 = this.textBox1.Text;
}
Inicializar la clase Globals
El código que intenta utilizar la clase Globals antes de que el documento o el complemento se hayan inicializado por completo podría iniciar una excepción en tiempo de ejecución.Por ejemplo, al utilizar Globals cuando se declara una variable de nivel de clase podría fallar porque la clase Globals puede no haberse inicializado con referencias a todos los elementos host antes de que se cree una instancia del objeto declarado.
[!NOTA]
La clase Globals nunca se inicializa en tiempo de diseño, pero el diseñador crea las instancias del control.Esto significa que si crea un control de usuario que usa una propiedad de la clase Globals desde dentro de una clase de control de usuario, debe saber si la propiedad devuelve null antes de intentar utilizar el objeto devuelto.
Vea también
Conceptos
Obtener acceso a la cinta de opciones en tiempo de ejecución
Obtener acceso a un área de formulario en tiempo de ejecución