MenuItem.Checked Propiedad

Definición

Obtiene o establece un valor que indica si se va a mostrar una marca de verificación junto al texto del elemento de menú.Gets or sets a value indicating whether a check mark appears next to the text of the menu item.

public:
 property bool Checked { bool get(); void set(bool value); };
public bool Checked { get; set; }
member this.Checked : bool with get, set
Public Property Checked As Boolean

Valor de propiedad

Es true si hay una marca de verificación junto al elemento de menú; de lo contrario, es false.true if there is a check mark next to the menu item; otherwise, false. De manera predeterminada, es false.The default is false.

Excepciones

MenuItem es un menú de nivel superior o tiene elementos secundarios.The MenuItem is a top-level menu or has children.

Ejemplos

En el ejemplo de código siguiente Checked se usa la propiedad para proporcionar el estado en una aplicación.The following code example uses the Checked property to provide the state in an application. En este ejemplo, se usa un grupo de elementos de menú para especificar el color del texto de un TextBox control.In this example, a group of menu items are used to specify the color for the text in a TextBox control. El Click evento de tres elementos de menú utiliza el controlador de eventos proporcionado.The event handler provided is used by the Click event of three menu items. Cada elemento de menú especifica un color de menuItemRed texto, (rojo menuItemGreen ), (verde) menuItemBlue o (azul).Each menu item specifies a text color, menuItemRed (Red), menuItemGreen (Green), or menuItemBlue (Blue). El controlador de eventos determina el elemento de menú en el que se hizo clic, coloca una marca de verificación en el elemento de menú seleccionado y cambia TextBox el color del texto del control del formulario.The event handler determines which menu item was clicked, places a checkmark to the selected menu item, and changes the text color of the form's TextBox control. El ejemplo requiere que el System.Drawing espacio de nombres se haya agregado al formulario en el que se coloca este código.The example requires that the System.Drawing namespace has been added to the form that this code is placed in. En el ejemplo también se requiere TextBox que se haya agregado un al formulario en el que se encuentra este código de ejemplo textBox1en que se denomina.The example also requires that a TextBox has been added to the form that this example code is located in that is named textBox1.

private:
   // The following event handler would be connected to three menu items.
   void MyMenuClick( Object^ sender, EventArgs^ e )
   {
      // Determine if clicked menu item is the Blue menu item.
      if ( sender == menuItemBlue )
      {
         // Set the checkmark for the menuItemBlue menu item.
         menuItemBlue->Checked = true;
         // Uncheck the menuItemRed and menuItemGreen menu items.
         menuItemRed->Checked = false;
         menuItemGreen->Checked = false;
         // Set the color of the text in the TextBox control to Blue.
         textBox1->ForeColor = Color::Blue;
      }
      else if ( sender == menuItemRed )
      {
         
         // Set the checkmark for the menuItemRed menu item.
         menuItemRed->Checked = true;
         // Uncheck the menuItemBlue and menuItemGreen menu items.
         menuItemBlue->Checked = false;
         menuItemGreen->Checked = false;
         // Set the color of the text in the TextBox control to Red.
         textBox1->ForeColor = Color::Red;
      }
      else
      {
         // Set the checkmark for the menuItemGreen.
         menuItemGreen->Checked = true;
         // Uncheck the menuItemRed and menuItemBlue menu items.
         menuItemBlue->Checked = false;
         menuItemRed->Checked = false;
         // Set the color of the text in the TextBox control to Blue.
         textBox1->ForeColor = Color::Green;
      }
   }
// The following event handler would be connected to three menu items.
 private void MyMenuClick(Object sender, EventArgs e)
 {
    // Determine if clicked menu item is the Blue menu item.
    if(sender == menuItemBlue)
    {
       // Set the checkmark for the menuItemBlue menu item.
       menuItemBlue.Checked = true;
       // Uncheck the menuItemRed and menuItemGreen menu items.
       menuItemRed.Checked = false;
       menuItemGreen.Checked = false;
       // Set the color of the text in the TextBox control to Blue.
       textBox1.ForeColor = Color.Blue;
    }
    else if(sender == menuItemRed)
    {
       // Set the checkmark for the menuItemRed menu item.
       menuItemRed.Checked = true;
       // Uncheck the menuItemBlue and menuItemGreen menu items.
       menuItemBlue.Checked = false;
       menuItemGreen.Checked = false;
       // Set the color of the text in the TextBox control to Red.
       textBox1.ForeColor = Color.Red;
    }
    else
    {
       // Set the checkmark for the menuItemGreen.
       menuItemGreen.Checked = true;
       // Uncheck the menuItemRed and menuItemBlue menu items.
       menuItemBlue.Checked = false;
       menuItemRed.Checked = false;
       // Set the color of the text in the TextBox control to Blue.
       textBox1.ForeColor = Color.Green;
    }
 }

' The following event handler would be connected to three menu items.
Private Sub MyMenuClick(sender As Object, e As EventArgs)
    ' Determine if clicked menu item is the Blue menu item.
    If sender Is menuItemBlue Then
        ' Set the checkmark for the menuItemBlue menu item.
        menuItemBlue.Checked = True
        ' Uncheck the menuItemRed and menuItemGreen menu items.
        menuItemRed.Checked = False
        menuItemGreen.Checked = False
        ' Set the color of the text in the TextBox control to Blue.
        textBox1.ForeColor = Color.Blue
    Else
        If sender Is menuItemRed Then
            ' Set the checkmark for the menuItemRed menu item.
            menuItemRed.Checked = True
            ' Uncheck the menuItemBlue and menuItemGreen menu items.
            menuItemBlue.Checked = False
            menuItemGreen.Checked = False
            ' Set the color of the text in the TextBox control to Red.
            textBox1.ForeColor = Color.Red
        Else
            ' Set the checkmark for the menuItemGreen.
            menuItemGreen.Checked = True
            ' Uncheck the menuItemRed and menuItemBlue menu items.
            menuItemBlue.Checked = False
            menuItemRed.Checked = False
            ' Set the color of the text in the TextBox control to Blue.
            textBox1.ForeColor = Color.Green
        End If
    End If
End Sub

Comentarios

Puede usar la propiedad Checked en combinación con otros elementos de menú en un menú para proporcionar el estado de una aplicación.You can use the Checked property in combination with other menu items in a menu to provide state for an application. Por ejemplo, puede colocar una marca de verificación en un elemento de menú de un grupo de elementos para identificar el tamaño de la fuente que se va a mostrar para el texto de una aplicación.For example, you can place a check mark on a menu item in a group of items to identify the size of the font to be displayed for the text in an application. También puede utilizar la Checked propiedad para identificar el elemento de menú seleccionado en un grupo de elementos de menú mutuamente excluyentes.You can also use the Checked property to identify the selected menu item in a group of mutually exclusive menu items.

Nota

Esta propiedad no se puede establecer true en para los elementos de menú de nivel superior.This property cannot be set to true for top-level menu items.

Se aplica a