Hotkeys

Top  Previous  Next

Every Command in TextWorx may be assigned it's own Global Hotkey.

 

Remember, a Global Hotkey means it works in any window on the entire computer.  So it is probably a good idea only to set a few of your most used commands.

 

As this can't be done yet in the Options Panel, you have to do it via the INI file.

However, you can see a complete list of hotkeys in the Hotkeys tab of the Options Panel.

 

 

Configuring Global Hotkeys via INI

 

The text before the = is called the INI Key.  The text after the = is called the INI Value.

The name in [brackets] is called the INI Section.

Lines that start with a semicolon ; are comments and TextWorx ignores them, but you can use them to make notes.

 

All hotkeys follow the same format.

#        win key

^        control

+        shift

!        alt

 

You can mix and match modifiers.

You can use any of the keys from AutoHotkey's Key Listing.

Try to avoid the alt key, though, as Windows programs make use of the alt key to interact with menu-bars, and if you use an alt key, it can interfere.

#+K                win+shift+K

#Lbutton        win+Left Mouse Button

+^B                shift+control+B

 

 

TextWorx Menu Hotkey

This is the Global Hotkey to summon the TextWorx Menu.

 

[Preferences]
hotkey=#K

 

 

TextWorxToolbar Hotkey

This is the Global Hotkey to toggle the TextWorx Toolbar.

 

[Toolbar]
hotkey=#+K

 

Command Hotkeys

If you wish to set a hotkey for a Command, use the [Hotkeys] section in the TextWorx.ini file.

If it does not exist in your INI file, simply create it.

 

The INI Key should be the CommandID of whatever command you want to assign a hotkey.

The INI Value should be the hotkey itself.

You can set a hotkey to ANY CommandID.

 

Command 99 is a test command which simply displays a dialogue reporting the hotkey you used, the commandID and the Command Name.

You can use 99 to test how comfortable your hotkey is.

 

The following section will set four Global Command Hotkeys:

win+Left Mouse Button will call 99 Command Report.

win+T        will run 104 Paste as Text (very handy hotkey).

win+shift+O will opens 100 TextWorx Options.

win+ctrl+E will run 201 "Encase" with double-quotes on your selected text.

Notice the comments above each INI entry (comments are optional) to help you know what the commands do when you edit the INI file

 

You can even use media keys.  For example, some keyboards have a Power Button.  It is SC15E.   Just use it as the hotkey.

 

Important Note about Assigning Hotkeys!

When you assign hotkeys to TextWorx commands, though, be sure and think about how TextWorx uses shift and control as modifier keys for the commands - and TextWorx will honour those even if you use them for the hotkey - so there may some conflict.

For commands that use shift or control (or both) for their commands to allow them to work in reverse or on lines, you will have to set a hotkey with those modifiers in order to use them.

Example: Say we want to set a hotkey for 201 "encase", and we will use win+" for the hotkey (same as win+'). We will want to set four hotkeys for this command in order to have all three variants available to us:

201=#'        encase in quotes

201=#+'        remove quotes

201=^'        encase lines in quotes

201=#^+'        remove quotes from ends of lines

 

For commands that don't use command modifiers (that is, they don't work on lines or in reverse) you can set whatever hotkey you like.

You can even set multiple hotkeys for the same command.

 

Also, beware of using alt in your hotkeys, because alt often times invokes a windows own menu.

 

 

[Hotkeys]
;Test
99=#LButton
;paste as text
104=#t
;options   
100=#+o
;"encase" --- encase, decase, e
201=#'
201=#+'
201=^'
201=#^+'