Google

CCP4 web logo CCP4i: Graphical User Interface
Documentation for Programmers
update_extendingframe

next button previous button top button

NAME

update_extendingframe - revise the number of visible frames of an extending frame widget

SYNOPSIS

update_extendingframe proc_name external_counter arrayname counterVar increment update_scroll

DESCRIPTION

See also documentation on CreateExtendingFrame and UpdateExtendingFrame. In particular, UpdateExtendingFrame may be used instead of update_extendingframe as it has a slightly more simple syntax.

The number of visible frames of an extending frame widget is usually controlled by the user with the standard buttons labelled 'Add foo' and 'Edit list'. However, occasionally the application programmer may want to reset the number of visible frames explicitly, usually when first drawing the window to reset from the standard default of having no frames visible. The programmer should ensure that all the parameters for all the widgets that will be drawn are already defined.

The inputs to this procedure are:

proc_name
the name of the procedure which draws the contents of one frame of the extending frame. This prcedure should be in the task.tcl.
external_counter
should usually be zero unless this extending frame is nested inside another extending frame or toggle frame in which case this parameter should be n for the nth frame of the higher extending/toggle frame.
arrayname
is the name of the array for the task
counterVar
is the name of the element in the array which contains the counter for the number of visible frames
increment
is the number of frames by which to increase or (if negative) decrease the number of visble frames.
update_scroll
should have a value 1 or 0. If it is 1 (i.e. 'true') then the range of the scroll bar on the side of the task window is updated. This is usually necessary if the number of lines displayed in the window has changed. However, the process is slow and should be blocked by setting update_scroll to 0 if there are multiple changes to the window.

KEYWORDS