逐步解說:使用 CheckBox 控制項來變更文件格式
本逐步解說將示範如何透過 Microsoft Office Word 的文件層級自訂,使用 Windows Form 控制項來變更文字格式。
**適用於:**本主題中的資訊適用於 Word 2013 和 Word 2010 的文件層級專案。如需詳細資訊,請參閱依 Office 應用程式和專案類型提供的功能。
這個逐步解說將說明下列工作:
在設計階段,透過文件層級專案將文字和控制項加入至文件。
當選項被選取時將文字格式化
若要查看完成範例的結果,請參閱 Office 程式開發範例和逐步解說中的<Word 控制項範例>。
注意事項 |
---|
您的電腦可能會在下列說明中,以不同名稱或位置顯示某些 Visual Studio 使用者介面項目。您所擁有的 Visual Studio 版本以及使用的設定會決定這些項目。如需詳細資訊,請參閱 Visual Studio 設定。 |
必要條件
您需要下列元件才能完成此逐步解說:
-
包含 Microsoft Office Developer 工具的 Visual Studio 2012 版本。如需詳細資訊,請參閱[設定電腦以開發 Office 方案](bb398242\(v=vs.110\).md)。
- Word 2013 或 Word 2010。
建立專案
第一步就是建立 Word 文件專案。
若要建立新的專案
建立名稱為 My Word Formatting 的 Word 文件專案。在精靈中選取 [建立新文件]。
如需詳細資訊,請參閱HOW TO:在 Visual Studio 中建立 Office 專案。
Visual Studio 會在設計工具中開啟新的 Word 文件,並將 My Word Formatting 專案加入至 [方案總管]。
將文字和控制項加入至 Word 文件
在這個逐步解說中,會將 Bookmark 控制項中的三個核取方塊和一些文字加入至 Word 文件中。這些核取方塊將向使用者呈現文字格式化選項。
若要加入三個核取方塊
確認已在 Visual Studio 設計工具中開啟文件。
從 [工具箱] 的 [通用控制項] 索引標籤,將第一個 CheckBox 控制項拖曳至文件。
在 [屬性] 視窗中變更下列屬性。
屬性
值
名稱
applyBoldFont
文字
粗體
按下 Enter,將插入點移到第一個核取方塊下方。
將第二個核取方塊加入文件中 ApplyBoldFont 核取方塊下方,然後變更下列屬性。
屬性
值
名稱
applyItalicFont
文字
斜體
按下 Enter,將插入點移到第二個核取方塊下方。
將第三個核取方塊加入文件中 ApplyItalicFont 核取方塊下方,然後變更下列屬性。
屬性
值
名稱
applyUnderlineFont
文字
底線
若要加入文字和書籤控制項
將插入點移到核取方塊控制項下方,並輸入下列文字:
按一下核取方塊,變更這段文字的格式。
從 [工具箱] 的 [Word 控制項] 索引標籤,將 Bookmark 控制項拖曳至文件中。
[加入書籤控制項] 對話方塊隨即出現。
選取您加入文件的文字,然後按一下 [確定]。
名稱為 Bookmark1 的 Bookmark 控制項便會加入文件中的選取文字。
將 [屬性] 視窗中的 [(名稱)] 屬性值變更為 fontText**。**
接著,撰寫程式碼以便在選取或清除核取方塊時,將文字格式化。
在選取或清除核取方塊時將文字格式化
當使用者選取某一種格式選項時,變更文件中文字的格式。
若要在選取核取方塊時變更格式
在 [方案總管] 中的 ThisDocument 上按一下滑鼠右鍵,然後按一下捷徑功能表上的 [檢視程式碼]。
(僅限 C#) 將下列常數加入至 ThisDocument 類別 (Class)。
const int WordTrue = -1; const int WordFalse = 0;
將下列程式碼加入至 applyBoldFont 核取方塊的 Click 事件處理常式。
Private Sub applyBoldFont_Click(ByVal sender As Object, ByVal e As System.EventArgs) _ Handles applyBoldFont.Click Me.fontText.Bold = Me.applyBoldFont.Checked End Sub
private void applyBoldFont_Click(object sender, System.EventArgs e) { if (this.applyBoldFont.Checked == true) { this.fontText.Bold = WordTrue; } else { this.fontText.Bold = WordFalse; } }
將下列程式碼加入至 applyItalicFont 核取方塊的 Click 事件處理常式。
Private Sub applyItalicFont_Click(ByVal sender As Object, ByVal e As System.EventArgs) _ Handles applyItalicFont.Click Me.fontText.Italic = Me.applyItalicFont.Checked End Sub
private void applyItalicFont_Click(object sender, System.EventArgs e) { if (this.applyItalicFont.Checked == true) { this.fontText.Italic = WordTrue; } else { this.fontText.Italic = WordFalse; } }
將下列程式碼加入至 applyUnderlineFont 核取方塊的 Click 事件處理常式。
Private Sub applyUnderlineFont_Click(ByVal sender As Object, ByVal e As System.EventArgs) _ Handles applyUnderlineFont.Click If Me.applyUnderlineFont.Checked Then Me.fontText.Underline = Word.WdUnderline.wdUnderlineSingle Else Me.fontText.Underline = Word.WdUnderline.wdUnderlineNone End If End Sub
private void applyUnderlineFont_Click(object sender, System.EventArgs e) { if (this.applyUnderlineFont.Checked == true) { this.fontText.Underline = Word.WdUnderline.wdUnderlineSingle; } else { this.fontText.Underline = Word.WdUnderline.wdUnderlineNone; } }
在 C# 中,您必須將文字方塊的事件處理常式加入至 Startup 事件。如需如何建立事件處理常式的詳細資訊,請參閱 HOW TO:在 Office 專案中建立事件處理常式。
this.applyBoldFont.Click += new EventHandler(applyBoldFont_Click); this.applyItalicFont.Click += new EventHandler(applyItalicFont_Click); this.applyUnderlineFont.Click += new EventHandler(applyUnderlineFont_Click);
測試應用程式
您現在可以測試文件,以確認當您選取或清除核取方塊時,文字會正確地格式化。
若要測試您的文件
請按 F5 執行您的專案。
選取或清除核取方塊。
請確認文字是否會正確地格式化。
後續步驟
這個逐步解說示範在 Word 文件上使用核取方塊以及以程式方式變更文字格式的基本概念。以下則是接下來的一些工作:
使用按鈕填入 (Populate) 文字方塊。如需詳細資訊,請參閱逐步解說:使用按鈕在文件的文字方塊中顯示文字。
使用選項按鈕選取圖表樣式。如需詳細資訊,請參閱逐步解說:使用選項按鈕更新文件中的圖表。
請參閱
概念
Office 文件上的 Windows Form 控制項限制