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