createWF {widgetInvoke}R Documentation

A function to specify widget structure for widgetInvoke


This function will present a widget (currently using Gtk) that will allow the user (in this case, typically a package author or maintainer) to specify the structure of the function widgets used by widgetInvoke.




funName The name of the function to create a widget for


The package that funName is in must already be loaded via library for this function to work properly.

This function will use RGtk to display a widget detailing the arguments of the specified function, and other information to be used for the widgetInvoke function. The widget presents a six column table, with the first column detailing each argument name. The arguments themselves are represented by the rows of the table.

The Type column specifies the type of the argument (e.g. character, logical, etc). If this field is blank, it is assumed that any type of value may be entered in by the widgetInvoke user. A character vector can be entered to specify a set of possible values (e.g. "mean", "median") that the argument is allowed to take - to do this use comma separated, quoted strings.

The Default column is used to specify the default value of the argument, if any. Leaving this field blank will imply that there is no default value, otherwise the value in this field must be of the type specified by type.

The Location column describes where this argument will appear. The widget used by widgetInvoke allows for notebook style paning, and this field will specify which pane the argument will appear on. By default, all arguments appear on the "main" pane, but by specifying another string a new pane will be created.

WidgetType allows the user to specify what sort of widget is used by widgetInvoke for the entry of this argument. Currently, logical and vector types must use either Radio or DropDown and all other types must use TypeIn.

If the Required check box is marked for an argument, that means that the argument must be filled in with a value by the widgetInvoke user.

The Reset button can be used to bring the entire table back to its original state. Any changes the user has made will be reverted.

The Check button will check the validity of all the values stored in the table and report to the user if there are potential problems.

The Preview button will display a window that will be identical to what the widgetInvoke user will see. For this sub-window, the Evaluate window will not actually evaluate the function, but simply close the window.

The Save button will save the information in the table to an XML file in the current directory, of the name FUN.xml, where FUN is the name of the function.


This function is used for its side effect, which is to output a file with the appropriate meta-data. The default filename is funName.xml (where funName is the same as the value specified by the parameter) and stored in the current working directory of the R session. By using the Save As button, this can be changed, and saved to any file the operator wishes.


Jeff Gentry

See Also



  if (interactive())

[Package widgetInvoke version 0.0.9 Index]