MenuItem.Enabled Propriedade

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém ou define um valor que indica se o item de menu está habilitado.

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

Valor da propriedade

Boolean

true se o item de menu estiver habilitado; caso contrário, false. O padrão é true.

Exemplos

O exemplo de código a seguir demonstra como usar o Popup evento para determinar se MenuItem os objetos que dão suporte para operações de recortar, copiar e excluir são habilitados antes que o menu em que são exibidos seja mostrado. O exemplo determina se textBox1, um TextBox controle no formulário, está habilitado, tem foco de entrada e tem texto selecionado antes de habilitar os MenuItem objetos. Este exemplo requer que três MenuItem objetos sejam criados chamados menuCut, menuCopye menuDelete tenham sido criados.

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 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

Comentários

Um MenuItem que está desabilitado é exibido em uma cor cinza para indicar seu estado. Quando um item de menu pai é desabilitado, todos os itens de submenu não são exibidos.

Aplica-se a

Partilhar via