An os_input_submit is a submit button within an os_form . When this button is selected, the name of each input element within the containing os_form is paired with the current value of the input element and transmitted to the action URL specified by the os_form .

By default, an os_input_submit button is typically labeled "Submit" or "Submit Query." A label value for the button can be specified through either a constructor or the value() member function. The label value cannot be modified by the user.

A name for an os_input_submit button can be specified through either a constructor or the name() member function. If an os_input_submit does not specify a name, its value is not transmitted when the containing os_form is submitted.

An os_form can contain multiple os_input_submit buttons. Each os_input_submit can specify a different name and value. However, when an os_form is submitted, only the name/value pair associated with the selected os_input_submit is transmitted, and then only if that os_input_submit specifies a name.

Declaration


  #include <ospace/web/insubmit.h>
class os_input_submit : public os_element

Interface

Constructor

os_input_submit()

Constructs a generic input submit button.

Constructor

os_input_submit( const string& value )

Constructs an input submit button with button text value .

Constructor

os_input_submit( const string& value , const string& name )

Constructs an input submit button with button text value and name name .

clone

/* virtual */ os_element* clone() const

Returns a base class pointer to a heap-based deep copy of the input submit button.

name

os_input_submit& name( const string& name )

Sets the name to name and returns a reference to the input submit button.

name

string name() const

Returns the name, or the empty string if not set.

value

string value() const

Returns the button label value, or the empty string if not set.

value

os_input_submit& value( const string& value )

Sets the button label to value and returns a reference to the input submit button.