ToolBar.ToolBarButtonCollection.Item[] Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient ou définit ToolBarButton de la collection.

Surcharges

Item[String]	Obtient ToolBarButton avec la clé spécifiée de la collection.
Item[Int32]	Obtient ou définit le bouton de barre d'outils à l'emplacement de l'index spécifié dans la collection de boutons de barre d'outils.

Item[String]

Obtient ToolBarButton avec la clé spécifiée de la collection.

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

Paramètres

key

String

Nom de la ToolBarButton à récupérer.

Valeur de propriété

ToolBarButton

ToolBarButton dont la propriété Name correspond à la clé spécifiée.

Remarques

La Name propriété correspond à la clé d’un ToolBarButton dans le ToolBar.ToolBarButtonCollection.

La comparaison de clés n’est pas sensible à la casse. Si le key paramètre est null ou une chaîne vide, Item[] retourne null.

Item[Int32]

Obtient ou définit le bouton de barre d'outils à l'emplacement de l'index spécifié dans la collection de boutons de barre d'outils.

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

Paramètres

index

Int32

Emplacement indexé du ToolBarButton dans la collection.

Valeur de propriété

ToolBarButton

ToolBarButton représentant le bouton de barre d'outils situé à l'index spécifié.

Exceptions

ArgumentNullException

index a la valeur null.

ArgumentOutOfRangeException

La valeur index est inférieure à zéro.

• ou - La valeur index est supérieure au nombre de boutons de la collection et la collection de boutons n'est pas null.

Exemples

L’exemple de code suivant remplace le dernier bouton de barre d’outils d’une barre d’outils. Ce code nécessite qu’un ToolBar et au moins un ToolBarButton ont été créés. L’exemple obtient le nombre de boutons de la barre d’outils et remplace le dernier bouton par un nouveau bouton créé. La index valeur du bouton de barre d’outils en cours de remplacement est définie sur la Count propriété, moins une, car la ToolBarButton collection est un index de base zéro.

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

Remarques

Pour affecter des ToolBarButton contrôles à un emplacement spécifique ou les récupérer à partir du ToolBar.ToolBarButtonCollection, vous pouvez référencer l’objet de collection avec une valeur d’index spécifique. La valeur d’index du fichier ToolBar.ToolBarButtonCollection est un index de base zéro.

Voir aussi

• Count
• ToolBarButton