MenuItem.Enabled-Eigenschaft

Ruft einen Wert ab, der angibt, ob das Menüelement aktiviert ist, oder legt diesen fest.

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

Syntax

'Declaration
<LocalizableAttribute(True)> _
Public Property Enabled As Boolean
'Usage
Dim instance As MenuItem
Dim value As Boolean

value = instance.Enabled

instance.Enabled = value

[LocalizableAttribute(true)] 
public bool Enabled { get; set; }

[LocalizableAttribute(true)] 
public:
property bool Enabled {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_Enabled ()

/** @property */
public void set_Enabled (boolean value)

public function get Enabled () : boolean

public function set Enabled (value : boolean)

Eigenschaftenwert

true, wenn das Menüelement aktiviert ist, andernfalls false. Der Standardwert ist true.

Hinweise

Ein deaktiviertes MenuItem wird zur Angabe seines Zustands in einem Grauton angezeigt. Wenn ein übergeordnetes Menüelement deaktiviert ist, werden keine Untermenüelemente angezeigt.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie mit dem Popup-Ereignis bestimmt wird, ob MenuItem-Objekte, die Unterstützung für Ausschneide-, Kopier- und Löschvorgänge bereitstellen, vor dem Anzeigen des Menüs aktiviert sind, in dem sie angezeigt werden. Im Beispiel wird bestimmt, ob textBox1, ein TextBox-Steuerelement im Formular, aktiviert ist, den Eingabefokus besitzt und ob darin Text ausgewählt ist, bevor die MenuItem-Objekte aktiviert werden. Bei diesem Beispiel ist es erforderlich, dass zuvor drei MenuItem-Objekte mit den Namen menuCut, menuCopy und menuDelete erstellt wurden.

Private Sub PopupMyMenu(ByVal sender As Object, ByVal e As System.EventArgs) Handles menuEdit.Popup
   If textBox1.Enabled = False OrElse textBox1.Focused = False OrElse textBox1.SelectedText.Length = 0 Then
      menuCut.Enabled = False
      menuCopy.Enabled = False
      menuDelete.Enabled = False
   Else
      menuCut.Enabled = True
      menuCopy.Enabled = True
      menuDelete.Enabled = True
   End If
End Sub

private void PopupMyMenu(object sender, System.EventArgs e)
{
   if (textBox1.Enabled == false || textBox1.Focused == false ||
      textBox1.SelectedText.Length == 0)
   {
      menuCut.Enabled = false;
      menuCopy.Enabled = false;
      menuDelete.Enabled = false;
   }
   else
   {
      menuCut.Enabled = true;
      menuCopy.Enabled = true;
      menuDelete.Enabled = true;
   }
}

private:
   void PopupMyMenu( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      if ( textBox1->Enabled == false || textBox1->Focused == false || textBox1->SelectedText->Length == 0 )
      {
         menuCut->Enabled = false;
         menuCopy->Enabled = false;
         menuDelete->Enabled = false;
      }
      else
      {
         menuCut->Enabled = true;
         menuCopy->Enabled = true;
         menuDelete->Enabled = true;
      }
   }

private void PopupMyMenu(Object sender, System.EventArgs e)
{
    if (textBox1.get_Enabled() == false || textBox1.get_Focused() == false 
        || textBox1.get_SelectedText().get_Length() == 0) {
        menuCut.set_Enabled(false);
        menuCopy.set_Enabled(false);
        menuDelete.set_Enabled(false);
    }
    else {
        menuCut.set_Enabled(true);
        menuCopy.set_Enabled(true);
        menuDelete.set_Enabled(true);
    }
} //PopupMyMenu

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

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

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