[Androidアプリ]標準動作一覧 / ピンチ操作
はじめに
Androidアプリの「ピンチ操作」カテゴリに含まれる、標準動作一覧です。
もくじ
詳細
座標を中心にピンチインする
-
X,Y座標を中心にピンチインします。
ピンチインとは、画面を縮小（ズームアウト）する操作です。 -
座標は、画面の左上隅を (0, 0)とする基準点からの距離で指定します。
右方向がX軸、下方向がY軸となり、それぞれの値が増えることで位置を表します。
※1 X座標、Y座標の絶対値指定 - 必須条件：「アプリケーションを起動する」関連のアクションがテスト手順に含まれない場合は、動作しません。
- 画面表示前にピンチインしてしまう場合は、ピンチインする前に「秒待機する」の動作を入れてください。
- テストに用いるAndroid端末によっては、意図しない動きとなる可能性があります。
| 画面名(設定値1) | 中心座標（X座標、Y座標）の数値を半角数字（整数）で入力する |
| 要素名(設定値2) | 中心からピンチインする距離（ピクセル数）を半角数字（少数点可）で入力する |
| 設定値(設定値3) | ピンチイン操作にかける時間の長さ（秒）を半角数字（小数点可）で入力する |
座標を中心にピンチアウトする
-
X,Y座標を中心にピンチアウトします。
ピンチアウトとは、画面を拡大（ズームイン）する操作です。 -
座標は、画面の左上隅を (0, 0)とする基準点からの距離で指定します。
右方向がX軸、下方向がY軸となり、それぞれの値が増えることで位置を表します。
※1 X座標、Y座標の絶対値指定 - 必須条件：「アプリケーションを起動する」関連のアクションがテスト手順に含まれない場合は、動作しません。
- 画面表示前にピンチアウトしてしまう場合は、ピンチアウトする前に「秒待機する」の動作を入れてください。
- テストに用いるAndroid端末によっては、意図しない動きとなる可能性があります。
| 画面名(設定値1) | 中心座標（X座標、Y座標）の数値を半角数字（整数）で入力する |
| 要素名(設定値2) | 中心からピンチアウトする距離（ピクセル数）を半角数字（小数点可）で入力する |
| 設定値(設定値3) | ピンチアウト操作にかける時間の長さ（秒）を半角数字（小数点可）で入力する |
※1 X座標、Y座標の絶対値指定
- 端末によって画面サイズが異なるため、座標の範囲（最小値・最大値）も端末ごとに異なります。
テスト対象の端末の画面サイズに応じた座標範囲を考慮して、座標を指定してください。
端末の画面サイズは「Android Studio」の「DeviceManager」から確認可能です。 - 座標の最大座標は、(width – 1, height – 1)です。
下図の例にある通り、Pixel 9 Proの場合は、解像度が「1280×2856」ですので、最大座標は「1279×2855」となります。 - 座標は常に画面自体に対して固定されているため、表示領域が移動しても画面内の座標（X・Y）は変化しません。
・(0, 0)：親ビューの左上
・x > 0：右方向
・y > 0：下方向
マイナス値を座標として指定すると、その分だけ左（または上）にはみ出す位置になります。
つまり、「マイナス座標 = 親ビュー外側の位置」です。
また、親ビューのx,y座標の上限値を超えた座標も、マイナス値と同様の扱いになります。
