MenuItem.Index-Eigenschaft

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

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Property Index As Integer
'Usage
Dim instance As MenuItem
Dim value As Integer

value = instance.Index

instance.Index = value

public int Index { get; set; }

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

/** @property */
public int get_Index ()

/** @property */
public void set_Index (int value)

public function get Index () : int

public function set Index (value : int)

Eigenschaftenwert

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

Ausnahmen

Hinweise

Diese Eigenschaft stellt die indizierte Position eines Menüelements in der Auflistung der Menüelemente des übergeordneten Menüs bereit. Mithilfe dieser Eigenschaft können Sie ein Menüelement an einem anderen Ort in diesem Menü neu positionieren. Auch beim Erstellen eines MenuItem können Sie mit dieser Eigenschaft dessen Position in einer Menüstruktur während der Erstellung angeben.

Beispiel

Im folgenden Codebeispiel wird die Position zweier Menüelemente in einem Menü getauscht. Für das folgende Codebeispiel müssen zwei MenuItem-Objekte mit den Namen menuItem1 und menuItem2 erstellt werden. Das Menüelement menuItem1 wird im Menü um eine Position nach unten verschoben, während menuItem2 um eine Position nach oben verschoben wird.

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

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 void SwitchMyMenuItems()
{
    // Move menuItem1 down one position in the menu order.
    menuItem1.set_Index(menuItem1.get_Index() + 1);
    // Move menuItem2 up one position in the menu order.
    menuItem2.set_Index(menuItem2.get_Index() - 1);
} //SwitchMyMenuItems

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

MenuItem-Klasse
MenuItem-Member
System.Windows.Forms-Namespace