逐步解說：使用 CheckBox 控制項變更文件格式

本逐步解說示範如何在 Microsoft Office Word 的文件層級自訂中使用 Windows Forms 控制項來變更文字格式。

適用於： 本主題中的資訊適用於 Word 的文件層級專案。 如需詳細資訊，請參閱 Office 應用程式和專案類型所提供的功能。

本逐步解說將說明下列工作：

• 在設計階段，將文字和控制項新增至文件層級專案的文件中。

• 選取選項時設定文字格式。

  若要將結果視為已完成的範例，請參閱 Office 開發範例和逐步解說中的 Word 控制項範例。

  備註

  在下列指示的某些 Visual Studio 使用者介面項目中，您的電腦可能會顯示不同的名稱或位置： 您所擁有的 Visual Studio 版本以及使用的設定會決定這些項目。 如需詳細資訊，請參閱 個人化 IDE。

先決條件

您需要下列組件才能完成本步驟解說：

• 包含 Microsoft Office 開發人員工具的 Visual Studio 版本。 如需詳細資訊，請參閱 設定電腦以開發 Office 解決方案。

• Word 2013 或 Word 2010 。

建立專案

第一步是建立一個 Word 文件專案。

建立新專案

1. 建立名為 「我的 Word 格式」的 Word 文件專案。 在精靈中，選取 [建立新文件]。

   如需詳細資訊，請參閱 如何：在 Visual Studio 中建立 Office 專案。

   Visual Studio 會在設計工具中開啟新的 Word 檔，並將 [我的 Word 格式設定 ] 專案新增至 [方案總管]。

將文字和控制項新增至 Word 文件

在本逐步解說中，將控制項中的 Bookmark 三個核取方塊和一些文字新增至 Word 文件。 核取方塊會向使用者顯示格式化文字的選項。

新增三個核取方塊

1. 確認檔已在 Visual Studio 設計工具中開啟。

2. 從「工具箱」的「通用控制項」索引標籤中，將第一個CheckBox控制項拖曳至文件。

3. 在 [屬性] 視窗中，變更下列屬性。

   房產	價值觀
   名稱	應用粗體字體
   文字	大膽

4. 按 Enter 鍵將插入點移至第一個勾選框下方。

5. 在核取方塊下方 ApplyBoldFont 的文檔中新增第二個核取方塊，並變更以下屬性。

   房產	價值觀
   名稱	applyItalicFont
   文字	斜體

6. 按 Enter 鍵將插入點移至第二個核取方塊下方。

7. 在核取方塊下方 ApplyItalicFont 的文檔中新增第三個核取方塊，並變更以下屬性。

   房產	價值觀
   名稱	套用底線字型
   文字	底線

新增文字和書籤控制項

1. 將插入點移至核取方塊控制項下方，然後輸入下列文字：

   按一下核取方塊以變更此文字的格式。

2. 從 [工具箱] 的 [Word 控制項] 索引標籤中，將Bookmark控制項拖曳至文件。

   新增 書籤控制項 對話方塊隨即出現。

3. 選取您新增至文件的文字，然後按一下 「確定」。

   Bookmark名為 Bookmark1 的控制項會新增至文件中選取的文字。

4. 在 [屬性] 視窗中，將 （Name） 屬性的值變更為 fontText。

   接下來，編寫程式碼以在勾選或清除核取方塊時格式化文字。

當核取方塊被核取或清除時，格式化文字

當使用者選取格式選項時，請變更文件中文字的格式。

選取核取方塊時變更格式

1. 以滑鼠右鍵按一下 ThisDocument[方案總管]，然後按一下捷徑功能表上的 [ 檢視程式碼 ]。

2. 僅針對 C#，請將下列常數新增至 ThisDocument 類別。

   const int WordTrue = -1;
   const int WordFalse = 0;
   

3. 將下列程式碼新增至 Click 核取方塊的 applyBoldFont 事件處理常式。

   • C#
   • VB

   private void applyBoldFont_Click(object sender, System.EventArgs e)
   {
       if (this.applyBoldFont.Checked == true)
       {
           this.fontText.Bold = WordTrue;
       }
       else
       {
           this.fontText.Bold = WordFalse;
       }
   }
   

4. 將下列程式碼新增至 Click 核取方塊的 applyItalicFont 事件處理常式。

   • C#
   • VB

   private void applyItalicFont_Click(object sender, System.EventArgs e)
   {
       if (this.applyItalicFont.Checked == true)
       {
           this.fontText.Italic = WordTrue;
       }
       else
       {
           this.fontText.Italic = WordFalse;
       }
   }
   

5. 將下列程式碼新增至 Click 核取方塊的 applyUnderlineFont 事件處理常式。

   • C#
   • VB

   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;
       }
   }
   

6. 在 C# 中，您必須將文字方塊 Startup 的事件處理常式新增至事件。 如需如何建立事件處理常式的相關資訊，請參閱 如何：在 Office 專案中建立事件處理常式。

   this.applyBoldFont.Click += new EventHandler(applyBoldFont_Click);
   this.applyItalicFont.Click += new EventHandler(applyItalicFont_Click);
   this.applyUnderlineFont.Click += new EventHandler(applyUnderlineFont_Click);
   

測試應用程式

您現在可以測試文件，以驗證在選取或清除核取方塊時文字的格式是否正確。

測試您的文件

1. 請按 F5 執行您的專案。

2. 選取或清除核取方塊。

3. 確認文字格式正確。

後續步驟

本逐步解說示範使用核取方塊，以及以程式設計方式變更 Word 文件上的文字格式設定的基本概念。 以下是接下來可能出現的一些任務：

• 使用按鈕填入文字方塊。 如需詳細資訊，請參閱 逐步解說：使用按鈕在文件的文字方塊中顯示文字。

• 使用單選按鈕來選擇圖表樣式。

相關內容

• 使用 Word 的逐步解說
• Office 開發範例和逐步解說
• NamedRange 控制項
• Office 文件上 Windows Forms 控制項的限制