Партнёры:
Хостинг:
NAME
DtComboBox - the ComboBox widget class
SYNOPSIS
#include <Dt/ComboBox.h>
DESCRIPTION
The DtComboBox widget is a combination of a TextField and a
List widget that provides a list of valid choices for the
TextField. Selecting an item from this list automatically
fills in the TextField with that list item.
Widget subclassing is not supported for the DtComboBox
widget class.
The resources for the XmList and XmTextField widgets that
are created by the DtComboBox are accessible by using the
XtNameToWidget(3X) function. The names of these widgets are
*List and Text, respectively. (The *List notation is
required because the List widget is not an immediate descen-
dant of the DtComboBox. See XtNameToWidget(3X).) in the .)
Classes
The DtComboBox widget inherits behavior and resources from
the Core, Composite and XmManager classes.
The class pointer is dtComboBoxWidgetClass.
The class name is DtComboBoxWidget.
New Resources
The following table defines a set of widget resources used
by the application to specify data. The application 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, the application must
remove the DtN or DtC prefix and use the remaining letters.
To specify one of the defined values for a resource in a
.Xdefaults file, the application must remove the Dt prefix
and use the remaining letters (in either lower case or upper
case, but including 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 appli-
cable (N/A).
DtComboBox Resource Set
_______________________________________________________________________________
Name Class Type Default Access
_______________________________________________________________________________
DtNmarginHeight DtCMarginHeight Dimension 2 CSG
DtNmarginWidth DtCMarginWidth Dimension 2 CSG
DtNselectedItem DtCSelectedItem XmString dynamic CSG
DtNselectedPosition DtCSelectedPosition int dynamic CSG
DtNselectionCallback DtCCallback XtCallbackList NULL C
DtNcomboBoxType DtCComboBoxType unsigned int DtDROP_DOWN_LIST C
DtNmarginHeight
Specifies the number of pixels added between the
top and bottom of the text widget and the start of
the shadow.
DtNmarginWidth
Specifies the number of pixels added between the
right and left sides of the text widget and the
start of the shadow.
DtNselectedItem
This resource is passed through to the XmList to
set the XmNselectedItemCount and XmNselectedItems
as the single item in the XmNitems that matches
this specified XmString in the List. Setting both
DtNselectedItem and DtNselectedPosition in the same
argument list produces undefined behavior.
DtNselectedPosition
This resource is passed through to the XmList to
set the XmNselectedItemCount and XmNselectedItems
as the single item at this specified position in
the List. Setting both DtNselectedItem and
DtNselectedPosition in the same argument list pro-
duces undefined behavior.
DtNselectionCallback
This callback list is issued when an item is
selected from the DtComboBox widget's List. The
call_data structure contains a DtComboBoxCallback-
Struct with the reason DtCR_SELECT.
DtNcomboBoxType
This resource determines the style of the DtCom-
boBox. There are two choices:
DtDROP_DOWN_COMBO_BOX
Provides an editable text area.
DtDROP_DOWN_LIST
Provides a static text area.
Inherited Resources
The DtComboBox widget inherits behavior and resources from
the following named superclasses. For a complete descrip-
tion of each resource, see the man page for that superclass.
XmManager Resource Set
_____________________________________________________________________________
Name Class Type Default Access
_____________________________________________________________________________
XmNbottom- XmCBottom- Pixel dynamic CSG
ShadowColor ShadowColor
XmNbottom- XmCBottom- Pixmap XmUNSPECIFIED- CSG
ShadowPixmap ShadowPixmap _PIXMAP
XmNforeground XmCForeground Pixel dynamic CSG
XmNhelpCallback XmCCallback XtCallbackList NULL C
XmNhighlightColor XmCHighlightColor Pixel dynamic CSG
XmNhighlightPixmap XmCHighlightPixmap Pixmap dynamic CSG
XmNinitialFocus XmCInitialFocus Widget NULL CSG
XmNnavigationType XmCNavigationType XmNavigationType dynamic CSG
XmNshadowThickness XmCShadowThickness Dimension dynamic CSG
XmNstringDirection XmCStringDirection XmStringDirection dynamic CG
XmNtopShadowColor XmCTopShadowColor Pixel dynamic CSG
XmNtopShadowPixmap XmCTopShadowPixmap Pixmap dynamic CSG
XmNtraversalOn XmCTraversalOn Boolean dynamic CSG
XmNunitType XmCUnitType unsigned char dynamic CSG
XmNuserData XmCUserData XtPointer NULL CSG
Composite Resource Set
________________________________________________________________________
Name Class Type Default Access
________________________________________________________________________
XmNchildren XmCReadOnly WidgetList NULL G
XmNinsertPosition XmCInsertPosition XtOrderProc default procedure CSG
XmNnumChildren XmCReadOnly Cardinal 0 G
Core Resource Set
_______________________________________________________________________________________
Name Class Type Default Access
_______________________________________________________________________________________
XmNaccelerators XmCAccelerators XtAccelerators dynamic CSG
XmNancestorSensitive XmCSensitive Boolean dynamic G
XmNbackground XmCBackground Pixel dynamic CSG
XmNbackgroundPixmap XmCPixmap Pixmap XmUNSPECIFIED- CSG
_PIXMAP
XmNborderColor XmCBorderColor Pixel XtDefaultForeground CSG
XmNborderPixmap XmCPixmap Pixmap XmUNSPECIFIED- CSG
_PIXMAP
XmNborderWidth XmCBorderWidth Dimension 0 CSG
XmNcolormap XmCColormap Colormap dynamic CG
XmNdepth XmCDepth int dynamic CG
XmNdestroyCallback XmCCallback XtCallbackList NULL C
XmNheight XmCHeight Dimension dynamic CSG
XmNinitial- XmCInitial- Boolean True C
ResourcesPersistent ResourcesPersistent
XmNmappedWhen- XmCMappedWhen- Boolean True CSG
Managed Managed
XmNscreen XmCScreen Screen * dynamic CG
XmNsensitive XmCSensitive Boolean True CSG
XmNtranslations XmCTranslations XtTranslations dynamic CSG
XmNwidth XmCWidth Dimension dynamic CSG
XmNx XmCPosition Position 0 CSG
XmNy XmCPosition Position 0 CSG
Callback Information
A pointer to the following structure is passed to each
DtComboBox callback:
typedef struct {
int reason;
XEvent *event;
XmString item_or_text;
int item_position;
} DtComboBoxCallbackStruct;
The reason argument indicates why the callback was invoked;
it is always DtCR_SELECT.
The event argument points to the XEvent that triggered the
callback, or NULL if the callback was not triggered by an
XEvent.
The item_or_text argument is the contents of the Text widget
at the time the event caused the callback to be invoked.
This data is only valid within the scope of the call_data
structure, so the application must copy it when it is used
outside of this scope.
The item_position argument is the new value of the DtNselec-
tedPosition resource in the DtComboBox's List. If this is
zero, it means the user entered a value in the XmTextField
widget.
SEE ALSO
DtComboBoxAddItem(3X), DtComboBoxDeletePos(3X),
DtComboBoxSelectItem(3X), DtComboBoxSetItem(3X),
DtCreateComboBox(3X), Composite(3X), Constraint(3X),
Core(3X), XmList(3X), XmManager(3X), XmText(3X),
XmTextField(3X), XtGetValues(3X), XtSetValues(3X).
|
Закладки на сайте Проследить за страницей |
Created 1996-2024 by Maxim Chirkov Добавить, Поддержать, Вебмастеру |