From 3baba6fb4b6c17ff77eb4a13a812ccde9263dce2 Mon Sep 17 00:00:00 2001
From: "ctrlaltca@gmail.com" <>
Date: Wed, 1 Jun 2011 23:01:03 +0000
Subject: gave the build scripts a run so that new ids can be generated. Added
new docs to the quickstart.pdf misc doc fixes
---
demos/quickstart/protected/pages/Controls/Captcha.page | 18 +++++++++---------
.../protected/pages/Controls/ClientScriptLoader.page | 12 ++++++------
.../protected/pages/Controls/Conditional.page | 6 +++---
.../quickstart/protected/pages/Controls/Keyboard.page | 12 ++++++------
demos/quickstart/protected/pages/Controls/Slider.page | 12 ++++++------
.../quickstart/protected/pages/Controls/Standard.page | 3 +--
6 files changed, 31 insertions(+), 32 deletions(-)
(limited to 'demos/quickstart/protected/pages/Controls')
diff --git a/demos/quickstart/protected/pages/Controls/Captcha.page b/demos/quickstart/protected/pages/Controls/Captcha.page
index 8a6e8a81..6810d2a2 100644
--- a/demos/quickstart/protected/pages/Controls/Captcha.page
+++ b/demos/quickstart/protected/pages/Controls/Captcha.page
@@ -1,36 +1,36 @@
+
TCaptcha displays a CAPTCHA that can be used to determine if the input is entered by a real user instead of some program. TCaptcha displays a token (a string consisting of alphanumeric characters) as an image and the user is expected to repeat the token in a text box. The token image is generated in a way such that it can be recognized by a human being, but not a program.
+
To use TCaptcha, you must enable the PHP GD2 extension with TrueType font support. Unlike other CAPTCHA scripts, TCaptcha does not need session or cookie.
+
The token generated by TCaptcha can be configured in several ways. To specify the length of characters in the token, set MinTokenLength and MaxTokenLength. To use case-insensitive token comparison and generate upper-case-only token, set CaseSensitive to false. More advanced users can try to set TokenAlphabet to specify which characters may appear in the generated tokens.
+
The validation of the token is related with two properties: TestLimit (defaults to 5 times) and TokenExpiry (defaults to 600 seconds). The former specifies how many times a token can be tested with on the server side, and the latter says when a generated token will expire. If the validation fails in any of the two scenarios, a new token will be automatically generated.
+
To specify the appearance of the generated token image, set TokenImageTheme to be an integer between 0 and 63. You may try the following example to see how this value affects the generated token image. The size of the generated token image is determined by TokenFontSize. In particular, the image width is proportional to the font size. You may also set Width to scale the generated image to your desired size, but the scaled image may not look good. By setting ChangingTokenBackground to true, the image background of the token will be variating even though the token is the same during postbacks.
+
Upon postback, user input can be validated by calling the method TCaptcha.validate(). More easily, you can use a TCaptchaValidator to automate the validation work for you. The TCaptchaValidator has the additional benefit of being able to validate the user input on the client-side. By default, a generated token will remain unchanged during postbacks. A new token can be generated by calling TCaptcha.regenerateToken() manually.
+
The following template shows a typical use of the TCaptcha control:
TCaptcha
+TCaptcha
TClientScriptLoader
+TClientScriptLoader
Allowable scripts and script dependencies can be grouped by using a "packages.php" file with the following format. This "packages.php" is optional, if absent the file names @@ -81,7 +81,7 @@ on both 'package1' and 'package2' groupings. That is, 'pac will combine, in order, 'file1.js', 'file2.js', 'file3.js', and 'file4.js'.
-To load a particular javascript file or package, set the PackageScripts property with value 'package1' to load the 'package1' scripts. @@ -96,10 +96,10 @@ Dependencies of the packages are automatically resolved by the script loader php </script> -
Each <com:TClientScriptLoader> generates an HTML <script> +
Each <com:TClientScriptLoader> generates an HTML <script> element to load the required javascript files.
-The DebugMode property when false removes comments and white spaces from the published javascript files. If the DebugMode property is not set, the debug mode is determined from the @@ -113,7 +113,7 @@ directory for the next requests. That is, in non-debug mode the scripts are cach in the assets directory until they are deleted. -
The EnableGzip property (default is true) enables the
published javascripts to be served as zipped if the browser and php server allows it.
diff --git a/demos/quickstart/protected/pages/Controls/Conditional.page b/demos/quickstart/protected/pages/Controls/Conditional.page
index e8ea4a65..a2662e86 100644
--- a/demos/quickstart/protected/pages/Controls/Conditional.page
+++ b/demos/quickstart/protected/pages/Controls/Conditional.page
@@ -1,6 +1,6 @@
@@ -17,13 +17,13 @@ you set Condition in template only and the expression should not refer
objects that are available on or after the onInit lifecycle.
+
TConditional is very light. It instantiates either TrueTemplate
FalseTemplate, but never both. And the condition is evaluated only once.
A typical usage of TConditional is shown as following:
+
TKeyboard displays a virtual keyboard that users can click on to enter input in
an associated text box. It helps to reduce the keyboard recording hacking.
+
To use TKeyboard, write a template like following:
+
A TKeyboard control is associated with a TTextBox control by specifying
ForControl to be the ID of that control. When the textbox is in focus,
a virtual keyboard will pop up; and when the text box is losing focus, the keyboard
will hide automatically. Set AutoHide to false to keep the keyboard showing all the time.
+
The appearance of the keyboard can also be changed by specifying a customized CSS file via
CssUrl. By default, the CSS class name for the keyboard is 'Keyboard'. This may
also be changed by specifying KeyboardCssClass
diff --git a/demos/quickstart/protected/pages/Controls/Slider.page b/demos/quickstart/protected/pages/Controls/Slider.page
index d71c28a0..324f12ad 100644
--- a/demos/quickstart/protected/pages/Controls/Slider.page
+++ b/demos/quickstart/protected/pages/Controls/Slider.page
@@ -9,7 +9,7 @@ which define the range of possible value, and a handle which can slide
a value in the range. The track can be either Horizontal or Vertical, depending of the Direction
property. By default, it's horizontal.
+
The range boundaries are defined by MinValue and MaxValue properties.
The default range is from 0 to 100.
The StepSize property can be used to define the step between 2 values inside the range.
@@ -17,13 +17,13 @@ Notice that this step will be recomputed if there is more than 200 values betwee
You can also provide the allowed values by setting the Values array.
+
The handle sub-properties can be accessed by Handle property. You can also provide your own control
for the handle, using HandleClass property. Note that this class must be a subclass of
TSliderHandle
+
The TSlider control can be easily customized using CssClasses. You can provide your own css file, using the
CssUrl property.
The css class for TSlider can be set by the CssClass property. Defaults values are 'hslider' for
@@ -33,15 +33,15 @@ draw a red block as a cursor. 'handle-image' css class is also provided f
as the handle.
+
If AutoPostBack property is true, postback is performed as soon as the value changed.
+
TSlider raises the onValueChanged event when the value of the slider has changed during postback.
+
You can also attach ClientSide javascript events handler to the slider :
* the tutorial for this control is not completed yet.TConditional
+TConditional
TKeyboard
+TKeyboard
Standard Controls
-Standard Controls