ControlExtensions.AddProgressBar Yöntem (ControlCollection, Range, String)

Makale
08/01/2011

Yeni bir ekler ProgressBar belirtilen aralık çalışma sayfası denetimi.

Ad alanı: Microsoft.Office.Tools.Excel
Derleme: Microsoft.Office.Tools.Excel.v4.0.Utilities (Microsoft.Office.Tools.Excel.v4.0.Utilities.dll içinde)

Sözdizimi

'Bildirim
<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
)

Parametreler

controls
Tür: Microsoft.Office.Tools.Excel.ControlCollection
Denetim eklemek için koleksiyon.Bu parametre kendinizin saðlamasý değil.Tarafından döndürülen koleksiyonu bu yöntem aradığınızda Worksheet.Controls (uygulama düzeyinde projedeki) özelliği veya WorksheetBase.Controls özelliği (bir belge düzeyinde projesinde), bu parametre otomatik olarak sağlanan.

range
Tür: Microsoft.Office.Interop.Excel.Range
A Range sınırları için denetim sağlar

name
Tür: System.String
Denetimde dizin oluşturmak için kullanılan denetimin adını ControlCollection örneği.

Dönüş Değeri

Tür: Microsoft.Office.Tools.Excel.Controls.ProgressBar
ProgressBar Eklenmiştir denetim ControlCollection örneği.

Kullanım Notu

Visual Basic ve C# programlarında, bu yöntemi ControlCollection türündeki herhangi bir nesne üzerinde örnek yöntemi olarak çağırabilirsiniz. Bu yöntemi çağırmak için örnek yöntemi sözdizimini kullandığınızda, ilk parametreyi yok sayın. Daha fazla bilgi için bkz. Uzantı Yöntemler (@) veya Uzantı Yöntemler (C# programlama Kılavuzu).

Özel Durumlar

Exception	Koşul
ArgumentNullException	Ad veya aralık bağımsız değişkeni nullnull başvuru (Visual Basic\'te Nothing), veya adı bağımsız değişkeni sıfır uzunluk.
ControlNameAlreadyExistsException	Aynı ada sahip bir denetim söz ControlCollection örneği.
InvalidRangeException	Belirtilen aralık geçerli değil. Multi-Area aralıkları kullanılamaz. Aralık aynı çalışma sayfasında olması ControlCollection örneği.

Açıklamalar

AddProgressBar Yöntemi sağlar ekleme ProgressBar sonuna kadar nesneleri ControlCollection. Kaldırmak için bir ProgressBar , önceden eklenmiştir programlı, kullanın Remove yöntemi.

Aralığı yeniden boyutlandırıldığında denetim otomatik olarak yeniden boyutlandırır.

Örnekler

Aşağıdaki kod örneği ekler bir ProgressBar hücreleri denetime A1 ile B1ve 50'ye denetimin geçerli konumunu artırır. Bu örneği kullanmak için çalıştırın buradan Sheet1 sınıfında bir belge düzeyinde proje.

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

.NET Framework Güvenliği

Anında arayanlar için tam güven. Bu üye kısmen güvenilen kodla kullanılamaz. Daha fazla bilgi için bkz. kısmen güvenilir kod tarafından Kitaplıklar kullanma.

Ayrıca bkz.

Başvuru

ControlExtensions Sınıf

AddProgressBar Fazla Yük

Microsoft.Office.Tools.Excel Ad Alanı

Aracılığıyla paylaş