About Infocon Components

Infocon structure and functionality

This diagram illustrates the basic structure and functionality of the infocon component:

1. Selected content area: This area is where the content for the selected record displays.

   What actually displays here depends on the Display Selected Item As property for the infocon component. If that property is set to Text, then the value that displays here is taken from the first display field in the selected tile. If the Display Selected Item As property is set to Tile, then this area displays the entire selected tile.

   Note that the tile is not resized to fit the available space. If it is too large, it is simply truncated. So, you must take care when defining the width and height for the infocon component, to make sure that the tile can display if the Tile option is selected. This means that the infocon must be sized larger than the tile form it is being used to display.

2. Infocon header: This is the area that displays at all times. This area includes both the Selected content area and the Drop-down arrow.

   When the infocon is displaying in the collapsed mode, the header is all that displays. When the infocon is in the expanded mode, the Expanded display area also displays.

   Note: If the Always Expand property is set to True, the entire header is hidden.
3. Drop-down arrow: This button toggles the infocon back and forth from the collapsed mode to the expanded mode.

   This button functions much like the drop-down arrows used in ComboBox and List components.

4. Expanded display area: This area displays only when the infocon is in the expanded mode.
   Note: If the Always Expand property is set to True, then this area always displays.

   This area can extend beyond the borders of the Infocon header area in any direction, depending on how the Tile Direction property is set for the infocon. In all cases, this display area "floats" above all other form content. The size of this area is specified by settings in the Tile Direction, List Columns, and List Rows properties for the infocon.

   When a tile is selected, this area closes, and the selected tile is displayed in the header.

Designing infocon behavior

When designing forms to work with infocon components, it is helpful to keep in mind that the Tile Direction, List Columns, and List Rows properties interact to define the infocon's appearance and behavior.

When tile direction is right or left

These are the general rules for infocon behavior when the Tile Direction property is set to Right or Left. Note that these rules might not apply, depending on the size and placement of the infocon component within the form.

• The height of the expanded display area (see previous section) is determined by the List Rows property. The number specified there determines the number of whole tiles that display top-to-bottom.
• If all tiles returned do not fit within the available expanded display area, a horizontal scrollbar provides access to the rest of the tiles.

When tile direction is down or up

These are the general rules for infocon behavior when the Tile Direction property is set to Down or Up. Note that these rules might not apply, depending on the size and placement of the infocon component within the form.

• The width of the expanded display area (see previous section) is determined by the List Columns property. The number specified there determines the number of whole tiles that are displayed side-by-side. If necessary, a horizontal scrollbar is used.
• If all tiles returned do not fit within the available Expanded display area, a vertical scrollbar provides access to the rest of the tiles.
• If horizontal expansion is required, the Expanded display area always expands to the right.

Miscellaneous other comments on infocon behavior

These are some other notes and comments about infocon behaviors:

• Tile images can be loaded using "Just In Time" processing. For the smart client, this depends on the tile definition. For the web client, the images are always loaded after the tiles are initially retrieved and rendered. The images then appear in the tiles as they are loaded.
• Previous sections have noted that the general rules might not apply, depending on the size and placement of the infocon component within the form.

  For example, in cases where the Tile Direction property has been set to Down, if the infocon component is located near the bottom of the form, it actually displays the Expanded display area as though the Tile Direction is set to Up.

  Typically, the underlying logic first tries to display the popup panel with the requested direction and size (the List Columns or List Rows properties). If that fails, it tries the opposite direction, still with the requested size. If that fails, scrollbars are introduced and the size is reduced.

  In some cases, the expanded display area can even overlap the header (see the section on infocon structure and functionality).  

  This is seen most often in the web client, because the limitations of the browser window are more stringent.

• In the web client only, the tile forms themselves can have buttons and hyperlink button components. These components trigger their events if the named event handler is defined on the host form. The infocon processing logic guarantees that the tile that contains the clicked button is selected before the event is triggered.

About drag and drop events with infocons

You can use Drag From and Drop On form events as you would in a list box component.