@ widget - X11 User Interface Routines for ImageMagick�� �  0 




NAME

4widget - X11 User Interface Routines 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)






9

FUNCTION DESCRIPTIONS






5

XColorBrowserWidget

IFunction 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:



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






+

XCommandWidget

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






+

XConfirmWidget

FFunction XConfirmWidget displays a Confirm widget with a notice to theHuser. The function returns -1 if Dismiss is pressed, 0 for Cancel, and 1for Yes.

,The format of the XConfirmWidget routine is:

C

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


(A description of each parameter follows:




status:
FFunction XConfirmWidget returns True if the user presses Yes otherwiseFalse 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.






)

XDialogWidget

IFunction XDialogWidget displays a Dialog widget with a query to the user.FThe user keys a reply and presses the Ok or Cancel button to exit. The7typed text 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.






3

XFileBrowserWidget

FFunction XFileBrowserWidget displays a File Browser widget with a fileIquery 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 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.






3

XFontBrowserWidget

FFunction XFontBrowserWidget displays a Font Browser widget with a fontIquery 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 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

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






3

XListBrowserWidget

JFunction 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

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






+

XMonitorWidget

AFunction XMonitorWidget displays the progress a task is making inHcompleting a task. A span of zero toggles the active status. An inactive$state disables 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.






)

XNoticeWidget

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






3

XPreferencesWidget

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






-

XTextViewWidget

=Function 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.