Cómo agregar un modificador de alternancia (XAML)

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

Normalmente, los modificadores para alternar se agregan en el editor de lenguaje XAML o mediante una herramienta de diseño como Blend para Visual Studio. También puedes agregar un modificador para alternar 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 un modificador para alternar en XAML

Hh868198.wedge(es-es,WIN.10).gifPara agregar un modificador para alternar en XAML

  1. Agrega un control ToggleSwitch a un contenedor principal.
  2. Para asignar un nombre al modificador para alternar, 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 un encabezado al modificador para alternar, establece la propiedad Header en un valor de cadena.
  4. Para asignar una etiqueta que indique que el modificador para alternar está activado, establece la propiedad OnContent en un valor de cadena.
  5. Para asignar una etiqueta que indique que el modificador para alternar está desactivado, establece la propiedad OffContent en un valor de cadena.
  6. Para realizar una acción cuando cambie el estado del modificador para alternar, agrega un controlador para el evento Toggled. En el controlador del evento Toggled, agrega código que realice alguna acción.
    
    <ToggleSwitch x:Name="toggleSwitch1" Header="ToggleSwitch" 
                  OnContent="On" OffContent="Off" 
                  Toggled="ToggleSwitch_Toggled"/>
    
    
    
    
    private void ToggleSwitch_Toggled(object sender, RoutedEventArgs e)
    {
        // Add code to perform some action here.
    }
    
    
    

    Para comprobar el estado del control fuera del evento Toggled, usa la propiedad IsOn.

Paso 2: Agregar un modificador para alternar mediante programación

Hh868198.wedge(es-es,WIN.10).gifPara agregar un modificador para alternar mediante programación

  1. Crea un nuevo objeto ToggleSwitch.
  2. Para asignar un encabezado al modificador para alternar, establece la propiedad Header en un valor de cadena.
  3. Para asignar una etiqueta que indique que el modificador para alternar está activado, establece la propiedad OnContent en un valor de cadena.
  4. Para asignar una etiqueta que indique que el modificador para alternar está desactivado, establece la propiedad OffContent en un valor de cadena.
  5. Para realizar una acción cuando cambie el estado del modificador para alternar, agrega un controlador para el evento Toggled. En el controlador de eventos Toggled, agrega código que realice alguna acción.
  6. Agrega el ToggleSwitch a un contenedor primario en el árbol visual para que el modificador para alternar se muestre en la interfaz de usuario.
    
    // Create a new toggle switch, set it's content, 
    // and add a Toggled event handler.
    ToggleSwitch toggleSwitch1 = new ToggleSwitch();
    toggleSwitch1.Header = "Toggle Switch";
    toggleSwitch1.OnContent = "On";
    toggleSwitch1.OffContent = "Off";
    toggleSwitch1.Toggled += ToggleSwitch_Toggled;
    
    // Add the toggle switch to a parent container in the visual tree.
    stackPanel1.Children.Add(toggleSwitch1);
    
    
    
    
    private void ToggleSwitch_Toggled(object sender, RoutedEventArgs e)
    {
        // Add code to perform some action here.
    }
    
    
    

    Para comprobar el estado del control fuera del evento Toggled, usa la propiedad IsOn.

Paso 3: Agregar un modificador para alternar mediante una herramienta de diseño

Hh868198.wedge(es-es,WIN.10).gifPara agregar un modificador para alternar mediante una herramienta de diseño

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

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

  2. Agrega un control ToggleSwitch a la superficie de diseño. Realiza una de las siguientes acciones:
    • Haz doble clic en el modificador para alternar. El modificador para alternar se agrega al contenedor principal seleccionado con valores predeterminados de posición y tamaño.
    • Arrastra el modificador para alternar hasta la superficie de diseño. El modificador para alternar se agrega en la posición donde se coloca, con los valores predeterminados de tamaño y contenido.
    • Dibuja el control del modificador para alternar en la superficie de diseño. El modificador para alternar se agrega con los valores de tamaño y posición que dibujes.
  3. Si es necesario, asigna un nombre al control ToggleSwitch. Con el modificador para alternar seleccionado, escribe el nombre del 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 encabezado de ToggleSwitch. Con el modificador para alternar seleccionado, escribe la cadena de contenido en el cuadro de texto de la propiedad Encabezado.

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

  5. Si es necesario, actualiza la etiqueta para que indique cuándo está activado el control ToggleSwitch. Con el modificador para alternar seleccionado, escribe la cadena de contenido en el cuadro de texto de la propiedad OnContent.

    Si el panel Propiedades está organizado por Categoría, la propiedad OnContent estará en la categoría Común. El valor predeterminado es "On".

  6. Si es necesario, actualiza la etiqueta para que indique cuándo está desactivado el control ToggleSwitch. Con el modificador para alternar seleccionado, escribe la cadena de contenido en el cuadro de texto de la propiedad OffContent.

    Si el panel Propiedades está organizado por Categoría, la propiedad OffContent estará en la categoría Común. El valor predeterminado es "Off".

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

Temas relacionados

ToggleSwitch
Directrices y lista de comprobación para modificadores para alternar
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