ToolBar.ToolBarButtonCollection.Item[] Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient ou définit une ToolBarButton valeur dans la collection.

Surcharges

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

Item[String]

Source:

ToolBar.ToolBarButtonCollection.cs

Obtient une ToolBarButton clé 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ération.

Valeur de propriété

ToolBarButton

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

Remarques

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

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

Item[Int32]

Source:

ToolBar.ToolBarButtonCollection.cs

Obtient ou définit le bouton de barre d’outils à l’emplacement 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é de la ToolBarButton collection.

Valeur de propriété

ToolBarButton

Qui ToolBarButton représente le bouton de barre d’outils à l’emplacement indexé spécifié.

Exceptions

ArgumentNullException

La index valeur est null.

ArgumentOutOfRangeException

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

- ou -

La index valeur 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 aient été créés. L’exemple obtient le nombre de boutons de la barre d’outils et remplace le dernier bouton par un bouton nouvellement 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 ToolBarButton des 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 ToolBar.ToolBarButtonCollection fichier est un index de base zéro.

Voir aussi

• Count
• ToolBarButton