Section 3: library functions
XtReservePropertyAtom, XtReleasePropertyAtom – maintain a cache of property atoms Syntax #include <X11/Intrinsic.h> Atom XtReservePropertyAtom(Widget w); void XtReleasePropertyAtom(Widget w, Atom atom); Arguments w Specifies the widget used to reserve the atom. atom Specifies the atom whose reservation is to be released. Description XtReservePropertyAtom returns an atom that may be used for properties in conjunction with conversion…
XtGetGC, XtReleaseGC – obtain and destroy a sharable GC Syntax #include <X11/Intrinsic.h> GC XtGetGC(Widget w, XtGCMask value_mask, XGCValues *values); void XtReleaseGC(Widget w, GC gc); Arguments gc Specifies the GC to be deallocated. values Specifies the actual values for this GC. value_mask Specifies which fields of the values are specified. w Specifies the widget. Description The…
XtRegisterGrabAction – register button and key grabs Syntax #include <X11/Intrinsic.h> void XtRegisterGrabAction(XtActionProc action_proc, Boolean owner_events, unsigned int event_mask, int pointer_mode, int keyboard_mode); Arguments action_proc Specifies the action procedure to search for in translation tables. action event params num_params Specify arguments to XtGrabButton or XtGrabKey Description XtRegisterGrabAction adds the specified action_proc to a list known to…
XtInsertEventTypeHandler, XtRemoveEventTypeHandler, XtRegisterExtensionSelector, XtSetEventDispatcher, XtDispatchEventToWidget – extension event handling Syntax #include <X11/Intrinsic.h> void XtInsertEventTypeHandler(Widget widget, int event_type, XtPointer select_data, XtEventHandler proc, XtPointer client_data, XtListPosition position); void XtRemoveEventTypeHandler(Widget widget, int event_type, XtPointer select_data, XtEventHandler proc, XtPointer client_data); void XtRegisterExtensionSelector(Display* display, int min_event_type, int max_event_type, XtExtensionSelectProc proc, XtPointer client_data); XtEventDispatchProc XtSetEventDispatcher(Display* display, int event_type, XtEventDispatchProc proc); Boolean…
XtRegisterDrawable – register a drawable with the Intrinsics event dispatcher Syntax #include <X11/Intrinsic.h> void XtRegisterDrawable(Display* display, Drawable drawable, Widget widget); void XtUnregisterDrawable(Display* display, Drawable drawable); Arguments display Specifies the drawable’s display. drawable Specifies the drawable to register. widget Specifies the widget to register the drawable for. Description XtRegisterDrawable associates the specified drawable with the specified…
XtSetKeyTranslator, XtTranslateKeycode, XtRegisterCaseConverter, XtConvertCase – convert KeySym to KeyCodes Syntax #include <X11/Intrinsic.h> void XtSetKeyTranslator(Display *display, XtKeyProc proc); void XtTranslateKeycode(Display *display, KeyCode keycode, Modifiers modifiers, Modifiers *modifiers_return, KeySym *keysym_return); void XtRegisterCaseConverter(Display *display, XtCaseProc proc, KeySym start, KeySym stop); void XtConvertCase(Display *display, KeySym keysym, KeySym *lower_return, KeySym *upper_return); Arguments display Specifies the display. keycode Specifies the KeyCode…
XtMalloc, XtCalloc, XtRealloc, XtFree, XtNew, XtNewString – memory management functions Syntax #include <X11/Intrinsic.h> char *XtMalloc(Cardinal size); char *XtCalloc(Cardinal num, Cardinal size); char *XtRealloc(char *ptr, Cardinal num); void XtFree(char *ptr); type *XtNew(type); String XtNewString(String string); Cardinal XtAsprintf(char **new_string, const char *format, …); Arguments num Specifies the number of bytes or array elements. ptr Specifies a pointer…
XtRealizeWidget, XtIsRealized, XtUnrealizeWidget – realize and unrealize widgets Syntax #include <X11/Intrinsic.h> void XtRealizeWidget(Widget w); Boolean XtIsRealized(Widget w); void XtUnrealizeWidget(Widget w); Arguments w Specifies the widget. Description If the widget is already realized, XtRealizeWidget simply returns. Otherwise, it performs the following: • Binds all action names in the widget’s translation table to procedures (see Section 10.1.2)….
XtQueryGeometry – query the preferred geometry of a child widget Syntax #include <X11/Intrinsic.h> XtGeometryResult XtQueryGeometry(Widget w, XtWidgetGeometry *intended, XtWidgetGeometry *preferred_return); Arguments intended Specifies any changes the parent plans to make to the child’s geometry or NULL. preferred_return Returns the child widget’s preferred geometry. w Specifies the widget. Description To discover a child’s preferred geometry, the…
XtProcessLock, XtProcessUnlock – lock and unlock process Syntax #include <X11/Intrinsic.h> void XtProcessLock(void); void XtProcessUnlock(void); Description XtProcessLock is used to lock all process global data. XtProcessUnlock unlocks the process. See Also X Toolkit Intrinsics – C Language Interface Xlib – C Language X Interface
XtProcessLock, XtProcessUnlock – lock and unlock process Syntax #include <X11/Intrinsic.h> void XtProcessLock(void); void XtProcessUnlock(void); Description XtProcessLock is used to lock all process global data. XtProcessUnlock unlocks the process. See Also X Toolkit Intrinsics – C Language Interface Xlib – C Language X Interface
XtNextEvent, XtPending, XtPeekEvent, XtProcessEvent, XtMainLoop – query and process events and input Syntax #include <X11/Intrinsic.h> void XtNextEvent(XEvent *event_return); Boolean XtPeekEvent(XEvent *event_return); Boolean XtPending(void); void XtProcessEvent(XtInputMask mask); void XtMainLoop(void); Arguments event Specifies a pointer to the event structure that is to be dispatched to the appropriate event handler. event_return Returns the event information to the specified…
XtPopup, XtPopupSpringLoaded, XtCallbackNone, XtCallbackNonexclusive, XtCallbackExclusive – map a pop-up Syntax #include <X11/Intrinsic.h> void XtPopup(Widget popup_shell, XtGrabKind grab_kind); void XtPopupSpringLoaded(Widget popup_shell); void XtCallbackNone(Widget w, XtPointer client_data, XtPointer call_data); void XtCallbackNonexclusive(Widget w, XtPointer client_data, XtPointer call_data); void XtCallbackExclusive(Widget w, XtPointer client_data, XtPointer call_data); Actions void XtMenuPopup(String shell_name); Arguments call_data Specifies the callback data, which is not used…
XtPopup, XtPopupSpringLoaded, XtCallbackNone, XtCallbackNonexclusive, XtCallbackExclusive – map a pop-up Syntax #include <X11/Intrinsic.h> void XtPopup(Widget popup_shell, XtGrabKind grab_kind); void XtPopupSpringLoaded(Widget popup_shell); void XtCallbackNone(Widget w, XtPointer client_data, XtPointer call_data); void XtCallbackNonexclusive(Widget w, XtPointer client_data, XtPointer call_data); void XtCallbackExclusive(Widget w, XtPointer client_data, XtPointer call_data); Actions void XtMenuPopup(String shell_name); Arguments call_data Specifies the callback data, which is not used…
XtPopdown, XtCallbackPopdown – unmap a pop-up Syntax #include <X11/Intrinsic.h> void XtPopdown(Widget popup_shell); void XtCallbackPopdown(Widget w, XtPointer client_data, XtPointer call_data); Actions void XtMenuPopdown(String shell_name); Arguments call_data Specifies the callback data, which is not used by this procedure. client_data Specifies a pointer to the XtPopdownID structure. popup_shell Specifies the widget shell to pop down. shell_name Specifies the…
XtNextEvent, XtPending, XtPeekEvent, XtProcessEvent, XtMainLoop – query and process events and input Syntax #include <X11/Intrinsic.h> void XtNextEvent(XEvent *event_return); Boolean XtPeekEvent(XEvent *event_return); Boolean XtPending(void); void XtProcessEvent(XtInputMask mask); void XtMainLoop(void); Arguments event Specifies a pointer to the event structure that is to be dispatched to the appropriate event handler. event_return Returns the event information to the specified…
XtNextEvent, XtPending, XtPeekEvent, XtProcessEvent, XtMainLoop – query and process events and input Syntax #include <X11/Intrinsic.h> void XtNextEvent(XEvent *event_return); Boolean XtPeekEvent(XEvent *event_return); Boolean XtPending(void); void XtProcessEvent(XtInputMask mask); void XtMainLoop(void); Arguments event Specifies a pointer to the event structure that is to be dispatched to the appropriate event handler. event_return Returns the event information to the specified…
XtParseTranslationTable, XtAugmentTranslations, XtOverrideTranslations, XtUninstallTranslations – manage translation tables Syntax #include <X11/Intrinsic.h> XtTranslations XtParseTranslationTable(const char *table); void XtAugmentTranslations(Widget w, XtTranslations translations); void XtOverrideTranslations(Widget w, XtTranslations translations); void XtUninstallTranslations(Widget w); Arguments table Specifies the translation table to compile. translations Specifies the compiled translation table to merge in (must not be NULL). w Specifies the widget into which…
XtParseAcceleratorTable, XtInstallAccelerators, XtInstallAllAccelerators – managing accelerator tables Syntax #include <X11/Intrinsic.h> XtAccelerators XtParseAcceleratorTable(const char * source); void XtInstallAccelerators(Widget destination, Widget source); void XtInstallAllAccelerators(Widget destination, Widget source); Arguments source Specifies the accelerator table to compile. destination Specifies the widget on which the accelerators are to be installed. source Specifies the widget or the root widget of the…
XtParent – obtain widget’s parent widget id Syntax #include <X11/Intrinsic.h> Widget XtParent(Widget w); Arguments w Specifies the widget. Description XtParent returns the widget’s parent widget ID. See Also X Toolkit Intrinsics – C Language Interface Xlib – C Language X Interface