ControlExtensions.AddProgressBar – metoda (ControlCollection, Range, String)

Článek
08/11/2011

Přidá nový ProgressBar řízení v rozsahu určeném listu.

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 AddProgressBar ( _
    controls As ControlCollection, _
    range As Range, _
    name As String _
) As ProgressBar

public static ProgressBar AddProgressBar(
    this ControlCollection controls,
    Range range,
    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.

range
Typ: Microsoft.Office.Interop.Excel.Range
A Range , který poskytuje hranice ovládacího prvku.

name
Typ: System.String
Název ovládacího prvku, který lze použít k řízení v rejstříku ControlCollection instance.

Vrácená hodnota

Typ: Microsoft.Office.Tools.Excel.Controls.ProgressBar
ProgressBar 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	Oblast nebo název argument je nullodkaz Null (Nothing v jazyce Visual Basic), nebo argument název má nulovou délku.
ControlNameAlreadyExistsException	Ovládací prvek se stejným názvem je již v ControlCollection instance.
InvalidRangeException	Určený rozsah je platný. Multi -oblast rozsahy nelze použít. Rozsah by měl být na stejném list jako ControlCollection instance.

Poznámky

AddProgressBar Metoda umožňuje přidat ProgressBar objekty na konci ControlCollection. Odebrání ProgressBar , byl již přidán programově, použijte Remove metody.

Ovládací prvek automaticky přizpůsobí velikost při změně velikosti oblasti.

Příklady

Následující příklad kódu přidá ProgressBar řízení buněk A1 prostřednictvím B1a pak zvýší aktuální pozici ovládacího prvku do 50. Chcete-li použít tento příklad spustit z Sheet1 třídy v projektu úrovni dokumentu.

    Private Sub ExcelRangeAddProgressBar()

        Dim ProgressBar1 As Microsoft.Office.Tools. _
            Excel.Controls.ProgressBar = Me.Controls. _
            AddProgressBar(Me.Range("A1", "B1"), _
            "ProgressBar1")

        ProgressBar1.Maximum = 100
        ProgressBar1.Step = 50
        ProgressBar1.PerformStep()

    End Sub

private void ExcelRangeAddProgressBar()
{

    Microsoft.Office.Tools.Excel.Controls.ProgressBar
         progressBar1 = this.Controls.AddProgressBar(
         this.Range["A1", "B1"], "progressBar1");
    progressBar1.Maximum = 100;
    progressBar1.Step = 50;
    progressBar1.PerformStep();
}

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

AddProgressBar – přetížení

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

Sdílet prostřednictvím