choose

Класс: matlab.uitest.TestCase
Пакет: matlab.uitest

Выполните выбирают жест на компоненте пользовательского интерфейса

Синтаксис

choose(testcase,comp,option)
choose(testcase,compNoOpts)

Описание

choose(testcase,comp,option) выполняет выбрать жест на заданном элементе на компоненте пользовательского интерфейса comp.

choose(testcase,compNoOpts) выполняет выбрать жест на компоненте пользовательского интерфейса, который не запрашивает дополнительную информацию, такую как вкладка или древовидный узел. Например, используйте этот синтаксис, чтобы выбрать определенную вкладку, но использовать предыдущий синтаксис, чтобы выбрать конкретную вкладку из группы вкладки.

Входные параметры

развернуть все

Экземпляр теста в виде matlab.uitest.TestCase объект.

Компонент, чтобы выбрать во время теста в виде компонента пользовательского интерфейса возражает что поддержки выбрать жест. Компоненты, что поддержка выбирает жесты, включают флажки, кнопки, переключатели и выпадающие списки.

Поддерживаемый компонентТипичная функция создания
Группа кнопокuibuttongroup
Флажокuicheckbox
Дискретная кнопкаuiknob
Выпадающий списокuidropdown
Кнопкаuiknob
Поле спискаuilistbox
Переключательuiradiobutton
Ползунокuislider
Кнопка состоянияuibutton
Переключатель (рокер, ползунок, переключаются),uiswitch
Группа вкладкиuitabgroup
Кнопка-переключательuitogglebutton
Переключите инструментuitoggletool

Элемент в компоненте пользовательского интерфейса, чтобы выбрать. Тип данных option зависит от типа протестированного компонента. Например, если comp переключатель, option текст или числовое значение от Items свойство переключателя. Если comp флажок или инструмент переключателя, option логическое значение.

Когда компонент имеет Items свойство, option может быть значение элемента в Items или индекс к элементу в Items. Например, для дискретной кнопки по умолчанию, можно выбрать 'Medium' с помощью значения для option это - любой 'Medium' или 3.

Компонент, чтобы выбрать в виде компонента пользовательского интерфейса возражает, что поддержки выбрать жест и не запрашивают дополнительную информацию. Компоненты, что поддержка выбирает жесты, включают вкладки и древовидные узлы.

Поддерживаемый компонентТипичная функция создания
Вкладкаuitab
Древовидный узелuitreenode

Примеры

развернуть все

Создайте дискретную кнопку.

knob = uiknob('discrete');

A figure with a discrete knob. The knob value is 'Off'.

Создайте интерактивный тест и выберите значение кнопки 'High'. Анимированная синяя точка выполняет программируемое, выбирают жест.

tc = matlab.uitest.TestCase.forInteractiveUse;
tc.choose(knob,'High')

A figure with a discrete knob. The knob value is 'High'.

Просмотрите значение Items свойство на кнопке.

knob.Items
ans =

  1×4 cell array

    {'Off'}    {'Low'}    {'Medium'}    {'High'}

Выберите значение кнопки 'Low' индексом. Кнопка перемещается от 'High' к 'Low'.

tc.choose(knob,2)

A figure with a discrete knob. The knob value is 'Low'.

Создайте поле списка и включите нескольким выбор узла.

listbox = uilistbox('Multiselect','on')
listbox = 

  ListBox (Item 1) with properties:

              Value: {'Item 1'}
              Items: {'Item 1'  'Item 2'  'Item 3'  'Item 4'}
          ItemsData: []
        Multiselect: 'on'
    ValueChangedFcn: ''
           Position: [100 100 100 74]

  Show all properties

A figure with a list box that has four items. Item 1 is chosen.

Создайте интерактивный тест и выберите пункты 1 - 3.

tc = matlab.uitest.TestCase.forInteractiveUse;
tc.choose(listbox,1:3)

A figure with a list box that has four items. Items 1 through 3 are chosen.

Выберите пункты 1 и 3 с помощью значений Items свойство.

tc.choose(listbox,{'Item 1','Item 3'})

A figure with a list box that has four items. Items 1 and 3 are chosen.

Создайте ползунок.

s = uislider;

Создайте интерактивный тест и проверьте, что значением кнопки ползунка является 0.

tc = matlab.uitest.TestCase.forInteractiveUse;
tc.verifyEqual(s.Value,0)
Verification passed.

Выберите новое значение ползунка и проверьте изменения значения ползунка. Поскольку среда подражает пользователю, управляющему компонентом к произвольно precisioned значение, это - лучшая практика использовать допуск, чтобы сравнить фактические и ожидаемые значения ползунка.

expVal = 42;
tc.choose(s,expVal)
tc.verifyEqual(s.Value,expVal,'AbsTol',0.1)
Verification passed.

Создайте фигуру с двумя вкладками.

fig = uifigure;
group = uitabgroup(fig);
tab1 = uitab(group,'Title','Tab #1');
tab2 = uitab(group,'Title','Tab #2');

Создайте интерактивный тест и проверьте, что выбранный заголовок вкладки содержит подстроку '#1'.

tc = matlab.uitest.TestCase.forInteractiveUse;
tc.verifySubstring(group.SelectedTab.Title,'#1')
verification passed.

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

tc.choose(group,'Tab #2')
tc.verifyEqual(group.SelectedTab,tab2)
Verification passed.

Вопросы совместимости

развернуть все

Поведение изменяется в R2020b

Введенный в R2018a
Для просмотра документации необходимо авторизоваться на сайте