Definitions Editor

The Edit Definitions dialog provides the means specifying which definitions you wish to appear on the widget palette.

At the top of the dialog is an area for selecting and browsing around your definitions. The Base Directory button displays a selection dialog used to specify the directory into which you have or will place your definitions. The items list is a list of known definitions. You can select from the Definitions list provided or type a definition name directly into the Definition field.

The Widget Name is the name of a definition widget in the specified file.

The Save File resource is the name of the file in which the specified definition can be found.

The Icon Resource is the name of a resource which is used to access the Palette icon for the definition. WorkShop Visual will query this resource at runtime for a file name. The algorithm used is the same as for the standard widget icons.

The Icon File resource is the name of a bitmap or XPM formatted file which contains the image to be displayed in the Palette. You can use the WorkShop Visual Pixmap Editor to create the Icon file. This file is only used if the Icon Resource does not yield a valid filename.

The Include file resource allows you to specify the name of a header file which contain the declaration of the definition. This header file will be included into generated source when you create instances of your definition in your widget hierarchy.

The Resource File resource is the name of a file which contains, definition-specific X resources.

You may optionally specify an interface to the help system for your definition object; WorkShop Visual supports both flat ascii help files and FrameMaker Help document and markers (depending upon whether the Use FrameViewer toggle is set from the Help menu).

The Prime button fills in the fields of the dialog using information derived from the currently selected widget and the current design. It does not change or add a new definition but simply supplies some default values using the current context as a template. This can save you having to type in all the fields.

The Update button will effect the changes you have made and adds (or updates) your definition into the widget Palette.

The Delete button will remove the currently selected definition from the Palette.

For fields which are specified as file names you can press the button to display a FileSelection dialog.

NOTES

The initial list of definition widgets in the Palette is taken from the file ${HOME}/.xddefinitionsrc.

See also: