Bwidget - X11 User Interface Methods for ImageMagick;/


NAME



3widget - X11 User Interface Methods for ImageMagick




(

SYNOPSIS



BXColorBrowserWidget(display,windows,action,reply)

Rselection_number=XCommandWidget(display,windows,selections,event)

Istatus=XConfirmWidget(display,windows,message,qualifier)

BXDialogWidget(display,windows,action,query,reply)

AXFileBrowserWidget(display,windows,action,reply)

AXFontBrowserWidget(display,windows,action,reply)

6XInfoWidget(display,windows,activity)

XXListBrowserWidget(display,windows,window_info,list,action,query,reply)

Tselection_number=XMenuWidget(display,windows,title,selections,item)

BXMonitorWidget(display,windows,task,quantum,span)

AXNoticeWidget(display,windows,message,qualifier)

BXPreferencesWidget(display,resource_info,windows)

SXTextViewWidget(display,resource_info,windows,mono,title,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.

1The format of the XColorBrowserWidget routine is:

<

      XColorBrowserWidget(display,windows,action,reply)


(A description of each parameter follows:

6
display:


BSpecifies 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 routine is:

L

      selection_number=XCommandWidget(display,windows,selections,event)


(A description of each parameter follows:

*
selection_number:


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

display:


BSpecifies 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 routine is:

C

      status=XConfirmWidget(display,windows,message,qualifier)


(A description of each parameter follows:

status:


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

display:


BSpecifies 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 routine is:

<

      XDialogWidget(display,windows,action,query,reply)


(A description of each parameter follows:

!
display:


BSpecifies 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.

0The format of the XFileBrowserWidget routine is:

;

      XFileBrowserWidget(display,windows,action,reply)


(A description of each parameter follows:

!
display:


BSpecifies 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.

0The format of the XFontBrowserWidget routine is:

;

      XFontBrowserWidget(display,windows,action,reply)


(A description of each parameter follows:

!
display:


BSpecifies 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 routine is:

0

      XInfoWidget(display,windows,activity)


(A description of each parameter follows:

!
display:


BSpecifies 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.

0The format of the XListBrowserWidget routine is:

R

      XListBrowserWidget(display,windows,window_info,list,action,query,reply)


(A description of each parameter follows:

!
display:


BSpecifies 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 routine is:

N

      selection_number=XMenuWidget(display,windows,title,selections,item)


(A description of each parameter follows:

*
selection_number:


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

display:


BSpecifies 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



JMethod XMonitorWidget displays the progress a task is making in completingCa task. A span of zero toggles the active status. An inactive statedisables the progress monitor.

,The format of the XMonitorWidget routine is:

<

      XMonitorWidget(display,windows,task,quantum,span)


(A description of each parameter follows:

!
display:


BSpecifies 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 routine is:

;

      XNoticeWidget(display,windows,message,qualifier)


(A description of each parameter follows:

!
display:


BSpecifies 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.

0The format of the XPreferencesWidget routine is:

<

      XPreferencesWidget(display,resource_info,windows)


(A description of each parameter follows:

!
display:


BSpecifies a connection to an X server; returned from XOpenDisplay.'

resource_info:


5Specifies a pointer to a X11 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 routine is:

M

      XTextViewWidget(display,resource_info,windows,mono,title,textlist)


(A description of each parameter follows:

!
display:


BSpecifies a connection to an X server; returned from XOpenDisplay.'

resource_info:


5Specifies a pointer to a X11 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.