Provided by: libmotif-dev_2.3.8-3.1build1_amd64 
NAME
XmLabelGadget — The LabelGadget widget class "XmLabelGadget" "widget class" "LabelGadget"
SYNOPSIS
#include <Xm/LabelG.h>
DESCRIPTION
LabelGadget is an instantiable widget and is also used as a superclass for other button
gadgets, such as PushButtonGadget and ToggleButtonGadget.
LabelGadget can contain either text or a pixmap. LabelGadget text is a compound string.
Refer to the Motif Programmer's Guide for more information on compound strings. The text
can be multilingual, multiline, and/or multifont. When a LabelGadget is insensitive, its
text is stippled, or the user-supplied insensitive pixmap is displayed.
LabelGadget supports both accelerators and mnemonics primarily for use in LabelGadget
subclass widgets that are contained in menus. Mnemonics are available in a menu system
when the button is visible. Accelerators in a menu system are accessible even when the
button is not visible. The LabelGadget displays the mnemonic by underlining the first
matching character in the text string. The accelerator is displayed as a text string
adjacent to the label text or pixmap, depending on the layout direction.
LabelGadget consists of many margin fields surrounding the text or pixmap. These margin
fields are resources that may be set by the user, but LabelGadget subclasses and Manager
parents also modify some of these fields. They tend to modify the XmNmarginLeft,
XmNmarginRight, XmNmarginTop, and XmNmarginBottom resources and leave the XmNmarginWidth
and XmNmarginHeight resources as set by the application.
LabelGadget takes into account XmNshadowThickness in determining its layout but does not
draw the shadow. That is, if XmNshadowThickness is greater than 0 (zero), LabelGadget
leaves space for the shadow, but the shadow does not appear.
In a LabelGadget, XmNtraversalOn and XmNhighlightOnEnter are forced to False inside Popup
menu panes, Pulldown menu panes, and OptionMenus. Otherwise these resources default to
False.
LabelGadget uses the XmQTmenuSystem and XmQTspecifyRenderTable traits, and holds the
XmQTaccessTextual, XmQTcareParentVisual, XmQTmenuSavvy, and XmQTtransfer traits.
Data Transfer Behavior
LabelGadget and it subclasses, except when used in a menu system, support dragging of the
label contents from the LabelGadget. However, the label contents are draggable only if
the XmNenableUnselectableDrag resource of XmDisplay is set to True.
As a source of data, LabelGadget and its subclasses support the following targets and
associated conversions of data to these targets:
locale If the locale target matches the widget's locale, the widget transfers
XmNlabelString in the encoding of the locale. This target is supported only
when XmNlabelType is XmSTRING or XmPIXMAP_AND_STRING.
COMPOUND_TEXT
The widget transfers XmNlabelString as type COMPOUND_TEXT. This target is
supported only when XmNlabelType is XmSTRING or XmPIXMAP_AND_STRING.
UTF8_STRING
The widget transfers XmNlabelString as type UTF8_STRING. This target is
supported only when XmNlabelType is XmSTRING of XmPIXMAP_AND_STRING.
PIXMAP The widget transfers XmNlabelPixmap as type DRAWABLE. This target is supported
when XmNlabelType is XmPIXMAP or XmPIXMAP_AND_STRING.
STRING The widget transfers XmNlabelString as type STRING. This target is supported
when XmNlabelType is XmSTRING or XmPIXMAP_AND_STRING.
TEXT If XmNlabelString is fully convertible to the encoding of the locale, the widget
transfers XmNlabelString in the encoding of the locale. Otherwise, the widget
transfers XmNlabelString as type COMPOUND_TEXT. This target is supported when
XmNlabelType is XmSTRING or XmPIXMAP_AND_STRING.
_MOTIF_CLIPBOARD_TARGETS
The widget transfers, as type ATOM, a list of the targets it supports for the
CLIPBOARD selection. When XmNlabelType is XmSTRING or XmPIXMAP_AND_STRING,
these include the following targets:
• _MOTIF_COMPOUND_STRING
• COMPOUND_TEXT
• UTF8_STRING
• The encoding of the locale, if XmNlabelString is fully convertible to the
encoding of the locale
• STRING, if XmNlabelString is fully convertible to STRING
When XmNlabelType is XmPIXMAP or XmPIXMAP_AND_STRING, the targets include
PIXMAP.
_MOTIF_COMPOUND_STRING
The widget transfers XmNlabelString as a compound string in Byte Stream format.
This target is supported when XmNlabelType is XmSTRING or XmPIXMAP_AND_STRING.
_MOTIF_EXPORT_TARGETS
The widget transfers, as type ATOM, a list of the targets to be used as the
value of the DragContext's XmNexportTargets in a drag-and-drop transfer. When
XmNlabelType is XmSTRING or XmPIXMAP_AND_STRING, these include
_MOTIF_COMPOUND_STRING, COMPOUND_TEXT, UTF8_STRING, the encoding of the locale,
STRING, TEXT, BACKGROUND, and FOREGROUND. When XmNlabelType is XmPIXMAP or
XmPIXMAP_AND_STRING, these include PIXMAP, BACKGROUND, and FOREGROUND.
As a source of data, LabelGadget also supports the following standard Motif targets:
BACKGROUND
The widget transfers the parent's XmNbackground as type PIXEL.
CLASS The widget finds the first shell in the widget hierarchy that has a WM_CLASS
property and transfers the contents as text in the current locale.
CLIENT_WINDOW
The widget finds the first shell in the widget hierarchy and transfers its
window as type WINDOW.
COLORMAP The widget transfers the parent's XmNcolormap as type COLORMAP.
FOREGROUND
The widget transfers the parent's XmNforeground as type PIXEL.
NAME The widget finds the first shell in the widget hierarchy that has a WM_NAME
property and transfers the contents as text in the current locale.
TARGETS The widget transfers, as type ATOM, a list of the targets it supports. These
include the standard targets in this list. When XmNlabelType is XmSTRING or
XmPIXMAP_AND_STRING, these also include _MOTIF_COMPOUND_STRING, COMPOUND_TEXT,
UTF8_STRING, the encoding of the locale, STRING, and TEXT. When XmNlabelType is
XmPIXMAP or XmPIXMAP_AND_STRING, these also include PIXMAP.
TIMESTAMP The widget transfers the timestamp used to acquire the selection as type
INTEGER.
_MOTIF_RENDER_TABLE
The widget transfers XmNrenderTable if it exists, or else the default text
render table, as type STRING.
_MOTIF_ENCODING_REGISTRY
The widget transfers its encoding registry as type STRING. The value is a list
of NULL separated items in the form of tag encoding pairs. This target
symbolizes the transfer target for the Motif Segment Encoding Registry. Widgets
and applications can use this Registry to register text encoding formats for
specified render table tags. Applications access this Registry by calling
XmRegisterSegmentEncoding and XmMapSegmentEncoding.
Classes
LabelGadget inherits behavior, resources, and traits from Object, RectObj and XmGadget.
The class pointer is xmLabelGadgetClass.
The class name is XmLabelGadget.
New Resources
The following table defines a set of widget resources used by the programmer to specify
data. The programmer can also set the resource values for the inherited classes to set
attributes for this widget. To reference a resource by name or by class in a .Xdefaults
file, remove the XmN or XmC prefix and use the remaining letters. To specify one of the
defined values for a resource in a .Xdefaults file, remove the Xm prefix and use the
remaining letters (in either lowercase or uppercase, but include any underscores between
words). The codes in the access column indicate if the given resource can be set at
creation time (C), set by using XtSetValues (S), retrieved by using XtGetValues (G), or is
not applicable (N/A).
┌──────────────────────────────────────────────────────────────────────────────────────────────────────────┐
--
RELATED
Object(3), RectObj(3), XmCreateLabelGadget(3), XmVaCreateLabelGadget(3),
XmVaCreateManagedLabelGadget(3), XmFontListCreate(3), XmStringCreate(3),
XmStringCreateLtoR(3), and XmGadget(3).
XmLabelGadget(3)