package CGI::Test::Form::Widget::Button::Submit;
use strict;
##################################################################
# $Id: Submit.pm 411 2011-09-26 11:19:30Z nohuhu@nohuhu.org $
# $Name: cgi-test_0-104_t1 $
##################################################################
#
#  Copyright (c) 2001, Raphael Manfredi
#
#  You may redistribute only under the terms of the Artistic License,
#  as specified in the README file that comes with the distribution.
#

use Carp;

#
# This class models a FORM submit button.
#

use base qw(CGI::Test::Form::Widget::Button);

#
# Attribute access
#

sub gui_type
{
    return "submit button";
}

#
# ->press
#
# Press button.
# Has immediate effect: a GET/POST request is issued.
#
# Returns resulting CGI::Test::Page.
#
sub press
{
    my $this = shift;
    $this->set_is_pressed(1);
    return $this->form->submit;
}

#
# Button predicates
#

sub is_submit
{
    return 1;
}

1;

=head1 NAME

CGI::Test::Form::Widget::Button::Submit - A submit button

=head1 SYNOPSIS

 # Inherits from CGI::Test::Form::Widget::Button
 # $form is a CGI::Test::Form

 my $send = $form->submit_by_name("send");
 my $answer = $send->press;

=head1 DESCRIPTION

This class models a submit button.
Pressing it immediately triggers an HTTP request, as defined by the form.

The interface is the same as the one described in
L<CGI::Test::Form::Widget::Button>.

=head1 AUTHORS

The original author is Raphael Manfredi.

Steven Hilton was long time maintainer of this module.

Current maintainer is Alexander Tokarev F<E<lt>tokarev@cpan.orgE<gt>>.

=head1 SEE ALSO

CGI::Test::Form::Widget::Button(3).

=cut