NAME>/


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 );



ivoid XMonitorWidget( Display *display, XWindows *windows, const char *task, const off_tquantum, const off_t 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 off_t quantum, const off_t 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.