From 0e004c696b0e68b2cff37a4c3315b022a35eaf43 Mon Sep 17 00:00:00 2001 From: Perberos Date: Thu, 1 Dec 2011 22:24:23 -0300 Subject: moving from https://github.com/perberos/mate-desktop-environment --- docs/key_mouse_navigation.txt | 112 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 112 insertions(+) create mode 100644 docs/key_mouse_navigation.txt (limited to 'docs/key_mouse_navigation.txt') diff --git a/docs/key_mouse_navigation.txt b/docs/key_mouse_navigation.txt new file mode 100644 index 00000000..d111f43e --- /dev/null +++ b/docs/key_mouse_navigation.txt @@ -0,0 +1,112 @@ +This document describes the keyboard and mouse navigation model used +in the default Caja views in detail. This is useful as a a guide +for people implementing a Caja view or something else that wants +to have a feel that is compatible with Caja. + +*********** Icon view ******************** + +Keyboard: +========= + +Navigation and selection: + +When the focus is on the icon view you can move the currently selected +icon by using: + +Arrow Keys - moves one step in the direction +Tab - moves to the "next" icon in order (i.e. at the end of one row, + go to the first icon the next row) +Shift Tab - moves to the "previous" icon in order +Home - moves to the first icon +End - moves to the last icon + +In order to allow multiple selection the above navigation keys can be +combined with the Control key to move the keyboard focus without +affecting the current selection. If you use normal movement (not using +control) all the previously selected icons will be deselected. + +If several icons are selected and there is no keyboard focus you press +up or left will start navigating from the topmost leftmost icon, while +pressing down or right will start from the bottommost rightmost +icon. This works the same way if you hold down Control. + +To select or deselect an icon position the keyboard focus on it and +press ctlr-space. ctrl-space with no keyboard focus produces a +keyboard focus at the first selected icon, or the first one if none +are selected. + +In manual layout (and especially, on the desktop) the keyboard arrow +keys work in a slightly different way. To allow all icons to be +reached the closest icon in the quadrant of the direction selected +will be used as the "next" icon when navigating. + +Other keyboard shortcuts: + +Return, Keypad Return - Activate the selected objects +Space (without control) - Activate the selected objects +Escape - Undo icon stretching if in progress + +Alt Left - go back +Alt Right - go forward +Alt Up - go up a directory +Alt Down - enter directory / activate selection + +Shift-F10 bring up context menu for selection, or the directory context menu if nothing is selected +Ctrl-F10 bring up context menu for directory + +Other key presses are used for typeahead search + +In rename mode: + +Escape - Cancel rename +Return, Keypad Return - Finish rename + +Mouse: +====== + +In double click mode: + +Clicking on an icon selects it and deselects all others on +BUTTON_PRESS. Dragging does the default dnd file operation. + +Clicking on blank space deselect all selected icons. Doesn't allow +dragging. + +Double clicking (both clicks on the same icon) with no modifiers +activates the clicked file. (And deselects the others due to the first +click.) + +Clicking when Control (Shift can also be used, which is not written +out below) is held down can be used to do multiple selections. + +Control-click on empty space does nothing. +Control-click on unselected icon selects it on BUTTON_PRESS +Control-click on selected icon de-selects it on BUTTON_RELEASE +Control-double click does nothing +Control can be held down while starting a drag + +While doing a drag modifers affect the operation the drag causes: +Control - Copy the files +Shift - Move the files +Alt - Open a menu with the available alternatives + +All the basic clicks are typically done with the left button, but can +be done with the other buttons to. [Do we want this?] However some of +the buttons also have special operations: + +Right-click on a selected icon opens the context menu for the selected +icons. +Right-click on empty space opens the context menu for the directory. +Middle-button drag always opens the menu with possible operations on +drop. + +In single click mode: + +Single click mode work just like double click mode except single +clicks on icons activate the icon on button release if you didn't +drag, didn't hold down for 1.5 secs or clicked twice within the +double-click time. + +*********** List view ******************** + +[TODO: Add stuff here] -- cgit v1.2.1