ControlExtensions.AddCheckedListBox 方法 (ControlCollection, Range, String)

在工作表中的指定范围添加一个新的 CheckedListBox 控件。

命名空间：  Microsoft.Office.Tools.Excel
程序集：  Microsoft.Office.Tools.Excel.v4.0.Utilities（在 Microsoft.Office.Tools.Excel.v4.0.Utilities.dll 中）

语法

声明
<ExtensionAttribute> _
Public Shared Function AddCheckedListBox ( _
    controls As ControlCollection, _
    range As Range, _
    name As String _
) As CheckedListBox

public static CheckedListBox AddCheckedListBox(
    this ControlCollection controls,
    Range range,
    string name
)

参数

• controls
  类型：Microsoft.Office.Tools.Excel.ControlCollection
  要添加控件的集合。不需要您自己提供此参数。对 Worksheet.Controls 属性（在应用程序级项目中）或 WorksheetBase.Controls 属性（在文档级项目中）返回的集合调用此方法时，将自动提供此参数。

• range
  类型：Microsoft.Office.Interop.Excel.Range
  提供控件的边界的 Range。

• name
  类型：System.String
  可用于索引 ControlCollection 实例中控件的控件名称。

返回值

类型：Microsoft.Office.Tools.Excel.Controls.CheckedListBox
添加到 ControlCollection 实例的 CheckedListBox 控件。

使用说明

在 Visual Basic 和 C# 中，可以在 ControlCollection 类型的任何对象上将此方法作为实例方法来调用。当使用实例方法语法调用此方法时，请省略第一个参数。有关更多信息，请参见扩展方法 (Visual Basic)或扩展方法（C# 编程指南）。

异常

备注

使用 AddCheckedListBox 方法可以将 CheckedListBox 对象添加到 ControlCollection 的末尾。 若要移除以前以编程方式添加的 CheckedListBox，请使用 Remove 方法。

在调整范围的大小时，控件会自动调整其自身的大小。

示例

下面的代码示例将一个 CheckedListBox 控件添加到单元格**“A1”至“B5”**，向该复选列表框添加两个项，然后选择“First Item”复选框。 若要使用此示例，请从文档级项目内的 Sheet1 类中运行此示例。

    Private Sub ExcelRangeAddCheckedListBox()

        Dim CheckedListBox1 As Microsoft.Office.Tools. _
            Excel.Controls.CheckedListBox = Me.Controls. _
            AddCheckedListBox(Me.Range("A1", "B5"), _
            "CheckedListBox1")
        CheckedListBox1.Items.Add("First Item")
        CheckedListBox1.Items.Add("Second Item")
        CheckedListBox1.SetItemChecked(0, True)

    End Sub

private void ExcelRangeAddCheckedListBox()
{

    Microsoft.Office.Tools.Excel.Controls.CheckedListBox
        checkedListBox1 = this.Controls.AddCheckedListBox(
        this.Range["A1", "B5"], "checkedListBox1");
    checkedListBox1.Items.Add("First Item");
    checkedListBox1.Items.Add("Second Item");
    checkedListBox1.SetItemChecked(0, true);
}

.NET Framework 安全性

• 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息，请参见通过部分受信任的代码使用库。

请参见

参考

ControlExtensions 类

AddCheckedListBox 重载

Microsoft.Office.Tools.Excel 命名空间