全域存取 Visual Studio Tools for Office 專案中的物件
更新:2007 年 11 月
您可以使用 Globals 類別 (Class),從專案的任何程式碼中存取多個不同的專案項目。
如何使用 Globals
Globals 是靜態類別,這個靜態類別會將項目參考保留在專案中。您可以使用 Globals 類別,從專案中的任何程式碼參考下列項目:
Excel 活頁簿 (Workbook) 或範本專案中的 Workbook 或任何 Worksheet 主項目。您可以使用參考專案中每個主項目之 Globals 類別的屬性,即可存取這些主項目。主項目名稱預設為 ThisWorkbook、Sheet1、Sheet2 和 Sheet3。
Word 文件或範本專案中的 Document 主項目。這個主項目屬性的預設名稱為 Globals.ThisDocument。
應用程式層級專案中的 AddIn 主項目。這個主項目屬性的預設名稱為 Globals.ThisAddIn。
專案中使用 [功能區設計工具] 自訂的所有功能區。您可以使用 Globals.Ribbons 屬性存取功能區。
Outlook 增益集專案中的所有 Outlook 表單區域。您可以使用 Globals.FormRegions 屬性存取表單區域。
例如,您可以撰寫程式碼,在使用者按一下執行窗格上的按鈕時,將文字插入至 Sheet1 上的 NamedRange 控制項 (如下面範例所示)。
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
Handles Button1.Click
If Globals.Sheet1 IsNot Nothing Then
Globals.Sheet1.NamedRange1.Value2 = Me.TextBox1.Text
End If
End Sub
private void button1_Click(object sender, EventArgs e)
{
if (Globals.Sheet1 != null)
{
Globals.Sheet1.namedRange1.Value2 = this.textBox1.Text;
}
}
初始化 Globals 類別
嘗試在文件或增益集完全初始化之前使用 Globals 類別的程式碼,可能會擲回執行階段例外狀況 (Exception)。例如,在宣告類別層級的變數時使用 Globals 可能會失敗,因為 Globals 類別可能不會在宣告的物件具現化之前,使用所有主項目的參考進行初始化。
注意事項: |
---|
雖然 Globals 類別絕對不會在設計階段初始化,但是設計工具卻會建立控制項執行個體。這表示如果您建立會呼叫 Globals 類別之方法的使用者控制項,您必須撰寫程式碼,在嘗試存取方法之前,檢查該方法是否會傳回 null。 |