Content-type: text/html; charset=UTF-8 Man page of Fx_Frame

Fx_Frame

Section: Herrin Software Development, Inc. (1)
Updated: 21 Oct 2000
Index Return to Main Contents

NAME

Fx_Frame - Bind a Tk frame/label to a Qddb structured attribute

SYNOPSIS

Fx_Frame itcl_instancename -w window -attr attrname ?options?

DESCRIPTION

Fx_Frame binds a Tk frame/label pair (with Add/View/Del buttons if the attribute is expandable) to a Qddb structured attribute. You must specify the -w and -attr options for each Fx_Frame instance.

OPTIONS

-setschema schema_desc

Sets the schema descriptor (returned by qddb_schema open) to schema_desc for all subsequent calls to Fx_Frame and Fx_Entry. Need only be specified once.

-w frame_path

Use the Tk window path frame_path when creating the frame for the entry and its buttons/label. This is mandatory.

-attr attr

Declares this instance to refer to the Qddb attribute attr in the current view. This is mandatory.

-restrict directory

Restricts all configuration files for expandable attributes to a particular directory. Typically, this is the same application-specific directory given by the -restrict option to Fx_Menubar. The directory need not exist, but some ancestor must be writable by the user. The user is constrained to the attr_config/ATTRNAME subdirectory for reading/writing expandable attribute configuration files, where ATTRNAME is the name of the attribute being configured.

-focus TkWidg

When an instance is added, place focus in the Tk widget TkWidg. Typically, this is an entry or a text box. You can get the entry by calling the Fx_Entry method GetEntry. For example, if the Fx_Entry instance that you want to receive focus is entry_number_1 and the Fx_Frame instance is frame_number_1, you might reconfigure the Fx_Frame after creating its entries by:

    frame_number_1 configure -focus [entry_number_1 GetEntry]

-beforeadd list

Evaluate the Tcl list list before adding a new instance.

-beforechange list

Evaluate the Tcl list list before selecting an instance to view.

-beforedelete list

Evaluate the Tcl list list before deleting a instance.

-afteradd list

Evaluate the Tcl list list after adding a new instance.

-afterchange list

Evaluate the Tcl list list after selecting and instance to view.

-afterdelete list

Evaluate the Tcl list list after deleting a instance.

-addtoend 0|1

Add new instances to the end of the instance pool for this attribute. Defaults to 1. If 0, new instances are added to the beginning of the instance pool (so that more recently added instances are normally viewed first).

-copy_instances list

When a new instance is created, copy attribute values from the current view to the new instance. Only attributes in list are copied.

-showbutton_add 0|1

If 0, do not show the add button if the attribute is expandable; otherwise, show the add button. The default is 1.

-showbutton_view 0|1

If 0, do not show the view button if the attribute is expandable; otherwise, show the view button. The default is 1.

-showbutton_del 0|1

If 0, do not show the del button if the attribute is expandable; otherwise, show the del button. The default is 1.

-button_add text|bitmap

If the first character in the value is '@', then Fx assumes it is a bitmap and the following characters specify the path to the bitmap file. Otherwise, it is assumed to be text. The default is Add.

-button_view text|bitmap

-button_del text|bitmap

-side top|bottom|left|right

Declares the side to pack the label's frame within $w.

-padx padding

Declare the horizontal padding for the frame specified with -w.

-pady padding

Declare the vertical padding for the frame specified with -w.

-anchor e|w|s|n|ne|se|sw|nw

Specifies the anchoring for the frame containing the label and buttons.

-relief sunken|raised|flat|groove

Specifies the relief of the frame specified by -w

-bd borderwidth

Specifies the border width of the frame specified by -w.

-labelfg color

Overrides the default Fx label color (blue).

OPTION NOTES

The options -button_{add,view,del}, -{before,after}{add,change,delete} and -addtoend are only valid for expandable attributes. The sort/print order of the "view" button (if it exists) may be configured by clicking <Control-Button-3> over the Fx_Frame's label.

METHODS

configure options: Reconfigure the instance with the specified options.

PROCEDURES

GetInstances: Returns all instances of Fx_Frame.

TK WIDGETS

Each Fx_Frame instance contains the main frame specified with -w (say .f), a subframe called f_0 (.f.f_0), a label l (.f.f_0.l), and three buttons b_add, b_view, and b_del (.f.f_0.b_add, etc.) iff the associated attribute is expandable. You can re-pack these Tk widgets any way you please after calling Fx_Frame.

DEFAULT BINDINGS

Clicking <Control-Button-3> over the Fx_Frame's label will bring up a dialog for configuring the view button's listbox. If the attribute associated with the Fx_Frame is not expandable, <Control-Button-3> does nothing.

NOTES

You must specify --with-itcl when configuring Qddb to install the Fx toolkit. Fx depends on [Incr Tcl]. The busy cursor depends on --with-blt.

REFERENCES

A Guide to QDDB
Eric H. Herrin II and Raphael A. Finkel

Qddb User's Guide

An ASCII Database for Fast Queries of Relatively Stable Data
Eric H. Herrin II and Raphael A. Finkel
Computing Systems, Volume 4 Number 2
University of California Press, Berkeley CA

Schema and Tuple Trees: An Intuitive Structure for 
Representing Relational Data
Eric H. Herrin, II and Raphael A. Finkel
Computing Systems, Volume 9, Number 2
MIT Press, Cambridge MA

TCL and the TK Toolkit 
John K. Ousterhout
Addison-Wesley, 1994
ISBN 0-201-63337-X

DIAGNOSTICS

BUGS

None known.

This document was created by man2html, using the manual pages.
Time: 18:55:30 GMT, October 31, 2018