MenuItem.Enabled Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

public:
 property bool Enabled { bool get(); void set(bool value); };

public bool Enabled { get; set; }

member this.Enabled : bool with get, set

Public Property Enabled As Boolean

Eigenschaftswert

Boolean

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

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie das Popup -Ereignis verwendet wird, um zu bestimmen, ob MenuItem Objekte, die Ausschneide-, Kopier- und Löschvorgänge unterstützen, aktiviert sind, bevor das Menü angezeigt wird, in dem sie angezeigt werden. Im Beispiel wird ermittelt, ob textBox1ein TextBox Steuerelement im Formular aktiviert ist, den Eingabefokus hat und Text ausgewählt ist, bevor die MenuItem Objekte aktiviert werden. In diesem Beispiel müssen drei MenuItem Objekte mit dem Namen menuCut, menuCopyund menuDelete erstellt werden.

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

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

Hinweise

Ein MenuItem deaktivierter wird in einer grauen Farbe angezeigt, um seinen Zustand anzugeben. Wenn ein übergeordnetes Menüelement deaktiviert ist, werden nicht alle Untermenüelemente angezeigt.

Gilt für:

Freigeben über