JAL-1738 JAL-345 changed keystroke to ‘B’ (with modifiers) and added documentation
authorJim Procter <jprocter@issues.jalview.org>
Tue, 22 Nov 2016 12:41:33 +0000 (12:41 +0000)
committerJim Procter <jprocter@issues.jalview.org>
Tue, 22 Nov 2016 12:41:49 +0000 (12:41 +0000)
help/html/features/chimera.html
help/html/features/jmol.html
help/html/features/search.html
help/html/keys.html
help/html/menus/alignmentMenu.html
help/html/menus/alwselect.html
resources/lang/Messages.properties
src/jalview/gui/AlignFrame.java
src/jalview/jbgui/GAlignFrame.java

index 257c84c..cbef2c1 100644 (file)
     number and chain code ([RES]Num:Chain). Moving the mouse over an
     associated residue in an alignment window highlights the associated
     atoms in the displayed structures. When residues are selected in the
-    Chimera window, they are highlighted on the alignment. For
-    comprehensive details of Chimera's commands, refer to the tool's
-    Help menu.
-  
+    Chimera window, they are highlighted on the alignment.
+  <p>For comprehensive details of Chimera's commands, refer to the
+    tool's Help menu.</p>
   <p>
     <strong>Selecting residues in Jalview from Chimera</strong><br />
-    When a selection is highlighted in a Jalview window, use the <em>Select&#8594;Select
-      Highlighted Region</em> function to create a column selection for the
-    mapped positions in the sequence alignment.
+    When a selection is highlighted in a Jalview window, use the
+    <em>Select&#8594;Select Highlighted Region</em> or press <em>B</em>
+    to add the mapped positions to the alignment window's column
+    selection.
   </p>
   <p>
     Basic screen operations (see <a
index 2f10196..0cd6168 100644 (file)
       based structure superposition was added in Jalview 2.6</em>
   </p>
   <p>
-    <strong>Controls</strong><br> The structure is by default
-    rendered as a ribbon diagram. Moving the mouse over the structure
-    brings up tooltips giving the residue name, PDB residue number and
-    chain code, atom name and number
-    ([RES]Num:Chain.AtomName#AtomNumber). If a mapping exists to a
-    residue in any associated sequences, then this will be highlighted
-    in each one's alignment window. The converse also occurs - moving
-    the mouse over an associated residue in an alignment window
-    highlights the associated atoms in the displayed structures.
+    <strong>Controls</strong><br> The structure is by default rendered
+    as a ribbon diagram. Moving the mouse over the structure brings up
+    tooltips giving the residue name, PDB residue number and chain code,
+    atom name and number ([RES]Num:Chain.AtomName#AtomNumber). If a
+    mapping exists to a residue in any associated sequences, then this
+    will be highlighted in each one's alignment window. The converse
+    also occurs - moving the mouse over an associated residue in an
+    alignment window highlights the associated atoms in the displayed
+    structures. Press B or use
+    <em>Select&#8594;Select Highlighted columns</em> from any linked
+    alignment window to mark the columns highlighted after mousing over
+    the structure.
   </p>
   <p>Selecting a residue highlights its associated sequence residue
     and alpha carbon location. Double clicking an atom allows distances
index 9766782..82516bf 100755 (executable)
@@ -65,6 +65,17 @@ td {
     Settings&quot; under the &quot;View&quot; menu to change the
     visibility and colour of the new sequence feature.</p>
   <p>
+  <p>
+    <strong>Selecting regions from Search Results</strong>
+  </p>
+  <p>
+    Press 'B' or select the <em>Select Highlighted Columns</em> option
+    from the alignment window's select menu to add columns containing
+    highlighted search results to the alignment window's column
+    selection.
+  </p>
+  <p>
+  
     <strong>A quick Regular Expression Guide</strong>
   </p>
   <p>A regular expression is not just a simple text query - although
index 2ba9a49..b79ce4d 100755 (executable)
@@ -167,6 +167,19 @@ columns are selected, you should use the <a href="features/hiddenRegions.html">H
       <td>Both</td>
       <td>Launches the search window</td>
     </tr>
+    <tr><td><strong>B</strong></td>
+      <td>Both</td>
+      <td>Mark the currently highlighted columns</td>
+    </tr>
+    <tr><td><strong>Alt 'B'</strong></td>
+      <td>Both</td>
+      <td>Mark all but the currently highlighted columns</td>
+    </tr>
+    <tr><td><strong>Control 'B'</strong></td>
+      <td>Both</td>
+      <td>Toggle the marks on the currently highlighted 
+          columns (or all others if Alt is pressed)</td>
+    </tr>
     <tr>
       <td><strong>H</strong></td>
       <td>Both</td>
index 24f8239..167cb25 100755 (executable)
             columns in the alignment according to secondary structure,
             labels and values shown in alignment annotation rows. </em></li>
         <li><strong>Select Highlighted Columns</strong> <br /> <em>Selects
-            the columns currently highlighted as a result of a find, mouse
-            over, or selection event from a linked structure viewer or other
-            application. Modifiers will work on some platforms: SHIFT will
-            add columns to selection, ALT will invert the highlighted set
-            before selection, and CTRL (or META) will toggle the selection.
-        </em></li>
+        the columns currently highlighted as a result of a find, mouse
+        over, or selection event from a linked structure viewer or other
+        application. Modifiers will work on some platforms: ALT will add
+        all but the highlighted set to the column selection, and CTRL
+        (or META) will toggle the selection. </em></li>
       </ul></li>
     <li><strong>View</strong>
       <ul>
index 0318818..07828a3 100644 (file)
     <li><strong>Select Highlighted Columns</strong> <br /> <em>Selects
         the columns currently highlighted as a result of a find, mouse
         over, or selection event from a linked structure viewer or other
-        application. Modifiers will work on some platforms: SHIFT will
-        add columns to selection, ALT will invert the highlighted set
-        before selection, and CTRL (or META) will toggle the selection.
-    </em></li>
+        application. Modifiers will work on some platforms: ALT will add
+        all but the highlighted set to the column selection, and CTRL
+        (or META) will toggle the selection. </em></li>
   </ul>
 </body>
 </html>
index 8739d74..b3f02a0 100644 (file)
@@ -126,6 +126,7 @@ action.colour = Colour
 action.calculate = Calculate
 action.select_all = Select all
 action.select_highlighted_columns = Select Highlighted Columns
+tooltip.select_highlighted_columns = Press B to mark highlighted columns, Ctrl-B to toggle, and Alt-B to mark all but highlighted columns 
 action.deselect_all = Deselect all
 action.invert_selection = Invert selection
 action.using_jmol = Using Jmol
index 8a09c1d..6a389b6 100644 (file)
@@ -669,6 +669,16 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener,
           toggleHiddenRegions(toggleSeqs, toggleCols);
           break;
         }
+        case KeyEvent.VK_B:
+        {
+          boolean toggleSel = evt.isControlDown() || evt.isMetaDown();
+          boolean modifyExisting = true; // always modify, don't clear
+                                         // evt.isShiftDown();
+          boolean invertHighlighted = evt.isAltDown();
+          avc.markHighlightedColumns(invertHighlighted, modifyExisting,
+                  toggleSel);
+          break;
+        }
         case KeyEvent.VK_PAGE_UP:
           if (viewport.getWrapAlignment())
           {
@@ -5934,10 +5944,11 @@ public class AlignFrame extends GAlignFrame implements DropTargetListener,
   protected void selectHighlightedColumns_actionPerformed(
           ActionEvent actionEvent)
   {
+    // include key modifier check in case user selects from menu
     avc.markHighlightedColumns(
             (actionEvent.getModifiers() & ActionEvent.ALT_MASK) != 0,
-            (actionEvent.getModifiers() & ActionEvent.SHIFT_MASK) != 0,
-            (actionEvent.getModifiers() & ActionEvent.CTRL_MASK) != 0);
+            true,
+            (actionEvent.getModifiers() & (ActionEvent.META_MASK | ActionEvent.CTRL_MASK)) != 0);
   }
 }
 
index d6474f1..af8a172 100755 (executable)
@@ -2182,9 +2182,9 @@ public class GAlignFrame extends JInternalFrame
       }
     });
     JMenuItem selectHighlighted = new JMenuItem(
-            MessageManager.getString("label.select_highlighted_columns"));
-    keyStroke = KeyStroke.getKeyStroke(KeyEvent.VK_L, Toolkit
-            .getDefaultToolkit().getMenuShortcutKeyMask(), false);
+            MessageManager.getString("action.select_highlighted_columns"));
+    selectHighlighted.setToolTipText(MessageManager
+            .getString("tooltip.select_highlighted_columns"));
     al = new ActionListener()
     {
       @Override
@@ -2193,8 +2193,7 @@ public class GAlignFrame extends JInternalFrame
         selectHighlightedColumns_actionPerformed(actionEvent);
       }
     };
-    addMenuActionAndAccelerator(keyStroke, selectHighlighted, al);
-
+    selectHighlighted.addActionListener(al);
     JMenu tooltipSettingsMenu = new JMenu(
             MessageManager.getString("label.sequence_id_tooltip"));
     JMenu autoAnnMenu = new JMenu(