Class: CustomLabel

Source Location: /stdctrls.inc.php

Class Overview

Object
   |
   --Persistent
      |
      --Component
         |
         --Control
            |
            --FocusControl
               |
               --CustomControl
                  |
                  --GraphicControl
                     |
                     --CustomLabel

CustomLabel class

Class Details

[line 352]
CustomLabel class

CustomLabel is the base class for controls that display text on a form. The Caption of the CustomLabel may contain HTML formatted text.

[ Top ]

Properties

DataField [public]
DataSource [public]
Link [public]
LinkTarget [public]
WordWrap [public]

Events

OnClick [public]
OnDblClick [public]

JS Events

[none]

Methods

Constants

[none]

Child classes:

Label: Label class derived from CustomLabel.

Inherited Properties

Class: FocusControl

FocusControl::ControlCount: Return the number of controls for which this control is the Parent
FocusControl::Layout: Specifies the Layout this control lives in @see ActiveLayout

Class: Control

Control::AdjustToLayout: If true, the control should adjust to the selected layout
Control::Align: Specifies the Align for this control
Control::Alignment: Specifies the alignment to be used by the control
Control::Caption: Returns the caption property
Control::Color: Returns the color property
Control::ControlStyle: An array which holds the control style, with settings for the IDE
Control::Cursor: Cursor to show when the mouse is over the control
Control::DesignColor: Specifies a color can be used by the control in design time
Control::DoParentReset: Performs a parent reset if true
Control::Enabled: Determines if the controls is enabled or not
Control::Font: Determines the Font to be used when generating this control
Control::Height
Control::Hint: Text to show in a tooltip when the mouse is over the control for some time
Control::HintAttribute: This function returns the attribute for the hint that can be included in any tag. The attribute's name is "title".
Control::IsLayer: Specifies if this control is a Layer instead be integrated into the document
Control::JsEvents: Return assigned javascript events as attributes for the tag
Control::JSWrapperHiddenFieldName: Get the name of the hidden field used to submit the value which event was fired.
Control::Layer: Determines the layer this control is going to be rendered
Control::Left: Left coordinate
Control::Parent: Determines the parent control which holds this control
Control::ParentColor: Determines where a control looks for its color information.
Control::ParentFont: Determines where a control looks for its font information.
Control::ParentShowHint: Determines where a control looks to find out if its Help Hint should be shown.
Control::PopupMenu: Specifies the PopupMenu component to show when right clicking the control
Control::ShowHint: Determines whether the control displays a Help Hint when the mouse pointer rests momentarily on the control.
Control::Style: CSS style to be used when rendering the component
Control::StyleClass: Return the normalized CSS style
Control::Top: Top coordinate
Control::Visible: Determines if the controls is visible in run-time or not
Control::Width: Control width

Class: Component

Component::ComponentCount: Indicates how many components this component is owner
Component::Components: Component list containing all the components owned by this component
Component::ControlState: A flag to know the state of the control, csLoading, csDesigning
Component::DataFieldValue: This function returns the value of the datafield, if any
Component::Name: Name for the component, to be used as an identifier, should be unique
Component::NamePath: The path to uniquely identify a component, qualified by the owner when required
Component::Owner: The owner of this component, usually the page component, but the owner of pages is the application object
Component::Tag: A versatily property of every Component that can be used in any way you want

Class: Persistent

Persistent::NamePath: Used to serialize/unserialize
Persistent::Owner: Owner of the component, in Persistent always return null

Inherited Events

Class: Control

Control::OnAfterShow: Event fired after show the control
Control::OnBeforeShow: Event fired before show the control
Control::OnShow: Event fired at the same moment the control is show, some controls can

Inherited JS Events

Class: Control

Control::OnActivate: Fires when the object is set as the active element.
Control::OnBeforeCopy: Fires on the source object before the selection is copied to the system clipboard.
Control::OnBeforeCut: Fires on the source object before the selection is deleted from the document.
Control::OnBeforeDeactivate: Fires immediately before the activeElement is changed from the current object to another object in the parent document.
Control::OnBeforeEditfocus: Fires before an object contained in an editable element enters a UI-activated state or when an editable container object is control selected.
Control::OnBeforePaste: Fires on the target object before the selection is pasted from the system clipboard to the document.
Control::OnBlur: Fires when the object loses the input focus.
Control::OnChange: Fires when the contents of the object or selection have changed.
Control::OnClick: Fires when the user clicks the left mouse button on the object.
Control::OnContextMenu: Fires when the user clicks the right mouse button in the client area, opening the context menu.
Control::OnControlSelect: Fires when the user is about to make a control selection of the object.
Control::OnCopy: Fires on the source element when the user copies the object or selection, adding it to the system clipboard.
Control::OnCut: Fires on the source element when the object or selection is removed from the document and added to the system clipboard.
Control::OnDblClick: Fires when the user double-clicks the object.
Control::OnDeactivate: Fires when the activeElement is changed from the current object to another object in the parent document.
Control::OnDrag: Fires on the source object continuously during a drag operation.
Control::OnDragEnter: Fires on the target element when the user drags the object to a valid drop target.
Control::OnDragLeave: Fires on the target object when the user moves the mouse out of a valid drop target during a drag operation.
Control::OnDragOver: Fires on the target element continuously while the user drags the object over a valid drop target.
Control::OnDragStart: Fires on the source object when the user starts to drag a text selection or selected object.
Control::OnDrop: Fires on the target object when the mouse button is released during a drag-and-drop operation.
Control::OnFilterChange: Fires when a visual filter changes state or completes a transition.
Control::OnFocus: Fires when the object receives focus
Control::OnHelp: Fires when the user presses the F1 key while the browser is the active window.
Control::OnKeyDown: Fires when the user presses a key.
Control::OnKeyPress: Fires when the user presses an alphanumeric key.
Control::OnKeyUp: Fires when the user releases a key.
Control::OnLoseCapture: Fires when the object loses the mouse capture.
Control::OnMouseDown: Fires when the user clicks the object with either mouse button.
Control::OnMouseEnter: Fires when the user moves the mouse pointer into the object.
Control::OnMouseLeave: Fires when the user moves the mouse pointer outside the boundaries of the object.
Control::OnMouseMove: Fires when the user moves the mouse over the object.
Control::OnMouseOut: Fires when the user moves the mouse pointer outside the boundaries of the object.
Control::OnMouseOver: Fires when the user moves the mouse pointer into the object.
Control::OnMouseUp: Fires when the user releases a mouse button while the mouse is over the object.
Control::OnPaste: Fires on the target object when the user pastes data, transferring the data from the system clipboard to the document.
Control::OnPropertyChange: Fires when a property changes on the object.
Control::OnReadyStateChange: Fires when the state of the object has changed.
Control::OnResize: Fires when the size of the object is about to change.
Control::OnResizeEnd: Fires when the user finishes changing the dimensions of the object in a control selection.
Control::OnResizeStart: Fires when the user begins to change the dimensions of the object in a control selection
Control::OnSelectStart: Fires when the object is being selected

Inherited Methods

Class: FocusControl

FocusControl::__construct
FocusControl::dumpChildren: Dump all children
FocusControl::updateChildrenColors: Update the colors for all the children if parentcolor is set
FocusControl::updateChildrenFonts: If this control has any children that have ParentFont==true then this function will assign the Font property to all children Font properties.
FocusControl::updateChildrenParentProperties: If this control has any children that use a property's value from the parent then this function will update all necessary properties.
FocusControl::updateChildrenShowHints: Update the ShowHints properties for all children controlss

Class: Control

Control::__construct: Constructor for the class
Control::addJSWrapperToEvents: Add or replace the JS event attribute with the wrapper.
Control::canShow: Determines whether a control can be shown or not
Control::dumpChildren: Dump all children components
Control::dumpContents: Dump the control contents, inherit and fill this method with the code
Control::dumpHeaderCode
Control::dumpJavascript: Dump Javascript code required for this component to work
Control::dumpJSEvent: Dumps a javascript named $event
Control::dumpJsEvents: Dump Javascript events
Control::getJSWrapperFunction: JS wrapper function that forwards a JS event to the PHP script by submitting the HTML form.
Control::getJSWrapperFunctionName: Get the function name of a JS event wrapper.
Control::getJSWrapperSubmitEventValue: Value set to the hidden field when the specific JS event was fired and the wrapper function was called.
Control::loaded
Control::show: Show control contents
Control::updateParentColor: If ParentColor == true the parent's color is assigned to this control.
Control::updateParentFont: If ParentFont == true the parent's font is assigned to this control.
Control::updateParentProperties: Updates all properties that use the parent property as source.
Control::updateParentShowHint: If ParentShowHint == true the parent's showhint is assigned to this control.

Class: Component

Component::__construct: Constructor
Component::ajaxCall: Returns the js event attribute to call the server using ajax
Component::callEvent: Calls a server event
Component::dumpChildrenHeaderCode: Dump the header code for all the children
Component::dumpChildrenJavascript: Dump the javascript code for all the children
Component::dumpHeaderCode: To dump header code required
Component::dumpHiddenKeyFields: This function dumps out the key fields for the current row, useful to
Component::dumpJavascript: To dump the javascript code needed by this component
Component::fixupProperty: This method returns the right object (or the input string if object not found) for an object name Should be used on the loaded method for object properties to find the right reference
Component::generateAjaxEvent: Returns the js event attribute to call the server using Ajax we use xajax to handle all the ajax stuff.
Component::hasValidDataField: This function returns true if the datafield is valid
Component::init: To initialize a component, the right place to process events
Component::insertComponent: Insert a component into the components collection
Component::loaded: A virtual method to get notified when the object has been fully loaded from a stream
Component::loadedChildren: Calls childrens loaded recursively
Component::loadResource: Load this component from a string
Component::preinit: To initialize a component, called before init()
Component::readAccessibility: Overwrite this method to provide accessibility info for the RPC engine
Component::readFromResource: Read a component from a resource file
Component::removeComponent: Remove a component from the components collection
Component::serializeChildren: Serialize all children
Component::unserializeChildren: Unserialize all children
Component::updateDataField: Checks if there is any datafield attached to the component

Class: Persistent

Persistent::assign: Assing the source properties to this object
Persistent::assignError: Raises an assignation error
Persistent::assignTo: Assign this object to another object
Persistent::serialize: Stores this object into the session, it uses PHP reflection system to get published properties, the ones that will be stored.
Persistent::unserialize: Read this object properties from the session, only published properties will be recovered, components need an owner to be unserialized.

Class: Object

Object::__construct: Constructor
Object::className: Returns the name of the object class
Object::classNameIs: Check if the object is from a specific class
Object::classParent: Returns the parent class of the object
Object::inheritsFrom: Check if the object inherits from a specific class
Object::methodExists: Check if a method exists
Object::readProperty: Reads a property from the streams
Object::__get: To virtualize properties
Object::__set: To virtualize properties

Properties

property DataField : string [line 630]

DataField indicates which field of the DataSource is used to fill in the Caption.

Tags:

return:

Returns the data field.

[ Top ]

property DataSource : mixed [line 653]

DataSource indicates the source where the Caption is read from.

The label is read-only meaning it does not update any data in the data source.

Tags:

return:

Data source object or null if not used.

[ Top ]

property Link : string [line 675]

If Link is set the Caption is rendered as a link.

Tags:

return:

Link, if empty string the link is not used.

[ Top ]

property LinkTarget : string [line 697]

Target attribute when the label acts as a link.

Tags:

return:	The link target as defined by the HTML specs.
link:	http://www.w3.org/TR/html4/present/frames.html#adef-target

[ Top ]

property WordWrap : bool [line 711]

Specifies whether the label text wraps when it is too long for the width of the label.

Tags:

return:

True if word wrap is enabled, false otherwise.

[ Top ]

Events

property OnClick [line 587]

Occurs when the user clicks the control.

property OnDblClick [line 608]

Occurs when the user double clicks the control.

Javascript Events

Methods

constructor __construct [line 364]

CustomLabel __construct(
[
$aowner = null])

Overrides FocusControl::__construct (parent method not documented)

Parameters:

$aowner

[ Top ]

void dumpContents [line 403]

void dumpContents(
)

Overrides Control::dumpContents (Dump the control contents, inherit and fill this method with the code)

[ Top ]

void dumpJavascript [line 530]

void dumpJavascript(
)

Overrides Control::dumpJavascript (Dump Javascript code required for this component to work)

[ Top ]

void init [line 375]

void init(
)

Overrides Component::init (To initialize a component, the right place to process events)

[ Top ]

void loaded [line 396]

void loaded(
)

Overrides Control::loaded (parent method not documented)

[ Top ]

string strip_selected_tags [line 569]

string strip_selected_tags(
string
$text, [array
$tags = array()])

Helper function to strip selected tags.

This function will also replace self-closing tags (XHTML
<hr />) and will work if the text contains line breaks.

Tags:

return:	Returns $text without the defined $tags.
access:	protected

Parameters:

string	$text	Text that may contain the tags to strip.
array	$tags	All tags that should be stripped from $text.

[ Top ]

Documentation generated on Tue, 27 Mar 2007 13:35:48 +0200 by phpDocumentor 1.3.1