Globální přístup k objektům v projektech pro systém Office
Při vytváření projektu aplikace sady Office, Visual Studio automaticky generuje třídu s názvem Globals v projektu.Můžete použít Globals třídu pro přístup k několika položek jiný projekt v době spuštění libovolného kódu v projektu.
Platí pro: Informace v tomto tématu se vztahují na projekty na úrovni dokumentu i na úrovni aplikace v Office 2013 a v Office 2010. Další informace najdete v tématu Dostupné funkce podle aplikací systému Office a typů projektu.
Způsob použití třídy Globals
Globalsje statické třídy, který udržuje odkazy na určité položky v projektu.Pomocí Globals třídou, dostanete následující položky z jakéhokoliv kódu v projektu za běhu:
ThisWorkbook a Sheetn tříd v projektu aplikace Excel sešit nebo šablonu.Tyto objekty můžete přistupovat pomocí Globals.ThisWorkbook a Sheetn vlastnosti.
ThisDocument Třídou v aplikace Word dokument nebo šablonu projektu.Tento objekt lze přistupovat pomocí Globals.ThisDocument vlastnost.
ThisAddIn Třídy v projektu úrovni aplikace.Tento objekt lze přistupovat pomocí Globals.ThisAddIn vlastnost.
Všechny pásy karet ve vašem projektu, který jste přizpůsobili pomocí Návrháře pásu karet.Pásy karet můžete přistupovat pomocí Globals.Ribbons vlastnost.Další informace naleznete v tématu Přístup k pásu karet za běhu.
Všechny oblasti formulářů aplikace Outlook v projektu aplikace doplněk pro aplikaci Outlook.Oblasti formulářů můžete přistupovat pomocí Globals.FormRegions vlastnost.Další informace naleznete v tématu Přístup k oblasti formuláře za běhu.
Tovární objekt, který umožňuje vytvářet ovládací prvky pásu karet a hostitelem položky za běhu v projektech cílených .NET Framework 4 nebo .NET Framework 4,5.Tento objekt lze přistupovat pomocí Globals.Factory vlastnost.Tento objekt je instancí třídy, která implementuje jedno následující rozhraní:
Například můžete použít Globals.Sheet1 vlastnost, kterou chcete vložit text do NamedRange ovládacího prvku na Sheet1 když uživatel klikne na tlačítko v podokně akcí v projektu na úrovni dokumentu pro aplikaci 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;
}
Inicializace třídy Globals
Kód, který se pokouší použít Globals třídy před zcela inicializován dokument nebo doplněk může vyvolat výjimku běhu.Například pomocí Globals při deklarování proměnné úrovni třídy zdařit, protože Globals třída nemusí být inicializována s odkazy na všechny položky hostitel dříve, než je vytvořena instance objektu deklarovaného.
[!POZNÁMKA]
Globals Třída není nikdy inicializován v době návrhu, ale Návrhář jsou vytvořeny instance ovládacích prvků.To znamená, že pokud vytvoříte uživatelský ovládací prvek, který používá vlastnost Globals třídy z uvnitř třídy uživatelského ovládacího prvku, je nutné zda vlastnost vrátí null dříve, než se pokusíte použít vráceného objektu.
Viz také
Koncepty
Přístup k oblasti formuláře za běhu
Přehled hostitelských položek a hostitelských ovládacích prvků