further documentation updates: everything else plus some things that were not even listed. Only T*RatingList has been left out

12 files changed, 251 insertions, 6 deletions

diff --git a/demos/quickstart/protected/pages/ActiveControls/ActiveDatePicker.page b/demos/quickstart/protected/pages/ActiveControls/ActiveDatePicker.page
new file mode 100644
index 00000000..774a84b3
--- /dev/null
+++ b/demos/quickstart/protected/pages/ActiveControls/ActiveDatePicker.page
@@ -0,0 +1,16 @@
+<com:TContent ID="body" >

+

+<h1>TActiveDatePicker</h1>

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

+

+<p class="block-content">

+<tt>TActiveDatePicker</tt> is the active control counter part to <tt>TDatePicker</tt> control.

+When the date selection is changed, the <tt>OnCallback</tt> event is raised.

+</p>

+<p class="block-content">

+Please refer to the documentation of <tt>TDatePicker</tt> for further usage informations.

+</p>

+

+<com:RunBar PagePath="ActiveControls.Samples.TActiveDatePicker.Home" />

+

+<div class="last-modified">$Id$</div></com:TContent>
\ No newline at end of file
diff --git a/demos/quickstart/protected/pages/ActiveControls/ActiveFileUpload.page b/demos/quickstart/protected/pages/ActiveControls/ActiveFileUpload.page
new file mode 100644
index 00000000..8bdb7cfe
--- /dev/null
+++ b/demos/quickstart/protected/pages/ActiveControls/ActiveFileUpload.page
@@ -0,0 +1,33 @@
+<com:TContent ID="body" >

+

+<h1>TActiveFileUpload</h1>

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

+

+<p class="block-content">

+<tt>TActiveFileUpload</tt> 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 <tt>HasFile</tt>

+indicates whether the file upload is successful. If successful, the file

+may be obtained by calling<tt>saveAs</tt> to save it at a specified place.

+You can use <tt>FileName</tt>, <tt>FileType</tt>,

+<tt>FileSize</tt> to get the original client-side file name,

+the file mime type, and the file size information. If the upload is not

+successful, <tt>ErrorCode</tt> contains the error code

+describing the cause of failure.

+</p>

+

+<p class="block-content">

+TActiveFileUpload raises <tt>OnFileUpload</tt> event if a file is uploaded

+(whether it succeeds or not).

+</p>

+

+<p class="block-content">

+TActiveFileUpload actually does a postback in a hidden IFrame, and then does a callback.

+This callback then raises the <tt>OnFileUpload</tt> 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.

+</p>

+

+<com:RunBar PagePath="ActiveControls.Samples.TActiveFileUpload.Home" />

+

+<div class="last-modified">$Id$</div></com:TContent>
\ 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..00077b59
--- /dev/null
+++ b/demos/quickstart/protected/pages/ActiveControls/ActiveHiddenField.page
@@ -0,0 +1,12 @@
+<com:TContent ID="body" >

+

+<h1>TActiveHiddenField</h1>

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

+

+<p class="block-content">

+<tt>TActiveHiddenField</tt> is the active control counterpart of <tt>THiddenField</tt> 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 <tt>Value</tt> property.

+</p>

+

+<div class="last-modified">$Id$</div></com:TContent>
\ No newline at end of file
diff --git a/demos/quickstart/protected/pages/ActiveControls/CallbackEventParameter.page b/demos/quickstart/protected/pages/ActiveControls/CallbackEventParameter.page
new file mode 100644
index 00000000..e99a2d40
--- /dev/null
+++ b/demos/quickstart/protected/pages/ActiveControls/CallbackEventParameter.page
@@ -0,0 +1,26 @@
+<com:TContent ID="body" >

+

+<h1>TCallbackEventParameter</h1>

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

+

+<p class="block-content">

+<tt>TCallbackEventParameter</tt> provides the parameter passed during the callback

+request in the <tt>CallbackParameter</tt> property. The

+callback response content (e.g. new HTML content) must be rendered

+using an THtmlWriter obtained from the <tt>NewWriter</tt>

+property, which returns a <b>NEW</b> instance of TCallbackResponseWriter.

+</p>

+

+<p class="block-content">

+Each instance <tt>TCallbackResponseWriter</tt> 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.

+</p>

+

+<p class="block-content">

+The response data (i.e., passing results back to the client-side

+callback handler function) can be set using <tt>ResponseData</tt> property.

+</p>

+

+<div class="last-modified">$Id$</div></com:TContent>
\ 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 bb74c4bf..1a216db6 100644
--- a/demos/quickstart/protected/pages/ActiveControls/Home.page
+++ b/demos/quickstart/protected/pages/ActiveControls/Home.page
@@ -17,8 +17,6 @@ of <a href="?page=ActiveControl.ClientSideJavascript">javascript classes</a>.
 TActiveButton</a> control. See also the later part of the <a href="?page=Tutorial.CurrencyConverter">Currency Converter</a> tutorial for a more in depth example.

 </p>

 

-<p id="640425" class="block-content">* the tutorial for this control is not completed yet.</p>

-

 <h2 id="128032">Standard Active Controls</h2>

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

   <li>

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

 

   <li>

+  <a href="?page=ActiveControls.ActiveDatePicker">TActiveDatePicker</a>

+  adds a date picker that permits the suer to choose a date.

+  </li>

+

+  <li>

+  <a href="?page=ActiveControls.ActiveFileUpload">TActiveFileUpload</a>

+  displays a file upload field on a page and uses an iframe to permit handling of the

+  file upload in a callback.

+  </li>

+

+  <li>

+  <a href="?page=ActiveControls.ActiveHiddenField">TActiveHiddenField</a>

+  displays a hidden input field that can be changed upon callback.

+  </li>

+

+  <li>

   <a href="?page=ActiveControls.ActiveHyperLink">TActiveHyperLink</a>

   represents a hyperlink on a Web page.

   </li>

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

 

   <li>

+  <a href="">TActiveRatingList</a>

+  is an EXPERIMENTAL class that displays clickable images that represent a TRadioButtonList.

+  </li>

+

+  <li>

   <a href="?page=ActiveControls.ActiveTextBox">TActiveTextBox</a>

   represents a text input field on a Web page.

   It can collect single-line, multi-line or password text input from users.

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

 

 	<li>

-	* <a href="?page=ActiveControls.InPlaceTextBox">TInPlaceTextBox</a>

+	<a href="?page=ActiveControls.InPlaceTextBox">TInPlaceTextBox</a>

 	represents a label that can be edited by clicked.

 	</li>

 

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

 	

 	<li>

-	<a href="?page=ActiveControls.DragDrop">TDropContainer & TDraggable</a> 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.

+	<a href="?page=ActiveControls.DragDrop">TDropContainer &amp; TDraggable</a> 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.

 	</li>

 

 </ul>

@@ -433,6 +452,11 @@ A Prado user can use them to customize active controls behaviour and interact di
 	</li>

 

 	<li>

+	<a href="?page=ActiveControls.CallbackEventParameter">TCallbackEventParameter</a>

+	provides the parameter passed during the callback request.

+	</li>

+

+	<li>

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

diff --git a/demos/quickstart/protected/pages/ActiveControls/InPlaceTextBox.page b/demos/quickstart/protected/pages/ActiveControls/InPlaceTextBox.page
new file mode 100644
index 00000000..2349d255
--- /dev/null
+++ b/demos/quickstart/protected/pages/ActiveControls/InPlaceTextBox.page
@@ -0,0 +1,42 @@
+<com:TContent ID="body" >

+

+<h1>TInPlaceTextBox</h1>

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

+

+<p class="block-content">

+<tt>TInPlaceTextBox</tt> 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 <tt>EditTriggerControlID</tt> is clicked.

+</p>

+

+<p class="block-content">

+If the <tt>OnLoadingText</tt> 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 <tt>OnLoadingText</tt> 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.

+</p>

+

+<p class="block-content">

+Once the textbox loses focus, if <tt>AutoPostBack</tt>

+is true and the textbox content has changed, a callback request is made and

+the <tt>OnTextChanged</tt> event is raised like that of the TActiveTextBox.

+During the request, the textbox is disabled.

+</p>

+

+<p class="block-content">

+After the callback request returns sucessfully, the textbox is enabled.

+If the <tt>AutoHideTextBox</tt> property is true, then

+the textbox will be hidden and the label is then shown.

+</p>

+

+<p class="block-content">

+Since 3.1.2, you can set the <tt>ReadOnly</tt> property to make

+the control not editable. This property can be also changed on callback

+</p>

+

+<com:RunBar PagePath="ActiveControls.Samples.TInPlaceTextBox.Home" />

+

+<div class="last-modified">$Id$</div></com:TContent>
\ 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 @@
+<com:TContent ID="body">

+

+<h1>TActiveDatePicker Samples</h1>

+

+<table class="sampletable">

+

+<tr>

+	<td class="samplenote">Default TActiveDatePicker triggering a callback to a label</td>

+	<td class="sampleaction">

+		<com:TActiveDatePicker ID="date1" OnCallback="dateChanged"/>

+		<com:TActiveLabel ID="label1" />

+	</td>

+</tr>

+	

+</table>

+

+<div class="last-modified">$Id$</div></com:TContent>
\ 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 @@
+<?php
+
+class Home extends TPage
+{
+	public function dateChanged($sender, $param)
+	{
+		$this->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 @@
+<com:TContent ID="body">

+

+<h1>TActiveFileUpload Sample</h1>

+

+<p>

+Please choose a file to upload:

+</p>

+

+<com:TActiveFileUpload OnFileUpload="fileUploaded" />

+

+<br/>

+

+<com:TActiveLabel ID="Result" />

+

+<div class="last-modified">$Id$</div></com:TContent>
\ 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 @@
+<?php

+

+class Home extends TPage

+{

+	public function fileUploaded($sender,$param)

+	{

+		if($sender->HasFile)

+		{

+			$this->Result->Text="

+				You just uploaded a file:

+				<br/>

+				Name: {$sender->FileName}

+				<br/>

+				Size: {$sender->FileSize}

+				<br/>

+				Type: {$sender->FileType}";

+		}

+	}

+}

+

+?>
\ 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 @@
+<com:TContent ID="body">

+

+<h1>TInPlaceTextBox Samples</h1>

+

+<table class="sampletable">

+

+<tr><td class="samplenote">

+An in-place textbox text updating a label when its text changes:

+</td><td class="sampleaction">

+<com:TInPlaceTextBox ID="txt1" Text="This is an in-place textbox" OnTextChanged="textChanged" />

+<br/><com:TActiveLabel Text="This is a label" ID="label1"

+/>

+</td></tr>

+

+</table>

+

+<div class="last-modified">$Id$</div></com:TContent>
\ 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 @@
+<?php
+
+class Home extends TPage
+{
+	public function textChanged($sender,$param)
+	{
+		$this->label1->Text=$this->txt1->Text;
+	}
+}
+
+?>
\ No newline at end of file