ARPUS/ce, Version 2.6.2 (03/10/05) (SCCS 1.2) _______________________________________________________________________________ Concept: Ce Menubar and Pulldowns SYNOPSIS: Ce provides pull downs to access many of the switches and obscure features. The functionality and operation is similar to pulldowns on many other X based applications with the exception of the items in the "Edit" pulldown which operate over a marked range of text. Ce pulldowns execute strings of one or more Ce commands are built up from Ce commands in the .Cekeys file. Some experienced Ce users will look at pulldowns and say "What is this stuff? Make it go away." The 'pdm' will toggle off the menu bar. The .Xdefaults resource "Ce.pdm : no" will default it to off. To turn off the menubar in just ceterm windows add "ceterm.pdf : no" to your .Xdefaults file. USING EDIT PULLDOWNS: Most of the pulldown items under the "Edit" pulldown operate over a range of text or a location. In it's normal operating mode, using the default key definitions, two problems using the edit pulldowns occur. First, Ce attaches the text cursor to the mouse cursor. This messes up the marked area when you move the cursor to get to the menu bar. The second is that the Left mouse button Marks an area on the down stroke and copies to the default paste buffer on the up stroke. The up stroke removes the highlighting. While it is possible to re-highlight the area on the up stroke by adding ";rm;echo" to the ';m1u' key definition, we will assume you mark the area using the 'F1' key to begin highlighting or <Shift>-F1 to begin rectangular highlighting. There is a Ce command which moves the cursor to the menu bar and freezes the window until pulldown activity is completed. This command has a default location of ^Escape (<Ctrl>-Escape). Thus to use edit pulldowns over a marked range of text use F1 to begin marking the range of text and <Ctrl>-Escape to freeze the main window and move to the menu bar. Select the option you want. Cancel by clicking In the main window. Using a position oriented pulldown such as "Paste" is done the same way except you don't mark a region. ADDING AND CHANGING PULLDOWNS: Pulldown menus and the items in the menu bar are defined using the 'mi' (Menu Item) command and can be executed on the fly or put into the .Cekeys file. The 'mi' command follows the format of the kd (Key Definition command). It identifies the pulldown name and line number (zero based) where this menu item is to be located, the string to appear in the line, and a list of Ce commands to execute. A pulldown is made to appear on the window with the 'pd' (Pulldown) Ce command. The parameter to 'pd' identifies the name of the pulldown as specified in the 'mi' command. A 'pd' command can be executed from the 'Ce' command window, placed under a key definition, or placed as the command in a menu item. The last technique is how cascading menu's are created. EXAMPLES: The following is extracted from the default set of menu items. mi File/0 'Save'pw;msg 'File saved' ke mi File/1 'Save As'pn -c -r &'New Name:';ro -off;pw ke mi File/2 'Close/Save'wc ke mi File/3 'Close/NoSave'wc -y ke mi Edit/0 'Copy'xc ke mi Edit/1 'Cut'xd ke mi Edit/2 'Paste'xp ke mi Edit/3 'Undo'undo ke mi Edit/4 'Redo'redo ke mi Edit/5 'Text Flow'tf ke mi Edit/6 'Find Matching Delim'bl -d ke mi Modes/0 'Case'pd Case ke mi Modes/1 'Insert'pd Insert ke mi Modes/2 'hex'pd Hex ke mi Modes/3 'Lineno'pd Lineno ke mi Modes/4 'ScrollBar'pd ScrollBr ke mi Modes/5 'Vt100'pd vt ke mi Modes/6 'Track Mouse'pd Mouse ke mi Macro/0 'No Macros Defined' ke mi Help/0 'Intro'cv -envar y ke mi Help/1 'Commands'cv -envar y ke mi Case/0 'Sensitive find'sc -on ke mi Case/1 'Insensitive find'sc -off ke mi Insert/0 'Insert'ei -on ke mi Insert/1 'Overstrike'ei -off ke mi Hex/0 'On'hex -on ke mi Hex/1 'Off'hex -off ke mi Lineno/0 'On'lineno -on ke mi Lineno/1 'Off'lineno -off ke mi ScrollBr/0 'On'sb -on ke mi ScrollBr/1 'Off'sb -off ke mi ScrollBr/2 'Auto'sb -auto ke mi vt/0 'On'vt -on ke mi vt/1 'Off'vt -off ke mi vt/2 'Auto'vt -auto ke mi Mouse/0 'On'mouse -on ke mi Mouse/1 'Off'mouse -off ke mi Menubar/0 'File'pd File ke mi Menubar/1 'Edit'pd Edit ke mi Menubar/2 'Modes'pd Modes ke mi Menubar/3 'Macro'pd Macro ke Note that the top menu bar is just a pulldown with the special name Menubar. If you execute 'pd Menubar' at the Ce 'Command:' prompt, you can access this menu. Note also that the special pulldown for 'Help' is treated as a special case in the Menubar to right justify it. To add a line to an existing pulldown, find the name of the pulldown you want to add the line to and pick the next sequential line number in the sequence of line numbers. You can count the lines in the existing pulldown starting at line zero. If you skip a number, the new line will not appear. These two values separated by a slash give you the key for the 'mi' command. For example: Modes/7 for a new item in the Modes pulldown. At this point you are ready to format the 'mi' command. Lets say you were adding a pulldown to modes to invert the screen with the 'inv' command. mi Modes/7 'invert'inv ke | | | | | | | | | | | +-- End of mi command token | | | | | | | | | +------ List of DM commands separated by semicolons | | | | (in this case there is only 1) | | | | | | | +----------- String to appear in the pulldown on this line | | | | | +------------------- Zero based line number where the menu item goes | | | +------------------------ Name of the pulldown to add to | +------------------------------ The 'mi' command Note that pulldown names are 1 to 8 character alphanumeric names. RELATED HELP FILES: pdm (Pull Down Menus) tmb (To Menu Bar) mi (Menu Item) pd (Pull Down) xd (Cut ) xp (Paste) xl (Copy Literal) regionsCon (region description) support (customer support) _______________________________________________________________________________ Copyright (c) 1994, Robert Styma Consulting. All rights reserved.