逐步解說:使用 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 文件中。這些核取方塊將向使用者呈現文字格式化選項。

若要加入三個核取方塊

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

  2. 從 [工具箱] 的 [通用控制項] 索引標籤,將第一個 CheckBox 控制項拖曳至文件。

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

    屬性

    名稱

    applyBoldFont

    文字

    粗體

  4. 按下 Enter,將插入點移到第一個核取方塊下方。

  5. 將第二個核取方塊加入文件中 ApplyBoldFont 核取方塊下方,然後變更下列屬性。

    屬性

    名稱

    applyItalicFont

    文字

    斜體

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

  7. 將第三個核取方塊加入文件中 ApplyItalicFont 核取方塊下方,然後變更下列屬性。

    屬性

    名稱

    applyUnderlineFont

    文字

    底線

若要加入文字和書籤控制項

  1. 將插入點移到核取方塊控制項下方,並輸入下列文字:

    按一下核取方塊,變更這段文字的格式。

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

    [加入書籤控制項] 對話方塊隨即出現。

  3. 選取您加入文件的文字,然後按一下 [確定]。

    名稱為 Bookmark1Bookmark 控制項便會加入文件中的選取文字。

  4. 將 [屬性] 視窗中的 [(名稱)] 屬性值變更為 fontText**。**

接著,撰寫程式碼以便在選取或清除核取方塊時,將文字格式化。

在選取或清除核取方塊時將文字格式化

當使用者選取某一種格式選項時,變更文件中文字的格式。

若要在選取核取方塊時變更格式

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

  2. (僅限 C#) 將下列常數加入至 ThisDocument 類別 (Class)。

    const int WordTrue = -1;
    const int WordFalse = 0;
    
  3. 將下列程式碼加入至 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;
        }
    }
    
  4. 將下列程式碼加入至 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;
        }
    }
    
  5. 將下列程式碼加入至 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;
        }
    }
    
  6. 在 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);
    

測試應用程式

您現在可以測試文件,以確認當您選取或清除核取方塊時,文字會正確地格式化。

若要測試您的文件

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

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

  3. 請確認文字是否會正確地格式化。

後續步驟

這個逐步解說示範在 Word 文件上使用核取方塊以及以程式方式變更文字格式的基本概念。以下則是接下來的一些工作:

請參閱

概念

使用 Word 的逐步解說

NamedRange 控制項

Office 文件上的 Windows Form 控制項限制

其他資源

Office 程式開發範例和逐步解說