描画ツール モジュールでの対話式操作の種類とキーボード ショートカット

この記事では、マウス、タッチ スクリーン、またはキーボード ショートカットを使用して図形を描画および編集するためのさまざまな方法について、概要を説明します。

描画マネージャーでは、図形を描画するためにマップを対話式に操作する 3 つの異なる方法がサポートされています。

• click - マウスまたはタッチでクリックしたときに座標が追加されます。
• freehand - マウスまたはタッチでマップ上にドラッグしたときに座標が追加されます。
• hybrid - マウスまたはタッチでクリックまたはドラッグしたときに座標が追加されます。

図形を描画する方法

図形を描画する前に、描画マネージャーの drawingMode オプションを、サポートされている描画設定に設定します。 この設定は、プログラムで行うことも、ツール バーのいずれかの描画ボタンを押して行うこともできます。 描画モードは、図形が描画された後も有効なままであるため、同じ種類の図形をさらに描画することが簡単になります。 プログラムによって描画モードをアイドル状態に設定します。 または、ツール バーの現在の描画モード ボタンを選択して、アイドル状態に切り替えます。

次のセクションでは、図形をマップに描画するさまざまな方法の概要を示します。

点を描画する方法

描画マネージャーが draw-point 描画モードの場合は、次の操作を実行することでマップ上にポイントを描画できます。 これらの方法は、すべての対話式操作モードで使用できます。

描画の開始

• マウスの左ボタンを選択するか、またはマップをタッチして、マップに点を追加します。
• マウスがマップの上にある場合は、F キーを押すと、マウス ポインターの座標に点が追加されます。 この方法では、マップにポイントを追加する際の精度が高くなります。 マウスの左ボタンを押す動作により、マウスの移動が少なくなります。
• クリックするか、タッチするか、F キーを押すことによって、続けてマップにポイントを追加します。

描画の完了

• 描画ツール バーにある任意のボタンを選択します。
• プログラムによって描画モードを設定します。
• C キーを押します。

描画の取り消し

• Escape キーを押します。

線を描画する方法

描画マネージャーが draw-line モードの場合は、対話式操作モードに応じて、次のアクションを実行してマップ上のポイントを描画できます。

描画の開始

• クリック モード
  • マウスの左ボタンを選択するか、またはマップをタッチして、マップ上に線の各点を追加します。 クリックまたはタッチするごとに、線に座標が追加されます。
  • マウスがマップの上にある場合は、F キーを押すと、マウス ポインターの座標に点が追加されます。 この方法では、マップにポイントを追加する際の精度が高くなります。 マウスの左ボタンを押す動作により、マウスの移動が少なくなります。
  • 必要なすべてのポイントが線に追加されるまで、クリックを続けます。
• フリーハンド モード
  • マウスの左ボタンを押すか、マップ上でタッチダウンして、マウスまたはタッチ ポイントをドラッグします。 マウスまたはタッチ ポイントがマップ内を移動すると、線に座標が追加されます。 マウスまたはタッチアップ イベントがトリガーされるとすぐに、描画が完了します。 描画マネージャーの freehandInterval オプションによって、座標が追加される頻度が定義されます。
• ハイブリッド モード
  • 1 本の線を描画するときに、必要に応じてクリックとフリーハンドの方法を切り替えます。 たとえば、いくつかのポイントをクリックした後、マウスを押しながらドラッグして一連のポイントを追加し、さらにいくつかのポイントをクリックします。

描画の完了

• ハイブリッド モードまたはクリック モード
  • 最後のポイントでマップをダブルクリックします。
  • 描画ツール バーの任意のボタンをクリックします。
  • プログラムによって描画モードを設定します。
• フリーハンド モード
  • マウスのボタンまたはタッチ ポイントを離します。
• C キーを押します。

描画の取り消し

• Escape キーを押します。

多角形を描画する方法

描画マネージャーが draw-polygon モードの場合は、対話式操作モードに応じて、次のアクションを実行してマップ上のポイントを描画できます。

描画の開始

• クリック モード
  • マウスの左ボタンを選択するか、またはマップをタッチして、マップ上に多角形の各点を追加します。 クリックまたはタッチするごとに、多角形に座標が追加されます。
  • マウスがマップの上にある場合は、F キーを押すと、マウス ポインターの座標に点が追加されます。 この方法では、マップにポイントを追加する際の精度が高くなります。 マウスの左ボタンを押す動作により、マウスの移動が少なくなります。
  • 必要なすべてのポイントが多角形に追加されるまで、クリックを続けます。
• フリーハンド モード
  • マウスの左ボタンを押すか、マップ上でタッチダウンして、マウスまたはタッチ ポイントをドラッグします。 マウスまたはタッチ ポイントがマップ内を移動すると、多角形に座標が追加されます。 マウスまたはタッチアップ イベントがトリガーされるとすぐに、描画が完了します。 描画マネージャーの freehandInterval オプションによって、座標が追加される頻度が定義されます。
• ハイブリッド モード
  • 1 つの多角形を描画するときに、必要に応じてクリックとフリーハンドの方法を切り替えます。 たとえば、いくつかのポイントをクリックした後、マウスを押しながらドラッグして一連のポイントを追加し、さらにいくつかのポイントをクリックします。

描画の完了

• ハイブリッド モードまたはクリック モード
  • 最後のポイントでマップをダブルクリックします。
  • 多角形の最初の点をクリックします。
  • 描画ツール バーの任意のボタンをクリックします。
  • プログラムによって描画モードを設定します。
• フリーハンド モード
  • マウスのボタンまたはタッチ ポイントを離します。
• C キーを押します。

描画の取り消し

• Escape キーを押します。

四角形を描画する方法

描画マネージャーが draw-rectangle モードの場合は、対話式操作モードに応じて、次のアクションを実行してマップ上のポイントを描画できます。 生成される図形は、四角形の拡張 GeoJSON 仕様に従います。

描画の開始

• マップ上でマウスの左ボタンを押すかタッチダウンして四角形の最初の角を追加し、ドラッグして四角形を作成します。

描画の完了

• マウスのボタンまたはタッチ ポイントを離します。
• プログラムによって描画モードを設定します。
• C キーを押します。

描画の取り消し

• Escape キーを押します。

円を描画する方法

描画マネージャーが draw-circle モードの場合は、対話式操作モードに応じて、次のアクションを実行してマップ上のポイントを描画できます。 生成される図形は、円の拡張 GeoJSON 仕様に従います。

描画の開始

• マップ上でマウスの左ボタンを押すかタッチダウンして円の中心を追加し、ドラッグして円の半径を指定します。

描画の完了

• マウスのボタンまたはタッチ ポイントを離します。
• プログラムによって描画モードを設定します。
• C キーを押します。

描画の取り消し

• Escape キーを押します。

キーボード ショートカット

描画ツールでは、キーボード ショートカットがサポートされています。 これらのキーボード ショートカットは、マップにフォーカスがあるときに機能します。

Key	アクション
C	進行中の描画を完了し、描画モードをアイドル状態に設定します。 フォーカスは、最上位レベルのマップ要素に移動します。
Escape	進行中の描画を取り消し、描画モードをアイドル状態に設定します。 フォーカスは、最上位レベルのマップ要素に移動します。
F	マウスがマップ上にある場合、ポイント、線、または多角形に座標を追加します。 クリック モードまたはハイブリッド モードのときにマップをクリックした場合と同等のアクションです。 このショートカットを使用すると、より正確で高速な描画を行うことができます。 一方の手でマウスの位置を決め、押すジェスチャでマウスを動かすことなく、もう一方の手でボタンを押すことができます。
Delete または Backspace	図形が編集モードの間に選択された場合は、それらを削除します。

次のステップ

描画ツール モジュールのクラスについて詳細を確認します。

描画マネージャー

描画ツール バー