Metoda ControlExtensions.AddPropertyGrid — (ControlCollection, Range, String)
Dodaje nowy PropertyGrid kontroli do arkusza, w zakresie określonym.
Przestrzeń nazw: Microsoft.Office.Tools.Excel
Zestaw: Microsoft.Office.Tools.Excel.v4.0.Utilities (w Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
Składnia
'Deklaracja
<ExtensionAttribute> _
Public Shared Function AddPropertyGrid ( _
controls As ControlCollection, _
range As Range, _
name As String _
) As PropertyGrid
public static PropertyGrid AddPropertyGrid(
this ControlCollection controls,
Range range,
string name
)
Parametry
- controls
Typ: Microsoft.Office.Tools.Excel.ControlCollection
Dodaj formant do kolekcji.Nie podano tego parametru samodzielnie.Gdy wywołanie tej metody dotyczące zbierania, zwrócony przez Worksheet.Controls właściwości (w projekcie na poziomie aplikacji) lub WorksheetBase.Controls właściwości (w projekcie poziomie dokumentu), ten parametr jest dostarczane automatycznie.
- range
Typ: Microsoft.Office.Interop.Excel.Range
A Range , który pozwala granice formantu.
- name
Typ: System.String
Nazwa formantu, który może być używane do indeksowania kontroli w ControlCollection instancji.
Wartość zwracana
Typ: Microsoft.Office.Tools.Excel.Controls.PropertyGrid
Informacje dotyczące użycia
W językach Visual Basic i C# tę metodę można wywołać jako metodę wystąpienia dowolnego obiektu typu ControlCollection. Gdy w celu wywołania tej metody jest używana składnia metody wystąpienia, należy pominąć pierwszy parametr. Aby uzyskać więcej informacji, zobacz temat Metody rozszerzeń (Visual Basic) lub Metody rozszerzeń (Przewodnik programowania w języku C#).
Wyjątki
| Wyjątek | Warunek |
|---|---|
| ArgumentNullException | Argument Nazwa lub zakres jest nullodwołanie o wartości null (Nothing w języku Visual Basic), lub w argumencie Nazwa ma zerowej długości. |
| ControlNameAlreadyExistsException | Formant o tej samej nazwie jest już w ControlCollection instancji. |
| InvalidRangeException | Zakres, który został określony jest nieprawidłowy.Nie można użyć Multi-Area zakresów.Zakres powinien być w tym samym arkuszu, jako ControlCollection instancji. |
Uwagi
AddPropertyGrid Metoda umożliwia dodanie PropertyGrid obiekty do końca ControlCollection.Aby usunąć PropertyGrid formantu, który został wcześniej dodany programowo, użyj Remove metody.
Gdy zmieniany jest rozmiar zakresu automatycznie zmienia rozmiar formantu.
Przykłady
Dodaje się następujący przykład kodu PropertyGrid kontroli do komórek A1 przez C12 i Button kontroli do komórki A14.Następnie wyświetla właściwości przycisku w PropertyGrid.Aby wykorzystać ten przykład, należy uruchomić go z Sheet1 klasy w projekcie na poziomie dokumentu.
Private Sub ExcelRangeAddPropertyGrid()
Dim PropertyGrid1 As Microsoft.Office.Tools.Excel. _
Controls.PropertyGrid = Me.Controls. _
AddPropertyGrid(Me.Range("A1", "C12"), _
"PropertyGrid1")
Dim Button1 As Microsoft.Office.Tools.Excel. _
Controls.Button = Me.Controls.AddButton( _
Me.Range("A14"), "Button1")
Button1.Text = "OK"
PropertyGrid1.SelectedObject = Button1
End Sub
private void ExcelRangeAddPropertyGrid()
{
Microsoft.Office.Tools.Excel.Controls.PropertyGrid
propertyGrid1 = this.Controls.AddPropertyGrid(
this.Range["A1", "C12"], "propertyGrid1");
Microsoft.Office.Tools.Excel.Controls.Button button1 =
this.Controls.AddButton(this.Range["A14"],
"button1");
button1.Text = "OK";
propertyGrid1.SelectedObject = button1;
}
Zabezpieczenia programu .NET Framework
- Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Używanie bibliotek pochodzących z częściowo zaufanego kodu.