ToolBar.ToolBarButtonCollection.Item[] Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Возвращает или задает коллекцию ToolBarButton .

Перегрузки

Имя	Описание
Item[String]	Получает указанный ToolBarButton ключ из коллекции.
Item[Int32]	Возвращает или задает кнопку панели инструментов в указанном индексированного расположении в коллекции кнопок панели инструментов.

Item[String]

Исходный код:

ToolBar.ToolBarButtonCollection.cs

Получает указанный 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]

Исходный код:

ToolBar.ToolBarButtonCollection.cs

Возвращает или задает кнопку панели инструментов в указанном индексированного расположении в коллекции кнопок панели инструментов.

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