LongPressジェスチャー

Note: Sign in to the developer console to build or publish your skill.

LongPressジェスチャー

重要： LongPressジェスチャーにはAPL 1.4以降が必要です。これよりも古いバージョンのAPLを実行しているデバイスには、別のエクスペリエンスを提供してください。

LongPressジェスチャーは、タッチ可能なコンポーネントに長押しのサポートを提供します。ユーザーがコンポーネントをタップしたまま長押しすると、LongPressがトリガーされます。

プロパティ

プロパティ	型	デフォルト	説明
type	"LongPress"	必須	"LongPress"に設定する必要があります。
onLongPressStart	コマンドの配列	[]	長押しが最初に検出されたときに実行するコマンドです。
onLongPressEnd	コマンドの配列	[]	長押しが終了したときに実行するコマンドです。

onLongPressStart

長押しイベントが発生したときに実行するコマンドです。onLongPressStartのコマンドは、ユーザーが十分な時間ポインターを押し続けた後に実行されます。onLongPressStartのコマンドは、ユーザーがポインターを放すまで実行されます。

生成されるイベントの形式は次のようになります。

"event": {
  "source": {
    "type": "COMPONENT_TYPE", // コンポーネントの型    
    "handler": "LongPressStart",
    ...                     // コンポーネントのソースのプロパティ
  },
  "component": {
    "x": Number,       // コンポーネント内でのアップイベントのX位置（dp）
    "y": Number,       // コンポーネント内でのアップイベントのY位置（dp）
    "width": Number,   // コンポーネントの幅（dp）
    "height": Number,  // コンポーネントの高さ（dp）
  },
  "inBounds": Boolean  // ポインターがコンポーネントの変換後の境界内にある場合はtrue
}

ポインター位置のinBoundsの計算では、重なり合うコンポーネントは考慮されません。

event.sourceのプロパティの詳細については、イベントソースを参照してください。

onLongPressStartイベントハンドラーは、コンポーネントのデータバインディングコンテキストで高速モードで実行されます。

onLongPressEnd

長押しが解放されたときに実行するコマンドです。onLongPressEndのコマンドは、ユーザーがポインターを放した後に実行されます。

生成されるイベントの形式は次のようになります。

"event": {
  "source": {
    "type": "COMPONENT_TYPE", // コンポーネントの型    
    "handler": "LongPressEnd",
    ...                     // コンポーネントのソースのプロパティ
  },
  "component": {
    "x": Number,       // コンポーネント内でのアップイベントのX位置（dp）
    "y": Number,       // コンポーネント内でのアップイベントのY位置（dp）
    "width": Number,   // コンポーネントの幅（dp）
    "height": Number,  // コンポーネントの高さ（dp）
  },
  "inBounds": Boolean  // ポインターがコンポーネントの変換後の境界内にある場合はtrue
}

ポインター位置のinBoundsの計算では、重なり合うコンポーネントは考慮されません。

event.sourceのプロパティの詳細については、イベントソースを参照してください。

onLongPressEndイベントハンドラーは、コンポーネントのデータバインディングコンテキストで通常モードで実行されます。