Customizing menu and toolbars

RealWorld Designer is a general purpose framework and can be used as a foundation for editors of any document type. Because it cannot assume anything about the actual type of documents, it must allow extensive customization of user interface elements. The entire menu, toolbars and other sub-windows placed inside the main window are controlled by a Window layout configuration.

Accessing the Window layout configuration

The layout configuration is very complex and knowledge of the underlying principles is required to fully understand all its aspects. Reading about menu commands, operation and view plug-ins is recommended.

Because the window layout configuration dialog is confusing and it is easy to make a mistake, it is by default inaccessible. To gain access to the layout configuration, go to the options dialog (main menu: Tools->Application Options) and check the Show menu commands for layout control box. This will add new commands to the Tools menu.

Layout configuration can be reverted to the original one if anything goes wrong. But - this revert mechanism deletes all your customization, it might be better to backup and restore a layout using layout management dialog.

Adding new command to a toolbar

This short guide demonstrates how to add a new button to the main toolbar.

  1. Open a file.
  2. Click on Configure Layout in Tools menu.
  3. A dialog appears. Note that the View type box in the upper part of the dialog is set to Toolbar. This indicates that the main view used in this layout will have toolbars. Below is a list of toolbars (00000000, 00000001, 00000002) and to the right of the list is a configuration of the selected toolbar. When the area is too small, a message is displayed instead of the actual configuration. Click on the message and the dialog changes.
  4. The dialog now displays the properties of the first toolbar. The right side of the window shows the position in the hierarchical structure of the entire configuration. The toolbar ID is set to TBMAIN and the commands in the toolbar are controlled by the List commands object. The list contains several items displayed in the middle of the dialog window. The right part of the dialog window show configuration of the command selected in the list.
  5. The buttons above the list can be used to add, remove or reposition item in the toolbar. Note that one item in the list may actually represent multiple commands.

rsrc/configure-main-toolbar.png image

To add for example Save As function to the toolbar, select the first item (App-File: New, Open, Save) and duplicate it using the ++ button. The re-configure the duplicate to App-File: Save as.

speech bubble iconRecent comments

user iconAnonymous on August 18th 2013 0

Somewhere in this world of help, Vlastimil answered my question about re-setting my toolbars, thank you for your answer. Wheww, I almost faited !
Thanks Vlast ! !

Since I am here, about a year ago all of my icons were changed to look small as before they could be viewed big.

Since I did all of that work to make them look good but then i could not see my work (in the big view), I quit using the program.

Now, at the time, I wrote you and you said that you could generate a small program so you could see the icons big again. You said it was a window update that screwed everything up. I didn't want to bother you and I figured other people would have the same problem & so you would eventually write something that allowed the icons to seen as big again.

Where might i pick up that process to allow the icons to be seen big again?

Thanks Vlastimil

Linda

user icon