Widget Reference

The following chapters provide a reference describing the resources, actions, callbacks and public functions for the EditObject, ObjectEditor, EditTable, Scroll, and View3D widget classes and the CompBase widget metaclass.

This chapter includes the following sections:


Overview


Introduction

The INT widgets are created in exactly the same manner as Xm widgets are created. There are widget creation convenience functions that you can use to create (unmanaged) INT widgets. These widget creation functions are described in the INT widget class reference sections. You can also use the Xt widget creation functions:

As always, after you create an unmanaged widget, you must manage the widget before it is visible on the screen.


INT widgets are freed in exactly the same way as Xm widgets are freed. You can use the Xt function, XtDestroyWidget, to free the memory and data structures associated with a INT widget or object. When a parent widget is destroyed with this function, all of its children will also be destroyed.


Some of the INT widgets (e.g. EditTable) use external data structures which you may need to free using the Xt function, XtFree. Also, some of the INT functions (e.g. XintEditTableGetColumnData) return pointers to a copy of the data requested. You may also need to free the storage allocated for the copy when you have finished using it. The widget and object reference sections point out when it is your responsibility to free INT widget or object related data structures.


An application gets the current value of a resource of an INT widget in exactly the same manner as it gets resources of Xm widgets. You can use the Xt resource value access functions:


An application sets the value of a resource of an INT widget in exactly the same manner as it sets the resources of Xm widgets at widget creation time. After widget creation time you can use the following Xt resource value access functions to set resources:


EditObject is the widget class that serves as a container for all the Graphic objects. It provides the methods, actions and callbacks necessary to create, display and edit Graphic objects. Every Graphic object must be created with a parent that is an EditObject widget or whose class is derived from EditObject.

The ObjectEditor class provides a panel containing a set of buttons and menus for interactively creating and modifying the resources of Graphic objects, including the line and fill style, the fill pattern, the colors, etc. The appearance and the content of the panel can be modified through the resources provided by the ObjectEditor class.

The EditTable class provides a set of programming tools to help you create advanced spreadsheet and table-oriented data displays in the X Window/Motif environment. EditTAble makes it easy to control all aspects of a table display, from the simple arrangements of titles, annotation, margins, color, and shading, to the more complex aspects of data formatting, validation, and hardcopy output.

The Scroll is the widget class that is a container widget that scrolls INT widgets so that the scrolled child widget's annotation remains visible during scrolling. The Scroll widget combines one or two ScrollBar widgets, a viewing area that implements a visible window onto a portion of the scrolled child, and drawing area widgets for displaying the scrolled child widget's title, horizontal annotation and vertical annotation.


Summary of Components

The following widget classes are described in this section: