ToolBar.ToolBarButtonCollection.IndexOfKey(String) Method

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Retrieves the index of the first occurrence of a ToolBarButton with the specified key.

public:
 virtual int IndexOfKey(System::String ^ key);

public virtual int IndexOfKey (string key);

abstract member IndexOfKey : string -> int
override this.IndexOfKey : string -> int

Public Overridable Function IndexOfKey (key As String) As Integer

Parameters

key

String

The name of the ToolBarButton to search for.

Returns

Int32

The index of the first occurrence of a ToolBarButton with the specified key, if found; otherwise, -1.

Remarks

If IndexOfKey is called successively, the last returned index will be checked for a key match first, and if there is no match, the search starts at the beginning of the collection.

The Name property corresponds to the key for a ToolBarButton in the ToolBar.ToolBarButtonCollection.

The key comparison is not case-sensitive. If the key parameter is null or an empty string, Item[] returns -1.