INPUT /  OUTPUT /  LANGUAGE



Computing with ioLProgrammer's GuideLanguage Reference

abs tag   add tag   align field   and tag   array tag   audio tag   backgroundColor field   bold field   border field   borderBottom field   borderColor field   borderLeft field   borderRight field   borderStyle field   borderTop field   bottom field   box tag   button tag   carat field   checkBox tag   choiceBox tag   class tag   clear tag   clientFrame tag   color field   console tag   dialog tag   div tag   do field   ellipse tag   else field   eq tag   false tag   focus field   focusOrder field   font field   for tag   ge tag   gt tag   height field   hotKey field   if tag   img tag   inf tag   inline field   input tag   invalid tag   int tag   italic field   join tag   layer field   le tag   left field   limit field   line tag   lt tag   margin field   marginBottom field   marginLeft field   marginRight field   marginTop field   mod tag   mul tag   ne tag   neg tag   not tag   null tag   num tag   onClear field   onClick field   onCommit field   onContextClick field   onExit field   onFocus field   onGet field   onKeyDown field   onKeyPress field   onKeyUp field   onMouseDown field   onMouseIn field   onMouseMove field   onMouseOut field   onMouseUp field   onPull field   onPush field   onResize field   onTimer field   openLink tag   or tag   pivot field   playing field   put tag   putError tag   putLn tag   requestTransfer tag   right field   rotate field   scalar tag   scroll field   scrollPos field   selectable field   spacing field   spacingBottom field   spacingLeft field   spacingRight field   spacingTop field   span tag   split tag   sub tag   table tag   tabRow tag   then field   timer tag   top field   transfer tag   transferAbility tag   transition field   true tag   underline field   vector tag   video tag   visible field   void tag   width field   with field   xor tag


clientFrame tag

Category: presentation tag

Creates a sub-console frame in the program console to host another program within your program.

Rather than containg content directly like a box tag, the clientFrame tag provides the ability for a separate console running a different program to be nested inside another program console.

Fields

Primary field

Category: scalar field

Gets a unique key that can be used to run a local program inside the client frame. The key is generated automatically by the system environment and can't be altered.

Secondary fields

title: the title of the inner program console. icon: png file data of the inner program's icon. connected: true if an inner client is connected to the clientFrame.

Behaviour

After the tag is complete, the primary field will automatically contain a unique key that should be passed back to the running program, and used to create an environment for a child process to be spawned with the clientFrame tag to be used as its controlling console.

The full mechanics for spawning one program from another are language-dependent and beyond the scope of this guide. In general, the HIPE_HOSTKEY environment variable must be set to the key string in the primary field of the client frame, afterwhich spawning the new program in that environment will cause it to be framed in the clientFrame

The title, icon, color and backgroundColor fields cannot be set within the clientFrame tag itself, they are set within the sub-console process and can be read but not modified within the tag. Events such as onTitle, onIcon, onColor and onBackgroundColor are triggered when the sub-console's properties change, and then the fields can be accessed to get their new values if required.

Notes

Example