Main Content

最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

press

クラス: matlab.uitest.TestCase
パッケージ: matlab.uitest

UI コンポーネントでの押し下げ動作の実行

構文

press(testcase,comp)
press(testcase,comp,location)
press(testcase,spn,direction)
press(testcase,fig,'SelectionType',type)
press(testcase,fig,location,'SelectionType',type)

説明

press(testcase,comp) は、comp UI コンポーネントの押し下げ動作を実行します。

press(testcase,comp,location) は、コンポーネント内の押し下げる位置を指定します。AxesUIAxesPolarAxes、または Figure オブジェクト内の位置を指定できます。位置を指定しない場合、MATLAB®comp の中央を押し下げます。

press(testcase,spn,direction) は、スピナー spn の 'up' と 'down' の direction ボタンのうち、いずれを押し下げるかを指定します。

press(testcase,fig,'SelectionType',type) は、マウスの選択タイプ type を使用して UI figure fig 上で押し下げ動作を実行します。

press(testcase,fig,location,'SelectionType',type) は、指定されたマウスの選択タイプを使用して UI figure 内で押す位置を指定します。

入力引数

すべて展開する

テスト ケースのインスタンス。matlab.uitest.TestCase オブジェクトとして指定します。

テスト中に押すコンポーネント。押し下げ動作をサポートする UI コンポーネント オブジェクトとして指定します。押し下げ動作をサポートするコンポーネントには、イメージ、ボタン、チェック ボックス、スイッチ、メニュー、座標軸、Figure などがあります。

サポートされるコンポーネント一般的な作成関数
イメージuiimage
ボタン

uibutton

uiradiobutton

uitogglebutton

チェック ボックスuicheckbox
スイッチ

uiswitch

メニューuimenu
座標軸axes
UI 座標軸uiaxes
極座標軸polaraxes
UI Figureuifigure

データ型: matlab.ui.control.Image | matlab.ui.control.Button | matlab.ui.control.StateButton | matlab.ui.control.RadioButton | matlab.ui.control.ToggleButton | matlab.ui.control.CheckBox | matlab.ui.control.Switch | matlab.ui.control.ToggleSwitch | matlab.ui.control.RockerSwitch | matlab.ui.container.Menu | matlab.graphics.axis.Axes | matlab.ui.control.UIAxes | matlab.graphics.axis.PolarAxes | matlab.ui.Figure

押す位置。点の座標として指定します。

  • 座標軸および UI 座標軸 — x 座標、y 座標、およびオプションで z 座標を含む、1 行 2 列または 1 行 3 列の数値配列。

  • 極座標軸 — θ 座標および r 座標を含む、1 行 2 列の数値配列。

  • UI Figure — x 座標および y 座標を含む、1 行 2 列の数値配列。UI Figure の左下隅からのピクセル単位の座標を使用して、押し下げる点の座標を指定します。

例: [32.5 13 0.25] (UI 座標軸)

例: [pi/2 0.5] (極座標軸)

例: [100 200] (UI Figure)

テスト中に押すスピナー コンポーネント。matlab.ui.control.Spinner オブジェクトとして指定します。通常、スピナー コンポーネントの作成には関数 uispinner を使用します。

データ型: matlab.ui.control.Spinner

スピナーの変更方向。'up' または 'down' として指定します。スピナーの値をインクリメントするには 'up' を使用します。値をデクリメントするには 'down' を使用します。

データ型: char | string

指定されたマウスの選択タイプを使用してテスト中に押す UI figure コンポーネント。matlab.ui.Figure オブジェクトとして指定します。UI figure コンポーネントは、関数 uifigure で作成されます。

データ型: matlab.ui.Figure

マウスの選択タイプ。'normal''extend''alt'、または 'open' として指定します。この入力は、UI figure でマウス ボタンがどのように押されるかについての情報を提供します。詳細については、UI Figure のプロパティ を参照してください。

次の表は、選択タイプの取り得る値と、これらの値を生成するアクションの一覧です。

対応するアクション

'normal'

左マウス ボタンをクリック

'extend'

以下のいずれか:

  • Shift キーを押しながら左マウス ボタンをクリック

  • 中央のマウス ボタンをクリック

  • 左と右の両方のマウス ボタンをクリック

'alt'

以下のいずれか:

  • Control キーを押しながら左マウス ボタンをクリック

  • 右マウス ボタンをクリック

'open'

任意のマウス ボタンをダブルクリック

データ型: char | string

すべて展開する

スライダー スイッチを作成します。

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 figure と対話型のテスト ケース インスタンスを作成します。

f = uifigure;
tc = matlab.uitest.TestCase.forInteractiveUse;

UI figure の中央で右クリックをテストします。プログラムによる押し下げ動作を表す青い点が表示され、Figure の中央で消えます。

tc.press(f,'SelectionType','alt')

UI figure 上の座標 (100, 200) でダブルクリックをテストします。プログラムによる押し下げ動作を表す青い点が表示され、指定した位置で消えます。

tc.press(f,[100 200],'SelectionType','open')
R2018a で導入