DragStarted

ユーザーが、マウスボタンを押したままマウスを移動させたとき、つまりドラッグ動作を開始したときに発生するイベント。

このイベントは、マウスボタンを 1 回だけ押してからドラッグ操作を開始した場合にのみ発生します。マウスボタンを短時間内に連続して 2 回押した後にドラッグ操作を開始した場合には、このイベントは発生しません。

注意事項

DragStarted イベントは、多くの場合 GuiManager.start-drag-drop の呼び出しにより処理されます。

GuiEventTarget.on-drag-started は DragStarted 用の スタティックイベントハンドラ です。

詳細情報は、『Curl 開発者ガイド』の「ドラッグアンドドロップ」の章を参照してください。

新しい DragStarted オブジェクトを作成します。

このイベントに関連付けられている ImplicitPointerGrabManager。

注意事項

この ImplicitPointerGrabManager は、必要に応じてこのイベントから取り出され、後の使用のために保存されます。

このメソッドは GuiEvent オブジェクトの状態をクリアするために gui-toolkit で呼び出されます。

注意事項

既定の実装では GuiEvent.consumed? フィールドを false に設定します。

オーバーライド

サブクラスでは、追加されるすべての状態がクリアされるようこのメソッドをオーバーライドしてください。また、基本クラスでクリアすべきすべての状態がクリアされるように、スーパー実装を呼び出す必要もあります。

現在の暗黙的なポインタグラブに対するグラブオブジェクトを指定します。

v: グラブオブジェクトになるオブジェクト。

注意事項

このイベントの処理が終了するまでの間に、現在の暗黙的なポインタグラブにグラブオブジェクトが指定されなかった場合、DragStarted.release-implicit-pointer-grab が呼び出されたかのように、その暗黙的なポインタグラブはキャンセルされます。

このメソッドの詳細な情報については、PointerPress.continue-implicit-pointer-grab を参照してください。

この Event のスタティックイベントハンドラを起動します。

target: この Event を処理する GuiEventTarget。

プログラミング注意事項

このメソッドは、この Event のスタティックイベントハンドラを呼び出すときに、GuiEventTarget.handle-event によって呼び出されます。このメソッドは、適切なスタティックイベントハンドラがすべて呼び出された後に返します。

オーバーライド

このメソッドは、それ自身のスタティックイベントハンドラに関連付けられた Event のすべてのサブクラスでオーバーライドされます。E クラスで定義されたオーバーライドメソッドは、次のテンプレートに従う必要があります。

{method protected {fire-methods target:GuiEventTarget}:void
    {target.on-E self}
    {super.fire-methods target}
}

ここで、on-E は E クラスに関連付けられたスタティックイベントハンドラ名です。fire-methods 内のメソッド呼び出しは、Curl 言語のスタティックイベントハンドラ呼び出し順位の規則 (最も用途の特定されたものから最も一般的な用途のもの) に従って順序付ける必要があります。