ToolBar.ToolBarButtonCollection.Item[] Proprietà

Definizione

Ottiene o imposta un oggetto ToolBarButton nell'insieme.Gets or sets a ToolBarButton within the collection.

Overload

Item[String]

Ottiene un oggetto ToolBarButton con la chiave specificata dall'insieme.Gets a ToolBarButton with the specified key from the collection.

Item[Int32]

Ottiene o imposta il pulsante della barra degli strumenti in corrispondenza della posizione dell'indice specificata nell'insieme di pulsanti della barra degli strumenti.Gets or sets the toolbar button at the specified indexed location in the toolbar button collection.

Item[String]

Ottiene un oggetto ToolBarButton con la chiave specificata dall'insieme.Gets a ToolBarButton with the specified key from the 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

Parametri

key
String

Nome dell'oggetto ToolBarButton da recuperare.The name of the ToolBarButton to retrieve.

Valore della proprietà

ToolBarButton

Oggetto ToolBarButton la cui proprietà Name corrisponde alla chiave specificata.The ToolBarButton whose Name property matches the specified key.

Commenti

La Name proprietà corrisponde alla chiave per un oggetto ToolBarButton in ToolBar.ToolBarButtonCollection .The Name property corresponds to the key for a ToolBarButton in the ToolBar.ToolBarButtonCollection.

Il confronto delle chiavi non fa distinzione tra maiuscole e minuscole.The key comparison is not case-sensitive. Se il key parametro è null o una stringa vuota, Item[] restituisce null .If the key parameter is null or an empty string, Item[] returns null.

Si applica a

Item[Int32]

Ottiene o imposta il pulsante della barra degli strumenti in corrispondenza della posizione dell'indice specificata nell'insieme di pulsanti della barra degli strumenti.Gets or sets the toolbar button at the specified indexed location in the toolbar button collection.

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

Parametri

index
Int32

La posizione indicizzata dell'oggetto ToolBarButton nell'insieme.The indexed location of the ToolBarButton in the collection.

Valore della proprietà

ToolBarButton

Controllo ToolBarButton che rappresenta il pulsante della barra degli strumenti in corrispondenza della posizione dell'indice specificata.A ToolBarButton that represents the toolbar button at the specified indexed location.

Eccezioni

Il valore index è null.The index value is null.

Il valore index è minore di zero.The index value is less than zero.

-oppure--or- Il valore indexè maggiore del numero di pulsanti nell'insieme e l'insieme dei pulsanti non è null.The index value is greater than the number of buttons in the collection, and the collection of buttons is not null.

Esempio

Nell'esempio di codice seguente viene sostituito l'ultimo pulsante della barra degli strumenti su una barra degli strumenti.The following code example replaces the last toolbar button on a toolbar. Per questo codice è necessario che sia ToolBar stato creato un e almeno uno ToolBarButton .This code requires that a ToolBar and at least one ToolBarButton have been created. Nell'esempio viene ottenuto il numero di pulsanti sulla barra degli strumenti e viene sostituito l'ultimo pulsante con quello appena creato.The example gets the number of buttons on the toolbar and replaces the last button with a newly created one. Il index valore del pulsante della barra degli strumenti sostituito viene impostato sulla Count proprietà, meno uno, perché la ToolBarButton raccolta è un indice in base zero.The index value of the toolbar button being replaced is set to the Count property, minus one, since the ToolBarButton collection is a zero-based index.

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

Commenti

Per assegnare ToolBarButton controlli a un percorso specifico o per recuperarli da ToolBar.ToolBarButtonCollection , è possibile fare riferimento all'oggetto raccolta con un valore di indice specifico.To assign ToolBarButton controls to a specific location, or to retrieve them from the ToolBar.ToolBarButtonCollection, you can reference the collection object with a specific index value. Il valore di indice di ToolBar.ToolBarButtonCollection è un indice in base zero.The index value of the ToolBar.ToolBarButtonCollection is a zero-based index.

Vedi anche

Si applica a