Name

XmeTraitSet — Installs a trait on a specified object

Synopsis

#include <Xm/TraitP.h>
Boolean XmeTraitSet(object, trait, 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).