NAME9/


NAME



widget - 




(

SYNOPSIS



ivoid XColorBrowserWidget( Display *display, XWindows *windows, const char *action, char*reply );

kint XCommandWidget( Display *display, XWindows *windows, const char ** selections, XEvent*event );

jint XConfirmWidget( Display *display, XWindows *windows, const char *message, const char*qualifier );

hint XDialogWidget( Display *display, XWindows *windows, const char *action, const char#*query, char *reply );

hvoid XFileBrowserWidget( Display *display, XWindows *windows, const char *action, char*reply );

hvoid XFontBrowserWidget( Display *display, XWindows *windows, const char *action, char*reply );

mvoid XInfoWidget( Display *display, XWindows *windows, const char *activity );

tvoid XListBrowserWidget( Display *display, XWindows *windows, XWindowInfo *window_info, char constK** list, const char *action, const char *query, char *reply );

hint XMenuWidget( Display *display, XWindows *windows, const char *title, const char **&selections, char *item );

pvoid XMonitorWidget( Display *display, XWindows *windows, const char *task, const unsigned int#quantum, const unsigned int span );

jvoid XNoticeWidget( Display *display, XWindows *windows, const char *message, const char*qualifier );

kunsigned int XPreferencesWidget( Display *display, XResourceInfo *resource_info, XWindows*windows );

pvoid XTextViewWidget( Display *display, const XResourceInfo *resource_info, XWindows *windows,Econst unsigned int mono, const char *title, char const ** textlist );




B

FUNCTION DESCRIPTIONS






>

XColorBrowserWidget



GMethod XColorBrowserWidget displays a Color Browser widget with a colorIquery to the user. The user keys a reply and presses the Action or CancelKbutton to exit. The typed text is returned as the reply function parameter.

0The format of the XColorBrowserWidget method is:|

void XColorBrowserWidget ( Display *display, XWindows *windows, const char *action, char *reply );


=A description of each parameter follows:

9

display:


Specifies a connection to an :X server; returned from XOpenDisplay.#

window:


,Specifies a pointer to a XWindows structure.#

action:


1Specifies a pointer to the action of this widget."

reply:


9The response from the user is returned in this parameter.






4

XCommandWidget



KMethod XCommandWidget maps a menu and returns the command pointed to by the!user when the button is released.

+The format of the XCommandWidget method is:}

int XCommandWidget ( Display *display, XWindows *windows, const char **selections, XEvent *event );


=A description of each parameter follows:

-

selection_number:


;Specifies the number of the selection that the user choose.$

display:


Specifies a connection to an :X server; returned from XOpenDisplay.#

window:


,Specifies a pointer to a XWindows structure.'

selections:


KSpecifies a pointer to one or more strings that comprise the choices in themenu."

event:


Specifies a pointer to a *X11 XEvent structure.






4

XConfirmWidget



JMethod XConfirmWidget displays a Confirm widget with a notice to the user.KThe function returns -1 if Dismiss is pressed, 0 for Cancel, and 1 for Yes.

+The format of the XConfirmWidget method is:

int XConfirmWidget ( Display *display, XWindows *windows, const char *message, const char *qualifier );


=A description of each parameter follows:

#

status:


JMethod XConfirmWidget returns True if the user presses Yes otherwise False is returned.$

display:


Specifies a connection to an :X server; returned from XOpenDisplay.#

window:


,Specifies a pointer to a XWindows structure.$

message:


@Specifies the message to display before terminating the program.&

qualifier:


'Specifies any qualifier to the message.






2

XDialogWidget



KMethod XDialogWidget displays a Dialog widget with a query to the user. TheHuser keys a reply and presses the Ok or Cancel button to exit. The typed1text is returned as the reply function parameter.

*The format of the XDialogWidget method is:

int XDialogWidget ( Display *display, XWindows *windows, const char *action, const char *query, char *reply );


=A description of each parameter follows:

$

display:


Specifies a connection to an :X server; returned from XOpenDisplay.#

window:


,Specifies a pointer to a XWindows structure.#

action:


1Specifies a pointer to the action of this widget."

query:


8Specifies a pointer to the query to present to the user."

reply:


9The response from the user is returned in this parameter.






<

XFileBrowserWidget



JMethod XFileBrowserWidget displays a File Browser widget with a file queryJto the user. The user keys a reply and presses the Action or Cancel buttonDto exit. The typed text is returned as the reply function parameter.

/The format of the XFileBrowserWidget method is:{

void XFileBrowserWidget ( Display *display, XWindows *windows, const char *action, char *reply );


=A description of each parameter follows:

$

display:


Specifies a connection to an :X server; returned from XOpenDisplay.#

window:


,Specifies a pointer to a XWindows structure.#

action:


1Specifies a pointer to the action of this widget."

reply:


9The response from the user is returned in this parameter.






<

XFontBrowserWidget



JMethod XFontBrowserWidget displays a Font Browser widget with a font queryJto the user. The user keys a reply and presses the Action or Cancel buttonDto exit. The typed text is returned as the reply function parameter.

/The format of the XFontBrowserWidget method is:{

void XFontBrowserWidget ( Display *display, XWindows *windows, const char *action, char *reply );


=A description of each parameter follows:

$

display:


Specifies a connection to an :X server; returned from XOpenDisplay.#

window:


,Specifies a pointer to a XWindows structure.#

action:


1Specifies a pointer to the action of this widget."

reply:


9The response from the user is returned in this parameter.






.

XInfoWidget



FMethod XInfoWidget displays text in the Info widget. The purpose is toEinform the user that what activity is currently being performed (e.g.+reading an image, rotating an image, etc.).

(The format of the XInfoWidget method is:i

void XInfoWidget ( Display *display, XWindows *windows, const char *activity );


=A description of each parameter follows:

$

display:


Specifies a connection to an :X server; returned from XOpenDisplay.#

window:


,Specifies a pointer to a XWindows structure.%

activity:


KThis character string reflects the current activity and is displayed in the Info widget.






<

XListBrowserWidget



HMethod XListBrowserWidget displays a List Browser widget with a query toIthe user. The user keys a reply or select a reply from the list. Finally,Gthe user presses the Action or Cancel button to exit. The typed text is)returned as the reply function parameter.

/The format of the XListBrowserWidget method is:

void XListBrowserWidget ( Display *display, XWindows *windows, XWindowInfo *window_info, char const **list, const char *action, const char *query, char *reply );


=A description of each parameter follows:

$

display:


Specifies a connection to an :X server; returned from XOpenDisplay.#

window:


,Specifies a pointer to a XWindows structure.!

list:


JSpecifies a pointer to an array of strings. The user can select from these"strings as a possible reply value.#

action:


1Specifies a pointer to the action of this widget."

query:


8Specifies a pointer to the query to present to the user."

reply:


9The response from the user is returned in this parameter.






.

XMenuWidget



HMethod XMenuWidget maps a menu and returns the command pointed to by the!user when the button is released.

(The format of the XMenuWidget method is:

int XMenuWidget ( Display *display, XWindows *windows, const char *title, const char **selections, char *item );


=A description of each parameter follows:

-

selection_number:


;Specifies the number of the selection that the user choose.$

display:


Specifies a connection to an :X server; returned from XOpenDisplay.#

window:


,Specifies a pointer to a XWindows structure."

title:


@Specifies a character string that describes the menu selections.'

selections:


KSpecifies a pointer to one or more strings that comprise the choices in themenu.!

item:


HSpecifies a character array. The item selected from the menu is returnedhere.






4

XMonitorWidget



SMethod XMonitorWidget displays the progress a task is making in completing a task. oA span of zero toggles the active status. An inactive state disables the progress monitor.

+The format of the XMonitorWidget method is:

void XMonitorWidget ( Display *display, XWindows *windows, const char *task, const unsigned int quantum, const unsigned int span );


=A description of each parameter follows:

$

display:


Specifies a connection to an :X server; returned from XOpenDisplay.#

window:


,Specifies a pointer to a XWindows structure.!

task:


Identifies the task in progress.$

quantum:


HSpecifies the quantum position within the span which represents how much,progress has been made in completing a task.!

span:


1Specifies the span relative to completing a task.






2

XNoticeWidget



HMethod XNoticeWidget displays a Notice widget with a notice to the user.BThe function returns when the user presses the ``Dismiss'' button.

*The format of the XNoticeWidget method is:

void XNoticeWidget ( Display *display, XWindows *windows, const char *message, const char *qualifier );


=A description of each parameter follows:

$

display:


Specifies a connection to an :X server; returned from XOpenDisplay.#

window:


,Specifies a pointer to a XWindows structure.$

message:


@Specifies the message to display before terminating the program.&

qualifier:


'Specifies any qualifier to the message.






<

XPreferencesWidget



DMethod XPreferencesWidget displays a Preferences widget with programFpreferences. If the user presses the Apply button, the preferences are<stored in a configuration file in the users' home directory.

/The format of the XPreferencesWidget method is:

unsigned int XPreferencesWidget ( Display *display, XResourceInfo *resource_info, XWindows *windows );


=A description of each parameter follows:

$

display:


Specifies a connection to an :X server; returned from XOpenDisplay.*

resource_info:


Specifies a pointer to a 1X11 XResourceInfo structure.#

window:


,Specifies a pointer to a XWindows structure.






6

XTextViewWidget



;Method XTextViewWidget displays text in a Text View widget.

,The format of the XTextViewWidget method is:

void XTextViewWidget ( Display *display, const XResourceInfo *resource_info, XWindows *windows, const unsigned int mono, const char *title, char const **textlist );


=A description of each parameter follows:

$

display:


Specifies a connection to an :X server; returned from XOpenDisplay.*

resource_info:


Specifies a pointer to a 1X11 XResourceInfo structure.#

window:


,Specifies a pointer to a XWindows structure.!

mono:


*Use mono-spaced font when displaying text."

title:


CThis character string is displayed at the top of the widget window.%

textlist:


:This string list is displayed within the Text View widget.