Skip to content

Keyboard Shortcuts JP

Jump to bottom
Hiromichi Yokoyama edited this page Aug 4, 2026 · 2 revisions

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

このページは、MoleditPy のメインウィンドウ (ui/main_window_init.py) と 2D エディタの keyPressEvent ハンドラ (ui/molecular_scene_handler.py、キーマップ定義は ui/molecule_scene.py) に実装されている、すべてのキーボードショートカットの完全なリファレンスです。既存の Shortcut-* ページは デスクトップのランチャーアイコン（.exe へのファイル関連付けなど）を作成する方法についてのページであり、本ページとはまったく別の話題なので混同しないでください。

プラグインも context.add_menu_action(path, callback, shortcut=...)（ui/plugin_menu_manager.py 参照）で独自のショートカットを登録できます。これらは導入しているプラグインによって変わるため本ページには含まれません — Plugin メニューの各項目にショートカットが割り当てられていれば、項目名の横に表示されます。

1. 2D エディタ — カーソル位置に応じたキー操作

これらは 2D シーンの keyPressEvent が直接処理しており、マウスカーソルが 2D キャンバス上にある場合（選択に基づく操作の場合は選択中のアイテムがある場合）にのみ発火します。ほとんどのキーは マウスカーソルの直下にある原子/結合 に作用し、なければ現在の選択範囲に作用します。

1.1 カーソル下の元素を変更 / 原子描画モードへの切り替え

カーソルが原子の上にあれば、以下のキーでその場で元素を変更します。カーソルが空白キャンバス上にあれば、同じキーで「この元素を配置する」描画モードに切り替わります。

キー 元素
C 炭素
N 窒素
O 酸素
S 硫黄
F フッ素
B ホウ素
I ヨウ素
H 水素
P リン
Shift+C 塩素 (Cl)
Shift+B 臭素 (Br)
Shift+S ケイ素 (Si)

1.2 カーソル下または選択中の結合の結合次数/立体化学

1本以上の結合が選択されているか、カーソルが結合上にホバーしていれば、これらのキーでその次数/立体表示を変更します。結合はデータモデル内の (atom1_id, atom2_id) を双方向で照合して特定されます。

キー 効果
1 単結合にする（立体表示はクリア）
2 二重結合にする（立体表示はクリア）
3 三重結合にする（立体表示はクリア）
W くさび形（Wedge）立体結合にする（既にくさび形の結合にもう一度押すと、始点/終点原子を入れ替えて向きを反転）
D 破線（Dash）立体結合にする（同様に、もう一度押すと向きを反転）
Z ホバー中の二重結合のみ対象：Z（シス）配置にする
E ホバー中の二重結合のみ対象：E（トランス）配置にする

対象となる結合がない場合、1/2/3 は §1.3（現在の原子から新規原子・結合を追加する処理）にフォールスルーします。

1.3 現在の原子から原子・結合を追加

カーソルが原子上にある（または原子が1つだけ選択されている）状態で、かつ §1.2 の対象となる結合がない場合、1/2/3 はその原子からその次数の新しい結合を作成します：スナップ許容範囲（設定 bond_snapping_distance_2d、既定値 14.0 px）内に既存の原子が見つかればそれに結合し、なければ計算された位置に新しい炭素原子を作成して結合します。単結合・二重結合の連続配置では配置方向（時計回り/反時計回り）が交互に切り替わり、自然なジグザグ形状になります（三重結合ではこの交互切り替えは行われません）。

1.4 ホバー中/選択中の原子の電荷・ラジカル

キー 効果
+ 形式電荷を +1
- 形式電荷を -1
.（ピリオド） ラジカル電子数を 0 → 1 → 2 → 0 の順に循環

選択があればすべての選択中 AtomItem に、なければカーソル下の原子に適用されます。

1.5 ベンゼン環テンプレートのワンショット配置

キー 効果
4 カーソルが既存の原子または結合の上にある場合：ベンゼン環テンプレートをドラッグしたときと同じライブプレビューの幾何計算で、その場に一発でベンゼン環を配置（融合）します。カーソルが空白キャンバス上にある場合：現在のモードをベンゼン環テンプレート配置モードに切り替えます（テンプレートツールバーのベンゼンボタンをクリックしたのと同じ）。

1.6 削除・キャンセル

キー 効果
Delete / Backspace 結合を描画中（一時的なラバーバンド線が表示されている状態）であれば、そのドラッグ操作をキャンセルします。それ以外の場合、選択中のすべての原子・結合と、カーソル下のアイテム（あれば）を削除します。これによりキャンバスが空になった場合、シーン全体をクリアして再初期化します。

1.7 選択モード / 全選択

キー 効果
Space 選択モードでない場合：選択モードに切り替えます。すでに選択モードの場合：すべての原子・結合を選択します（Edit ▸ Select All と同じ）。

1.8 グローバルなモード切り替え（フォールバック）

上記のいずれにも該当せず、かつ Shift 以外の修飾キーが押されていない場合、元素キー（§1.1）や結合次数キーは、カーソル下の対象に作用する代わりに 以後のクリックのための描画モード を切り替えます — これが、何も選択されておらずカーソルが原子上にもないときの 1/2/3 の挙動です。

内部的には生のキー→結合モードのマップ（ui/molecule_scene.py の key_to_bond_mode_map）に、さらに 4 → Wedge、5 → Dash へのモード切り替えエントリが定義されています。4 は実際には到達不能です（§1.5 のベンゼンワンショット処理が先に横取りするため）が、5 は実際に機能します：修飾キーなしで、かつ結合/原子ターゲットがこのキーを先に消費しなければ、5 キーを押すと現在の描画モードが破線結合（Dash）配置に切り替わります。これはどのツールバーボタンのショートカット表示にも出ていません — 単なる裸のキー入力としてのみ機能します。

1.9 Alt キー — テンプレートの自動融合を抑制

環テンプレートを配置する際（またはライブプレビューを移動する際）に Alt を押しておくと、テンプレートプレビューを既存の結合上にドロップしたときに通常発動する自動的な二重結合/融合調整ロジック（設定 template_fusing_enabled_2d）が抑制されます。これは単独のショートカットではなく、ドラッグ中に押しておく修飾キーです。

2. メニューショートカット（グローバル、ui/main_window_init.py で定義）

これらは標準の QAction ショートカットで、（2D キャンバスに限定されず）メインウィンドウのどこでも有効です。

File メニュー

ショートカット アクション
Ctrl+N 新規作成
Ctrl+O プロジェクトを開く...
Ctrl+S プロジェクトを保存
Ctrl+Shift+S プロジェクトに名前を付けて保存...
Ctrl+Q 終了

（インポート/エクスポートのサブメニュー — MOL/SDF、SMILES、InChI、3D MOL/XYZ、PME Raw、PNG/SVG、STL、OBJ/MTL — にはショートカットが ありません。メニューからのみアクセスできます。）

Edit メニュー

ショートカット アクション
Ctrl+Z（プラットフォーム標準の Undo） 元に戻す
プラットフォーム標準の Redo（Windows では Ctrl+Y、macOS/Linux では Ctrl+Shift+Z） やり直し
Ctrl+X（プラットフォーム標準の Cut） 切り取り
Ctrl+C（プラットフォーム標準の Copy） コピー
Ctrl+V（プラットフォーム標準の Paste） 貼り付け
Ctrl+R 2D を回転...（2D 回転ダイアログを開く）
Ctrl+J 2D をクリーンアップ（Edit ▸ Clean Up 2D、RDKit の Compute2DCoords による再レイアウト）
Ctrl+K 2D を 3D に変換
Ctrl+L 3D を最適化
Ctrl+A（プラットフォーム標準の SelectAll） すべて選択
Ctrl+Shift+C すべてクリア

Add Hydrogens（水素を追加）と Remove Hydrogens（水素を削除）にはショートカットがありません。

注意： 3D カメラのリセットのショートカットは View メニューの Ctrl+Shift+R です（下記参照）。Ctrl+R ではありません — Ctrl+R は「2D を回転...」です。MoleditPy の古いドキュメント（4.x 以前）では Ctrl+R が「Reset 3D View」と記載されている場合がありますが、これはその後 Ctrl+Shift+R に移動しています。

View メニュー

ショートカット アクション
プラットフォーム標準の ZoomIn（通常 Ctrl++） ズームイン — 2D ビューを ×1.2 に拡大
プラットフォーム標準の ZoomOut（通常 Ctrl+-） ズームアウト — 2D ビューを ÷1.2 に縮小
Ctrl+0 ズームをリセット — 2D ビューの変換を固定の 0.75 倍にリセット
Ctrl+9 ビューに合わせる — 表示中の 2D シーンのすべてのアイテムをビューポートに収める（シーンが空の場合はズームリセットにフォールバック）
Ctrl+Shift+R 3D ビューをリセット — 3D ビューの plotter.reset_camera() を呼び出す
Ctrl+1 パネルレイアウト：均等（50:50）
Ctrl+2 パネルレイアウト：2D フォーカス（70:30）
Ctrl+3 パネルレイアウト：3D フォーカス（30:70）
Ctrl+H 2D パネルの表示/非表示切り替え

Redraw 3D Molecule（3D 分子を再描画）、キラルラベルの表示切り替え、原子情報表示のサブメニュー（Show Index / Original ID / XYZ Index / Coordinates / Element Symbol）、0-based/1-based インデックス切り替えにはショートカットがありません。

Analysis / 3D Edit / Settings / Help メニュー

Analysis メニュー（Show Analysis...）、3D Edit メニュー（Translation...、Move Selected Atoms...、Move Group...、Align to ▸ Axis/Plane、Mirror...、Planarize...、Adjust Bond Length/Angle/Dihedral Angle...、Constrained Optimization...）、Plugin ▸ Plugin Manager...、Settings メニュー、Help メニュー（About、GitHub、GitHub Wiki、User Manual）のいずれの項目にもキーボードショートカットは割り当てられていません — メニューからのみ実行できます。Reset All Settings も同様にメニュー専用です。

3. 3D ビューのマウス/修飾キー操作

厳密には「キーボードショートカット」ではありませんが、上記としばしば混同されるため 3D ビュー側の対応表としてここに記載します。

入力 効果
左ドラッグ 3D ビューを回転
マウスホイール / Ctrl+ホイール ズーム
中ボタンドラッグ、または Shift+左ドラッグ パン（移動）
ツールバーの 3D Select トグル 原子ピッキング/測定モードに入る（2/3/4原子選択で距離/角度/二面角を表示）。ショートカットはなくツールバーボタンのみ
ツールバーの 3D Drag トグル、または Alt 押しっぱなし 3D 原子ドラッグモードに入る（または Alt を押している間だけ一時的に入る）：3D ビュー内で原子をクリックドラッグして移動し、接続されているすべての部分も一緒に動かす

4. 実用上の注意点

  • keyPressEvent 内でショートカットは厳密な優先順位で消費されます：ベンゼンワンショット（4）→ ラジカル（.）→ 電荷（+/-）→ 原子記号変更 → 結合次数/立体表示変更 → ホバー時の Z/E → 結合次数からの新規原子追加 → 削除/キャンセル → Space → グローバルモード切り替え。想定より前段のルールにキーを消費されることがあります — 例えば結合が選択されている場合、1/2/3 は常にその結合の次数変更を優先し、新しい原子の追加にはなりません。
  • 2D エディタのキー処理はすべて、2D パネルが編集可能な状態（ui_manager.is_2d_editable）であることが前提です。Import ▸ 3D MOL/SDF や 3D XYZ（2D エディタをクリアする）で 3D ビューア専用モードに入ると、新しい 2D 構造の作成を始めるまでこれらのキーは反応しなくなります。
  • 標準キー系のショートカット（Undo、Redo、Cut、Copy、Paste、SelectAll、ZoomIn、ZoomOut）は Qt の QKeySequence.StandardKey を通じて解決されるため、実際のキーの組み合わせはハードコードされておらず OS の慣習に従います（例：macOS では Ctrl の代わりに Cmd）。

5. 関連ページ

Clone this wiki locally