INPUT /  OUTPUT /  LANGUAGE






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