press
类: matlab.uitest.TestCase
命名空间: matlab.uitest
对 UI 组件执行按下手势
语法
说明
输入参数
示例
创建一个滑块开关。
s = uiswitch('slider');
创建一个交互式测试用例并按下开关。表示编程按下手势的蓝点出现在开关的中心，然后消失。开关从 'Off' 移动到 'On'。
tc = matlab.uitest.TestCase.forInteractiveUse; tc.press(s);
创建 UI 坐标区和交互式测试用例实例。
ax = uiaxes; tc = matlab.uitest.TestCase.forInteractiveUse;
按下坐标区的中心。表示编程按下手势的蓝点出现在坐标区的中心，然后消失。
tc.press(ax)
在坐标区坐标 (0.85, 0.2) 处按下。表示编程按下手势的蓝点出现在指定的坐标区坐标位置，然后消失。
tc.press(ax,[0.85 0.2])
创建一个状态按钮。
b = uibutton('state');创建一个交互式测试用例，并验证状态按钮的值为 false。
tc = matlab.uitest.TestCase.forInteractiveUse; tc.verifyFalse(b.Value)
Verification passed.
按下该按钮并验证状态更改为 true。表示编程按下手势的蓝点出现在按钮上，然后消失。
tc.press(b) tc.verifyTrue(b.Value)
Verification passed.
创建一个初始值为 42 的微调器。
s = uispinner('Value',42);
initVal = s.Value;创建一个交互式测试用例并增大微调器的值。验证微调器的新值等于初始值加上微调器步长值。
tc = matlab.uitest.TestCase.forInteractiveUse;
tc.press(s,'up')
tc.verifyEqual(s.Value,initVal+s.Step)Verification passed.
减小微调器的值，并验证微调器的值又变回初始值。
tc.press(s,'down')
tc.verifyEqual(s.Value,initVal)
Verification passed.
创建一个 UI 图窗和一个交互式测试用例实例。
f = uifigure; tc = matlab.uitest.TestCase.forInteractiveUse;
测试在 UI 图窗的中心处的右键点击。表示编程按下手势的蓝点出现在图窗的中心，然后消失。
tc.press(f,'SelectionType','alt')
测试在 UI 图窗的坐标 (100, 200) 处双击。表示编程按下手势的蓝点出现在指定的位置，然后消失。
tc.press(f,[100 200],'SelectionType','open')
自 R2023b 起
通过自动滚动到组件，对不在图窗可查看区域的组件执行手势。
创建一个具有状态按钮的可滚动图窗，该按钮位于图窗的可查看区域之外。
fig = uifigure("Scrollable","on"); b = uibutton(fig,"state","Position",[fig.Position(3)+100 100 100 22]);
为交互测试创建一个测试用例，并验证按钮的初始状态。
tc = matlab.uitest.TestCase.forInteractiveUse; tc.verifyFalse(b.Value)
Verification passed.
按下按钮并验证其状态是否更改。由于图窗是可滚动的，因此 App 测试框架在执行手势之前会自动滚动到该按钮。
tc.press(b) tc.verifyTrue(b.Value)
Verification passed.
