## Class THotSpot

Description

THotSpot class.

THotSpot implements the basic functionality common to all hot spot shapes. Derived classes include TCircleHotSpot, TPolygonHotSpot and TRectangleHotSpot.

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

Located in /Web/UI/WebControls/TImageMap.php (line 290)

    TComponent
       |
       --THotSpot

Direct descendents

Class | Description
--- | ---
TCircleHotSpot | Class TCircleHotSpot.
TRectangleHotSpot | Class TRectangleHotSpot.
TPolygonHotSpot | Class TPolygonHotSpot.

Method Summary
string getAccessKey ()
string getAlternateText ()
boolean getCausesValidation ()
string getCoordinates ()
string getHotSpotMode ()
string getNavigateUrl ()
string getPostBackValue ()
string getShape ()
integer getTabIndex ()
string getTarget ()
string getValidationGroup ()
mixed getViewState (string $key, [mixed $defaultValue = null])
void render (THtmlWriter $writer)
void setAccessKey (string $value)
void setAlternateText (string $value)
void setCausesValidation (boolean $value)
void setHotSpotMode (string $value)
void setNavigateUrl (string $value)
void setPostBackValue (string $value)
void setTabIndex (integer $value)
void setTarget (string $value)
void setValidationGroup (string $value)
void setViewState (string $key, mixed $value, [mixed $defaultValue = null])
Methods
getAccessKey (line 338)

- return: the access key that allows you to quickly navigate to the HotSpot region. Defaults to ''.
- access: public

string getAccessKey ()
getAlternateText (line 354)

- return: the alternate text to display for a HotSpot object. Defaults to ''.
- access: public

string getAlternateText ()
getCausesValidation (line 435)

- return: whether postback event trigger by this hotspot will cause input validation, default is true
- access: public

boolean getCausesValidation ()
getCoordinates (line 333)

- return: coordinates defining the hotspot shape.
- access: public
- abstract:

string getCoordinates ()

Redefined in descendants as:

- TCircleHotSpot::getCoordinates()
- TRectangleHotSpot::getCoordinates()
- TPolygonHotSpot::getCoordinates()

getHotSpotMode (line 370)

- return: the behavior of a HotSpot object when it is clicked. Defaults to 'NotSet'.
- access: public

string getHotSpotMode ()
getNavigateUrl (line 387)

- return: the URL to navigate to when a HotSpot object is clicked. Defaults to ''.
- access: public

string getNavigateUrl ()
getPostBackValue (line 403)

- return: a value that is post back when the HotSpot is clicked. Defaults to ''.
- access: public

string getPostBackValue ()
getShape (line 329)

- return: shape of the hotspot, can be 'circle', 'rect', 'poly', etc.
- access: public
- abstract:

string getShape ()

Redefined in descendants as:

- TCircleHotSpot::getShape()
- TRectangleHotSpot::getShape()
- TPolygonHotSpot::getShape()

getTabIndex (line 419)

- return: the tab index of the HotSpot region. Defaults to 0.
- access: public

integer getTabIndex ()
getTarget (line 468)

- return: the target window or frame to display the new page when the HotSpot region is clicked. Defaults to ''.
- access: public

string getTarget ()
getValidationGroup (line 451)

- return: the group of validators which the hotspot causes validation upon postback
- access: public

string getValidationGroup ()
getViewState (line 303)

Returns a viewstate value.

This function is very useful in defining getter functions for component properties that must be kept in viewstate.

- return: the viewstate value corresponding to $key
- access: protected

mixed getViewState (string $key, [mixed $defaultValue = null])

- string $key: the name of the viewstate value to be returned
- mixed $defaultValue: the default value. If $key is not found in viewstate, $defaultValue will be returned

render (line 486)

Renders this hotspot.

- access: public

void render (THtmlWriter $writer)

- THtmlWriter $writer

setAccessKey (line 346)

- access: public

void setAccessKey (string $value)

- string $value: the access key that allows you to quickly navigate to the HotSpot region.

setAlternateText (line 362)

- access: public

void setAlternateText (string $value)

- string $value: the alternate text to display for a HotSpot object.

setCausesValidation (line 443)

- access: public

void setCausesValidation (boolean $value)

- boolean $value: whether postback event trigger by this hotspot will cause input validation

setHotSpotMode (line 379)

- access: public

void setHotSpotMode (string $value)

- string $value: the behavior of a HotSpot object when it is clicked. Valid values include 'NotSet','Navigate','PostBack','Inactive'.

setNavigateUrl (line 395)

- access: public

void setNavigateUrl (string $value)

- string $value: the URL to navigate to when a HotSpot object is clicked.

setPostBackValue (line 411)

- access: public

void setPostBackValue (string $value)

- string $value: a value that is post back when the HotSpot is clicked.

setTabIndex (line 427)

- access: public

void setTabIndex (integer $value)

- integer $value: the tab index of the HotSpot region.

setTarget (line 477)

- access: public

void setTarget (string $value)

- string $value: the target window or frame to display the new page when the HotSpot region is clicked.

setValidationGroup (line 459)

- access: public

void setValidationGroup (string $value)

- string $value: the group of validators which the hotspot causes validation upon postback

setViewState (line 318)

Sets a viewstate value.

This function is very useful in defining setter functions for control properties that must be kept in viewstate. Make sure that the viewstate value must be serializable and unserializable.

- access: protected

void setViewState (string $key, mixed $value, [mixed $defaultValue = null])

- string $key: the name of the viewstate value
- mixed $value: the viewstate value to be set
- mixed $defaultValue: default value. If $value===$defaultValue, the item will be cleared from the viewstate.

#### Inherited Methods

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

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