MenuItem.Index Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft einen Wert ab, der die Position des Menüelements im übergeordneten Menü angibt, oder legt diesen fest.

public:
 property int Index { int get(); void set(int value); };

[System.ComponentModel.Browsable(false)]
public int Index { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.Index : int with get, set

Public Property Index As Integer

Eigenschaftswert

Int32

Der nullbasierte Index, der die Position des Menüelements im übergeordneten Menü darstellt.

Attribute

BrowsableAttribute

Ausnahmen

ArgumentOutOfRangeException

Der zugewiesene Wert ist kleiner als 0 (null) oder größer als die Elementanzahl.

Beispiele

Im folgenden Codebeispiel wird die Position von zwei Menüelementen in einem Menü umgestellt. Im folgenden Codebeispiel wird erforderlich, dass zwei MenuItem Objekte benannt menuItem1 und menuItem2erstellt werden. Das menuItem1 Menüelement verschiebt eine Position im Menü nach unten, während menuItem2 eine Position nach oben verschoben wird.

public:
   void SwitchMyMenuItems()
   {
      // Move menuItem1 down one position in the menu order.
      menuItem1->Index = menuItem1->Index + 1;
      // Move menuItem2 up one position in the menu order.
      menuItem2->Index = menuItem2->Index - 1;
   }

public void SwitchMyMenuItems()
{
   // Move menuItem1 down one position in the menu order.
   menuItem1.Index = menuItem1.Index + 1;
   // Move menuItem2 up one position in the menu order.
   menuItem2.Index = menuItem2.Index - 1;
}

Public Sub SwitchMyMenuItems()
    ' Move menuItem1 down one position in the menu order.
    menuItem1.Index = menuItem1.Index + 1
    ' Move menuItem2 up one position in the menu order.
    menuItem2.Index = menuItem2.Index - 1
End Sub

Hinweise

Diese Eigenschaft stellt die indizierte Position eines Menüelements in der Menüelementsammlung des übergeordneten Menüs bereit. Sie können diese Eigenschaft verwenden, um ein Menüelement an einen anderen Speicherort innerhalb des Menüs zu positionieren. Sie können diese Eigenschaft auch beim Erstellen einer MenuItem Eigenschaft verwenden, um ihre Position in einer Menüstruktur zum Zeitpunkt der Erstellung anzugeben.