oreground, checks which application has been in foreground before and shows a menu. This menu depends on if a definition has been made or fallback.
Please note, that this command uses the numbers 1-9 for internal purposes.
Do not use this command in conjunction with your own key%=MENU construction, as it assigns the pressed key to key% which you can use for your inquiries.
If you anyhow want to make your own key%=MENU command I recommend as follows key%=MENU(minit%(x%)) as this uses the variables, that are set up by MenuPlus.
see mCARDtask:
Allows you to switch to another task. As for MPJumpTo there are two possibilities calling this command.
1) MPSwitchTo:(&0) brings up a dialog with all running tasks. And as used, type TAB for the list, or the first letter to be faster. Confirmation brings you to the desired task.
2) MPSwitchTo:(Thread&) switches directly to that task - but how to get Thread& as user? I'll think about that.
Shows the message text$ in the upper left corner.
duration% is the time in twentieth of seconds, OPL programmers know this from pause. And like pause, if duration% is a negative value, the message can be cancelled with a keypress.
This command is let in for my ease. I simply does
BUSY LEFT$(text$,80) ,0
PAUSE duration%
Therefore text$ is automatically clipped to 80 characters.
If duration% is negative it can be cancelled with a keypress.
Up to now there are the following integrated commands. They are described in detail later.
preferences:
mCARDinfo: --> removed
mCARDtask:
mCARDdoc:
MPMenu:
MPJumpTo:(Folder$)
MPSwitchTo:(Thread&)
MPSelectDoc:(filewithpath$)
MPTaskList:
MPbusy:(text$, duration%)
MPinfo:
MPFgMacro:(filewithpath$)
MPFgApp:(filewithpath$)
MPFgDoc:(filewithpath$)
....... to be continued .......
MenuPlus 2.123
MenuPlus
tically clipped to 80 characters.
If duration% is negative it can be cancelled with a keypress.
BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDER PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. IN NO EVENT THE COPYRIGHT HOLDER WILL BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH THE HOLDER HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
Arial
Arial
Arial
MPFgDoc:(filewithpath$)
....... to be continued .......
MenuPlus 2.123
MenuPlus
gang Golder - All rights reserved.
enuPlus
To use this command you'll have to do something as follows. With the docs preferences select the documents you want to work with. They are stored in a database called MenuPlus.dad - notice the suffix .dad which means a .dat file for documents.
Calling mCARDdoc: shows the first 7 documents you used last. If you have defined a greater number the 8th menupoint is more... Selecting this brings up a dialog that shows all defined documents. Up to 90 are possible.
Whenever you use a document the "usetime" is stored in the database, so that always the last used are shown first.
I think this makes sense, as most times I need the same documents to work with and my S5classic does not provide such a function.
A special note about Macro5 taskswitch funktion. Due to some internal reasons Macro5 comes to foreground if you select MenuPlus. I handeled that in previous versions, but due to speed reasons I removed it in Version 2.12 as it is no Limitation.
The solution is very simple - do not call MenuPlus this way - use the MenuPlus hotkeys.
As there is no SIS package for installation, the user has to do this "by hand".
Create an folder MenuPlus in your ...\System\Apps\ directory. Copy the following files to it: MenuPlus.app, MenuPlus.aif, MenuPlus.icn, MenuPlus.hlp and ReadMe.
Next create a folder Module in this directory. You can use another path, but I do not recommend it. In this folder reside the modules. An other usefull folder is the special MenuPlus Macros folder. It is used for Macros that use MenuPlus commands.
You MUST also have installed: Macro5 library Version >2.40. Also the Sysram1 library and Systinfo library are needed. If you do not have them already installed, you can find them easily on the web. I have not included them in the package.
Due to the changes in preferences nMPD is needed - can be downloaded from www.neuon.com.
Thats all.
Shows a tiny digital clock. Usefull in Apps where you have switched of the taskbar (like me in Agenda)
Appereance is controlled by the following values.
x$ is horizontal
l or left
m or middle
r or right
x$ is vertical
t or top
m or middle
b or bottom
You MUST use MPClockOff to switch it off.
Look at example how I intended to use it.
I recommend the following structure of the modules. Please note, that PROC MenuPlus: is mandatory, as the application calls the module this way. Also the MPModuleKey??? must exist. If you do not want to use them, just enter no commands.
REM ############################
REM MenuPlus
wolfgang@golder.de
REM example modul
REM ############################
INCLUDE "MACRO.OPH"
PROC MenuPlus:
MPClock:("m","b")
mINIT
mCARD "example","test",%t
MPMenu:
MPClockOff:
IF key%=ASC("t")
execute your command here
ENDIF
PROC MPModuleKey1:
execute your command here
PROC MPModuleKey2:
REM up to MPModuleKey8:
fC:\documents\AccountsHelp
Table1
Title
"App Name
"Synonyms
Arial
Just for quickly compacting a Agenda or Data file. I implemented this as my Agenda has autocompact switched off and the file grows very much with often use. If you need to compact much files I recommend Ralph Sprenger's Compact. But just for the Agenda or a data file, it takes too much time.
Call it with file - the file will be compacted, call it with MPCompact:("") you get a file selector.
Gives the ability to JumpTo a desired folder in the system screen. You can use it two ways.
1) JumpTo:("") brings up a dialog, where you can choose the folder.
2) e.g. JumpTo:("C:\") jumps to drive C:\ -JumpTo:("C:\System\Apps\") guess what? - and so on... This works also with an CF-Card and even the ROM! But unfortunately it does not jump out of the ROM, and I can not figure out how to do this. But the good news is, that you can do it manually. On my S5classic UK-Version I use Ctrl-q. You should know by yourself the keypresses of the machine in your language.
Attention: you MUST set the keys to open multiple files to "Fn+Enter"
MenuPlus provides an additional menu. This menu can be different for each application and can be easily created with OPL and Macro5 commands. Addionally exist so called hotkeys, they can also be different for each application. There are also some builtin commands which are described later.
I developed it, cause I like to control my Series5 and the applications with the keyboard. This is much faster than using the pen.
MenuPlus is and will remain a Freeware application. All I ask for is that you send me your modules, which I will put on my homepage so that others can benefit from.
Enjoy it and have fun :-)
Copyright
2001 by Wolfgang Golder - All rights reserved.
Arial
Arial
Arial
Arial
Arial
If you run MenuPlus the first time, you are automatically brought to preferences.
Select the keys you want to use. The default values are the ones I use on my german machine.
Select the two macros that are assigned to the global hotkeys. If you do not know what I mean, just leave it empty.
But it is important to provide the two macro paths. The first one is where you store your Macro5 Macros. I use the second for macros that use menuPlus commands.
After being started MenuPlus sits in the background and waits for a hotkey. When it receives it, MenuPlus checks which application is in foreground and shows a menu. This menu depends on if a definition has been made and if not a "fallback" to the "normal" Menu is made.
The modifiers/hotkeys are choosen here. By user request I implemented Shift - then I noticed that one hotkey is not enough and that sometimes the pen would be usefull. So now you can choose between Ctrl and Shift as modifier, between menukey and the sidemenu as hotkey. By default Ctrl+Menu is selected. Additionally there are some other hotkeys. They are self explanatory. Also I implemented the possibility to use a Shift+Ctrl repacement. You have to assure by yourself that the coosen keys work on your machine. Next there are two "UserKeys". They are global and work out of each application. Last but not least there are "ModuleKeys". This means that you can define eight keys in combination with Fn. The hotkeys are the same in each application, but can have different actions in different applications. You should also choose the paths to your Macros folders. If you don't provide the correct paths, MenuPlus crashes when a Macro5 command is called. The preferences are stored in MenuPlus.ini.
MenuPlus must know which menu to show for an application. These definitions are stored in MenuPlus.dat. First choose an application, this appication can reside anywhere in ROM, RAM or CF-Card. Next choose the module for this application. Third you can select the position where the module is stored in MenuPlus.dat. The lower the number is, the earlier the definition is found and the menu shown. This means give your most used definition a low number and the least used a high number. Surely there are applications you do not want/need to have an additional menu. For this case I did something I call "fallback". It means, that if there is no appliation/module definition the "builtin" menu is shown.
choose the documents you want to be shown by mCARDdoc: The docs are stored in MenuPlus.dad
NO WARRANTY,
Arial
Arial
MenuPlus
installation$
MenuPlus
integrated commandsF
MenuPlus
mCARDtask:U
Arial
Shows the running tasks. Via MPMenu it is possible to switch to the selected task.
related MPMenu:
MenuPlus
mCARDinfo: --> removed --> use MPinfo: insteadn
Arial
Shows a menu, containing at the moment the following items:
date and time
free / total RAM
free / total on CF-Card
if external power is present
battery status - Attention the %value is dependand on Series5 with alcali batteries
is the link on or off
MenuPlus
MPMenu:U
Arial
MenuPluse
how it works?
MenuPlus
preferences
MenuPlus
example3
MenuPlus
MPJumpTo:(folder$)U
Arial
MenuPlus
MPSwitchTo:(thread&)U
Arial
MenuPlus
builtinMenu:U
Arial
does what the name says
MenuPlus
MPModuleKeyU
Arial
In the preferences you can define up to eight keys that can be used with Fn. Simply add a proc MPModuleKey1: to your own module. Look at example.
Accordingly the other procs are called MPModuleKey2: MPModuleKey3: MPModuleKey4: ... until MPModuleKey8:
MenuPlus
MPClock:("x$","y$") / MPClockOff:U
Arial
MenuPlus
MPToptoBack: MPBacktoTop:U
Arial
sends the foreground application to background and vice versa
MenuPlus
MPCompact:(filewithpath$)U
Arial
MenuPlus
MPaddDoc:U
Arial
Lets you add documents to the documents database in a very easy way.
Just highlight the desired file in the system screen and call this command.
MenuPluse
Note about Macro5
MenuPlus
credits
Christian Waldrauch doing a GREAT job with testing and for being the first sending modules
Mario Collado for his assistance with some basics
Fredy Ott for always announcing my applications in his news
MenuPlus
first steps-
MenuPlusBL
somewhere in December 2000
found Macros providing an additional menu. (Context from Mario Collado and MaruMenu from Markus Heinermann) I liked the idea very much, but not how it was implemented. So I created Menu+ for Macro5. This macro is still available from my homepage, but not developped any further. The modules from Menu+ are different from the ones of MenuPlus (the names start with M+...). As the size of the modules grew up and up and took longer and longer - I thought about a alternative solution.
MenuPlus V1.00 - 02.01.2001
First Version of the application MenuPlus. I called it MenuPlus to differ from the macro Menu+. It has the same functionality as Menu+ but with two small differences that make a big difference :-) The application stays in memory and the module also. This means that if you call MenuPlus twice or more often consecutively without changing the application, the module is only loaded once.
MenuPlus V2.00 - not released
MenuPlus V2.01 - not released
MenuPlus V2.02 - not released
MenuPlus V2.03 - 04.02.2001
programmed from scratch
able to execute Macro5 commands, therefore stopped Menu+
capturekey Ctrl+Menu
JumpTo
preferences improved
MenuPlus V2.04 - not released
system tasklist
JumpTo ROM
security checks
module priority = position
MenuPlus V2.05 - 18.02.2001
speed improved - nearly no delay
new module stucture
remembers the last used menupoint
MenuPlus V2.06 - 24.02.2001
crazy taskswitch function
some internal commands
information menu
second hotkey
user can choose modifier and hotkey
select macros path
MenuPlus V2.07 - 04.03.2001
icons in system screen
cleaned up definitions dialog
to keep the app as small as possible and to return to its roots I removed the planned TaskBar and cancelled SwitchFiles for the system screen
small cosmetic fix when displaying tasks
new command MPinfo:
a document launching menu
MenuPlus V2.08 - 24.03.2001
added the possibility of receiving keys from another application (see special)
improved the documents selector
removed about: as it is in the preferences dialog
removed mCARDinfo: better use MPinfo:
MenuPlus V2.09 - not released
MenuPlus V2.10 - not released
MenuPlus V2.11 - August 2001
many internal improvements since the last released version
added two hotkeys - one for the system screen, the other for the system tasklist
added the eight ModuleKeys
MenuPlus V2.12 / 2.13 - September 2001
totally rewritten event handling - reacts now faster and gives a smoother feeling
improved some of the existing commands
added more error handling
modules are now sorted automagically depending on how often they are used
unfortunately you MUST delete your MenuPlus.dat and MenuPlus.dad and make the definitions and add the documents new
all information for user is now shown in lower left corner
new commands:
MPClock
MPClockOff
MPToptoBack
MPBacktoTop
MPCompact
MPaddDoc
separate MPMacros
MPDocuments
MPBookmarks
MPNotes
....... to be continued .......
with more functions in your own menus the speed slows down - but its up to the user and what's a second :-) or less - in good old C64 times it took minutes only to load a program :-O
MPbusy:(text$,duration%)U
Arial
MenuPlus
history=
MenuPlus
preferences:U
Arial
preferences: lets you adjust your settings
MenuPlus
MPTaskList:U
Arial
calls the system tasklist
MenuPlus
MPinfo:U
Arial
Shows free RAM, free on CF-Card, external power or Battery, status of the link and the number of tasks.
The message disappeares after 30 seconds, alternate you can press a key.
Together with e.g. JumpTo and SelectDoc it's one of my personal favorites.
MenuPlus
mCARDdoc:U
Arial
MenuPlus
MPSelectDoc:(file$)U
Arial
used with mCARDdoc: - the documents shown with that command can be called with MPSelectDoc
MenuPlus
MPFgMacro:(filewithpath$)U
Arial
runs a macro
MenuPlus
MPFgApp:(filewithpath$)U
Arial
runs an app and brings it to foreground
MenuPlus
MPFgDoc:(filewithpath$)U
Arial
runs a document and brings it to foreground
MenuPlus
special
You can sent a key to MenuPlus so that it can react on without showing the menu. At the moment there are 4 possibilities:
(.txt)