## Class THiddenField

Description

Implements interfaces:

- IPostBackDataHandler
- IValidatable
- IDataRenderer

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: $Id: THiddenField.php 1850 2007-04-09 03:32:50Z xue $
- author: Qiang Xue <qiang.xue@gmail.com>

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

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

Direct descendents

Class | Description
--- | ---
TActiveHiddenField | TActiveHiddenField class

Method Summary
void focus ()
string getData ()
boolean getDataChanged ()
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 setData (string $value)
void setEnableTheming (boolean $value)
void setSkinID (string $value)
void setValue (string $value)
Methods
focus (line 42)

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.

getData (line 161)

Returns the value of the hidden field.

This method is required by IDataRenderer. It is the same as getValue().

- return: value of the hidden field
- access: public
- since: 3.1.0
- see: THiddenField::getValue()

string getData ()
getDataChanged (line 99)

Returns a value indicating whether postback has caused the control data change.

This method is required by the IPostBackDataHandler interface.

- return: whether postback has caused the control data change. False if the page is not in postback mode.
- access: public

boolean getDataChanged ()
getEnableTheming (line 183)

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

boolean getEnableTheming ()

Redefinition of:

TControl::getEnableTheming()

getTagName (line 33)

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

string getTagName ()
getValidationPropertyValue (line 109)

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 139)

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

string getValue ()
loadPostData (line 82)

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 131)

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 119)

Raises postdata changed event.

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

- access: public

void raisePostDataChangedEvent ()
render (line 53)

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.

setData (line 174)

Sets the value of the hidden field.

This method is required by IDataRenderer. It is the same as setValue().

- access: public
- since: 3.1.0
- see: THiddenField::setValue()

void setData (string $value)

- string $value: value of the hidden field

setEnableTheming (line 192)

- 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 201)

- 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 148)

Sets the value of the THiddenField

- access: public

void setValue (string $value)

- string $value: the value to be set

Redefined in descendants as:

- TActiveHiddenField::setValue() : Client-side Value property can only be updated after the OnLoad stage.

#### Inherited Methods

Inherited From TControl

> TControl::__construct()
> TControl::addedControl()
> TControl::addParsedObject()
> TControl::addToPostDataLoader()
> TControl::applyStyleSheetSkin()
> TControl::autoBindProperty()
> TControl::autoDataBindProperties()
> TControl::bindProperty()
> TControl::broadcastEvent()
> TControl::bubbleEvent()
> TControl::clearChildState()
> TControl::clearControlState()
> TControl::clearNamingContainer()
> TControl::clearViewState()
> TControl::convertUniqueIdToClientId()
> TControl::createChildControls()
> TControl::createControlCollection()
> 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::getCustomData()
> TControl::getEnabled()
> TControl::getEnableTheming()
> TControl::getEnableViewState()
> TControl::getHasAdapter()
> TControl::getHasAttributes()
> TControl::getHasChildInitialized()
> TControl::getHasControls()
> TControl::getHasInitialized()
> TControl::getHasLoaded()
> TControl::getHasLoadedPostData()
> TControl::getHasPreRendered()
> 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::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::setCustomData()
> TControl::setEnabled()
> TControl::setEnableTheming()
> TControl::setEnableViewState()
> TControl::setID()
> TControl::setPage()
> TControl::setSkinID()
> TControl::setTemplateControl()
> TControl::setViewState()
> TControl::setVisible()
> TControl::trackViewState()
> 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::addParsedObject()
> TComponent::attachEventHandler()
> TComponent::canGetProperty()
> TComponent::canSetProperty()
> TComponent::createdOnTemplate()
> 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

> TControl::AUTOMATIC_ID_PREFIX
> TControl::CLIENT_ID_SEPARATOR
> TControl::CS_CHILD_INITIALIZED
> TControl::CS_CONSTRUCTED
> TControl::CS_INITIALIZED
> TControl::CS_LOADED
> TControl::CS_PRERENDERED
> TControl::CS_STATE_LOADED
> TControl::ID_FORMAT
> TControl::ID_SEPARATOR
> TControl::IS_CHILD_CREATED
> TControl::IS_CREATING_CHILD
> TControl::IS_DISABLE_THEMING
> TControl::IS_DISABLE_VIEWSTATE
> TControl::IS_ID_SET
> TControl::IS_SKIN_APPLIED
> TControl::IS_STYLESHEET_APPLIED
> TControl::RF_ADAPTER
> TControl::RF_AUTO_BINDINGS
> TControl::RF_CHILD_STATE
> TControl::RF_CONTROLS
> TControl::RF_CONTROLSTATE
> TControl::RF_DATA_BINDINGS
> TControl::RF_EVENTS
> TControl::RF_NAMED_CONTROLS
> TControl::RF_NAMED_CONTROLS_ID
> TControl::RF_NAMED_OBJECTS
> TControl::RF_SKIN_ID

Documentation generated on Mon, 21 Apr 2008 11:35:05 -0400 by phpDocumentor 1.3.0RC4