Mac OS X Porting - Keyboard Shortcuts
Contributors
Introduction
For most of the keyboard shortcuts in OpenOffice.org, the Mac OS X port will follow the other OpenOffice.org platforms, to maintain consistency and allow people to use several platforms without much re-learning.
However, there are some special cases that require Mac OS X port to make exceptions in shortcuts, compared to the other platforms:
- Mac OS X System has global keyboard shortcuts that override existing OpenOffice.org shortcuts
- Apple Human Interface Guidelines (AHIG) requires that all Mac OS X applications define certain common set of shortcuts. That common set might cause a change for shortcut to have different functionality.
Example: When the user press F9 in OpenOffice.org (native version or X11 version), the fields are not refreshed, because the Mac OS X function Exposé is launched and catches the key accelerator (to refresh the fields, go to Tools>Refresh>Fields in the menu. What we have to do is to change the conflicting key accelerators for OpenOffice.org.
Mac OS X Shortcuts (under construction)
Introduction
This new section marked with under construction will contain as many as possible shortcuts available on Mac OS X. All these shortcuts are Apple HIG compliant and we should check them in OO.o and fix them if they do not work as expected.
Sections
Please, split shortcuts to smaller sections to make it easily editable. It's a pain to edit one long table. Thanks.
How to edit
Copy complete specification of shortcuts from Apple HIG to this wiki page and add red comments if something's wrong. If we use this way, we can have idea how it should work, how it works and what to fix.
Common shortcuts
This section contains common shortcuts for all OpenOffice.org applications.
Moving the insertion point with the arrow keys
Moving the insertion point | ||
---|---|---|
Status | Key | Moves insertion point |
OK | Right Arrow | One character to the right |
OK | Left Arrow | One character to the left |
OK | Up Arrow | To the line above, to the nearest character boundary at the same horizontal location |
OK | Down Arrow | To the line below, to the nearest character boundary at the same horizontal location |
EE | Option–Right Arrow | To the end of current word, then to the end of the next word It moves to the beginning of next word, then to the beginning of the next word |
OK | Option–Left Arrow | To the beginning of the current word, then to the beginning of the previous word |
OK | Option–Up Arrow | To the beginning of the current paragraph, then to the beginning of the previous paragraph |
EE | Option–Down Arrow | To the end of the current paragraph, then to the end of the next paragraph (not to the blank line after the paragraph, if there is one) Blank line is not skipped |
EE | Command–Right Arrow | To the next semantic unit, typically the end of the current line, then the end of the next line Doesn't work for next lines. It jumps to the end of the current line, but not to the ends of next lines. |
EE | Command–Left Arrow | To the previous semantic unit, typically the beginning of the current line, then the previous unit Doesn't work for previous lines. It jumps to the beginning of the current line, but not to the beginnings of previous lines. |
OK | Command–Up Arrow | Upward in the next semantic unit, typically the beginning of the document |
OK | Command–Down Arrow | Downward in the next semantic unit, typically the end of the document |
Exception: For non-Roman script systems, Command–Left Arrow and Command–Right Arrow are reserved for changing the direction of keyboard input.
Reserved shortcuts
Don’t use the keys and key combinations in Table below for actions other than those listed in the table.
Reserved shortcuts | ||
---|---|---|
Status | Keys | Action |
OK | Esc | Cancel the current action |
OK | Command-Tab | Activate the most recently used open application |
OK | Command-Shift-Tab | Activate the least recently used open application |
OK | Command-Option-D | Show or hide the Dock |
OK | Command-H | Hide the active application |
OK | Command-Option-H | Hide other applications (all but the active one) |
OK | Command-Shift-Q | Log out OO.o: Interrupt Macro |
OK | Command-Shift-Option-Q | Log out without confirmation |
OK | Command-Shift-Option-Control-Q | Force log out without confirmation |
OK | Command–Space bar | Show or hide Spotlight search field |
OK | Command-Option-Esc | Open the Force Quit dialog |
EE | Command-F5 | Turn VoiceOver on or off OO.o: Control Focus |
OK | Control-F1 | Turn full keyboard navigation on or off |
OK | Control-F7 | Toggle keyboard navigation in windows and dialogs |
EE | F9 | Tile or untile all open windows Writer: Fields |
OK | F10 | Tile or untile all open windows in current application |
EE | F11 | Hide or show all open windows Writer, Calc: Styles and Formatting |
EE | F12 | Display or hide Dashboard Writer: Numbering On/Off |
Application specific shortcuts
TODO - Application specific shortcuts only.
Shortcuts intercepted by Mac OS X
TODO - List of shortcuts they are intercepted by Mac OS X (F9 Expose) and they don't work in OO.o.
Mac OS X Shortcuts
The following table describes the differences in keyboard shortcuts and the reasons for the changes. For detailed information, see: Apple Human Interface Guidelines, AHIG for key accelerators and menus and for menu examples
Generic OpenOffice.org | |||
---|---|---|---|
Functionality | Ideal OpenOffice.org | OpenOffice.org Aqua | Reason |
Main command key | Command (CMD) the "Apple" key |
Command (CMD) the "Apple" key (implementation in progress) |
In Mac OS X, the Command -modifier is the logical equivalent of Control modifier in Windows and Linux |
Function keys | F1 - F12 | - | Function keys in Mac OS X have system-wide functionality (like F9 for Exposé) |
Spotlight search | CMD-Space | - | This shortcut is used system-wide in Mac OS X |
Apple reserved | CMD-Shift-Space | - | This shortcut is used system-wide in Mac OS X (see Apple shortcut documentation) |
Preferences... access to settings |
CMD-, i.e. comma |
CMD-, same shortcut |
AHIG, system-wide standard. Mac OS X: Preferences... in (System-wide) Application menu, i.e. the "Apple-menu" OOo: Tools > Options |
Help | CMD-? i.e. question mark |
F1 | AHIG, system-wide standard |
Undo | CMD-Z | CMD-Z | AHIG, system-wide standard |
Redo | CMD-SHIFT-Z | CMD-Y | AHIG, system-wide standard |
Spellcheck | CMD-; i.e. semicolon |
F7 | AHIG, system-wide standard. Mac OS X: Edit > Spellcheck |
Non-breaking space | Option-Space | CTRL-Space | conflicts with Mac OS X System. See also Wikipedia:Non-breaking space |
Close | CMD-W Close in File -menu |
CTRL-F4 and CTRL-W | AHIG, system-wide standard. OOo: window > Close window with the key accelerator and File > Close without key accelerator. |
Minimize minimize window |
CMD-M Minimize in Window -menu |
?? | AHIG, system-wide standard. |
Hide hide window |
CMD-H Hides the Window |
CMD-H Hides the Window |
AHIG, system-wide standard. |
Copy copy |
CMD-C Copy |
CMD-C Copy |
AHIG, system-wide standard. |
Paste paste |
CMD-V paste |
CMD-V paste |
AHIG, system-wide standard. |
Paste and Match style | CMD-SHIFT-OPTION-V Paste and Match style in Edit -menu |
- Paste Special -> Unformatted text in Edit -menu |
There is no direct command in OOo. CTRL-SHIFT-V activates the paste special dialog. However, the "Paste and Match style" should have shortcut as the text is more intuitive and is very handy when copy-pasting between different documents. |
Open open' |
CMD-O Open |
CMD-O Open |
AHIG, system-wide standard. |
Print |
CMD-P |
CMD-P |
AHIG, system-wide standard. |
Save | CMD-S save | CMD-S save | AHIG, system-wide standard. |
Save As | CMD-SHIFT-S | - | AHIG, system-wide standard. |
Left-align | CMD-{ i.e. left bracket |
CTRL-l | AHIG, system-wide standard |
Right-align | CMD-} i.e. right bracket |
CTRL-r | AHIG, system-wide standard |
Align to center | CMD-| i.e. pipe |
CTRL-e | AHIG, system-wide standard |
Decrease size of the selected item | CMD-- | ?? | AHIG, system-wide standard. Apple Pages: Format > Font > Smaller Equivalent of the Smaller command in OpenOffice.org |
Increase size of the selected item | CMD-+ | ?? | AHIG, system-wide standard. Apple Pages: Format > Font > Bigger Equivalent of the ?? command in OpenOffice.org |
Conditional hyphen | ?? | CTRL-- | conflicts with AHIG |
OpenOffice.org Writer | |||
Functionality | OpenOffice.org Mac OS X | OpenOffice.org | Reason |
Refresh fields | ?? | F9 | Conflicts with Mac OS X system. OOo: Tools > Refresh > Fields |
Style dialog | CMD-SHIFT-T | F11 | Conflicts with Mac OS X system. Apple Pages: View > Show Styles Drawer |
Default format in Format -menu | - | CTRL-SHIFT-Space | Conflicts with Apple reserved shortcut, see Apple shortcut documentation Apple Pages: Format > Reapply Defaults to Selection OOo: Format > Default format |
OpenOffice.org Calc | |||
Functionality | OpenOffice.org Mac OS X | OpenOffice.org | Reason |
Recalculate the cell content | ?? | F9 | Conflicts with Mac OS X system. OOo: Tools > Cell content > Recalculate |
Group (data) | ?? | F12 | Conflicts with Mac OS X system. OOo: Data > Plan > Group |