documentation updates: TCallback, TEventTriggeredCallback, TValueTriggeredCallback, TTimeTriggeredCallback

1 files changed, 56 insertions, 22 deletions

diff --git a/demos/quickstart/protected/pages/ActiveControls/Home.page b/demos/quickstart/protected/pages/ActiveControls/Home.page
index 7834cc1d..bb74c4bf 100644
--- a/demos/quickstart/protected/pages/ActiveControls/Home.page
+++ b/demos/quickstart/protected/pages/ActiveControls/Home.page
@@ -159,12 +159,12 @@ TActiveButton</a> control. See also the later part of the <a href="?page=Tutoria
 	</li>

 

 	<li>

-	* <a href="?page=ActiveControls.Callback">TCallback</a>

+	<a href="?page=ActiveControls.Callback">TCallback</a>

 	a generic control that can perform callback requests.

 	</li>

 

 	<li>

-	* <a href="?page=ActiveControls.EventTriggeredCallback">TEventTriggeredCallback</a>

+	<a href="?page=ActiveControls.EventTriggeredCallback">TEventTriggeredCallback</a>

 	triggers a callback request based on HTML DOM events.

 	</li>

 

@@ -174,12 +174,12 @@ TActiveButton</a> control. See also the later part of the <a href="?page=Tutoria
 	</li>

 

 	<li>

-	* <a href="?page=ActiveControls.TimeTriggeredCallback">TTimeTriggeredCallback</a>

+	<a href="?page=ActiveControls.TimeTriggeredCallback">TTimeTriggeredCallback</a>

 	triggers a callback request based on time elapsed.

 	</li>

 

 	<li>

-	* <a href="?page=ActiveControls.ValueTriggeredCallback">TValueTriggeredCallback</a>

+	<a href="?page=ActiveControls.ValueTriggeredCallback">TValueTriggeredCallback</a>

 	monitors (using a timer) an attribute of an HTML element and triggers a callback request

 	when the attribute value changes.

 	</li>

@@ -355,32 +355,72 @@ if Javascript was disabled on the client's browser.</p>
   

 </table>

 

-<h2 id="128036">Active Control Infrastructure Classes</h2>

+<h2 id="128036">Active Control Basic Infrastructure Classes</h2>

 <p id="640427" class="block-content">The following classes provide the basic infrastructure classes required to

-realize the active controls.</p>

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

+to use them.</p>

 <ul id="u4" class="block-content">

 	<li>

-	* <a href="?page=ActiveControls.ActiveControlAdapter">TActiveControlAdapter</a>

-	tracks the viewstate values of the control and update differences of the client-side HTML

-	element attributes.

+	<h3>TActiveControlAdapter</h3>

+	<com:DocLink ClassPath="System.Web.UI.ActiveControls.TActiveControlAdapter" />

+	<p class="block-content">

+		<tt>TActiveControlAdapter</tt> 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.

+	</p>

+	</li>

+

+	<li>

+	<h3>TActiveListControlAdapter</h3>

+	<com:DocLink ClassPath="System.Web.UI.ActiveControls.TActiveListControlAdapter" />

+	<p class="block-content">

+		<tt>TActiveListControlAdapter</tt> allows the adapted list controls to change the selections

+		on the client-side during a callback request.

+	</p>

 	</li>

 

 	<li>

-	* <a href="?page=ActiveControls.ActiveListControlAdapter">TActiveListControlAdapter</a>

-	allows the adapted list controls to change the selections on the client-side during

-	a callback request.

+	<h3>TActivePageAdapter</h3>

+	<com:DocLink ClassPath="System.Web.UI.ActiveControls.TActivePageAdapter" />

+	<p class="block-content">

+		<tt>TActivePageAdapter</tt> process the page life-cycle for callback requests.

+	</p>

 	</li>

 

 	<li>

-	* <a href="?page=ActiveControls.ActivePageAdapter">TActivePageAdapter</a>

-	process the page life-cycle for callback requests.

+	<h3>TBaseActiveControl</h3>

+	<com:DocLink ClassPath="System.Web.UI.ActiveControls.TBaseActiveControl" />

+	<p class="block-content">

+		<tt>TBaseActiveControl</tt> class provided additional basic properties common for every

+		active control. An instance of <tt>TBaseActiveControl</tt> or its decendent

+		<tt>TBaseActiveCallbackControl</tt> is created by <tt>TActiveControlAdapter::getBaseActiveControl()</tt>

+		method.

+		The <tt>EnableUpdate</tt> property determines wether the active

+		control is allowed to update the contents of the client-side when the callback

+		response returns.

+	</p>

 	</li>

 

 	<li>

-	* <a href="?page=ActiveControls.BaseActiveControl">TBaseActiveControl</a>

-	common active control methods and options.

+	<h3>TCallbackResponseAdapter</h3>

+	<com:DocLink ClassPath="System.Web.UI.ActiveControls.TCallbackResponseAdapter" />

+	<p class="block-content">

+		<tt>TCallbackResponseAdapter</tt> alters the <tt>THttpResponse</tt>'s outputs.

+		A <tt>TCallbackResponseWriter</tt> is used instead of the <tt>TTextWrite</tt> when

+		<tt>createHtmlWriter</tt> is called. Each call to createHtmlWriter will create

+		a new <tt>TCallbackResponseWriter</tt>. When <tt>flushContent()</tt> is called each

+		instance of <tt>TCallbackResponseWriter</tt>'s content is flushed.

+		The callback response data can be set using the <tt>ResponseData</tt> property.

+	</p>

 	</li>

 

+</ul>

+

+<h2>Active Control Infrastructure Advanced Classes</h2>

+<p class="block-content">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.

+</p>

+<ul class="block-content">

 	<li>

 	<a href="?page=ActiveControls.CallbackClientScript">TCallbackClientScript</a>

 	methods to manipulate the client-side HTML elements, also includes methods

@@ -396,12 +436,6 @@ realize the active controls.</p>
 	<a href="?page=ActiveControls.CallbackOptions">TCallbackOptions</a>

 	allows a common set of callback client-side options to be attached to one or more active controls.

 	</li>

-

-	<li>

-	* <a href="?page=ActiveControls.CallbackResponseAdapter">TCallbackResponseAdapter</a>

-	HTTP response for callback requests.

-	</li>

-

 </ul>

 

 <div class="last-modified">$Id$</div></com:TContent>