ToolBar.ToolBarButtonCollection.Item[] 属性

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

获取或设置集合中的 ToolBarButton。

重载

Item[String]	从集合中获取具有指定键的 ToolBarButton。
Item[Int32]	获取或设置工具栏按钮集合中指定索引位置的工具栏按钮。

Item[String]

从集合中获取具有指定键的 ToolBarButton。

public:
 virtual property System::Windows::Forms::ToolBarButton ^ default[System::String ^] { System::Windows::Forms::ToolBarButton ^ get(System::String ^ key); };

public virtual System.Windows.Forms.ToolBarButton this[string key] { get; }

member this.Item(string) : System.Windows.Forms.ToolBarButton

Default Public Overridable ReadOnly Property Item(key As String) As ToolBarButton

参数

key

String

要检索的 ToolBarButton 的名称。

属性值

ToolBarButton

ToolBarButton，其 Name 属性与指定键匹配。

注解

该 Name 属性对应于中某个 ToolBarButton 项的 ToolBar.ToolBarButtonCollection键。

关键比较不区分大小写。 key如果参数为null空字符串，Item[]则null返回 。

Item[Int32]

获取或设置工具栏按钮集合中指定索引位置的工具栏按钮。

public:
 virtual property System::Windows::Forms::ToolBarButton ^ default[int] { System::Windows::Forms::ToolBarButton ^ get(int index); void set(int index, System::Windows::Forms::ToolBarButton ^ value); };

public virtual System.Windows.Forms.ToolBarButton this[int index] { get; set; }

member this.Item(int) : System.Windows.Forms.ToolBarButton with get, set

Default Public Overridable Property Item(index As Integer) As ToolBarButton

参数

index

Int32

集合中 ToolBarButton 的索引位置。

属性值

ToolBarButton

ToolBarButton，它表示指定索引位置的工具栏按钮。

例外

ArgumentNullException

index 值为 null。

ArgumentOutOfRangeException

index 值小于零。

• 或 - index 值大于集合中的按钮数，并且按钮集合不为 null。

示例

下面的代码示例替换工具栏上的最后一个工具栏按钮。 此代码要求创建至少 ToolBar 一个 ToolBarButton 代码。 该示例获取工具栏上的按钮数，并将最后一个按钮替换为新创建的按钮。 index要替换的工具栏按钮的值设置为Count属性，减一个，因为ToolBarButton集合是从零开始的索引。

void ReplaceMyToolBarButton()
{
   int btns;
   btns = toolBar1->Buttons->Count;
   ToolBarButton^ toolBarButton1 = gcnew ToolBarButton;
   toolBarButton1->Text = "myButton";
   
   // Replace the last ToolBarButton in the collection.
   toolBar1->Buttons[ btns - 1 ] = toolBarButton1;
}

public void ReplaceMyToolBarButton()
 {
    int btns;
    btns = toolBar1.Buttons.Count;
    ToolBarButton toolBarButton1 = new ToolBarButton();
    toolBarButton1.Text = "myButton";
 
    // Replace the last ToolBarButton in the collection.
    toolBar1.Buttons[btns - 1] = toolBarButton1;
 }

Public Sub ReplaceMyToolBarButton()
    Dim btns As Integer
    btns = toolBar1.Buttons.Count
    Dim toolBarButton1 As New ToolBarButton()
    toolBarButton1.Text = "myButton"
    
    ' Replace the last ToolBarButton in the collection.
    toolBar1.Buttons(btns - 1) = toolBarButton1
End Sub

注解

若要将控件分配给 ToolBarButton 特定位置，或从中 ToolBar.ToolBarButtonCollection检索控件，可以使用特定的索引值引用集合对象。 索引值为 ToolBar.ToolBarButtonCollection 从零开始的索引。

另请参阅

• Count
• ToolBarButton