summaryrefslogtreecommitdiff
path: root/demos/quickstart
diff options
context:
space:
mode:
authorwei <>2006-09-09 03:08:55 +0000
committerwei <>2006-09-09 03:08:55 +0000
commite6105cdbe66420c4f30639ee1d652ce740054849 (patch)
treee046806b91241a1e6b18ae721f8358f0273e5924 /demos/quickstart
parent90b3f22cba8ad85ef2eb38c158fa2da46d798cf8 (diff)
Add basic active control docs.
Diffstat (limited to 'demos/quickstart')
-rw-r--r--demos/quickstart/protected/controls/TopicList.tpl2
-rw-r--r--demos/quickstart/protected/pages/ActiveControls/Home.page338
-rw-r--r--demos/quickstart/protected/pages/ActiveControls/TActiveButtonClass.pngbin0 -> 33847 bytes
-rw-r--r--demos/quickstart/protected/pages/ActiveControls/TActiveButtonClass.vsdbin0 -> 153088 bytes
-rw-r--r--demos/quickstart/protected/pages/ActiveControls/postback-callback.pngbin0 -> 23493 bytes
-rw-r--r--demos/quickstart/protected/pages/ActiveControls/postback-callback.vsdbin0 -> 59904 bytes
6 files changed, 339 insertions, 1 deletions
diff --git a/demos/quickstart/protected/controls/TopicList.tpl b/demos/quickstart/protected/controls/TopicList.tpl
index 1302338d..6a335442 100644
--- a/demos/quickstart/protected/controls/TopicList.tpl
+++ b/demos/quickstart/protected/controls/TopicList.tpl
@@ -44,7 +44,7 @@
<li><a href="?page=Controls.Validation">Validation Controls</a></li>
<li><a href="?page=Controls.List">List Controls</a></li>
<li><a href="?page=Controls.Data">Data Controls</a></li>
- <li><a href="?page=Construction">Active Controls</a></li>
+ <li><a href="?page=ActiveControls.Home">Active Controls (AJAX)</a></li>
<li><a href="?page=Controls.NewControl">Writing New Controls</a></li>
</ul>
</div>
diff --git a/demos/quickstart/protected/pages/ActiveControls/Home.page b/demos/quickstart/protected/pages/ActiveControls/Home.page
new file mode 100644
index 00000000..e3f13640
--- /dev/null
+++ b/demos/quickstart/protected/pages/ActiveControls/Home.page
@@ -0,0 +1,338 @@
+<com:TContent ID="body" >
+<h1>ActiveControls (AJAX)</h1>
+<p>Active Controls allows the browser to communicate with server
+without refreshing the current page.
+
+<h2>Standard Active Controls</h2>
+<ul>
+ <li>
+ <a href="?page=ActiveControls.ActiveButton">TActiveButton</a>
+ represents a click button on a Web page. It can be used to trigger a callback request.
+ </li>
+
+ <li>
+ <a href="?page=ActiveControls.ActiveCheckBox">TActiveCheckBox</a>
+ represents a checkbox on a Web page. It can be used to collect two-state user input
+ and can trigger a callback request.
+ </li>
+
+ <li>
+ <a href="?page=ActiveControls.ActiveCustomValidator">TActiveCustomValidator</a>
+ validates a particular control using a callback request.
+ </li>
+
+ <li>
+ <a href="?page=ActiveControls.ActiveHyperLink">TActiveHyperLink</a>
+ represents a hyperlink on a Web page.
+ </li>
+
+ <li>
+ <a href="?page=ActiveControls.ActiveImage">TActiveImage</a>
+ represents an image on a Web page.
+ </li>
+
+ <li>
+ <a href="?page=ActiveControls.ActiveImageButton">TActiveImageButton</a>
+ represents a click button that has an image as the background.
+ It is can be used to trigger a callback request.
+ </li>
+
+ <li>
+ <a href="?page=ActiveControls.ActiveLabel">TActiveLabel</a>
+ represents a label on a Web page.
+ The label can be customized via various CSS attributes.
+ </li>
+
+ <li>
+ <a href="?page=ActiveControls.ActiveLinkButton">TActiveLinkButton</a>
+ represents a hyperlink that can perform a callback request.
+ </li>
+
+ <li>
+ <a href="?page=ActiveControls.ActivePanel">TActivePanel</a>
+ represents a container for other controls on a Web page. In HTML,
+ it is displayed as a &lt;div&gt; element. The panel's contents
+ can be replaced during a callback request.
+ </li>
+
+ <li>
+ <a href="?page=ActiveControls.ActiveRadioButton">TActiveRadioButton</a>
+ represents a radiobutton on a Web page.
+ It is mainly used in a group from which users make a choice. It can
+ be used to perform a callback request.
+ </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.
+ It can be used to perform a callback request.
+ </li>
+
+ <li>
+ <a href="?page=ActiveControls.CallbackOptions">TCallbackOptions</a>
+ callback options such as <tt>OnLoading</tt/> client-side event handlers.
+ </li>
+
+</ul>
+
+<h2>Active List Controls</h2>
+<ul>
+ <li>
+ <a href="?page=ActiveControls.ActiveCheckBoxList">TActiveCheckBoxList</a>
+ displays a list of checkboxes on a Web page and each checkbox
+ can trigger a callback request.
+ </li>
+
+ <li>
+ <a href="?page=ActiveControls.ActiveDropDownList">TActiveDropDownList</a>
+ displays a dropdown list box that allows users to select a
+ single option from a few prespecified ones. It can be used
+ to perform a callback request.
+ </li>
+
+ <li>
+ <a href="?page=ActiveControls.ActiveListBox">TActiveListBox</a>
+ displays a list box that allows single or multiple selection. It can be used
+ to perform a callback request.
+ </li>
+
+ <li>
+ <a href="?page=ActiveControls.ActiveRadioButtonList">TActiveRadioButtonList</a>
+ is similar to TActiveCheckBoxList in every aspect except that each
+ TActiveRadioButtonList displays a group of radiobuttons. Each radio button
+ can perform a callback request.
+ </li>
+</ul>
+
+<h2>Extended Active Controls</h2>
+
+
+<ul>
+ <li>
+ <a href="?page=ActiveControls.AutoComplete">TAutoComplete</a>
+ extends TActiveTextBox to offer text completion suggestions.
+ </li>
+
+ <li>
+ <a href="?page=ActiveControls.Callback">TCallback</a>
+ a generic control that can perform callback requests.
+ </li>
+
+ <li>
+ <a href="?page=ActiveControls.EventTriggeredCallback">TEventTriggeredCallback</a>
+ triggers a callback request based on HTML DOM events.
+ </li>
+
+ <li>
+ <a href="?page=ActiveControls.InPlaceTextBox">TInPlaceTextBox</a>
+ represents a label that can be edited by clicked.
+ </li>
+
+ <li>
+ <a href="?page=ActiveControls.TimeTriggeredCallback">TTimeTriggeredCallback</a>
+ triggers a callback request based on time elapsed.
+ </li>
+
+ <li>
+ <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>
+
+</ul>
+
+<h2>Active Control Abilities</h2>
+
+<!-- tabular: align=|l|l|l|, width=(0.55 0.15 0.15 0.15) -->
+<table class="tabular">
+ <tr>
+ <th>Control Name</th>
+ <th>Can Update</th>
+ <th>Triggers Callback</th>
+ <th>Can Degrade</th>
+ </tr>
+ <tr><td>
+ <a href="?page=ActiveControls.ActiveButton">TActiveButton</a>
+ </td>
+ <td>Yes</td><td>Yes</td><td>Yes</td>
+ </tr>
+
+ <tr><td>
+ <a href="?page=ActiveControls.ActiveCheckBox">TActiveCheckBox</a>
+ </td>
+ <td>Yes</td><td>Yes</td><td>Yes</td>
+ </tr>
+
+ <tr><td>
+ <a href="?page=ActiveControls.ActiveCustomValidator">TActiveCustomValidator</a>
+ </td>
+ <td>No</td><td>Yes</td><td>No</td>
+ </tr>
+
+ <tr><td>
+ <a href="?page=ActiveControls.ActiveHyperLink">TActiveHyperLink</a>
+ </td>
+ <td>Yes</td><td>No</td><td>Yes</td>
+ </tr>
+
+ <tr><td>
+ <a href="?page=ActiveControls.ActiveImage">TActiveImage</a>
+ </td>
+ <td>Yes</td><td>No</td><td>Yes</td>
+ </tr>
+
+ <tr><td>
+ <a href="?page=ActiveControls.ActiveImageButton">TActiveImageButton</a>
+ </td>
+ <td>Yes</td><td>Yes</td><td>Yes</td>
+ </tr>
+
+ <tr><td>
+ <a href="?page=ActiveControls.ActiveLabel">TActiveLabel</a>
+ </td>
+ <td>Yes</td><td>No</td><td>Yes</td>
+ </tr>
+
+ <tr><td>
+ <a href="?page=ActiveControls.ActiveLinkButton">TActiveLinkButton</a>
+ </td>
+ <td>Yes</td><td>Yes</td><td>No</td>
+ </tr>
+
+ <tr><td>
+ <a href="?page=ActiveControls.ActivePanel">TActivePanel</a>
+ </td>
+ <td>Yes</td><td>No</td><td>Yes</td>
+ </tr>
+
+ <tr><td>
+ <a href="?page=ActiveControls.ActiveRadioButton">TActiveRadioButton</a>
+ </td>
+ <td>Yes</td><td>Yes</td><td>Yes</td>
+ </tr>
+
+ <tr><td>
+ <a href="?page=ActiveControls.ActiveTextBox">TActiveTextBox</a>
+ </td>
+ <td>Yes</td><td>Yes</td><td>Yes</td>
+ </tr>
+
+ <tr><td>
+ <a href="?page=ActiveControls.CallbackOptions">TCallbackOptions</a>
+ </td>
+ <td>No</td><td>No</td><td>N/A</td>
+ </tr>
+
+
+ <tr><td>
+ <a href="?page=ActiveControls.ActiveCheckBoxList">TActiveCheckBoxList</a>
+ </td>
+ <td>Yes</td><td>Yes</td><td>Yes</td>
+ </tr>
+
+ <tr><td>
+ <a href="?page=ActiveControls.ActiveDropDownList">TActiveDropDownList</a>
+ </td>
+ <td>Yes</td><td>Yes</td><td>Yes</td>
+ </tr>
+
+ <tr><td>
+ <a href="?page=ActiveControls.ActiveListBox">TActiveListBox</a>
+ </td>
+ <td>Yes</td><td>Yes</td><td>Yes</td>
+ </tr>
+
+ <tr><td>
+ <a href="?page=ActiveControls.ActiveRadioButtonList">TActiveRadioButtonList</a>
+ </td>
+ <td>Yes</td><td>Yes</td><td>Yes</td>
+ </tr>
+
+ <tr><td>
+ <a href="?page=ActiveControls.AutoComplete">TAutoComplete</a>
+ </td>
+ <td>Yes</td><td>Yes</td><td>Yes</td>
+ </tr>
+
+ <tr><td>
+ <a href="?page=ActiveControls.Callback">TCallback</a>
+ </td>
+ <td>No</td><td>Yes</td><td>No</td>
+ </tr>
+
+ <tr><td>
+ <a href="?page=ActiveControls.EventTriggeredCallback">TEventTriggeredCallback</a>
+ </td>
+ <td>No</td><td>Yes</td><td>No</td>
+ </tr>
+
+ <tr><td>
+ <a href="?page=ActiveControls.InPlaceTextBox">TInPlaceTextBox</a>
+ </td>
+ <td>Yes</td><td>Yes</td><td>No</td>
+ </tr>
+
+ <tr><td>
+ <a href="?page=ActiveControls.TimeTriggeredCallback">TTimeTriggeredCallback</a>
+ </td>
+ <td>No</td><td>Yes</td><td>No</td>
+ </tr>
+
+ <tr><td>
+ <a href="?page=ActiveControls.ValueTriggeredCallback">TValueTriggeredCallback</a>
+ </td>
+ <td>No</td><td>Yes</td><td>No</td>
+ </tr>
+</table>
+
+<h2>Active Control Infrastructure Classes</h2>
+<p>The following classes provide the basic infrastructure classes required to
+realize the active controls.</p>
+<ul>
+ <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.
+ </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.
+ </li>
+
+ <li>
+ <a href="?page=ActiveControls.ActivePageAdapter">TActivePageAdapter</a>
+ process the page life-cycle for callback requests.
+ </li>
+
+ <li>
+ <a href="?page=ActiveControls.BaseActiveControl">TBaseActiveControl</a>
+ common active control methods and options.
+ </li>
+
+ <li>
+ <a href="?page=ActiveControls.CallbackClientScript">TCallbackClientScript</a>
+ methods to manipulate the client-side HTML elements, also includes methods
+ to invoke javascript Effects on HTML elements.
+ </li>
+
+ <li>
+ <a href="?page=ActiveControls.CallbackClientSide">TCallbackClientSide</a>
+ common client-side callback request options, and client-side event handlers.
+ </li>
+
+ <li>
+ <a href="?page=ActiveControls.CallbackResponseAdapter">TCallbackResponseAdapter</a>
+ HTTP response for callback requests.
+ </li>
+
+</ul>
+<p>
+<img src="<%~ postback-callback.png %>" class="figure" />
+</p>
+<p>
+<img src="<%~ TActiveButtonClass.png %>" class="figure"/>
+</p>
+</com:TContent> \ No newline at end of file
diff --git a/demos/quickstart/protected/pages/ActiveControls/TActiveButtonClass.png b/demos/quickstart/protected/pages/ActiveControls/TActiveButtonClass.png
new file mode 100644
index 00000000..632d9a45
--- /dev/null
+++ b/demos/quickstart/protected/pages/ActiveControls/TActiveButtonClass.png
Binary files differ
diff --git a/demos/quickstart/protected/pages/ActiveControls/TActiveButtonClass.vsd b/demos/quickstart/protected/pages/ActiveControls/TActiveButtonClass.vsd
new file mode 100644
index 00000000..b9127223
--- /dev/null
+++ b/demos/quickstart/protected/pages/ActiveControls/TActiveButtonClass.vsd
Binary files differ
diff --git a/demos/quickstart/protected/pages/ActiveControls/postback-callback.png b/demos/quickstart/protected/pages/ActiveControls/postback-callback.png
new file mode 100644
index 00000000..031dcde3
--- /dev/null
+++ b/demos/quickstart/protected/pages/ActiveControls/postback-callback.png
Binary files differ
diff --git a/demos/quickstart/protected/pages/ActiveControls/postback-callback.vsd b/demos/quickstart/protected/pages/ActiveControls/postback-callback.vsd
new file mode 100644
index 00000000..7e054833
--- /dev/null
+++ b/demos/quickstart/protected/pages/ActiveControls/postback-callback.vsd
Binary files differ