ARPUS/ce, Version 2.6.2 (03/10/05) (SCCS 1.5)
_______________________________________________________________________________
icon [ -i | -w ]
"iconify window"
DESCRIPTION:
Use this command to change the window into an icon.
This command is dependent on the behavior of your environment's
window manager. ce will send an 'iconify' request to the window
manager, and most window managers honor such requests.
Once the window is icon'ed, the icon is under control of the
window manager. The normal window manager techniques for
un-iconifying the window should be used.
Icon'ing is a window manager function and in most cases best left
to the window manager. There are cases where you may want to use
the Ce icon command from a key definition, command file, or
alias. The following describes the behavior and use of the Ce
icon command.
Executing 'icon' with no arguments toggles the state of the
window between an icon and a window. When a Ce window is icon'ed
the only way to send it the icon command to turn it back into a
window is with the xdmc command. The only case this has been
observed to be useful is as follows: Suppose you are using a
multiple desktop window manager such as HP/UX or Sun CDE. You
were editing a file and icon'ed it on one desktop and maybe even
got the icon buried under some other window. In another desktop,
whenever you edit the file you get the "This is a CC window"
message. Using the UNIX command "xdmc -list -cmd" you can see
that the file is being edited and that it is icon'ed. Entering
the command "xdmc -p<cepid_from_xdmc-list> icon" will pop the
window up on the current desktop.
Options:
-i - Change to an icon
This option changes the window to an icon. If the window
is already icon'ed the command has no effect.
-w - Change to a window.
This option changes an icon to the window. If the window
is not an icon, the command has no effect. This option
might be used in a command file which icon's the ce
window and later un-icon's it. Since all the commands in
a command file (cmdf) are executed without reading
events from the X server, the Ce session does not yet
know that it has been icon'ed and thus toggling would
not have the desired effect.
Consider the following command file which runs the ispell tool on
a file currently being edited. The ispell tool is distributed
with the Linux operating system and is freeware available on the
internet. The procedure being done here is to save the file out,
run the ispell from a Ce cpo command in wait mode (which locks
the ce window while the ispell runs), cut the entire file, and
reload it from the spell checked copy. To get the locked Ce
window out of the way, we will icon it while ispell is running.
Command file:
ro -off; # Make sure the file is in read/write mode
pw; # Save the file
pn; # Put the name of the file in the output message window
tdmo; # Move the cursor to the output message window
tl; # Go to the leftmost part of the output message window
dr; # Mark
tr; # Go to the end of the file name
xc -l file; # Copy the name to a local paste buffer
tdm; # Go to the Ce 'Command:' window
tl; # Go to the leftmost part of the window
xd -l junk; # Cut anything in the command window
icon -i; # Icon the soon to be locked up Ce window
es'cpo -w "xterm -e ispell '; # Simulate typing first part of cpo command.
xp file; # Paste in the file name
tr; # Move past the file name
es'"'; # Close the quote in the cpo command
en; # Execute the cpo command, wait till ispell is done
tmw; # Go to the main window
1,$xd -l junk; # Cut the entire file
xd -l junk; # Clear out the local paste buffer to save memory
tdm; # Go to the Ce 'Command:' window
es'xp -f '; # Simulate typing part of a paste command
xp file; # Paste the file name into the paste command being built
tr; # Go to the end of the file name
en # Execute the paste command
icon -w # Restore the Ce window
The follow alias does the same thing and adds an ispell Ce command.
You can put the following alias all on one line in your .Cekeys file
to make ispell a Ce command. Assuming you have installed ispell.
alias ispell ro -off;pw;pn;tdmo;tl;dr;tr;xc -l file;tdm;tl;xd -l junk;
icon -i;es'cpo -w "xterm -e ispell ';xp file;tr;es'"';
en;tmw;1,$xd -l junk;xd -l junk;tdm;es'xp -f ';xp file;
tr;en;icon -w ke
RELATED HELP FILES:
geo (Window Geometry)
rs (Refresh Screen)
rw (Refresh Window)
cmdf (Command File)
alias (Alias commands)
mi (Menu Item)
support (customer support)
_______________________________________________________________________________
Copyright (c) 2005, Robert Styma Consulting. All rights reserved.