Cómo agregar una casilla (XAML)

Applies to Windows and Windows Phone

En este tutorial se describen los pasos para agregar una casilla a una aplicación de Windows en tiempo de ejecución con C++, C# o Visual Basic.

Normalmente, las casillas se agregan en el editor de lenguaje XAML o mediante una herramienta de diseño como Blend para Visual Studio. También puedes agregar una casilla en el código en tiempo de ejecución.

Guía básica: Relación de este tema con los demás. Consulta:

Lo que debes saber

Tecnologías

Requisitos previos

Instrucciones

Paso 1: Agregar una casilla en XAML

Hh868194.wedge(es-es,WIN.10).gifPara agregar una casilla en XAML

  1. Agrega un control CheckBox a un contenedor principal.
  2. Para asignar un nombre a la casilla, establece el atributo x:Name en un valor de cadena.

    Si tienes que hacer referencia a un control en el código, debes asignarle un nombre. De lo contrario, no es necesario que tenga un nombre.

  3. Para asignar una etiqueta a la casilla, establece la propiedad Content en un valor de cadena.
  4. Para realizar una acción cuando cambie el estado de una casilla, agrega un controlador para el evento Checked. En el controlador del evento Checked, agrega código que realice alguna acción.
    
    <CheckBox x:Name="checkbox1" Content="CheckBox" 
              Checked="CheckBox_Checked"/>
    
    
    
    
    private void CheckBox_Checked(object sender, RoutedEventArgs e)
    {
        // Add code to perform some action here.
    }
    
    
    

    Para comprobar el estado del control fuera del evento Checked, usa la propiedad IsChecked.

Paso 2: Agregar una casilla mediante código

Hh868194.wedge(es-es,WIN.10).gifPara agregar una casilla mediante código

  1. Crea un nuevo objeto CheckBox.
  2. Para asignar una etiqueta a la casilla, establece la propiedad Content en un valor de cadena.
  3. Para realizar una acción cuando cambie el estado de una casilla, agrega un controlador para el evento Checked. En el controlador de eventos Checked, agrega código que realice alguna acción.
  4. Agrega el CheckBox a un contenedor primario en el árbol visual para que la casilla se muestre en la interfaz de usuario.
    
    // Create a new check box, set it's content, 
    // and add a Checked event handler.
    CheckBox checkBox1 = new CheckBox();
    checkBox1.Content = "CheckBox";
    checkBox1.Checked += CheckBox_Checked;
    
    // Add the check box to a parent container in the visual tree.
    stackPanel1.Children.Add(checkBox1);
    
    
    
    
    private void CheckBox_Checked(object sender, RoutedEventArgs e)
    {
        // Add code to perform some action here.
    }
    
    
    

    Para comprobar el estado del control fuera del evento Checked, usa la propiedad IsChecked.

Paso 3: Agregar una casilla mediante una herramienta de diseño

Hh868194.wedge(es-es,WIN.10).gifPara agregar una casilla mediante una herramienta de diseño

  1. Selecciona el control CheckBox.
    • En Microsoft Visual Studio, selecciona el control CheckBox en el panel Cuadro de herramientas.
    • En Blend para Visual Studio, selecciona el control CheckBox en el panel Activos.

      Selecciona Controles en el lado izquierdo del panel Activos si no está seleccionado.

  2. Agrega un control CheckBox a la superficie de diseño. Realiza una de las siguientes acciones:
    • Haz doble clic en la casilla. La casilla se agrega al contenedor principal seleccionado con valores predeterminados de posición y tamaño.
    • Arrastra la casilla hasta la superficie de diseño. La casilla se agrega en la posición donde se coloca, con los valores predeterminados de tamaño y contenido.
    • Dibuja el control de casilla en la superficie de diseño. La casilla se agrega con los valores de tamaño y posición que dibujes.
  3. Si es necesario, asigna un nombre al control CheckBox. Con la casilla seleccionada, escribe el nombre en el cuadro de texto de la propiedad Nombre.

    El cuadro de texto de la propiedad Nombre está en la parte superior del panel Propiedades. Si tienes que hacer referencia a un control en el código, debes asignarle un nombre. De lo contrario, no es necesario que tenga un nombre.

  4. Actualiza el contenido de CheckBox. Realiza una de las siguientes acciones:
    • Haz clic en la casilla para seleccionarla y vuelve a hacer clic en ella para que su contenido se pueda modificar. Escribe nuevo contenido para la etiqueta de la casilla en la superficie de diseño.
    • Escribe la cadena de contenido en el cuadro de texto de la propiedad Contenido.

      Si el panel Propiedades está organizado por Categoría, la propiedad Contenido estará en la categoría Común.

  5. Para realizar una acción cuando cambie el estado de una casilla, agrega un controlador para el evento Checked. En el controlador de eventos Checked, agrega código que realice alguna acción.
    1. Selecciona la vista Evento en el panel Propiedad.
    2. Con la casilla seleccionada en la superficie de diseño, realiza una de las acciones siguientes:
      • Haz doble clic en el cuadro de texto del evento Checked para agregar un controlador con un nombre predeterminado.
      • Escribe un nombre en el cuadro de texto del evento Checked y presiona Entrar para agregar un controlador con un nombre personalizado.

Temas relacionados

CheckBox
Directrices para controles checkbox
Guía básica para crear aplicaciones de Windows en tiempo de ejecución con C# o Visual Basic
Guía básica para crear aplicaciones de Windows en tiempo de ejecución con C++

 

 

Mostrar:
© 2015 Microsoft