PEAR Manual
Prev |  | Next

# HTML_QuickForm::addElement()

HTML_QuickForm::addElement() -- Adds an element into the form

## Synopsis

    require_once 'HTML/QuickForm.php';

``object &HTML_QuickForm::addElement` (mixed $element)`

## Description

Adds an element into the form. If `$element` is a string representing an element type, then this method accepts variable number of parameters, their meaning and count depending on element type.

Parameters starting from second will be passed to the element's constructor, consult the docs for the appropriate element to find out which parameters to pass.

## Parameter

mixed `$element`

  element object or type of element to add (text, textarea, file...)

## Return value

return reference to added element

## Throws

Table 41-1. Possible PEAR_Error values

Error code | Error message | Reason | Solution
--- | --- | --- | ---
`QUICKFORM_UNREGISTERED_ELEMENT` | Element '`$element`' does not exist in HTML_QuickForm::_loadElement() | Tried to add an element of unknown type | Check the type name spelling or use HTML_QuickForm::registerElementType()
`QUICKFORM_INVALID_ELEMENT_NAME` | Element '`elementName`' already exists in HTML_QuickForm::addElement() | Tried to add an element having a name of an existing element, but of different type | Choose a different name for an element

## Note

since 1.0

This function can not be called statically.

Prev | Home | Next
constructor HTML_QuickForm::HTML_QuickForm() | Up | HTML_QuickForm::apiVersion()