From cb90a05700b7ca6b621420598ff232aa2285310c Mon Sep 17 00:00:00 2001 From: "ctrlaltca@gmail.com" <> Date: Thu, 2 Jun 2011 19:49:27 +0000 Subject: upported to trunk/ last doc changes, everything should be fine now --- .../pages/ActiveControls/ActiveCheckBoxList.page | 2 +- .../pages/ActiveControls/ActiveDataGrid.page | 12 +-- .../pages/ActiveControls/ActiveDataList.page | 2 +- .../pages/ActiveControls/ActiveDatePicker.page | 16 +++ .../pages/ActiveControls/ActiveDropDownList.page | 2 +- .../pages/ActiveControls/ActiveFileUpload.page | 33 ++++++ .../pages/ActiveControls/ActiveHiddenField.page | 12 +++ .../pages/ActiveControls/ActiveHyperLink.page | 2 +- .../pages/ActiveControls/ActiveImage.page | 2 +- .../pages/ActiveControls/ActiveImageButton.page | 2 +- .../pages/ActiveControls/ActiveLabel.page | 2 +- .../pages/ActiveControls/ActiveLinkButton.page | 2 +- .../pages/ActiveControls/ActiveListBox.page | 2 +- .../pages/ActiveControls/ActiveMultiView.page | 2 +- .../pages/ActiveControls/ActivePanel.page | 2 +- .../pages/ActiveControls/ActiveRadioButton.page | 2 +- .../ActiveControls/ActiveRadioButtonList.page | 2 +- .../pages/ActiveControls/ActiveRepeater.page | 2 +- .../pages/ActiveControls/ActiveTextBox.page | 2 +- .../pages/ActiveControls/AutoComplete.page | 4 +- .../protected/pages/ActiveControls/Callback.page | 34 +++++++ .../pages/ActiveControls/CallbackClientScript.page | 2 +- .../pages/ActiveControls/CallbackClientSide.page | 6 +- .../ActiveControls/CallbackEventParameter.page | 26 +++++ .../protected/pages/ActiveControls/DragDrop.page | 4 +- .../ActiveControls/EventTriggeredCallback.page | 15 +++ .../protected/pages/ActiveControls/Home.page | 112 ++++++++++++++++----- .../pages/ActiveControls/InPlaceTextBox.page | 42 ++++++++ .../Samples/TActiveDatePicker/Home.page | 17 ++++ .../Samples/TActiveDatePicker/Home.php | 11 ++ .../Samples/TActiveFileUpload/Home.page | 15 +++ .../Samples/TActiveFileUpload/Home.php | 21 ++++ .../ActiveControls/Samples/TCallback/Home.page | 57 +++++++++++ .../ActiveControls/Samples/TCallback/Home.php | 24 +++++ .../Samples/TEventTriggeredCallback/Home.page | 18 ++++ .../Samples/TEventTriggeredCallback/Home.php | 16 +++ .../Samples/TInPlaceTextBox/Home.page | 17 ++++ .../Samples/TInPlaceTextBox/Home.php | 11 ++ .../Samples/TTimeTriggeredCallback/Home.page | 24 +++++ .../Samples/TTimeTriggeredCallback/Home.php | 22 ++++ .../Samples/TValueTriggeredCallback/Home.page | 17 ++++ .../Samples/TValueTriggeredCallback/Home.php | 11 ++ .../ActiveControls/TimeTriggeredCallback.page | 16 +++ .../ActiveControls/ValueTriggeredCallback.page | 18 ++++ 44 files changed, 607 insertions(+), 56 deletions(-) create mode 100644 demos/quickstart/protected/pages/ActiveControls/ActiveDatePicker.page create mode 100644 demos/quickstart/protected/pages/ActiveControls/ActiveFileUpload.page create mode 100644 demos/quickstart/protected/pages/ActiveControls/ActiveHiddenField.page create mode 100644 demos/quickstart/protected/pages/ActiveControls/Callback.page create mode 100644 demos/quickstart/protected/pages/ActiveControls/CallbackEventParameter.page create mode 100644 demos/quickstart/protected/pages/ActiveControls/EventTriggeredCallback.page create mode 100644 demos/quickstart/protected/pages/ActiveControls/InPlaceTextBox.page create mode 100644 demos/quickstart/protected/pages/ActiveControls/Samples/TActiveDatePicker/Home.page create mode 100644 demos/quickstart/protected/pages/ActiveControls/Samples/TActiveDatePicker/Home.php create mode 100644 demos/quickstart/protected/pages/ActiveControls/Samples/TActiveFileUpload/Home.page create mode 100644 demos/quickstart/protected/pages/ActiveControls/Samples/TActiveFileUpload/Home.php create mode 100644 demos/quickstart/protected/pages/ActiveControls/Samples/TCallback/Home.page create mode 100644 demos/quickstart/protected/pages/ActiveControls/Samples/TCallback/Home.php create mode 100644 demos/quickstart/protected/pages/ActiveControls/Samples/TEventTriggeredCallback/Home.page create mode 100644 demos/quickstart/protected/pages/ActiveControls/Samples/TEventTriggeredCallback/Home.php create mode 100644 demos/quickstart/protected/pages/ActiveControls/Samples/TInPlaceTextBox/Home.page create mode 100644 demos/quickstart/protected/pages/ActiveControls/Samples/TInPlaceTextBox/Home.php create mode 100644 demos/quickstart/protected/pages/ActiveControls/Samples/TTimeTriggeredCallback/Home.page create mode 100644 demos/quickstart/protected/pages/ActiveControls/Samples/TTimeTriggeredCallback/Home.php create mode 100644 demos/quickstart/protected/pages/ActiveControls/Samples/TValueTriggeredCallback/Home.page create mode 100644 demos/quickstart/protected/pages/ActiveControls/Samples/TValueTriggeredCallback/Home.php create mode 100644 demos/quickstart/protected/pages/ActiveControls/TimeTriggeredCallback.page create mode 100644 demos/quickstart/protected/pages/ActiveControls/ValueTriggeredCallback.page (limited to 'demos/quickstart/protected/pages/ActiveControls') diff --git a/demos/quickstart/protected/pages/ActiveControls/ActiveCheckBoxList.page b/demos/quickstart/protected/pages/ActiveControls/ActiveCheckBoxList.page index 2560ece5..07068a43 100644 --- a/demos/quickstart/protected/pages/ActiveControls/ActiveCheckBoxList.page +++ b/demos/quickstart/protected/pages/ActiveControls/ActiveCheckBoxList.page @@ -1,6 +1,6 @@ -

TActiveCheckBoxList

+

TActiveCheckBoxList

diff --git a/demos/quickstart/protected/pages/ActiveControls/ActiveDataGrid.page b/demos/quickstart/protected/pages/ActiveControls/ActiveDataGrid.page index 9a82743d..9f413a83 100644 --- a/demos/quickstart/protected/pages/ActiveControls/ActiveDataGrid.page +++ b/demos/quickstart/protected/pages/ActiveControls/ActiveDataGrid.page @@ -34,16 +34,16 @@ Please refer to the original documentation of

-

Columns

+

Columns

-

Automatically Generated Columns

+

Automatically Generated Columns

TDataGrid by default will create a list of columns based on the structure of the bound data. TDataGrid will read the first row of the data, extract the field names of the row, and construct a column for each field. Each column is of type TActiveBoundColumn. All of this happens in an ajax callback.

-

Manually Specified Columns

+

Manually Specified Columns

The following example uses manually specified columns to show a list of book information,

@@ -60,7 +60,7 @@ Each column can be shown or hidden in a callback. -

Interacting with TActiveDataGrid

+

Interacting with TActiveDataGrid

The following example shows how to make the previous book information table an interactive one. It allows users to edit and delete book items from the table. Two additional columns are used in the example to allow users interact with the datagrid: TActiveEditCommandColumn and TActiveButtonColumn. In addition, TActiveDropDownListColumn replaces the previous TActiveTemplateColumn to allow users to select a rating from a dropdown list. Note, it is also possible to use TActiveTemplateColumn to achieve the same task. @@ -68,13 +68,13 @@ All the iteration is done using AJAX callbacks.

-

Sorting

+

Sorting

The following example turns the datagrid in Example 2 into a sortable one. Users can click on the link button displayed in the header of any column, and the data will be sorted in ascending order along that column. The grid is sorted and rendered upon a callback request.

-

Paging

+

Paging

The following example enables the paging functionality of the datagrid shown in Example 1. In this example, you move between the datagrid pages clicking on the pager links. The grid reacts to paging rendering itself as the result of a callback request. Note that you can't change the pager style upon callback.

diff --git a/demos/quickstart/protected/pages/ActiveControls/ActiveDataList.page b/demos/quickstart/protected/pages/ActiveControls/ActiveDataList.page index 12fb941f..cef53c66 100644 --- a/demos/quickstart/protected/pages/ActiveControls/ActiveDataList.page +++ b/demos/quickstart/protected/pages/ActiveControls/ActiveDataList.page @@ -1,6 +1,6 @@ -

TActiveDataList

+

TActiveDataList

diff --git a/demos/quickstart/protected/pages/ActiveControls/ActiveDatePicker.page b/demos/quickstart/protected/pages/ActiveControls/ActiveDatePicker.page new file mode 100644 index 00000000..b60036d0 --- /dev/null +++ b/demos/quickstart/protected/pages/ActiveControls/ActiveDatePicker.page @@ -0,0 +1,16 @@ + + +

TActiveDatePicker

+ + +

+TActiveDatePicker is the active control counter part to TDatePicker control. +When the date selection is changed, the OnCallback event is raised. +

+

+Please refer to the documentation of TDatePicker for further usage informations. +

+ + + +
$Id$
 \ No newline at end of file diff --git a/demos/quickstart/protected/pages/ActiveControls/ActiveDropDownList.page b/demos/quickstart/protected/pages/ActiveControls/ActiveDropDownList.page index 4400c552..6dfc870a 100644 --- a/demos/quickstart/protected/pages/ActiveControls/ActiveDropDownList.page +++ b/demos/quickstart/protected/pages/ActiveControls/ActiveDropDownList.page @@ -1,6 +1,6 @@ -

TActiveDropDownList

+

TActiveDropDownList

diff --git a/demos/quickstart/protected/pages/ActiveControls/ActiveFileUpload.page b/demos/quickstart/protected/pages/ActiveControls/ActiveFileUpload.page new file mode 100644 index 00000000..099e33f7 --- /dev/null +++ b/demos/quickstart/protected/pages/ActiveControls/ActiveFileUpload.page @@ -0,0 +1,33 @@ + + +

TActiveFileUpload

+ + +

+TActiveFileUpload displays a file upload field on a page. Upon postback, +the text entered into the field will be treated as the name of the file +that will be uploaded to the server. The property HasFile +indicates whether the file upload is successful. If successful, the file +may be obtained by callingsaveAs to save it at a specified place. +You can use FileName, FileType, +FileSize to get the original client-side file name, +the file mime type, and the file size information. If the upload is not +successful, ErrorCode contains the error code +describing the cause of failure. +

+ +

+TActiveFileUpload raises OnFileUpload event if a file is uploaded +(whether it succeeds or not). +

+ +

+TActiveFileUpload actually does a postback in a hidden IFrame, and then does a callback. +This callback then raises the OnFileUpload event. After the postback +a status icon is displayed; either a green checkmark if the upload is successful, +or a red x if there was an error. +

+ + + +
$Id$
 \ No newline at end of file diff --git a/demos/quickstart/protected/pages/ActiveControls/ActiveHiddenField.page b/demos/quickstart/protected/pages/ActiveControls/ActiveHiddenField.page new file mode 100644 index 00000000..23240da8 --- /dev/null +++ b/demos/quickstart/protected/pages/ActiveControls/ActiveHiddenField.page @@ -0,0 +1,12 @@ + + +

TActiveHiddenField

+ + +

+TActiveHiddenField is the active control counterpart of THiddenField component. +It displays a hidden input field on a Web page. The value of the input field can be accessed and changed +on callback via the Value property. +

+ +
$Id$
 \ No newline at end of file diff --git a/demos/quickstart/protected/pages/ActiveControls/ActiveHyperLink.page b/demos/quickstart/protected/pages/ActiveControls/ActiveHyperLink.page index a67462cf..e5e51d1f 100644 --- a/demos/quickstart/protected/pages/ActiveControls/ActiveHyperLink.page +++ b/demos/quickstart/protected/pages/ActiveControls/ActiveHyperLink.page @@ -3,7 +3,7 @@

TActiveHyperLink

-

+

The active control counterpart of THyperLink component. During a callback request, changes to the Text, ImageUrl, NavigateUrl and Target properties on the server side will also diff --git a/demos/quickstart/protected/pages/ActiveControls/ActiveImage.page b/demos/quickstart/protected/pages/ActiveControls/ActiveImage.page index 8cce8c9e..b9da97c9 100644 --- a/demos/quickstart/protected/pages/ActiveControls/ActiveImage.page +++ b/demos/quickstart/protected/pages/ActiveControls/ActiveImage.page @@ -1,6 +1,6 @@ -

TActiveImage

+

TActiveImage

diff --git a/demos/quickstart/protected/pages/ActiveControls/ActiveImageButton.page b/demos/quickstart/protected/pages/ActiveControls/ActiveImageButton.page index 44b988dd..3d0aae7f 100644 --- a/demos/quickstart/protected/pages/ActiveControls/ActiveImageButton.page +++ b/demos/quickstart/protected/pages/ActiveControls/ActiveImageButton.page @@ -1,6 +1,6 @@ -

TActiveImageButton

+

TActiveImageButton

diff --git a/demos/quickstart/protected/pages/ActiveControls/ActiveLabel.page b/demos/quickstart/protected/pages/ActiveControls/ActiveLabel.page index 8db4cf34..e8c84f51 100644 --- a/demos/quickstart/protected/pages/ActiveControls/ActiveLabel.page +++ b/demos/quickstart/protected/pages/ActiveControls/ActiveLabel.page @@ -1,6 +1,6 @@ -

TActiveLabel

+

TActiveLabel

diff --git a/demos/quickstart/protected/pages/ActiveControls/ActiveLinkButton.page b/demos/quickstart/protected/pages/ActiveControls/ActiveLinkButton.page index 387b40af..dc542ae8 100644 --- a/demos/quickstart/protected/pages/ActiveControls/ActiveLinkButton.page +++ b/demos/quickstart/protected/pages/ActiveControls/ActiveLinkButton.page @@ -1,6 +1,6 @@ -

TActiveLinkButton

+

TActiveLinkButton

diff --git a/demos/quickstart/protected/pages/ActiveControls/ActiveListBox.page b/demos/quickstart/protected/pages/ActiveControls/ActiveListBox.page index 802c9fb1..ce45339f 100644 --- a/demos/quickstart/protected/pages/ActiveControls/ActiveListBox.page +++ b/demos/quickstart/protected/pages/ActiveControls/ActiveListBox.page @@ -1,6 +1,6 @@ -

TActiveListBox

+

TActiveListBox

diff --git a/demos/quickstart/protected/pages/ActiveControls/ActiveMultiView.page b/demos/quickstart/protected/pages/ActiveControls/ActiveMultiView.page index a9553646..54867a0c 100644 --- a/demos/quickstart/protected/pages/ActiveControls/ActiveMultiView.page +++ b/demos/quickstart/protected/pages/ActiveControls/ActiveMultiView.page @@ -1,6 +1,6 @@ -

TActiveMultiView

+

TActiveMultiView

diff --git a/demos/quickstart/protected/pages/ActiveControls/ActivePanel.page b/demos/quickstart/protected/pages/ActiveControls/ActivePanel.page index dcfbc312..967b96c0 100644 --- a/demos/quickstart/protected/pages/ActiveControls/ActivePanel.page +++ b/demos/quickstart/protected/pages/ActiveControls/ActivePanel.page @@ -1,6 +1,6 @@ -

TActivePanel

+

TActivePanel

diff --git a/demos/quickstart/protected/pages/ActiveControls/ActiveRadioButton.page b/demos/quickstart/protected/pages/ActiveControls/ActiveRadioButton.page index ac6cf5ae..95c2e570 100644 --- a/demos/quickstart/protected/pages/ActiveControls/ActiveRadioButton.page +++ b/demos/quickstart/protected/pages/ActiveControls/ActiveRadioButton.page @@ -1,6 +1,6 @@ -

TRadioButton

+

TRadioButton

diff --git a/demos/quickstart/protected/pages/ActiveControls/ActiveRadioButtonList.page b/demos/quickstart/protected/pages/ActiveControls/ActiveRadioButtonList.page index 6095a9d3..31f16535 100644 --- a/demos/quickstart/protected/pages/ActiveControls/ActiveRadioButtonList.page +++ b/demos/quickstart/protected/pages/ActiveControls/ActiveRadioButtonList.page @@ -1,6 +1,6 @@ -

TActiveRadioButtonList

+

TActiveRadioButtonList

diff --git a/demos/quickstart/protected/pages/ActiveControls/ActiveRepeater.page b/demos/quickstart/protected/pages/ActiveControls/ActiveRepeater.page index d22a7467..f41c2ece 100644 --- a/demos/quickstart/protected/pages/ActiveControls/ActiveRepeater.page +++ b/demos/quickstart/protected/pages/ActiveControls/ActiveRepeater.page @@ -1,6 +1,6 @@ -

TActiveRepeater

+

TActiveRepeater

diff --git a/demos/quickstart/protected/pages/ActiveControls/ActiveTextBox.page b/demos/quickstart/protected/pages/ActiveControls/ActiveTextBox.page index 9a508e32..9665d11d 100644 --- a/demos/quickstart/protected/pages/ActiveControls/ActiveTextBox.page +++ b/demos/quickstart/protected/pages/ActiveControls/ActiveTextBox.page @@ -1,6 +1,6 @@ -

TActiveTextBox

+

TActiveTextBox

diff --git a/demos/quickstart/protected/pages/ActiveControls/AutoComplete.page b/demos/quickstart/protected/pages/ActiveControls/AutoComplete.page index 14af4af7..f4de7390 100644 --- a/demos/quickstart/protected/pages/ActiveControls/AutoComplete.page +++ b/demos/quickstart/protected/pages/ActiveControls/AutoComplete.page @@ -1,10 +1,10 @@ -

TAutoComplete

+

TAutoComplete

-TAutoComplete is an extended ActiveTextBox that provides a list of suggestions on the current partial word typed in the textbox. The suggestions are requested using callbacks. The Frequency and MinChars properties sets the delay and minimum number of characters typed, respectively, before requesting for sugggestions. An embedded TRepeater is used to Display the list of suggestions. It can be accessed and styled through the Suggestions property and its sub-properties.

+TAutoComplete is an extended ActiveTextBox that provides a list of suggestions on the current partial word typed in the textbox. The suggestions are requested using callbacks. The Frequency and MinChars properties sets the delay and minimum number of characters typed, respectively, before requesting for sugggestions. An embedded TRepeater is used to Display the list of suggestions. It can be accessed and styled through the Suggestions property and its sub-properties.

On each request for suggestions, the OnSuggestion event will be raised. The event handler receives the entered token that can be used to build the list of suggestions and to dataBind() it to the Suggestions repeater.

diff --git a/demos/quickstart/protected/pages/ActiveControls/Callback.page b/demos/quickstart/protected/pages/ActiveControls/Callback.page new file mode 100644 index 00000000..3e2b8527 --- /dev/null +++ b/demos/quickstart/protected/pages/ActiveControls/Callback.page @@ -0,0 +1,34 @@ + + +

TCallback

+ + +

+TCallback provides a basic callback handler that can be invoked from the +client side by using the javascript ojbect obtained from the +ActiveControl.Javascript property. +You can set the CallbackParameter property from javascript directly on +the object returned by ActiveControl.Javascript. +Once you are ready, you can call the dispatch() method on the object to +execute the callback. +The server-side event OnCallback is raised when a callback is requested made. +

+ +

+Example usage: +

+ +<com:TCallback ID="callback1" OnCallback="callback1_Requested" /> +<script type="text/javascript"> + function do_callback1() + { + var request = <%= $this->callback1->ActiveControl->Javascript %>; + request.dispatch(); + } +</script> +<div onclick="do_callback1()">Click Me!</div> + + + + +
$Id$
 \ No newline at end of file diff --git a/demos/quickstart/protected/pages/ActiveControls/CallbackClientScript.page b/demos/quickstart/protected/pages/ActiveControls/CallbackClientScript.page index 7ffd2db9..67361f4c 100644 --- a/demos/quickstart/protected/pages/ActiveControls/CallbackClientScript.page +++ b/demos/quickstart/protected/pages/ActiveControls/CallbackClientScript.page @@ -1,6 +1,6 @@ -

TCallbackClientScript

+

TCallbackClientScript

diff --git a/demos/quickstart/protected/pages/ActiveControls/CallbackClientSide.page b/demos/quickstart/protected/pages/ActiveControls/CallbackClientSide.page index c8e52585..8899a884 100644 --- a/demos/quickstart/protected/pages/ActiveControls/CallbackClientSide.page +++ b/demos/quickstart/protected/pages/ActiveControls/CallbackClientSide.page @@ -1,6 +1,6 @@ -

TCallbackClientSide

+

TCallbackClientSide

@@ -25,7 +25,7 @@ The following example demonstrates the toggling of a "loading" indicator when th </com:TActiveButton> -

Events

+

Events

The following client side events are executing in order if the callback @@ -58,7 +58,7 @@ response is returned. A successful request/response will raise OnSuccess event otherwise OnFailure will be raised.

-

Properties

+

Properties

The following properties can be used to change the way the callback request is performed. diff --git a/demos/quickstart/protected/pages/ActiveControls/CallbackEventParameter.page b/demos/quickstart/protected/pages/ActiveControls/CallbackEventParameter.page new file mode 100644 index 00000000..f4248638 --- /dev/null +++ b/demos/quickstart/protected/pages/ActiveControls/CallbackEventParameter.page @@ -0,0 +1,26 @@ + + +

TCallbackEventParameter

+ + +

+TCallbackEventParameter provides the parameter passed during the callback +request in the CallbackParameter property. The +callback response content (e.g. new HTML content) must be rendered +using an THtmlWriter obtained from the NewWriter +property, which returns a NEW instance of TCallbackResponseWriter. +

+ +

+Each instance TCallbackResponseWriter is associated with a unique +boundary delimited. By default each panel only renders its own content. +To replace the content of ONE panel with that of rendered from multiple panels +use the same writer instance for the panels to be rendered. +

+ +

+The response data (i.e., passing results back to the client-side +callback handler function) can be set using ResponseData property. +

+ +
$Id$
 \ No newline at end of file diff --git a/demos/quickstart/protected/pages/ActiveControls/DragDrop.page b/demos/quickstart/protected/pages/ActiveControls/DragDrop.page index 0969ddd0..3bd6c03a 100755 --- a/demos/quickstart/protected/pages/ActiveControls/DragDrop.page +++ b/demos/quickstart/protected/pages/ActiveControls/DragDrop.page @@ -1,6 +1,6 @@ -

TDropContainer

+

TDropContainer

TDropContainer represent an area where @@ -12,7 +12,7 @@ the OnDropk event.

-

TDraggable

+

TDraggable

TDraggable will make its child controls 'draggable'. diff --git a/demos/quickstart/protected/pages/ActiveControls/EventTriggeredCallback.page b/demos/quickstart/protected/pages/ActiveControls/EventTriggeredCallback.page new file mode 100644 index 00000000..5240ddfe --- /dev/null +++ b/demos/quickstart/protected/pages/ActiveControls/EventTriggeredCallback.page @@ -0,0 +1,15 @@ + + +

TEventTriggeredCallback

+ + +

+TEventTriggeredCallback triggers a new callback request when a particular EventName +on a control with ID given by ControlID is raised. +The default action of the event on the client-side can be prevented when +PreventDefaultAction is set to true. +

+ + + +
$Id$
 \ No newline at end of file diff --git a/demos/quickstart/protected/pages/ActiveControls/Home.page b/demos/quickstart/protected/pages/ActiveControls/Home.page index 7834cc1d..4eddd2f2 100644 --- a/demos/quickstart/protected/pages/ActiveControls/Home.page +++ b/demos/quickstart/protected/pages/ActiveControls/Home.page @@ -17,8 +17,6 @@ of javascript classes. TActiveButton control. See also the later part of the Currency Converter tutorial for a more in depth example.

-

* the tutorial for this control is not completed yet.

-

Standard Active Controls

  • @@ -37,6 +35,22 @@ TActiveButton control. See also the later part of the TActiveDatePicker + adds a date picker that permits the suer to choose a date. +
    • + +
  • + TActiveFileUpload + displays a file upload field on a page and uses an iframe to permit handling of the + file upload in a callback. +
    • + +
  • + TActiveHiddenField + displays a hidden input field that can be changed upon callback. +
    • +
  • TActiveHyperLink represents a hyperlink on a Web page. @@ -90,6 +104,11 @@ TActiveButton control. See also the later part of the TActiveRatingList + is an EXPERIMENTAL class that displays clickable images that represent a TRadioButtonList. +
    • +
  • TActiveTextBox represents a text input field on a Web page. @@ -159,35 +178,35 @@ TActiveButton control. See also the later part of the TCallback + TCallback a generic control that can perform callback requests.
  • - * TEventTriggeredCallback + TEventTriggeredCallback triggers a callback request based on HTML DOM events.
  • - * TInPlaceTextBox + TInPlaceTextBox represents a label that can be edited by clicked.
  • - * TTimeTriggeredCallback + TTimeTriggeredCallback triggers a callback request based on time elapsed.
  • - * TValueTriggeredCallback + TValueTriggeredCallback monitors (using a timer) an attribute of an HTML element and triggers a callback request when the attribute value changes.
  • - TDropContainer & TDraggable represents drag and drop containers. - The former will make its child controls "draggable" while the latter will raise a callback when a draggable - control is dropped on it. + TDropContainer & TDraggable represents drag and drop containers. + The former will make its child controls "draggable" while the latter will raise a callback when a draggable + control is dropped on it.
@@ -355,32 +374,72 @@ if Javascript was disabled on the client's browser.

-

Active Control Infrastructure Classes

+

Active Control Basic Infrastructure Classes

The following classes provide the basic infrastructure classes required to -realize the active controls.

+realize the active controls. They can be useful to develop new active controls, but Prado users tipically don't need +to use them.

  • - * TActiveControlAdapter - tracks the viewstate values of the control and update differences of the client-side HTML - element attributes. +

    TActiveControlAdapter

    + +

    + TActiveControlAdapter customizes the parent TControl class for active control classes. + It tracks changes in the viewstate values of the control and update + differences of the client-side HTML element attributes. +

  • - * TActiveListControlAdapter - allows the adapted list controls to change the selections on the client-side during - a callback request. +

    TActiveListControlAdapter

    + +

    + TActiveListControlAdapter allows the adapted list controls to change the selections + on the client-side during a callback request. +

  • - * TActivePageAdapter - process the page life-cycle for callback requests. +

    TActivePageAdapter

    + +

    + TActivePageAdapter process the page life-cycle for callback requests. +

  • - * TBaseActiveControl - common active control methods and options. +

    TBaseActiveControl

    + +

    + TBaseActiveControl class provided additional basic properties common for every + active control. An instance of TBaseActiveControl or its decendent + TBaseActiveCallbackControl is created by TActiveControlAdapter::getBaseActiveControl() + method. + The EnableUpdate property determines wether the active + control is allowed to update the contents of the client-side when the callback + response returns. +

    • +
  • +

    TCallbackResponseAdapter

    + +

    + TCallbackResponseAdapter alters the THttpResponse's outputs. + A TCallbackResponseWriter is used instead of the TTextWrite when + createHtmlWriter is called. Each call to createHtmlWriter will create + a new TCallbackResponseWriter. When flushContent() is called each + instance of TCallbackResponseWriter's content is flushed. + The callback response data can be set using the ResponseData property. +

    +
    • + +
+ +

Active Control Infrastructure Advanced Classes

+

The following classes provide advanced properties and events needed to realize the active controls. +A Prado user can use them to customize active controls behaviour and interact directly with the client side during a callback. +

+
  • TCallbackClientScript methods to manipulate the client-side HTML elements, also includes methods @@ -393,15 +452,14 @@ realize the active controls.

  • - TCallbackOptions - allows a common set of callback client-side options to be attached to one or more active controls. + TCallbackEventParameter + provides the parameter passed during the callback request.
  • - * TCallbackResponseAdapter - HTTP response for callback requests. + TCallbackOptions + allows a common set of callback client-side options to be attached to one or more active controls.
    • -
$Id$
 diff --git a/demos/quickstart/protected/pages/ActiveControls/InPlaceTextBox.page b/demos/quickstart/protected/pages/ActiveControls/InPlaceTextBox.page new file mode 100644 index 00000000..c1d31d41 --- /dev/null +++ b/demos/quickstart/protected/pages/ActiveControls/InPlaceTextBox.page @@ -0,0 +1,42 @@ + + +

TInPlaceTextBox

+ + +

+TInPlaceTextBox is a component rendered as a label and allows its +contents to be edited by changing the label to a textbox when +the label is clicked or when another control or html element with +ID given by EditTriggerControlID is clicked. +

+ +

+If the OnLoadingText event is handled, a callback request is +made when the label is clicked, while the request is being made the +textbox is disabled from editing. The OnLoadingText event allows +you to update the content of the textbox before the client is allowed +to edit the content. After the callback request returns successfully, +the textbox is enabled and the contents is then allowed to be edited. +

+ +

+Once the textbox loses focus, if AutoPostBack +is true and the textbox content has changed, a callback request is made and +the OnTextChanged event is raised like that of the TActiveTextBox. +During the request, the textbox is disabled. +

+ +

+After the callback request returns sucessfully, the textbox is enabled. +If the AutoHideTextBox property is true, then +the textbox will be hidden and the label is then shown. +

+ +

+Since 3.1.2, you can set the ReadOnly property to make +the control not editable. This property can be also changed on callback +

+ + + +
$Id$
 \ No newline at end of file diff --git a/demos/quickstart/protected/pages/ActiveControls/Samples/TActiveDatePicker/Home.page b/demos/quickstart/protected/pages/ActiveControls/Samples/TActiveDatePicker/Home.page new file mode 100644 index 00000000..fba7ec45 --- /dev/null +++ b/demos/quickstart/protected/pages/ActiveControls/Samples/TActiveDatePicker/Home.page @@ -0,0 +1,17 @@ + + +

TActiveDatePicker Samples

+ + + + + + + + +
Default TActiveDatePicker triggering a callback to a label + + +
+ +
$Id$
 \ No newline at end of file diff --git a/demos/quickstart/protected/pages/ActiveControls/Samples/TActiveDatePicker/Home.php b/demos/quickstart/protected/pages/ActiveControls/Samples/TActiveDatePicker/Home.php new file mode 100644 index 00000000..41f8359e --- /dev/null +++ b/demos/quickstart/protected/pages/ActiveControls/Samples/TActiveDatePicker/Home.php @@ -0,0 +1,11 @@ +label1->Text = date("r", $this->date1->TimeStamp); + } +} + +?> \ No newline at end of file diff --git a/demos/quickstart/protected/pages/ActiveControls/Samples/TActiveFileUpload/Home.page b/demos/quickstart/protected/pages/ActiveControls/Samples/TActiveFileUpload/Home.page new file mode 100644 index 00000000..ac82e02e --- /dev/null +++ b/demos/quickstart/protected/pages/ActiveControls/Samples/TActiveFileUpload/Home.page @@ -0,0 +1,15 @@ + + +

TActiveFileUpload Sample

+ +

+Please choose a file to upload: +

+ + + +
+ + + +
$Id$
 \ No newline at end of file diff --git a/demos/quickstart/protected/pages/ActiveControls/Samples/TActiveFileUpload/Home.php b/demos/quickstart/protected/pages/ActiveControls/Samples/TActiveFileUpload/Home.php new file mode 100644 index 00000000..d5cf990a --- /dev/null +++ b/demos/quickstart/protected/pages/ActiveControls/Samples/TActiveFileUpload/Home.php @@ -0,0 +1,21 @@ +HasFile) + { + $this->Result->Text=" + You just uploaded a file: +
+ Name: {$sender->FileName} +
+ Size: {$sender->FileSize} +
+ Type: {$sender->FileType}"; + } + } +} + +?> \ No newline at end of file diff --git a/demos/quickstart/protected/pages/ActiveControls/Samples/TCallback/Home.page b/demos/quickstart/protected/pages/ActiveControls/Samples/TCallback/Home.page new file mode 100644 index 00000000..55ced11e --- /dev/null +++ b/demos/quickstart/protected/pages/ActiveControls/Samples/TCallback/Home.page @@ -0,0 +1,57 @@ + + +

TCallback Samples

+ + + + + + + + +
+An active label text being set as the result of a callback: + + + + +
Click Me!
+
+ +
+
+A TCallback with a 3-items array as parameter. +The first parameter is defined in the onclick() attribute of the red div; +The second parameter is defined in the body of the javascript function; +The third parameter is taken from the textbox; + + + + +TextBox for third parameter: +
Click Me!
+
Parameter 1 is +
Parameter 2 is +
Parameter 3 is +
+ +
$Id$
 \ No newline at end of file diff --git a/demos/quickstart/protected/pages/ActiveControls/Samples/TCallback/Home.php b/demos/quickstart/protected/pages/ActiveControls/Samples/TCallback/Home.php new file mode 100644 index 00000000..e7f39967 --- /dev/null +++ b/demos/quickstart/protected/pages/ActiveControls/Samples/TCallback/Home.php @@ -0,0 +1,24 @@ +label1->Text="You clicked the div, didn't you?"; + } + + public function buttonClicked($sender,$param) + { + $this->label1->Text="This is a label"; + } + + public function callback2_Requested($sender,$param) + { + $parameters=$param->CallbackParameter; + $this->labelParam1->Text = THttpUtility::htmlEncode($parameters->Param1); + $this->labelParam2->Text = THttpUtility::htmlEncode($parameters->Param2); + $this->labelParam3->Text = THttpUtility::htmlEncode($parameters->Param3); + } +} + +?> \ No newline at end of file diff --git a/demos/quickstart/protected/pages/ActiveControls/Samples/TEventTriggeredCallback/Home.page b/demos/quickstart/protected/pages/ActiveControls/Samples/TEventTriggeredCallback/Home.page new file mode 100644 index 00000000..e5293f87 --- /dev/null +++ b/demos/quickstart/protected/pages/ActiveControls/Samples/TEventTriggeredCallback/Home.page @@ -0,0 +1,18 @@ + + +

TEventTriggeredCallback Samples

+ + + + + +
+ A callback will be executed when the textbox receives and loses focus + + + + + +
+ +
$Id$
 \ No newline at end of file diff --git a/demos/quickstart/protected/pages/ActiveControls/Samples/TEventTriggeredCallback/Home.php b/demos/quickstart/protected/pages/ActiveControls/Samples/TEventTriggeredCallback/Home.php new file mode 100644 index 00000000..8d92e4a3 --- /dev/null +++ b/demos/quickstart/protected/pages/ActiveControls/Samples/TEventTriggeredCallback/Home.php @@ -0,0 +1,16 @@ +label1->Text="Textbox focused"; + } + + public function txtBlurred($sender,$param) + { + $this->label1->Text="Textbox lost focus"; + } +} + +?> \ No newline at end of file diff --git a/demos/quickstart/protected/pages/ActiveControls/Samples/TInPlaceTextBox/Home.page b/demos/quickstart/protected/pages/ActiveControls/Samples/TInPlaceTextBox/Home.page new file mode 100644 index 00000000..cd55a432 --- /dev/null +++ b/demos/quickstart/protected/pages/ActiveControls/Samples/TInPlaceTextBox/Home.page @@ -0,0 +1,17 @@ + + +

TInPlaceTextBox Samples

+ + + + + +
+An in-place textbox text updating a label when its text changes: + + +
+
+ +
$Id$
 \ No newline at end of file diff --git a/demos/quickstart/protected/pages/ActiveControls/Samples/TInPlaceTextBox/Home.php b/demos/quickstart/protected/pages/ActiveControls/Samples/TInPlaceTextBox/Home.php new file mode 100644 index 00000000..5c132fd6 --- /dev/null +++ b/demos/quickstart/protected/pages/ActiveControls/Samples/TInPlaceTextBox/Home.php @@ -0,0 +1,11 @@ +label1->Text=$this->txt1->Text; + } +} + +?> \ No newline at end of file diff --git a/demos/quickstart/protected/pages/ActiveControls/Samples/TTimeTriggeredCallback/Home.page b/demos/quickstart/protected/pages/ActiveControls/Samples/TTimeTriggeredCallback/Home.page new file mode 100644 index 00000000..822be2b4 --- /dev/null +++ b/demos/quickstart/protected/pages/ActiveControls/Samples/TTimeTriggeredCallback/Home.page @@ -0,0 +1,24 @@ + + +

TTimeTriggeredCallback Samples

+ + + + + +
+A timer updating a label with the current time every 5 seconds: + + + + + +
+ +
$Id$
 \ No newline at end of file diff --git a/demos/quickstart/protected/pages/ActiveControls/Samples/TTimeTriggeredCallback/Home.php b/demos/quickstart/protected/pages/ActiveControls/Samples/TTimeTriggeredCallback/Home.php new file mode 100644 index 00000000..6c44c8c1 --- /dev/null +++ b/demos/quickstart/protected/pages/ActiveControls/Samples/TTimeTriggeredCallback/Home.php @@ -0,0 +1,22 @@ +time1->startTimer(); + } + + public function stopClicked($sender,$param) + { + $this->time1->stopTimer(); + } + + public function timerCallback($sender,$param) + { + $this->label1->Text="Current time is ".date('H:i:s'); + } + +} + +?> \ No newline at end of file diff --git a/demos/quickstart/protected/pages/ActiveControls/Samples/TValueTriggeredCallback/Home.page b/demos/quickstart/protected/pages/ActiveControls/Samples/TValueTriggeredCallback/Home.page new file mode 100644 index 00000000..50edf6ed --- /dev/null +++ b/demos/quickstart/protected/pages/ActiveControls/Samples/TValueTriggeredCallback/Home.page @@ -0,0 +1,17 @@ + + +

TValueTriggeredCallback Samples

+ + + + + +
+ A callback will be executed when the textbox text changes + + + + +
+ +
$Id$
 \ No newline at end of file diff --git a/demos/quickstart/protected/pages/ActiveControls/Samples/TValueTriggeredCallback/Home.php b/demos/quickstart/protected/pages/ActiveControls/Samples/TValueTriggeredCallback/Home.php new file mode 100644 index 00000000..7e2a8b20 --- /dev/null +++ b/demos/quickstart/protected/pages/ActiveControls/Samples/TValueTriggeredCallback/Home.php @@ -0,0 +1,11 @@ +label1->Text=date("[H:i:s]")." Textbox changed"; + } +} + +?> \ No newline at end of file diff --git a/demos/quickstart/protected/pages/ActiveControls/TimeTriggeredCallback.page b/demos/quickstart/protected/pages/ActiveControls/TimeTriggeredCallback.page new file mode 100644 index 00000000..d36ec2d9 --- /dev/null +++ b/demos/quickstart/protected/pages/ActiveControls/TimeTriggeredCallback.page @@ -0,0 +1,16 @@ + + +

TTimeTriggeredCallback

+ + +

+TTimeTriggeredCallback sends callback request every Interval seconds. +Upon each callback request, the OnCallback event is raised. +The timer can be started by calling startTimer() and stopped using +stopTimer(). The timer can be automatically started when +StartTimerOnLoad is true. +

+ + + +
$Id$
 \ No newline at end of file diff --git a/demos/quickstart/protected/pages/ActiveControls/ValueTriggeredCallback.page b/demos/quickstart/protected/pages/ActiveControls/ValueTriggeredCallback.page new file mode 100644 index 00000000..bdf8b459 --- /dev/null +++ b/demos/quickstart/protected/pages/ActiveControls/ValueTriggeredCallback.page @@ -0,0 +1,18 @@ + + +

TValueTriggeredCallback

+ + +

+TValueTriggeredCallback observes the value with PropertyName of a +control with ControlID. Changes to the observed +property value will trigger a new callback request. The property value is checked +for changes every Interval seconds. +A DecayRate can be set to increase the polling +interval linearly if no changes are observed. Once a change is +observed, the polling interval is reset to the original value. +

+ + + +
$Id$
 \ No newline at end of file -- cgit v1.2.3