Exportar (0) Imprimir
Expandir todo

MenuItem.Checked (Propiedad)

Actualización: noviembre 2007

Obtiene o establece un valor que indica si se va a mostrar una marca de verificación junto al texto del elemento de menú.

Espacio de nombres:  System.Windows.Forms
Ensamblado:  System.Windows.Forms (en System.Windows.Forms.dll)

public bool Checked { get; set; }
/** @property */
public boolean get_Checked()
/** @property */
public  void set_Checked(boolean value)

public function get Checked () : boolean
public function set Checked (value : boolean)

Valor de propiedad

Tipo: System.Boolean
Es true si hay una marca de verificación junto al elemento de menú; de lo contrario, es false. El valor predeterminado es false.

ExcepciónCondición
ArgumentException

MenuItem es un menú de nivel superior o tiene elementos secundarios.

La propiedad Checked se puede utilizar en combinación con otros elementos de un menú para proporcionar el estado de una aplicación. Por ejemplo, se puede colocar una marca de verificación junto a un elemento de menú de un grupo de elementos para identificar el tamaño de la fuente con la que se mostrará el texto de la aplicación. La propiedad Checked también se puede utilizar para identificar el elemento de menú seleccionado en un grupo de elementos que se excluyen mutuamente.

f5d61sas.alert_note(es-es,VS.90).gifNota:

Esta propiedad no se puede establecer en true para elementos de menú de nivel superior.

En el siguiente ejemplo de código se utiliza la propiedad Checked para proporcionar el estado de una aplicación. En este ejemplo se utiliza un grupo de elementos de menú para especificar el color del texto en un control TextBox. El evento Click de los tres elementos de menú utiliza el controlador de eventos proporcionado. Cada elemento de menú especifica un color de texto: menuItemRed (Rojo), menuItemGreen (Verde) o menuItemBlue (Azul). El controlador de eventos determina en qué elemento de menú se hizo clic, coloca una marca de verificación en el elemento de menú seleccionado y cambia el color del texto del control TextBox del formulario. En el ejemplo se requiere que se haya agregado el espacio de nombres System.Drawing al formulario donde se encuentra este código. También se requiere que se haya agregado un TextBox al formulario donde se encuentra el código de este ejemplo y que se denomina textBox1.

// 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 void MyMenuClick(Object sender, EventArgs e)
{
    // Determine if clicked menu item is the Blue menu item.
    if (sender.Equals( menuItemBlue)) {
        // Set the checkmark for the menuItemBlue menu item.
        menuItemBlue.set_Checked(true);

        // Uncheck the menuItemRed and menuItemGreen menu items.
        menuItemRed.set_Checked(false);
        menuItemGreen.set_Checked(false);

        // Set the color of the text in the TextBox control to Blue.
        textBox1.set_ForeColor(Color.get_Blue());
    }
    else {
        if (sender.Equals( menuItemRed)) {
            // Set the checkmark for the menuItemRed menu item.
            menuItemRed.set_Checked(true);

            // Uncheck the menuItemBlue and menuItemGreen menu items.
            menuItemBlue.set_Checked(false);
            menuItemGreen.set_Checked(false);

            // Set the color of the text in the TextBox control to Red.
            textBox1.set_ForeColor(Color.get_Red());
        }
        else {
            // Set the checkmark for the menuItemGreen.
            menuItemGreen.set_Checked(true);

            // Uncheck the menuItemRed and menuItemBlue menu items.
            menuItemBlue.set_Checked(false);
            menuItemRed.set_Checked(false);

            // Set the color of the text in the TextBox control to Blue.
            textBox1.set_ForeColor(Color.get_Green());
        }
    }
} //MyMenuClick 


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

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 3.5, 2.0, 1.0

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft