SmartPack v1.1 for Mesa/2

SmartPack for Mesa/2 is a collection of little tools to use with the
excellent spread sheet application Mesa/2 by Sundial Systems.

To use this tools you will need OS/2 Warp or eComstation with installed
Rexx support and of course a running Mesa/2.


The tools are currently (i) CellEdit v1.1, (ii) CellSize-Col v 1.1 and 
(iii) CellSize-Row v 1.1


Update information

Please reinstall the application with the install script, or copy the exe 
files to the existing v1.0 directory. 
Note: at the end of this file yu will find the latest news. Please refere 
to chapter 'history'.


Installation

Just unzip the files in the SmartPack archive to your Mesa/2 directory.
Then run install.cmd to create WPS objects.
You can start the programs direct from your WPS.


Setup and usage with Rexx

All objects can be launched from commandline or from rexx scripts. You will
find some sample scripts in the subdirectory \cmd.
Use this scripts in your Mesa/2 macros, or to add buttons to your Mesa/2
toolbar.

If you want to add buttons for the programs to your mesa toolbar you have
to add scripts and point these scripts to the *.cmd files by doing the
following:

You want to add a button for the CellEdit tool. Open the "Setup Toolbar"
dialog in Mesa/2, check the "Script name" radio button and enter
"Drive:fullpath\CellEdit.cmd" into the corresponding entry field. Enter a
description text like "Launch CellEdit" in the description field. Feel free
to load a bitmap for better identification of the cell editor. Then drag
the script icon and drop it to your toolbar. Close the "Setup Toolbar" window.
Voila. Now you are able to start CellEdit from your toolbar by clicking the
dropped button.


sample scripts are:
all.cmd - to open all available objects
celledit.cmd - to open the CellEdit program
folder.cmd - to open the WPS folder where the objects are located
readme.cmd - to open the reame file
spcol.cmd - to open the CellSize-Col program
sprow.cmd - to open the CellSize-Row program



(i) CellEdit v 1.1

CellEdit is a little editor with you are able to edit multiline text in
one cell. You can set soft line breaks in mesa using the "ALT" + "enter"
key combination, but unfortunate you can not copy and paste multiline
text in a cell. And its also very difficult to edit multiline text in a
cell, because Mesa/2 shows the whole text in one edit line.

With cell edit you can grab the contents of one cell to the CellEdit 
multiline entry field. Now you can comfortable edit the cell text, and after
editing you push the text back to a cell with a mouse click.

On the other site you can open text files and copy selected lines to one
cell in an easy way.

You can configure colors and fonts of the entry field by drag and drop
fonts and colors form WPS palettes.

CellEdit has most of the functions of a standard editor, plus the
following functions:


  Menu\Mesa\"Get cell contents"

Select this menu point to grab the content of the currently selected cell
in the currently activated layer in Mesa/2, and post the content to the
entry field of CellEdit. Old text in the entry field will be overwritten
by this function, so be carefully.


  Menu\Mesa\"Set cell contents"

Select this menu point to copy the whole content of the Celledit entry
field to the currently selected cell in the currently activated layer of
Mesa/2. The selected cell will get the alligns top and left, and the row
will be smartsized. Tabs are filtered and will not be transmitted. Word
wrap will be enabled.


   Menu\Mesa\"Set selected contents"

Selection of this menu point is the same like selection of "Set cell
contents". The only difference is, that the currently selected text will
be transmitted to Mesa/2, and not the whole entry field content.


(ii) CellSize-Col v 1.1

Mesa/2 does not allow you to set the size of a column by a numeric value.
CellSize-Col will help you to do the job. Once started CellSize will show
the size of the column of the currently selected cell. You can change the
number with values between 0 and 400 points, the max. possible cell size
in Mesa/2.
Ceelsize-Col has the following functions:

  Menu\options\unit

Select one of the following points form this submenu:

* inch - to set the size unit to inch
* point - to set the size unit to point
* cm - to set the size unit to cm

where is
1 inch = 72 points =  2.54 cm

After starting CellSize up the last used unit will displayed.

  Button\Get

Push this button to get the column size of the currently selected cell.
You have to use this function if you have selected another cell after
startup of CellEdit.

  Button\Apply

Push this button to change the size of the column of the currently
selected cell in Mesa/2 to the value displayed in the entry field of
CellEdit.
You can change the value manually. Its also possible to add a mathematical
string in the entry field. CellSize will interpret this string.

Sample:

You have started Celledit, and there is a Column Size of 50 points
displayed in the entry field. And you want to set the size to 55 points,
then type " + 5" in the entry field. The entry field shows now "50 + 5"
(without quotes). Now select "apply", and the new column size will be "55".
Or type " * 2" to double the cellsize.

Note: with "Get" and "Apply" its also possible to synchronize cell sizes.
Just grab the cellsize from one cell, select another cell and apply the
size from the first cell to the new selected one.

   Button\Ok

This button will do the same like "apply" with the difference that CellSize
will be closed after changing the size.

   CheckboX\"size is a SmartSize offset"

This is a very special function. Enable this checkbox and CellSize will
SmartSize the selected column, and after smartsizing the column will
enlarged by the value from the entry field. You can take this function to
get more space between your cell content and the cellborder. Use "0" in the
entry field to do a normal SmartSize.


(iii)CellSize-Row v 1.1

This is the equivalent to CellSize-Col, but works for row sizes of selected
cells. Refer the chapter above.



Limitations

The 'always on top' doesn't work if a VDM (DOS oer WINOS/2) window is open.
The tools will not work with multiple instances of Mesa. You can use it only
with the first opened instance.



Support

Support is currently available via email. Please use the word "smartpack"
in the subject line of your email.
Send your questions, suggestions or bugreports to

mail [at] subsys [dot] de

Your feedback is welcome!


You will find the latest version at
http://www.subsys.de



License

SmartPack is emailware.

OS2apirx.dll is copyrighted by Carsten Arnold (2003).
You will find his webpage with a lot of share- and freeware tools at:
http://www.c-arnold.de.vu

We allow you to use and distribute this files freely under the condition
that we are in no way responsible for any damage or loss you may suffer.

Another condition for use of this program is you must send us an E-Mail
stating that you are using the program. It is important for us to see
how many people are using the program so that we may determine the
usefullness of continuing this project into the future.

But if you want to support subsys you can buy the Subsys CDROM with all
programs of subsys solutions, including a full version of the
addressmanager Contact/2. See http://www.subsys.de/index2.htm for a
complete list of our work. This CD ROM will be available within the next
weeks. Please send us an email if you are interested in, we will contact
you if it is available. Thanks in advance. We will invest all donation
into the development of more stuff for OS/2 and eComStation.
Otherwise you can support us by helping to make documentions of subsys
software in other languages than german. Please contact us if you have
time and delight to work together.


History

new in v1.1
- new option in all modules: 'always on top', makes an floating window
Thanks to Carsten Arnold, who makes this possible with the OS2apirx.dll.
- new option in CellEdit: soft wrap
- bugfix in CellEdit: file save routine

Frank Wochatz
Berlin, den 12.04.2003

