Добавление переключателя (XAML)

Applies to Windows and Windows Phone

В этом учебнике приводится пошаговая процедура добавления тумблера в приложение среды выполнения Windows на C++, C# или Visual Basic.

Обычно тумблер добавляется в редакторе языка XAML или с помощью средства разработки, такого как Blend для Visual Studio. Также тумблер можно добавить в коде во время выполнения.

Схема создания: каким образом эта тема связана с другими? См. разделы:

Что необходимо знать

Технологии

Необходимые условия

Инструкции

Этап 1: Добавление тумблера на языке XAML

Hh868198.wedge(ru-ru,WIN.10).gifДобавление тумблера на языке XAML

  1. Добавьте элемент управления ToggleSwitch в родительский контейнер.
  2. Чтобы присвоить имя тумблеру, задайте атрибут x:Name для строкового параметра.

    Чтобы ссылаться в коде на элемент управления, у него должно быть имя. В противном случае имя не требуется.

  3. Чтобы присвоить тумблеру заголовок, задайте свойство Header для строкового параметра.
  4. Чтобы присвоить тумблеру метку, когда он включен, задайте свойство OnContent для строкового параметра.
  5. Чтобы присвоить тумблеру метку, когда он выключен, задайте свойство OffContent для строкового параметра.
  6. Чтобы выполнить действие при изменении состояния тумблера, добавьте обработчик для события Toggled. В обработчике событий Toggled добавьте код, чтобы выполнить какое-нибудь действие.
    
    <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.
    }
    
    
    

    Чтобы проверить состояние элемента управления вне события Toggled, используйте свойство IsOn.

Этап 2: Добавление тумблера в коде

Hh868198.wedge(ru-ru,WIN.10).gifДобавление тумблера в коде

  1. Создайте новый элемент управления ToggleSwitch.
  2. Чтобы присвоить тумблеру заголовок, задайте свойство Header для строкового параметра.
  3. Чтобы присвоить тумблеру метку, когда он включен, задайте свойство OnContent для строкового параметра.
  4. Чтобы присвоить тумблеру метку, когда он выключен, задайте свойство OffContent для строкового параметра.
  5. Чтобы выполнить действие при изменении состояния тумблера, добавьте обработчик для события Toggled. В обработчике событий Toggled добавьте код, чтобы выполнить какое-нибудь действие.
  6. Добавьте ToggleSwitch в родительский контейнер в визуальном дереве, чтобы показать тумблер в пользовательском интерфейсе.
    
    // 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.
    }
    
    
    

    Чтобы проверить состояние элемента управления вне события Toggled, используйте свойство IsOn.

Этап 3: Добавление тумблера с помощью средства разработки

Hh868198.wedge(ru-ru,WIN.10).gifДобавление тумблера с помощью средства разработки

  1. Выберите элемент управления ToggleSwitch.
    • В Microsoft Visual Studio выберите элемент управления ToggleSwitch на панели элементов.
    • В Blend для Visual Studio выберите элемент управления ToggleSwitch в области Активы.

      Выберите раздел Элементы управления в левой части области Активы, если он не выбран.

  2. Добавьте элемент управления ToggleSwitch в рабочую область конструирования. Выполните одно из следующих действий.
    • Дважды щелкните тумблер. Тумблер добавляется в выбранный родительский контейнер с параметрами положения и размера по умолчанию.
    • Перетащите тумблер в рабочую область конструирования. Тумблер добавляется в выбранное положение с параметрами размера и содержимого по умолчанию.
    • Нарисуйте элемент управления "тумблер" в рабочей области конструирования. Тумблер добавляется с параметрами размера и положения, используемыми при рисовании.
  3. Если требуется, присвойте имя элементу управления ToggleSwitch. После выбора тумблера введите имя в текстовом поле свойства Имя.

    Текстовое поле свойства Имя находится в верхней части области Свойства. Чтобы ссылаться в коде на элемент управления, у него должно быть имя. В противном случае имя не требуется.

  4. Обновите заголовок ToggleSwitch. После выбора тумблера введите строку содержимого в текстовом поле свойства Header.

    Если область Свойства упорядочена по значению Категория, свойство Header находится в категории Общие.

  5. Если требуется, обновите метку для отображения, когда двухпозиционный переключатель ToggleSwitch включен. После выбора тумблера введите строку содержимого в текстовом поле свойства OnContent.

    Если область Свойства упорядочена по значению Категория, свойство OnContent находится в категории Общие параметры. Значение по умолчанию — "Вкл.".

  6. Если требуется, обновите метку для отображения, когда двухпозиционный переключатель ToggleSwitch выключен. После выбора тумблера введите строку содержимого в текстовом поле свойства OffContent.

    Если область Свойства упорядочена по значению Категория, свойство OffContent находится в категории Общие параметры. Значение по умолчанию — "Выкл.".

  7. Чтобы выполнить действие при изменении состояния тумблера, добавьте обработчик для события Toggled. В обработчике событий Toggled добавьте код, чтобы выполнить какое-нибудь действие.
    1. Выберите представление Event (Событие) в области Property (Свойство).
    2. Когда переключатель выбран на поверхности разработки, выполните одно из следующих действий:
      • Дважды щелкните текстовое поле события Toggled, чтобы добавить обработчик с именем по умолчанию.
      • Введите имя в текстовом поле события Toggled и нажмите клавишу ВВОД, чтобы добавить обработчик с пользовательским именем.

Связанные разделы

ToggleSwitch
Руководство и контрольный список для тумблеров
Схема создания приложений среды выполнения Windows на C# или Visual Basic
Схема создания приложений среды выполнения Windows на C++

 

 

Показ:
© 2014 Microsoft