## Class THiddenField

Description

Implements interfaces:

- IPostBackDataHandler
- IValidatable

THiddenField class

THiddenField displays a hidden input field on a Web page. The value of the input field can be accessed via Value property. If upon postback the value is changed, a OnValueChanged event will be raised.

- since: 3.0
- version: $Revision: $ $Date: $
- author: Qiang Xue <qiang.xue@gmail.com>

Located in /Web/UI/WebControls/THiddenField.php (line 26)

    TComponent
       |
       --TApplicationComponent
          |
          --TControl
             |
             --THiddenField

Method Summary
void focus ()
boolean getEnableTheming ()
string getTagName ()
mixed getValidationPropertyValue ()
string getValue ()
boolean loadPostData (string $key, array $values)
void onValueChanged (TEventParameter $param)
void raisePostDataChangedEvent ()
void render (THtmlWriter $writer)
void setEnableTheming (boolean $value)
void setSkinID (string $value)
void setValue (string $value)
Methods
focus (line 40)

Sets focus to this control.

This method overrides the parent implementation by forbidding setting focus to this control.

- access: public

void focus ()

Redefinition of:

TControl::focus()
  Sets input focus to this control.

getEnableTheming (line 137)

- return: whether theming is enabled for this control. Defaults to false.
- access: public

boolean getEnableTheming ()

Redefinition of:

TControl::getEnableTheming()

getTagName (line 31)

- return: tag name of the hidden field.
- access: protected

string getTagName ()
getValidationPropertyValue (line 90)

Returns the value to be validated.

This methid is required by IValidatable interface.

- return: the value of the property to be validated.
- access: public

mixed getValidationPropertyValue ()
getValue (line 120)

- return: the value of the THiddenField
- access: public

string getValue ()
loadPostData (line 73)

Loads hidden field data.

This method is primarly used by framework developers.

- return: whether the data of the component has been changed
- access: public

boolean loadPostData (string $key, array $values)

- string $key: the key that can be used to retrieve data from the input data collection
- array $values: the input data collection

onValueChanged (line 112)

This method is invoked when the value of the getValue property changes between posts to the server.

The method raises 'OnValueChanged' event to fire up the event delegates. If you override this method, be sure to call the parent implementation so that the attached event handlers can be invoked.

- access: public

void onValueChanged (TEventParameter $param)

- TEventParameter $param: event parameter to be passed to the event handlers

raisePostDataChangedEvent (line 100)

Raises postdata changed event.

This method calls onValueChanged method. This method is primarly used by framework developers.

- access: public

void raisePostDataChangedEvent ()
render (line 51)

Renders the control.

This method overrides the parent implementation by rendering the hidden field input element.

- access: public

void render (THtmlWriter $writer)

- THtmlWriter $writer: the writer used for the rendering purpose

Redefinition of:

TControl::render()
  Renders the control.

setEnableTheming (line 146)

- access: public
- throws: TNotSupportedException This method is always thrown when calling this method.

void setEnableTheming (boolean $value)

- boolean $value: whether theming is enabled for this control.

Redefinition of:

TControl::setEnableTheming()

setSkinID (line 155)

- access: public
- throws: TNotSupportedException This method is always thrown when calling this method.

void setSkinID (string $value)

- string $value: Skin ID

Redefinition of:

TControl::setSkinID()

setValue (line 129)

Sets the value of the THiddenField

- access: public

void setValue (string $value)

- string $value: the value to be set

#### Inherited Methods

Inherited From TControl

> TControl::__construct()
> TControl::addedControl()
> TControl::addParsedObject()
> TControl::applyStyleSheetSkin()
> TControl::autoBindProperty()
> TControl::autoDataBindProperties()
> TControl::bindProperty()
> TControl::broadcastEvent()
> TControl::broadcastEventInternal()
> TControl::clearChildState()
> TControl::clearControlState()
> TControl::clearNamingContainer()
> TControl::clearViewState()
> TControl::createChildControls()
> TControl::createControlCollection()
> TControl::createdOnTemplate()
> TControl::dataBind()
> TControl::dataBindChildren()
> TControl::dataBindProperties()
> TControl::ensureChildControls()
> TControl::findControl()
> TControl::findControlsByID()
> TControl::findControlsByType()
> TControl::focus()
> TControl::getAdapter()
> TControl::getAllowChildControls()
> TControl::getAttribute()
> TControl::getAttributes()
> TControl::getChildControlsCreated()
> TControl::getClientID()
> TControl::getControls()
> TControl::getControlStage()
> TControl::getControlState()
> TControl::getEnabled()
> TControl::getEnableTheming()
> TControl::getEnableViewState()
> TControl::getHasAdapter()
> TControl::getHasAttributes()
> TControl::getHasControls()
> TControl::getID()
> TControl::getNamingContainer()
> TControl::getPage()
> TControl::getParent()
> TControl::getRegisteredObject()
> TControl::getSkinID()
> TControl::getSourceTemplateControl()
> TControl::getTemplateControl()
> TControl::getUniqueID()
> TControl::getViewState()
> TControl::getVisible()
> TControl::hasAttribute()
> TControl::initRecursive()
> TControl::isDescendentOf()
> TControl::isObjectRegistered()
> TControl::loadRecursive()
> TControl::loadState()
> TControl::loadStateRecursive()
> TControl::onBubbleEvent()
> TControl::onDataBinding()
> TControl::onInit()
> TControl::onLoad()
> TControl::onPreRender()
> TControl::onUnload()
> TControl::preRenderRecursive()
> TControl::raiseBubbleEvent()
> TControl::registerObject()
> TControl::removeAttribute()
> TControl::removedControl()
> TControl::render()
> TControl::renderChildren()
> TControl::renderControl()
> TControl::saveState()
> TControl::saveStateRecursive()
> TControl::setAdapter()
> TControl::setAttribute()
> TControl::setChildControlsCreated()
> TControl::setControlStage()
> TControl::setControlState()
> TControl::setEnabled()
> TControl::setEnableTheming()
> TControl::setEnableViewState()
> TControl::setID()
> TControl::setPage()
> TControl::setSkinID()
> TControl::setTemplateControl()
> TControl::setViewState()
> TControl::setVisible()
> TControl::traverseChildControls()
> TControl::unbindProperty()
> TControl::unloadRecursive()
> TControl::unregisterObject()
> TControl::__get()

Inherited From TApplicationComponent

> TApplicationComponent::getApplication()
> TApplicationComponent::getRequest()
> TApplicationComponent::getResponse()
> TApplicationComponent::getService()
> TApplicationComponent::getSession()
> TApplicationComponent::getUser()
> TApplicationComponent::publishAsset()
> TApplicationComponent::publishFilePath()

Inherited From TComponent

> TComponent::attachEventHandler()
> TComponent::canGetProperty()
> TComponent::canSetProperty()
> TComponent::detachEventHandler()
> TComponent::evaluateExpression()
> TComponent::evaluateStatements()
> TComponent::getEventHandlers()
> TComponent::getSubProperty()
> TComponent::hasEvent()
> TComponent::hasEventHandler()
> TComponent::hasProperty()
> TComponent::raiseEvent()
> TComponent::setSubProperty()
> TComponent::__get()
> TComponent::__set()

Class Constants

#### Inherited Constants

Inherited from TControl

Documentation generated on Mon, 01 May 2006 23:03:34 -0400 by phpDocumentor 1.3.0RC4