ControlExtensions.AddRichTextBox – metoda (ControlCollection, Double, Double, Double, Double, String)

Článek
01/03/2014

Přidá nový RichTextBox ovládacího prvku v listu v určené velikosti a umístění.

Obor názvů: Microsoft.Office.Tools.Excel
Sestavení: Microsoft.Office.Tools.Excel.v4.0.Utilities (v Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Syntaxe

'Deklarace
<ExtensionAttribute> _
Public Shared Function AddRichTextBox ( _
    controls As ControlCollection, _
    left As Double, _
    top As Double, _
    width As Double, _
    height As Double, _
    name As String _
) As RichTextBox

public static RichTextBox AddRichTextBox(
    this ControlCollection controls,
    double left,
    double top,
    double width,
    double height,
    string name
)

Parametry

controls
Typ: Microsoft.Office.Tools.Excel.ControlCollection
Kolekce přidat ovládací prvek.Nezadávejte tento parametr sami.Při volání této metody v kolekci vrácené Worksheet.Controls vlastnosti (v projektu úroveň aplikace) nebo WorksheetBase.Controls vlastnosti (v úrovni dokumentu projektu), tento parametr je zadán automaticky.

left
Typ: System.Double
Vzdálenost mezi levým okrajem ovládacího prvku a levým okrajem listu bodů.

top
Typ: System.Double
Vzdálenost mezi horním okrajem ovládacího prvku a horním okrajem listu bodů.

width
Typ: System.Double
Šířka ovládacího prvku v bodech.

height
Typ: System.Double
Výška ovládacích bodů.

name
Typ: System.String
Název ovládacího prvku.

Vrácená hodnota

Typ: Microsoft.Office.Tools.Excel.Controls.RichTextBox
RichTextBox Ovládací prvek, který byl přidán ControlCollection instance.

Poznámka k použití

V jazycích Visual Basic a C# lze tuto metodu volat jako metodu instance libovolného objektu typu ControlCollection. Pokud k volání této metody použijete syntaxi metody instance, vynechejte první parametr. Další informace naleznete v tématech Metody rozšíření (Visual Basic) a Metody rozšíření (Průvodce programováním v C#).

Výjimky

Výjimka	Podmínka
ArgumentNullException	Argument název je nullodkaz null (Nothing v jazyce Visual Basic) nebo má nulovou délku.
ControlNameAlreadyExistsException	Ovládací prvek se stejným názvem je již ControlCollection instance.

Poznámky

AddRichTextBox Metoda umožňuje přidat RichTextBox objekty na konec ControlCollection.Odebrání RichTextBox ovládací prvek, který byl dříve přidán programově, použijte Remove metoda.

Příklady

Následující příklad kódu přidá RichTextBox řízení na začátek listu, přiřadí text ovládacího prvku a pak formáty textu.Chcete-li použít tento příklad, spusťte jej z Sheet1 třídy v projektu na úrovni dokumentu.

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);
}

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Referenční dokumentace

ControlExtensions Třída

AddRichTextBox – přetížení

Microsoft.Office.Tools.Excel – obor názvů

Sdílet prostřednictvím