Class: Image

Source Location: /extctrls.inc.php

Class Overview

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

Image class

Class Details

[line 66]
Image class

A class to encapsulate and display an image.

[ Top ]

Properties Autosize [published] Border [published] BorderColor [published] Center [published] DataField [published] DataSource [published] ImageSource [published] Link [published] LinkTarget [published] ParentShowHint [published] PopupMenu [published] Proportional [published] ShowHint [published] Style [published] Visible [published]	Events OnClick [published] OnCustomize [published]	JS Events OnClick [published] OnDblClick [published] OnKeyDown [published] OnKeyPress [published] OnKeyUp [published] OnMouseDown [published] OnMouseMove [published] OnMouseOut [published] OnMouseOver [published] OnMouseUp [published]
Methods __construct dumpContents dumpJavascript init loaded	Constants [none]

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 Autosize : bool [line 425]

If Autosize is true the control takes over the size of the image.

This way the image is displayed 100%.

[ Top ]

property Border : bool [line 437]

Adds a border around the image if true.

[ Top ]

property BorderColor : string [line 449]

Color of the border, only has an affect if Border is set to true.

Use the HTML hex color format. e.g. #FF0000 for red.

[ Top ]

property Center : bool [line 470]

Indicates whether the image is centered in the image control.

When the image does not fit perfectly within the image control, use Center to specify how the image is positioned. When Center is true, the image is centered in the control. When Center is false, the upper left corner of the image is positioned at the upper left corner of the control.

Note: Center has no effect if the AutoSize property is true.

[ Top ]

property DataField : string [line 490]

Fieldname this control is attached to

[ Top ]

property DataSource : DataSource [line 498]

Datasource this control is attached to

[ Top ]

property ImageSource : string [line 507]

Source of the image denotes a path where the image is located.

This path can be relative to the script or absolute.

[ Top ]

property Link : string [line 519]

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 531]

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 ParentShowHint [line 539]

Determines where a control looks to find out if its Help Hint should be shown.

Defined in Control::ParentShowHint

[ Top ]

property PopupMenu [line 542]

Specifies the PopupMenu component to show when right clicking the control

Defined in Control::PopupMenu

[ Top ]

property Proportional : bool [line 560]

Indicates whether the image should be changed, without distortion, so that it fits the bounds of the image control.

Set Proportional to true to ensure that the image can be fully displayed in the image control without any distortion. When Proportional is true, images that are too large to fit in the image control are scaled down (while maintaining the same aspect ratio) until they fit in the image control. Images that are too small are displayed normally. That is, Proportional can reduce the magnification of the image, but does not increase it.

Note: The filesize is equal even the image is scaled down.

[ Top ]

property ShowHint [line 579]

Determines whether the control displays a Help Hint when the mouse pointer rests momentarily on the control.

Defined in Control::ShowHint

[ Top ]

property Style [line 582]

CSS style to be used when rendering the component

Defined in Control::Style

[ Top ]

property Visible [line 585]

Determines if the controls is visible in run-time or not

Defined in Control::Visible

[ Top ]

Events

property OnClick [line 359]

Occurs when the user clicks the control.

Tags:

return:

Returns the event handler or null if no handler is set.

Fires when the user clicks the left mouse button on the object.

Defined in Control::OnClick

[ Top ]

property OnCustomize [line 372]

Occurs before the image tag is written to the stream sent to the client.

Use this event to modifiy the image source.

Tags:

return:

Event handler or null to unset.

[ Top ]

Javascript Events

property OnClick [line 385]

Fires when the user clicks the left mouse button on the object.

Defined in Control::OnClick

[ Top ]

property OnDblClick [line 388]

Fires when the user double-clicks the object.

Defined in Control::OnDblClick

[ Top ]

property OnKeyDown [line 409]

Fires when the user presses a key.

Defined in Control::OnKeyDown

[ Top ]

property OnKeyPress [line 406]

Fires when the user presses an alphanumeric key.

Defined in Control::OnKeyPress

[ Top ]

property OnKeyUp [line 412]

Fires when the user releases a key.

Defined in Control::OnKeyUp

[ Top ]

property OnMouseDown [line 391]

Fires when the user clicks the object with either mouse button.

Defined in Control::OnMouseDown

[ Top ]

property OnMouseMove [line 400]

Fires when the user moves the mouse over the object.

Defined in Control::OnMouseMove

[ Top ]

property OnMouseOut [line 403]

Fires when the user moves the mouse pointer outside the boundaries of the object.

Defined in Control::OnMouseOut

[ Top ]

property OnMouseOver [line 397]

Fires when the user moves the mouse pointer into the object.

Defined in Control::OnMouseOver

[ Top ]

property OnMouseUp [line 394]

Fires when the user releases a mouse button while the mouse is over the object.

Defined in Control::OnMouseUp

[ Top ]

Methods

constructor __construct [line 83]

Image __construct(
[
$aowner = null])

Overrides FocusControl::__construct (parent method not documented)

Parameters:

$aowner

[ Top ]

void dumpContents [line 157]

void dumpContents(
)

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

[ Top ]

void dumpJavascript [line 333]

void dumpJavascript(
)

Write the Javascript section to the header

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

[ Top ]

void init [line 141]

void init(
)

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

[ Top ]

void loaded [line 116]

void loaded(
)

Overrides Control::loaded (parent method not documented)

[ Top ]

Documentation generated on Tue, 27 Mar 2007 13:34:45 +0200 by phpDocumentor 1.3.1

Class: Image

Class Overview

Class Details

Properties

Events

JS Events

Methods

Constants

Inherited Properties

Class: FocusControl

Class: Control

Class: Component

Class: Persistent

Inherited Events

Class: Control

Inherited JS Events

Class: Control

Inherited Methods

Class: FocusControl

Class: Control

Class: Component

Class: Persistent

Class: Object

Properties

property Autosize : bool [line 425]

property Border : bool [line 437]

property BorderColor : string [line 449]

property Center : bool [line 470]

property DataField : string [line 490]

property DataSource : DataSource [line 498]

property ImageSource : string [line 507]

property Link : string [line 519]

Tags:

property LinkTarget : string [line 531]

Tags:

property ParentShowHint [line 539]

property PopupMenu [line 542]

property Proportional : bool [line 560]

property ShowHint [line 579]

property Style [line 582]

property Visible [line 585]

Events

property OnClick [line 359]

Tags:

property OnCustomize [line 372]

Tags:

Javascript Events

property OnClick [line 385]

property OnDblClick [line 388]

property OnKeyDown [line 409]

property OnKeyPress [line 406]

property OnKeyUp [line 412]

property OnMouseDown [line 391]

property OnMouseMove [line 400]

property OnMouseOut [line 403]

property OnMouseOver [line 397]

property OnMouseUp [line 394]

Methods

constructor __construct [line 83]

Parameters:

void dumpContents [line 157]

void dumpJavascript [line 333]

void init [line 141]

void loaded [line 116]