load_item_in_frame

Declaration

load_item_in_frame (item, target: STRING)

Description

Load the item document into target. Of course, item must be in the index and target must be a frame. Use is_frame and is_item to make sure. Calls are handled in the order they are given, so if you load a frameset with one call, you can target a document expected to be loaded in a second call.

The name of the frame is assigned when you create the frameset page in your content. Also, there is a default frame for each window you create, named after the window. If your window is named 'pages', then the default main frame is named 'pages_window_frame'.

See Also

is_frame
window and frame functions
Frame Manager

Example

script on_error is
  -- responding to the error event
  if not is_window ('error') then
    make_window ('error')
    load_item_in_frame ('error_frames', 'error_window_frame')
    load_item_in_frame ('error_page', 'error_content')
      -- 'error_content' is a frame create as part of
      -- loading 'error_frames'
  end
  show_window ('error')
end