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

Článek
08/11/2011

Přidá nový LinkLabel ovládacího prvku v listu v zadané 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 AddLinkLabel ( _
    controls As ControlCollection, _
    left As Double, _
    top As Double, _
    width As Double, _
    height As Double, _
    name As String _
) As LinkLabel

public static LinkLabel AddLinkLabel(
    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 ve vrácené kolekci Worksheet.Controls Vlastnosti (v úrovni aplikace project) nebo WorksheetBase.Controls Vlastnosti (v úrovni dokumentu projektu) je tento parametr zadán automaticky.

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

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

width
Typ: System.Double
Šířka ovládacích bodů.

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.LinkLabel
LinkLabel 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 Extension Methods (Visual Basic) a Extension Methods (C# Programming Guide).

Výjimky

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

Poznámky

AddLinkLabel Metoda umožňuje přidat LinkLabel objekty na konci ControlCollection. Odebrání LinkLabel , které dříve přidali programově, použijte Remove metody.

Příklady

Následující příklad kódu přidá LinkLabel řízení na začátek lista potom změny textu na první Název. Kód poté změní barvu odkazu na modrou a nastaví LinkBehavior k HoverUnderline. Chcete-li použít tento příklad spustit z Sheet1 třídy v projektu úrovni dokumentu.

    Private Sub ExcelRangeAddListBox()

        Dim ListBox1 As Microsoft.Office.Tools.Excel. _
            Controls.ListBox = Me.Controls.AddListBox( _
            Me.Range("A1", "B6"), "ListBox1")

        ListBox1.Items.Add("First Item")
        ListBox1.Items.Add("Second Item")
        ListBox1.SelectedIndex = 0

    End Sub

private void ExcelRangeAddListBox()
{

    Microsoft.Office.Tools.Excel.Controls.ListBox
         listBox1 = this.Controls.AddListBox(
         this.Range["A1", "B6"], "lisBox1");
    listBox1.Items.Add("First Item");
    listBox1.Items.Add("Second Item");
    listBox1.SelectedIndex = 0;
}

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é

Odkaz

ControlExtensions Třída

AddLinkLabel – přetížení

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

Sdílet prostřednictvím