Menu

TextWorx has a completely customizable popup menu.

To show the TextWorx Menu, push the global hotkey, win+K (or whatever this is if you may have changed it - if you right-click TextWorx's tray icon, it will tell you the current hotkey).

This is how to use it:

1.Select some text in your normal text editor.

2.Push the hotkey to summon the TextWorx menu.

3.Select a function from the TexWorx menu.  Be sure to hold the modifier keys for alternate methods.

4.That's it.  TextWorx replaces your selected text with the modified text.

Use Modifier Keys to gain functionality:

•Without a modifier, the command will operate on the selected text as a block.

•shift         hold this to reverse the command.

•ctrl         will operate on each line individually.

•shift+ctrl  combine them to reverse the command on each line individually.

The Command List show all of the possible commands along with their modifier keys.

The ... in the Menu titles indicates that the command uses a dialogue box to gather user information - you should hold the modifier key WHEN you push the Accept button in the dialogue.

(scroll down, past this animation for more...)

Customizing the Menu

You can change most of these settings in the Options Panel, or you can follow the directions for Customizing the Menu with the Config INI file.

Nearly every item on the menu can be customized.

Customizing the Menu with the Config INI file

Open the TextWorx.ini file (you can use the command in the Tools Menu or System Tray Menu).  Locate the [Menus] section; it looks like this by default:

After you are finished editing the INI file, you can restart TextWorx from the Tools Menu or System Tray Menu with Restart TextWorx.

[Menus]
mainmenu=default
editor=default
transform=default
trim=default
insert=default
sort=default
coding=default
encase=default
convert=default
webedit=default
tools=default

Let's customize the items that appear in the main TextWorx Menu.

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.

The Main TextWorx Menu is configured with the mainmenu INI key.

First, comment out the mainmenu line by putting a ; in front of it.  That way it is there the next time you want it (this should work for any INI file, by the way).

Then copy and paste this string (it is the expanded default for mainmenu):

mainmenu=800||201|307|302|301||104|901|212|725||encase|coding|editor|sort|trim|transform|convert|webedit|insert|*sar|*date|tools

Now your section should look like this:

[Menus]
;mainmenu=default
mainmenu=800||201|307|302|301||104|901|212|725||encase|coding|editor|sort|trim|transform|convert|webedit|insert|*sar|*date|tools
editor=default
transform=default
trim=default
insert=default
sort=default
coding=default
encase=default
convert=default
webedit=default
tools=default

If you set the INI Value for TextWorx's own toolbars to default, then it will use it's own internal menu settings.

However, you can override this by creating your own like we have for the mainmenu above.  The only catch to overwriting the default menus is that if we add new functions to the menu, you won't see them and will have to add them manually if you want them.

Now that you have your own custom Main Menu, you are ready to change it to suit your fancy by modifying the mainmenu ini value; just have a look at the Explanation of the Menu Configuration below.

You can also create your own custom submenus.

Explanation of the Menu Configuration

The menu configuration follows a particular specification.

Menu Parameters

The order of parameters determines the order items appear in the menu.

Everything in the INI Value should be should be composed of these parameters:

Special Menus

Special Menus are menus that TextWorx displays with special processing. You cannot create your own Special Menus, but you can add or move them to any other menu.

Default Menus

If you set the INI Value for TextWorx's own toolbars to default, then it will use it's own internal menu settings.

However, you can override this by creating your own like we have for the mainmenu above.  The only catch to overwriting the default menus is that if we add new functions to the menu, you won't see them and will have to add them manually if you want them.  

Although you can do this, a better thing to do is to leave the other menus set to default and just remove the default menu from mainmenu and add your own.

How to Create Custom Submenus

You can create as many submenus as you like (as far as I can tell).  Here's how:

1.Add your menu to the [Menus] ini section.

2.Make sure to give it a unique ini key name.

3.Make sure to give it a title - that's the first parameter enclosed in single quotes: 'My Menu' in the example below.

4.Don't leave out the pipe | characters that separate the parameters.

5.Remember that regular and your own custom menus do not have quotes or stars.

Here we will add a new line to create a new submenu.

mymenu='My Menu'|icon:12|201|604|607|'Some Caption'|*tools|*custom

Then we add mymenu to the mainmenu.

You can see we've also added myothermenu, and moved the encase and coding menus out of the main menu into this one.

[Menus]
;mainmenu=default
mainmenu=800||mymenu|myothermenu||201|307|302|301||104|901|212|725||editor|sort|trim|transform|convert|webedit|insert|*sar|*date|tools
editor=default
transform=default
trim=default
insert=default
sort=default
coding=default
encase=default
convert=default
webedit=default
tools=default
mymenu='My Menu'|icon:12|201|607|604||*tools|*custom

myothermenu='My Other Menu'|icon:13|701|724|731|encase|coding