共用方式為


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

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

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

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

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

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

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

    備註

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

先決條件

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

建立專案

第一步是建立一個 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 事件處理常式。

    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 事件處理常式。

    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 事件處理常式。

    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 文件上的文字格式設定的基本概念。 以下是接下來可能出現的一些任務: