ControlExtensions.AddRichTextBox 方法 (ControlCollection, Range, String)

將新的 RichTextBox 控制項加入至工作表中指定的範圍。

命名空間：  Microsoft.Office.Tools.Excel
組件：  Microsoft.Office.Tools.Excel.v4.0.Utilities (在 Microsoft.Office.Tools.Excel.v4.0.Utilities.dll 中)

語法

'宣告
<ExtensionAttribute> _
Public Shared Function AddRichTextBox ( _
    controls As ControlCollection, _
    range As Range, _
    name As String _
) As RichTextBox

public static RichTextBox AddRichTextBox(
    this ControlCollection controls,
    Range range,
    string name
)

參數

• controls
  型別：Microsoft.Office.Tools.Excel.ControlCollection
  要加入控制項的集合。請勿自行提供此參數。當您在 Worksheet.Controls 屬性 (在應用程式層級的專案中) 或 WorksheetBase.Controls 屬性 (在文件層級的專案中) 所傳回的集合上呼叫這個方法時，會自動提供這個參數。

• range
  型別：Microsoft.Office.Interop.Excel.Range
  提供控制項繫結的 Range。

• name
  型別：System.String
  可於 ControlCollection 執行個體中用於索引控制項的控制項名稱。

傳回值

型別：Microsoft.Office.Tools.Excel.Controls.RichTextBox
加入 ControlCollection 執行個體的 RichTextBox 控制項中。

使用注意事項

在 Visual Basic 和 C# 中，您可以在任何 ControlCollection 型別物件中呼叫這個方法以做為執行個體。使用執行個體方法語法呼叫這個方法時，請省略第一個參數。如需詳細資訊，請參閱擴充方法 (Visual Basic)或擴充方法 (C# 程式設計手冊)。

例外狀況

備註

AddRichTextBox 方法可以用來將 RichTextBox 物件加入至 ControlCollection 的結尾。 若要移除先前以程式設計方式加入的 RichTextBox，請使用 Remove 方法。

控制項會在重新調整範圍大小時自動重新調整大小。

範例

下列程式碼範例會將 RichTextBox 控制項加入至儲存格 A1 至 B2，指派文字給控制項，然後格式化文字。 若要使用這個範例，請在文件層級專案中的 Sheet1 類別執行。

Private Sub ExcelRangeAddRichTextBox()

    Dim RichTextBox1 As Microsoft.Office.Tools. _
        Excel.Controls.RichTextBox = Me.Controls. _
        AddRichTextBox(Me.Range("A1", "B2"), _
        "RichTextBox1")

    RichTextBox1.Text = "Sample text"
    RichTextBox1.Select(0, 6)
    RichTextBox1.SelectionFont = New Font( _
        "Times New Roman", 10, FontStyle.Bold)

End Sub

private void ExcelRangeAddRichTextBox()
{

    Microsoft.Office.Tools.Excel.Controls.RichTextBox
         richTextBox1 = this.Controls.AddRichTextBox(
         this.Range["A1", "B2"], "richTextBox1");
    richTextBox1.Text = "Sample text";
    richTextBox1.Select(0, 6);
    richTextBox1.SelectionFont = new Font("Times New Roman",
        10, FontStyle.Bold);
}

.NET Framework 安全性

• 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊，請參閱從部分受信任程式碼使用程式庫。

請參閱

參考

ControlExtensions 類別

AddRichTextBox 多載

Microsoft.Office.Tools.Excel 命名空間