WaylandSeat QML Type

キーボード、マウス、タッチ入力へのアクセスを提供します。詳細...

Import Statement: import QtWayland.Compositor
In C++: QWaylandSeat

シグナル

メソッド

詳細説明

WaylandSeat型はさまざまなタイプのユーザー入力へのアクセスを提供し、キーボード・フォーカスとマウス・ポインターを維持する。これは Wayland プロトコルの wl_seat インターフェースに対応する。

シグナル・ドキュメント

void cursorSurfaceRequest(QWaylandSurface surface, int hotspotX, int hotspotY)

このシグナルは、クライアントが特定のsurface をマウスカーソルにするよう要求したときに発せられる。例えば、ユーザーが特定のサーフェス上にカーソルを置いたときに、カーソルをリサイズ矢印に変更したい場合などです。

hotspotXhotspotY はどちらも、クリックが起こるべきポインタ面の左上からのオフセットです。例えば、要求されたカーソル面が矢印の場合、パラメータは矢印の先端がその面のどこにあるかを示します。

注意: 対応するハンドラはonCursorSurfaceRequest です。


void keyboardFocusChanged(QWaylandSurface newFocus, QWaylandSurface oldFocus)

このシグナルは、setKeyboardFocus()が呼ばれたとき、またはWaylandQuickItem にフォーカスがあり、ユーザーがキーを押し始めたときに発行されます。

newFocus nullptr oldFocus はキーボードフォーカスを失ったサーフェスで、フォーカスを持つサーフェスがない場合は となります。nullptr

注: 対応するハンドラはonKeyboardFocusChanged です。


メソッドの説明

void sendKeyEvent(int qtKey, bool pressed)

qtKey キーの押下(pressedtrue の場合)または離鍵(pressedfalse の場合)イベントをキーボードデバイスに送信します。


void sendTouchCancelEvent(WaylandClient client)

client のキャンセルイベントをタッチデバイスに送信する。


void sendTouchFrameEvent(WaylandClient client)

client のタッチデバイスにフレームイベントを送信し、一連のタッチアップ、ダウン、モーションイベントの終了を示す。


void sendTouchPointMoved(WaylandSurface surface, int id, point position)

position の位置でsurface のタッチポイントid に対して touch moved イベントを送信します。

注意: タッチイベントの送信が終了したら、タッチフレームイベントを送信する必要があります。

警告 このAPIは、WaylandQuickItem::touchEventsEnabled を使用したタッチイベントの転送と組み合わせて使用しないでください。

タッチモーションイベントのシリアルを返します。


uint sendTouchPointPressed(WaylandSurface surface, int id, point position)

surface 上のタッチポイントid の押されたタッチイベントをposition の位置で送信します。

注意: タッチイベントを送信し終わったら、タッチフレームイベントを送信する必要があります。

警告 このAPIは、WaylandQuickItem::touchEventsEnabled を使用したタッチイベントの転送と組み合わせて使用しないでください。

touch downイベントのシリアルを返します。


void sendTouchPointReleased(WaylandSurface surface, int id, point position)

surface 上のタッチポイントid に対して、position の位置でタッチ解除イベントを送信します。

注意: タッチイベントを送信し終わったら、タッチフレームイベントを送信する必要があります。

警告 このAPIは、WaylandQuickItem::touchEventsEnabled を使用したタッチイベントの転送と組み合わせて使用しないでください。

touch upイベントのシリアルを返します。


[since 6.7] void sendUnicodeKeyPressEvent(uint unicode)

UCS4unicode のキー押下イベントをテキスト入力プロトコルで送信する。

注意: クライアントが、コンポジターがサポートしているテキスト入力プロトコルをサポートしていない場合、この関数は正しく動作しません。

このメソッドは Qt 6.7 で導入されました。


[since 6.7] void sendUnicodeKeyReleaseEvent(uint unicode)

UCS4unicode のキーリリースイベントをテキスト入力プロトコルで送信します。

注意: クライアントが、コンポジターがサポートしているテキスト入力プロトコルをサポートしていない場合、この関数は正しく動作しません。

このメソッドは Qt 6.7 で導入されました。


本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。