ToolBar.ToolBarButtonCollection.Item[] Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 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
.
S’applique à
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 représentant le bouton de barre d'outils situé à l'index spécifié.
Exceptions
index
a la valeur null
.
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 pasnull
.
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.