man page(1) manual page
Table of 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
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 View.

-button_del 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 Del.

-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.

SEE ALSO

Fx_Menubar(n), Fx_Entry(n), Fx_Print(n), Fx_QddbSearchParser(n), Fx(n)

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.


Table of Contents