CGI::Test::Form::Widget::Button3pm

Attributes

"is_pressed"

True when the button is pressed.

Attribute Setting

"press"

Press the button, setting "is_pressed" to true.

If the button is a reset button ("is_reset" is true), all widgets are reset to their initial state, and "undef" is returned.

If the button is a submit button ("is_submit" is true), then a GET/POST request is issued as appropriate and the reply is made available through a "CGI::Test::Page" object.

Otherwise, the button pressing is ignored, a warning is issued from the perspective of the caller, via "carp", and "undef" is returned.

Widget Classification Predicates

There is an additional set of predicates to distinguish between the various buttons:

"is_plain"

Returns true for a plain button, i.e. a button that has no submit/reset effects. Usually, those buttons are linked to a script, but "CGI::Test" does not support scripting yet.

"is_reset"

Returns true for reset buttons.

"is_submit"

Returns true for submit buttons, whether they are really shown as buttons or as images. A submit button will cause an HTTP request to be issued in response to its being pressed.

Miscellaneous Features

Although documented, those features are more targetted for internal use...

"set_is_pressed" flag

Change the pressed status of the button, to the value of flag. It does not raise any other side effect, like submitting an HTTP request if the button is a submit button.

You should probably use the "press" convenience routine instead of calling this feature directly.