link

Declaration

link (item, target: STRING)

Description

If the target is empty, then item is loaded into the frame associated with the current query without moving the query's current item. If the target is the name of the frame associated with the current query, then the query's current item is moved to item. If the target is some other frame, then item is loaded into that frame and functions exactly like load_item_in_frame.

Of course, item must be in the index and target must be a frame. Use is_frame and is_item to make sure.

See Also

is_frame
is_item
load_item_in_frame
navigation functions
Frame Manager
Database

Example

script link_to_questions is
  no_name_query_frame := 'questions'
    -- link the default query to the 'questions' frame
  link ('question_2', '')
    -- 'question_2' appears in 'questions'
    -- frame, but query current item is unchanged
  link ('question_2', 'questions')
    -- query moves to 'question_2', 'questions'
    -- is automatically updated
  link ('question_2', 'main_window_frame')
    -- 'question_2' is shown in 'main_window_frame'
end