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.
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.
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.