共用方式為

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

  • 發行項

將新的 CheckedListBox 控制項加入至指定之大小和位置的文件中。

命名空間：  Microsoft.Office.Tools.Word
組件：  Microsoft.Office.Tools.Word.v4.0.Utilities (在 Microsoft.Office.Tools.Word.v4.0.Utilities.dll 中)

語法

'宣告
<ExtensionAttribute> _
Public Shared Function AddCheckedListBox ( _
    controls As ControlCollection, _
    range As Range, _
    width As Single, _
    height As Single, _
    name As String _
) As CheckedListBox

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

參數

  • width
    型別：System.Single
    控制項的寬度 (以點為單位)。
  • height
    型別：System.Single
    控制項的高度 (以點為單位)。

傳回值

型別：Microsoft.Office.Tools.Word.Controls.CheckedListBox
已加入至文件的控制項。

使用注意事項

在 Visual Basic 和 C# 中，您可以在任何 ControlCollection 型別物件中呼叫這個方法以做為執行個體。使用執行個體方法語法呼叫這個方法時，請省略第一個參數。如需詳細資訊，請參閱擴充方法 (Visual Basic)或擴充方法 (C# 程式設計手冊)。

例外狀況

例外狀況 條件
ArgumentNullException

name 或 range 引數是 nullnull 參考 (即 Visual Basic 中的 Nothing)，或者，name 引數的長度為 0。
ControlNameAlreadyExistsException

具有相同名稱的控制項已經存在於 ControlCollection 執行個體中。
InvalidRangeException

指定的範圍無效。

備註

這個方法可以讓您將 CheckedListBox 物件加入至 ControlCollection 的尾端。

若要移除以程式設計方式加入的 CheckedListBox，請使用 Remove 方法。

範例

下列程式碼範例加入 CheckedListBox 控制項至文件的第一個段落、加入兩個項目至核取的清單方塊，然後再選取第一個項目核取方塊。 若要使用這個範例，請在文件層級專案中的 ThisDocument 類別執行。

Private Sub WordRangeAddCheckedListBox()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim CheckedListBox1 As Microsoft.Office.Tools.Word. _
        Controls.CheckedListBox = Me.Controls.AddCheckedListBox( _
        Me.Paragraphs(1).Range, 90, 66.75F, "CheckedListBox1")
    CheckedListBox1.Items.Add("First Item")
    CheckedListBox1.Items.Add("Second Item")
    CheckedListBox1.SetItemChecked(0, True)
End Sub 

private void WordRangeAddCheckedListBox()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Controls.CheckedListBox 
        checkedListBox1 = this.Controls.AddCheckedListBox(
        this.Paragraphs[1].Range, 90, 66.75F, "checkedListBox1");
    checkedListBox1.Items.Add("First Item");
    checkedListBox1.Items.Add("Second Item");
    checkedListBox1.SetItemChecked(0, true);
}

.NET Framework 安全性

請參閱

參考

ControlExtensions 類別

AddCheckedListBox 多載

Microsoft.Office.Tools.Word 命名空間