Share via

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

  • 發行項

更新：2007 年 11 月

適用於

本主題中的資訊僅適用於指定的 Visual Studio Tools for Office 專案和 Microsoft Office 版本。

專案類型

  • 文件層級專案

Microsoft Office 版本

  • Word 2007

  • Word 2003

如需詳細資訊，請參閱依應用程式和專案類型提供的功能。

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

這個逐步解說將說明下列工作：

  • 在設計階段，透過文件層級專案將文字和控制項加入至文件。

  • 當選項被選取時將文字格式化

若要查看完成範例的結果，請參閱 Word 控制項的範例。

注意事項：

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

必要條件

您需要下列元件才能完成此逐步解說：

  • Visual Studio Tools for Office (Visual Studio 2008 Professional 和 Visual Studio Team System 的選擇性元件)。

  • Microsoft Office Word 2003 或 Microsoft Office Word 2007。

Visual Studio Tools for Office 預設會與列出的 Visual Studio 版本一起安裝。若要查看是否已安裝，請參閱 安裝 Visual Studio Tools for Office。

建立專案

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

若要建立新的專案

  • 建立名稱為 My Word Formatting 的 Word 文件專案。選取精靈中的 [建立新文件]。

    如需詳細資訊，請參閱 HOW TO：建立 Visual Studio Tools for Office 專案。

    Visual Studio 會在設計工具中開啟新的 Word 文件，並將 My Word Formatting 專案加入至 [方案總管]。

將文字和控制項加入至 Word 文件

在這個逐步解說中，會將 Bookmark 控制項中的三個核取方塊和一些文字加入至 Word 文件中。這些核取方塊將向使用者呈現文字格式化選項。

若要加入三個核取方塊

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

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

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

    屬性

    值

    Name

    applyBoldFont

    Text

    Bold

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

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

    屬性

    值

    Name

    applyItalicFont

    Text

    Italic

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

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

    屬性

    值

    Name

    applyUnderlineFont

    Text

    Underline

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

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

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

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

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

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

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

  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：在 Visual Studio Tools for 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 程式開發範例和逐步解說