Athena Widget Set - C Language Interface - X Consortium ... - X.Org

More documents

Recommendations

Info

Simple WidgetsTo find the currently selected Toggle in a radio group of Toggle widgets use Xaw-ToggleGetCurrent.XtPointer XawToggleGetCurrent( XawToggleGetCurrent(radio_group),radio_group);radio_groupSpecifies any Toggle widget in the radio group.The value returned by this function is the radioData of the Toggle in this radiogroup that is currently set. The default value for radioData is the name of thatToggle widget. If no Toggle is set in the radio group specified then NULL is returned.Changing the Toggle that is set in a radio group.To change the Toggle that is currently set in a radio group use XawToggleSetCurrent.void XawToggleSetCurrent( radio_data), radio_group, radio_data);radio_groupradio_dataSpecifies any Toggle widget in the radio group.Specifies the radioData identifying the Toggle thatshould be set in the radio group specified by theradio_group argument.XawToggleSetCurrent locates the Toggle widget to be set by matching radio_dataagainst the radioData for each Toggle in the radio group. If none match, Xaw-ToggleSetCurrent returns without making any changes. If more than one Togglematches, XawToggleSetCurrent will choose a Toggle to set arbitrarily. If this causesany Toggle widgets to change state, all routines in their callback lists will beinvoked. The callback routines for a Toggle that is to be unset will be called beforethe one that is to be set. Unsetting all Toggles in a radio group.To unset all Toggle widgets in a radio group use XawToggleUnsetCurrent.void XawToggleUnsetCurrent( XawToggleUnsetCurrent(radio_group),radio_group);radio_groupSpecifies any Toggle widget in the radio group.If this causes a Toggle widget to change state, all routines on its callback list willbe invoked.57
Chapter 4. MenusThe Athena widget set provides support for single paned non-hierarchical popupand pulldown menus. Since menus are such a common user interface tool, supportfor them must be provided in even the most basic widget sets. In menuing as inother areas, the Athena Widget Set provides only basic functionality.Menus in the Athena widget set are implemented as a menu container (the Simple-Menu widget) and a collection of objects that comprise the menu entries. The SimpleMenuwidget is itself a direct subclass of the OverrideShell widget class, so noother shell is necessary when creating a menu. The managed children of a Simple-Menu must be subclasses of the Sme (Simple Menu Entry) object.The Athena widget set provides three classes of Sme objects that may be used tobuild menus.SmeSme-BSBSme-LineThe base class of all menu entries. It may be used as a menu entry itselfto provide blank space in a menu. "Sme" means "Simple Menu Entry."This menu entry provides a selectable entry containing a text string. Abitmap may also be placed in the left and right margins. "BSB" means"Bitmap String Bitmap."This menu entry provides an unselectable entry containing a separatorline.The SimpleMenu widget informs the window manager that it should ignore its windowby setting the Override Redirect flag. This is the correct behavior for thepress-drag-release style of menu operation. If click-move-click or "pinable" menusare desired it is the responsibility of the application programmer, using the Simple-Menu resources, to inform the window manager of the menu.To allow easy creation of pulldown menus, a MenuButton widget is also providedas part of the Athena widget set.Using the MenusThe default configuration for the menus is press-drag-release. The menus will typicallybe activated by clicking a pointer button while the pointer is over a MenuButton,causing the menu to appear in a fixed location relative to that button; this isa pulldown menu. Menus may also be activated when a specific pointer and/or keysequence is used anywhere in the application; this is a popup menu (e.g. clickingCtrl- in the common application xterm). In this case the menushould be positioned under the cursor. Typically menus will be placed so the pointercursor is on the first menu entry, or the last entry selected by the user.The menu remains on the screen as long as the pointer button is held down. Movingthe pointer will highlight different menu items. If the pointer leaves the menu, ormoves over an entry that cannot be selected then no menu entry will highlighted.When the desired menu entry has been highlighted, releasing the pointer buttonremoves the menu, and causes any mechanism associated with this entry to be invoked.58
Page 1 and 2:
Athena Widget Set -C Language Inter
Page 3 and 4:
Table of Contents1. Athena Widgets
Page 5 and 6:
Athena Widget Set -C Language Inter
Page 7 and 8:
Athena Widgetsand The Intrinsicswid
Page 9 and 10:
Athena Widgetsand The Intrinsics•
Page 11 and 12: Athena Widgetsand The IntrinsicsDRD
Page 13 and 14: Using Widgetsapplication_classoptio
Page 15 and 16: Using WidgetsName Class Type Defaul
Page 17 and 18: Using Widgetsapp_contextSpecifies t
Page 19 and 20: Using Widgetsnum_argsSpecifies the
Page 21 and 22: Using Widgets6. When the argument l
Page 23 and 24: Using Widgetseither the name used t
Page 25 and 26: Using WidgetsArg arglist[10];arglis
Page 27 and 28: Simple WidgetsSuperclass LabelResou
Page 29 and 30: Simple Widgets• Processing applic
Page 31 and 32: Simple WidgetsName Class Type Notes
Page 33 and 34: Simple WidgetsResourceswill allow i
Page 35 and 36: Simple WidgetsResourcesWhen creatin
Page 37 and 38: Simple WidgetsforegroundA pixel val
Page 39 and 40: Simple WidgetsresizeSpecifies a Boo
Page 43 and 44: Simple WidgetssliderWidthPanner Act
Page 47 and 48: Simple WidgetsRepeater ActionsThe R
Page 51 and 52: Simple Widgetsbacks and passes eith
Page 53 and 54: Simple WidgetsSimple Widget\ * reso
Page 55 and 56: Simple WidgetsResourcesThe StripCha
Page 57 and 58: Simple Widgetsvoid(*getValueProc)(
Page 61: Simple Widgetsnotify()When the Togg
Page 65 and 66: MenusNotify(\|)Called when the user
Page 67 and 68: MenusleftBitmaprightBitmapThis is a
Page 69 and 70: Chapter 5. Text WidgetsThe Text wid
Page 71 and 72: Text Widgetswill be insensitive and
Page 73 and 74: Text WidgetsTwoThreeFourFiveSelect
Page 75 and 76: Text Widgetsscroll-one-line-up()scr
Page 77 and 78: Text Widgetskill-to-end-of-paragrap
Page 79 and 80: Text Widgetsreconnect-im()The popup
Page 81 and 82: Text WidgetsText FunctionsLeft: bac
Page 83 and 84: Text Widgetsint XawTextReplace( w,
Page 85 and 86: Text WidgetsCalling this function i
Page 87 and 88: Text WidgetsClass Header fileClassC
Page 89 and 90: Text WidgetsResourcesClass Name Tex
Page 91 and 92: Text WidgetsClearing Portions of th
Page 93 and 94: Text WidgetsFinding the Size of the
Page 95 and 96: Text WidgetsXawTextPosition Read( w
Page 97 and 98: Text Widgetstypevalue_returnlength_
Page 99 and 100: Text WidgetsResourcesSuperclass Tex
Page 101 and 102: Text WidgetsBoolean XawAsciiSaveAsF
Page 103 and 104: Text WidgetsName Class Type Notes D
Page 105 and 106: Chapter 6. Composite and Constraint
Page 107 and 108: Composite and ConstraintWidgetsName
Page 109 and 110: Composite and ConstraintWidgetsName
Page 111 and 112: Composite and ConstraintWidgetsLayo
Page 113 and 114:
Composite and ConstraintWidgets{Wid
Page 115 and 116:
Composite and ConstraintWidgetsName
Page 117 and 118:
Composite and ConstraintWidgetsAppl
Page 119 and 120:
Page 121 and 122:
Page 123 and 124:
Composite and ConstraintWidgets: Gr
Page 125 and 126:
Composite and ConstraintWidgetsReso
Page 127 and 128:
Page 129 and 130:
Composite and ConstraintWidgetsAppl
Page 131 and 132:
Composite and ConstraintWidgetsLayo
Page 133 and 134:
Creating New Widgets(Subclassing)It
Page 135 and 136:
Creating New Widgets(Subclassing)dr
Page 137 and 138:
Creating New Widgets(Subclassing)st
Page 139 and 140:
Creating New Widgets(Subclassing)In
Page 141:
AcknowledgmentsDonna ConverseMIT X
show all

Athena Widget Set - C Language Interface - X Consortium ... - X.Org

Create successful ePaper yourself

Delete template?

Save as template?