JIM Control Usage Manual : Creating A Predefined Inline Window
[ To Table Of Contents ]

A predefined inline window may consist of two parts. The first part (depending on how you use it), is creation of a <DIV> element in your web page that would hold initial content of the inline window. The second part, is adding data to some arrays that represent the attributes of the inline window (the DIV is used to render the inline window inside of it). The reason this option is available to you is to give you a greater level of control over your inline windows.

As an example, let's say that you want to have a window visible when a web page loads. You add the following code to your web page(s) to set up the absolutely positioned <DIV> element as something such as:
<div id="number_one" name="number_one" class="divbox_one">
   <table class="tabcolor"><tr>
      <td width="65%" align="left" class="tabtitle"> A Title</td>
      <td width="35%" align="right"> </td>
   </tr></table><br />
   <span class="wcaption"><strong>Window #1:</strong><br />This is a plain window without user options associated to it.</span>
</div>

Now that you have created a static inline window, you will need to specify its attributes in the window arrays (found in the JIM Control source file (jim_control.js)):

window_position_x[1] = 50;	This specifies the position, along the X-axis of the web page where the inline window will be positioned.
window_position_y[1] = 200;	This specifies the position, along the Y-axis of the web page where the inline window will be positioned.
window_position_width[1] = 150;	This specifies the width of the inline window.
window_position_height[1] = 150;	This specifies the height of the inline window.
window_position_zindex[1] = 10;	This specifies the default z-index of the inline window. Normally you want this to be a low value so other inline windows, as they come into focus, will be shown on top as the active inline window.
window_position_id[1] = "number_one";	This specifies the ID of the DIV element that holds the inline window.
window_visible[1] = "visible";	This specifies whether the current inline window is visible. If you wish to hide the inline window, use a value of 'hidden' instead.
window_ifrm[1] = "";	If the DIV contains an iframe, this will hold the src value of the iframe. Typically, this array is set with dynamic inline windows, not manually.
window_ifrmname[1] = "";	If the DIV contains an iframe, this will hold the ID of the iframe. Typically this array is set with dynamic inline windows, not manually.
window_title[1] = "A Title";	If the DIV contains the header bar, this will hold the text that will be displayed in the header bar.
window_title_class[1] = "css_class_name";	CSS class associated to title area. If nothing is specified, the tabtitle css class is referenced.
window_resize[1] = "yes";	Equals yes if window can be resized, otherwise set it to no.

It is important to note that an inline window cannot be resized or dragged until you've added the attributes (such as by the example above) to the window arrays.

The Advantage of Predefined
One of the most significant reasons to use at least one predefined inline window is that you will have to ability to reuse the same inline window for other types of content that you may wish to insert into it. For example, you may want one link that a user clicks on to populate the inline window with text/html, yet with another link you may want the same inline window populated with an image or even another web page. By reusing predefined windows, you also lower the overhead on the end-user's computer of needing to keep track of a slew of inline windows.