ControlCollection.AddPropertyGrid 方法 (Range, String) (2007 system)
更新:2007 年 11 月
在工作表中的指定范围添加一个新的 PropertyGrid 控件。
命名空间: Microsoft.Office.Tools.Excel
程序集: Microsoft.Office.Tools.Excel.v9.0(在 Microsoft.Office.Tools.Excel.v9.0.dll 中)
语法
声明
Public Function AddPropertyGrid ( _
range As Range, _
name As String _
) As PropertyGrid
用法
Dim instance As ControlCollection
Dim range As Range
Dim name As String
Dim returnValue As PropertyGrid
returnValue = instance.AddPropertyGrid(range, _
name)
public PropertyGrid AddPropertyGrid(
Range range,
string name
)
参数
range
类型:Microsoft.Office.Interop.Excel.Range提供控件的边界的 Range。
name
类型:System.String可用于索引 ControlCollection 实例中控件的控件名称。
返回值
类型:Microsoft.Office.Tools.Excel.Controls.PropertyGrid
异常
异常 | 条件 |
---|---|
ArgumentNullException | 名称参数或范围参数为 nullnull 引用(在 Visual Basic 中为 Nothing),或者名称参数长度为零。 |
ControlNameAlreadyExistsException | ControlCollection 实例中已存在一个同名控件。 |
InvalidRangeException | 指定的范围无效。不能使用多区域范围。该范围应与 ControlCollection 实例同在一个工作表中。 |
备注
使用 AddPropertyGrid 方法可以将 PropertyGrid 对象添加到 ControlCollection 的末尾。若要移除以前以编程方式添加的 PropertyGrid 控件,请使用 Remove() 方法。
在调整范围的大小时,控件会自动调整其自身的大小。
示例
下面的代码示例将一个 PropertyGrid 控件添加到单元格“A1”至“C12”,并将一个 Button 控件添加到单元格“A14”。然后在 PropertyGrid 中显示该按钮的属性。
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", missing],
"button1");
button1.Text = "OK";
propertyGrid1.SelectedObject = button1;
}
权限
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。