Index Parent

Application class

 

The Application class is the main class in RxMUI.

Any window you create must be added to an application object.

Windows may be added to an application object during the init process via the SubWindow attribute.

The first window may be specified as

    .SubWindow="win"
or 
    .SubWindow.0="win"

Other windows may be added via the Add() function or during the init process as 

    .SubWindow.i="win"

A window can not be opened if it is not added to an application object.

See Objects handling

 

ATTRIBUTES
Name Type Class Note
Active B ISGN  
Author S IG  
Base S IG Must be present if UseCommodities or OwnARexx or UseARexx
Copyright S IG  
Description S IG  
DiskObject S I Name of an icon WITHOUT .info
DoubleStart B GN  
ForceQuit B GN  
HelpFile S I  
Iconified B SGN  
MenuStrip S I  
Num1 N ISGN Note
Num2 N ISGN  
Num3 N ISGN  
OwnARexx B I Note
SingleTask B I  
Sleep B I  
String1 S ISGN Note
String2 S ISGN  
String3 S ISGN  
Title S I Must be present if UseCommodities
UseARexx B I  
UseCommodities B I  
Version S IG  

 

OwnARexx
it is so bad that we have an ARexx port opened and we can't get messages from it.If you specify OwnARexx you have opened the same port that would be opened (it means BASE if SingleTask=1 BASE.X if SingleTask=0) but internal in the macro. It means that you have to handle ALL the commands coming to this port, MUI ones too (e.g. QUIT).

 

Num? String?
Num? and String? are user attributes.
They are really useful in situation like multiple macros project, or just as container for values.

 

METHODS
Nome Parameters Note
About [win],[string] Note
ABoutMUI [win] Note
AboutRxMUI [win] Note
InLine <fun>,[attribute | TriggerAttribute] Note
InputBuffered    
Load [file | ENV | ENVARC] default ENV
OpenConfigWindow    
Return <string> , [attr] Note
ReturnID [QUIT] Note
Save [file | ENV | ENVARC] default ENV
SetVar <var> Note

 

About
Shows a little about requester.
If no argument is supplied the content of the requester is made by same applications attributes, otherwise string is shown.

 

AboutMUI
Shows the "About MUI requester".

 

AboutRXMUI
Shows a little"About RxMUI requester".

 

InLine
Used in notification such as: 

    call Notify("slider",trigger,value,"app","InLine","parse arg name,value;...",attr)
When trigger changes to value, fun, an inline ARexx function macro, is called with arguments:
  1. the name of the notifier object
  2. the value of attr; the attribute must be G; a special value is TRIGGERATTR that means the triggering attribute; if no attribute is supplied, the function receives just one argument.
The function is called in the same process of the running macro and so in it there can be used any RxMUI functions on any object, but it is called as a separate ARexx macro and HASN'T GOT the environment of the running macro (e.g. ala INTEPRET command). It means mainly that the existing variables are not valid in the function (they just don't exist).

 

Return
Used only in Notify() as in 

    call Notify("WIN","CLOSEREQUEST","APP","RETURN","HELLO")
    call Notify("CYCLE","ACTIVE","APP","RETURN","TRIGGERATTR")

 

ReturnID
Used only in Notify() as in 

    call Notify("win","CloseRequest","EveryTime","app","ReturnID","quit")

or 
    call Notify("button","pressed",0."app","ReturnID")

The application will return the name of the object that triggered the notification or the special value QUIT that means the application should be closed. Any other value is a bad value.

 

SetVar
Used only in notification, set var to the value that triggered the notification, like in 

    call Notify("CYCLE","ACTIVE","EVERYTIME","SETVAR","ACT")
and act will always be the active entry of CYCLE .