[ Previous | Next | Contents | Glossary | Home | Search ]
Motif 2.1 Widget Writer's Guide

XmeTraitSet

Installs a trait on a specified object

Format

#include <Xm/TraitP.h>
Boolean XmeTraitSetXtPointer
objectXrmQuark traitXtPointer
trait_record

DESCRIPTION

XmeTraitSet installs trait on object. Typically, XmeTraitSet is called from a widget's class_part_initialize method. If it is, Motif propagates the trait to all subclasses of object.

object
Specifies the object. Typically, the object is a widget class.

trait
Specifies the XrmQuark value symbolizing the trait. Here is the list of trait quarks defined by the Motif toolkit:

XmQTaccessTextual
The object can display one primary text parcel.

XmQTactivatable
The object can become a command button in a DialogBox.

XmQTcareParentVisual
The object can borrow its parent's visual information.

XmQTcontainer
The object can manage children holding the XmQTcontainer trait.

XmQTcontainerItem
The object can be managed by a widget holding the XmQTcontainer trait.

XmQTdialogShellSavvy
The object can become a child of XmDialogShell.

XmQTjoinSide
The object can attach itself to one side of a suitable parent.

XmQTmenuSavvy
The object can become a menu child.

XmQTmenuSystem
The object can manage a menu system.

XmQTnavigator
The object can act as a navigator to a scrollable widget.

XmQTscrollFrame
The object can handle one or more widgets holding the XmQTnavigator trait.

XmQTspecifyRenderTable
The object can supply the names of its default render tables.

XmQTtakesDefault
The object can change its appearance to show that it is the default button.

XmQTtransfer
The object can serve as either the source or the destination (or possibly both) of a data transfer operation

trait_record
Specifies the name of the structure that holds the trait information. Specifying NULL turns off the trait for object and its subclasses.

RETURN

Returns True if the trait was succesfully installed on object. Otherwise, it returns False. One possible reason for failure is that the trait_record was not declared.

RELATED

XmeTraitGet(3).

[ Previous | Next | Contents | Glossary | Home | Search ]