DTCBUTTON |
Top Previous Next |
Syntax
DTCButton "title" [,style clipboard|nbclipboard|text|nbtext|button|title|nbtitle] [,args "job arguments"] [,width chars] [,match "regex"] [,library "name"] [,doctype "value"] [,parsevalue ["ruleset"]]
Description
The DTCButton command is interpreted by the UnForm Desktop Client for presentation in an application integration window. For each DTCButton command, an input field is constructed, along with a submission button, and presented on the form associated with the rule set. The DTCPanel command can be used to categorize the buttons in panels. Input fields are presented in the same order as presented in the rule set. Note that expressions are not supported.
Style This optional argument defines the style of the button provided to the user. The default style is "clipboard".
Args Options passed to the to the UnForm job running the rule set. There are automatic rule file and rule set arguments (-f and –r, respectively) to ensure the rule set with the button configuration is the one executed when a submission takes place.
Width This defines the width of the button, in nominal characters. Without a width, the title width is used. Use this to ensure consistent widths when multiple buttons are presented.
Match The match option is honored by the clipboard and nbclipboard styles. The clipboard value must match the specified regular expression in order to be pasted into the text field.
Library, Doctype These two options in tandem are honored by the clipboard and nbclipboard styles. The clipboard value must be a valid document ID within the library and doctype specified in order to be pasted into the text field.
ParseValue If this option is present, the value from the clipboard or window title is sent to the server for parsing. The server will run the current rule set or the optionally specified one, and use the value returned from the server in cgiresponse$ in place of the clipboard or title value. The rule set receives cgi.button$, cgi.panel$, and cgi.parsevalue$ when the request is sent.
|