ControlExtensions.AddProgressBar Yöntem (ControlCollection, Single, Single, Single, Single, String)
Yeni bir ekler ProgressBar denetlemek için belge içinde belirtilen boyut ve konumu.
Ad alanı: Microsoft.Office.Tools.Word
Derleme: Microsoft.Office.Tools.Word.v4.0.Utilities (Microsoft.Office.Tools.Word.v4.0.Utilities.dll içinde)
Sözdizimi
'Bildirim
<ExtensionAttribute> _
Public Shared Function AddProgressBar ( _
controls As ControlCollection, _
left As Single, _
top As Single, _
width As Single, _
height As Single, _
name As String _
) As ProgressBar
public static ProgressBar AddProgressBar(
this ControlCollection controls,
float left,
float top,
float width,
float height,
string name
)
Parametreler
- controls
Tür: Microsoft.Office.Tools.Word.ControlCollection
Denetimine eklemek için koleksiyon.Bu parametre, kendinizi sağlamaz.Tarafından döndürülen koleksiyon üzerinde bu yöntemi çağırdığınızda Document.Controls özelliği (uygulama düzeyi projesinde) veya DocumentBase.Controls özellik (bir belge düzeyi projesinde), bu parametre otomatik olarak verilir.
- left
Tür: System.Single
Nokta belgenin sol kenarında denetimin sol kenarı arasındaki uzaklık.
- top
Tür: System.Single
Nokta denetimin üst kenarı ve belgenin üst kenarı arasındaki uzaklık.
- width
Tür: System.Single
Nokta cinsinden denetimin genişliği.
- height
Tür: System.Single
Nokta cinsinden denetimin yüksekliği.
- name
Tür: System.String
Denetimde dizini oluşturmak için kullanılan adı ControlCollection örneği.
Dönüş Değeri
Tür: Microsoft.Office.Tools.Word.Controls.ProgressBar
Belgeye eklenmiş olan denetim.
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öntemleri (Visual Basic) veya Genişletme Yöntemleri (C# Programlama Kılavuzu).
Özel Durumlar
Exception | Koşul |
---|---|
ArgumentNullException | name Bağımsız değişkeni nullnull başvuru (Visual Basic'te Nothing) veya sıfır uzunlukta. |
ControlNameAlreadyExistsException | Aynı ada sahip bir denetim zaten kullanılıyor ControlCollection örneği. |
Notlar
Bu yöntem eklemenize olanak sağlayan ProgressBar nesneleri sonuna kadar ControlCollection.
Kaldırmak için bir ProgressBar programlı olarak eklenen, kullanın Remove yöntem.
Örnekler
Aşağıdaki kod örneği ekler bir ProgressBar sonra artar ve belgenin başlangıcına geçerli konumunu kontrol ProgressBar 50'ye.Bu örneği kullanmak için çalıştırın ThisDocument bir belge düzeyi projesinde sınıf.
Private Sub WordAddProgressBar()
Me.Paragraphs(1).Range.InsertParagraphBefore()
Dim ProgressBar1 As Microsoft.Office.Tools.Word.Controls _
.ProgressBar = Me.Controls.AddProgressBar(0, 0, 75, _
17.25F, "ProgressBar1")
ProgressBar1.Maximum = 100
ProgressBar1.Step = 50
ProgressBar1.PerformStep()
End Sub
private void WordAddProgressBar()
{
this.Paragraphs[1].Range.InsertParagraphBefore();
Microsoft.Office.Tools.Word.Controls.ProgressBar
progressBar1 = this.Controls.AddProgressBar(
0, 0, 75, 17.25F, "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üvenilen Koddan Kitaplıkları Kullanma.