ControlExtensions.AddPropertyGrid Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| AddPropertyGrid(ControlCollection, Range, String) |
Добавляет новый элемент управления PropertyGrid в указанный диапазон листа. |
| AddPropertyGrid(ControlCollection, Double, Double, Double, Double, String) |
Добавляет в заданное место листа новый элемент управления PropertyGrid указанного размера. |
AddPropertyGrid(ControlCollection, Range, String)
Добавляет новый элемент управления PropertyGrid в указанный диапазон листа.
public static Microsoft.Office.Tools.Excel.Controls.PropertyGrid AddPropertyGrid (this Microsoft.Office.Tools.Excel.ControlCollection controls, Microsoft.Office.Interop.Excel.Range range, string name);
Параметры
- controls
- ControlCollection
Коллекция, в которую добавляется элемент управления. Не предоставляйте этот параметр вручную. При вызове этого метода для коллекции, возвращаемой свойством Controls (в проекте уровня приложения) или свойством Controls (в проекте уровня документа), данный параметр предоставляется автоматически.
- name
- String
Имя элемента управления, которое можно использовать для индексации элемента управления в экземпляре ControlCollection.
Возвращаемое значение
Исключения
Аргумент имени или диапазона равен null, или аргумент имени имеет нулевую длину.
Элемент управления с таким именем уже имеется в данном экземпляре ControlCollection.
Указанный диапазон не существует. Невозможно использовать диапазоны с несколькими областями. Диапазон должен находиться на том же листе, что и экземпляр ControlCollection.
Примеры
Следующий пример кода добавляет PropertyGrid элемент управления в ячейки с a1 по C12 и Button элемент управления в ячейку A14. Затем он отображает свойства кнопки в PropertyGrid . Чтобы использовать этот пример, запустите его из Sheet1 класса в проекте уровня документа.
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;
}
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
Комментарии
AddPropertyGridМетод позволяет добавлять PropertyGrid объекты в конец ControlCollection . Чтобы удалить PropertyGrid элемент управления, который был ранее добавлен программно, используйте Remove метод.
Размер элемента управления автоматически изменяется при изменении размера диапазона.
Применяется к
AddPropertyGrid(ControlCollection, Double, Double, Double, Double, String)
Добавляет в заданное место листа новый элемент управления PropertyGrid указанного размера.
public static Microsoft.Office.Tools.Excel.Controls.PropertyGrid AddPropertyGrid (this Microsoft.Office.Tools.Excel.ControlCollection controls, double left, double top, double width, double height, string name);
Параметры
- controls
- ControlCollection
Коллекция, в которую добавляется элемент управления. Не предоставляйте этот параметр вручную. При вызове этого метода для коллекции, возвращаемой свойством Controls (в проекте уровня приложения) или свойством Controls (в проекте уровня документа), данный параметр предоставляется автоматически.
- left
- Double
Расстояние в пунктах между левым краем элемента управления и левым краем листа.
- top
- Double
Расстояние в пунктах между верхним краем элемента управления и верхним краем листа.
- width
- Double
Ширина элемента управления в пунктах.
- height
- Double
Высота элемента управления в пунктах.
- name
- String
Имя элемента управления.
Возвращаемое значение
Элемент управления PropertyGrid, добавленный в экземпляр ControlCollection.
Исключения
Аргумент имени равен null или имеет нулевую длину.
Элемент управления с таким именем уже имеется в данном экземпляре ControlCollection.
Примеры
В следующем примере кода в лист добавляется PropertyGrid элемент управления и Button элемент управления. Затем в коде отображаются свойства кнопки в PropertyGrid . Чтобы использовать этот пример, запустите его из Sheet1 класса в проекте уровня документа.
private void ExcelAddPropertyGrid()
{
Microsoft.Office.Tools.Excel.Controls.PropertyGrid
propertyGrid1 = this.Controls.AddPropertyGrid(
0, 0, 150, 150, "propertyGrid1");
Microsoft.Office.Tools.Excel.Controls.Button button1 =
this.Controls.AddButton(0, 160, 56.25, 17.25, "button1");
button1.Text = "OK";
propertyGrid1.SelectedObject = button1;
}
Private Sub ExcelAddPropertyGrid()
Dim PropertyGrid1 As Microsoft.Office.Tools. _
Excel.Controls.PropertyGrid = Me.Controls. _
AddPropertyGrid(0, 0, 150, 150, "PropertyGrid1")
Dim Button1 As Microsoft.Office.Tools.Excel. _
Controls.Button = Me.Controls.AddButton( _
0, 160, 56.25, 17.25, "Button1")
Button1.Text = "OK"
PropertyGrid1.SelectedObject = Button1
End Sub
Комментарии
AddPropertyGridМетод позволяет добавлять PropertyGrid объекты в конец ControlCollection . Чтобы удалить PropertyGrid элемент управления, который был ранее добавлен программно, используйте Remove метод.