共用方式為

逐步解說：使用 CheckBox 控制項變更檔格式設定

  • 發行項

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

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

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

  • 在設計時間將文字和控件新增至檔層級專案中的檔。

  • 選取選項時格式化文字。

    若要查看結果為已完成的範例，請參閱 Office 開發範例和逐步解說中的 Word 控件範例。

    注意

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

必要條件

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

建立專案

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

建立新專案

  1. 建立名稱 為 My Word Formatting 的 Word 檔案專案。 在精靈中，選取 [ 建立新檔]。

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

    Visual Studio 會在設計工具中開啟新的 Word 檔，並將 My Word Formatting 專案新增至 方案總管。

將文字和控件新增至 Word 檔

在本逐步解說中，將控件中的三個 Bookmark 複選框和一些文字新增至 Word 檔。 選取框會向使用者呈現格式化文字的選項。

新增三個複選框

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

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

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

    屬性 值
    名稱 applyBoldFont
    Text 粗體字

  4. 按 Enter 鍵，將插入點移到第一個複選框下方。

  5. 將第二個複選框新增至複選框下方 ApplyBoldFont 的檔，並變更下列屬性。

    屬性 值
    名稱 applyItalicFont
    Text 斜體

  6. 按 Enter 鍵，將插入點移到第二個複選框下方。

  7. 將第三個複選框新增至複選框下方 ApplyItalicFont 的檔，並變更下列屬性。

    屬性 值
    名稱 applyUnderlineFont
    Text 強調

新增文字和書簽控件

  1. 將插入點移至複選框控制下方，然後輸入下列文字：

    按兩下複選框以變更此文字的格式。

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

    [ 新增書籤控件 ] 對話框隨即出現。

  3. 選取您新增至檔的文字，然後按下 [ 確定]。

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

  4. 在 [屬性] 視窗中，將 [名稱] 屬性的值變更為 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 檔中的文字格式設定。 接著可以執行下列一些工作：

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

  • 使用選項按鈕以選取圖表樣式。

相關內容