The "xtmisc" Package

These routines are meant to provide miscellaneuos Xt support. NOTE: THIS PACKAGE IS WORK IN PROGRESS. THE INTERFACE MAY CHANGE IN THE NEXT RELEASE, POSSIBLY WITHOUT NOTICE.

Library: karmaXt
Link With: -lkarmaXt

Functions

xtmisc_set_icon	Create an icon for an application's top level widget.
xtmisc_popup_cbk	Pop up a popup widget.
xtmisc_exclusive_popup_cbk	Pop up a popup widget with exclusive grab.
xtmisc_popdown_cbk	Pop down a popup widget.
xtmisc_support_work_funcs	Register support for work functions within an Xt application.

Prototype Functions

XTMISC_PROTO_icon_func

Write an icon pixmap.

Functions

void xtmisc_set_icon ( Widget top_level, void (*icon_func) (Display *display, Pixmap pixmap, int width, int height) )

Create an icon for an application's top level widget.

Parameters:

top_level : The top level widget.
icon_func : The function to use when writing the icon. The prototype function is XTMISC_PROTO_icon_func.

Returns: Nothing.
Multithreading Level: Unsafe

void xtmisc_popup_cbk (Widget w, XtPointer client_data, XtPointer call_data)

This routine will pop up a popup widget. This routine is a convenience routine to be used as a callback.

Parameters:

w : The widget on which the event occurred. This is ignored.
client_data : The callback client data. This must be the popup widget.
call_data : The callback call data. This is ignored.

Returns: Nothing.
Multithreading Level: Unsafe

void xtmisc_exclusive_popup_cbk (Widget w, XtPointer client_data, XtPointer call_data)

This routine will pop up a popup widget. This routine is a convenience routine to be used as a callback. An exclusive grab is performed on the popped up widget.

Parameters:

w : The widget on which the event occurred. This is ignored.
client_data : The callback client data. This must be the popup widget.
call_data : The callback call data. This is ignored.

Returns: Nothing.
Multithreading Level: Unsafe

void xtmisc_popdown_cbk (Widget w, XtPointer client_data, XtPointer call_data)

This routine will pop down a popup widget. This routine is a convenience routine to be used as a callback.

Parameters:

w : The widget on which the event occurred. This is ignored.
client_data : The callback client data. This must be the popup widget.
call_data : The callback call data. This is ignored.

Returns: Nothing.
Multithreading Level: Unsafe

void xtmisc_support_work_funcs (XtAppContext app_context)

This routine will register Xt support for work functions using the wf package.

Parameters:

app_context : The Xt application context.

Returns: Nothing. On failure the process aborts.
Multithreading Level: Unsafe

Prototype Functions

void XTMISC_PROTO_icon_func (Display *display, Pixmap pixmap, int width, int height)

Write an icon pixmap.

Parameters:

display : The display pointer.
pixmap : The pixmap to write to.
width : The width of the pixmap.
height : The height of the pixmap.

Returns: Nothing.
Multithreading Level: Unsafe

Contact: Richard Gooch
Web Development: Ariel Internet Services