From 0daa38a4f5bb43d7332d681a98ccb693bc579230 Mon Sep 17 00:00:00 2001 From: "ctrlaltca@gmail.com" <> Date: Thu, 2 Jun 2011 19:27:21 +0000 Subject: further documentation updates: everything else plus some things that were not even listed. Only T*RatingList has been left out --- demos/quickstart/protected/pages/Controls/List.page | 12 ++++++++++++ .../quickstart/protected/pages/Controls/Validation.page | 16 ++++++++++++++++ 2 files changed, 28 insertions(+) (limited to 'demos/quickstart/protected/pages/Controls') diff --git a/demos/quickstart/protected/pages/Controls/List.page b/demos/quickstart/protected/pages/Controls/List.page index c7505181..c68a477f 100644 --- a/demos/quickstart/protected/pages/Controls/List.page +++ b/demos/quickstart/protected/pages/Controls/List.page @@ -49,12 +49,14 @@ $listbox->dataBind();

TListBox

+

TListBox displays a list box that allows single or multiple selection. Set the property SelectionMode as Single to make a single selection list box, and Multiple a multiple selection list box. The number of rows displayed in the box is specified via the Rows property value.

TDropDownList

+

TDropDownList displays a dropdown list box that allows users to select a single option from a few prespecified ones.

@@ -64,6 +66,7 @@ Since v3.1.1, TDropDownList starts to support prompt text (something li

TCheckBoxList

+

TCheckBoxList displays a list of checkboxes on a Web page. The alignment of the text besides each checkbox can be specified TextAlign. The layout of the checkboxes can be controlled by the following properties:

@@ -76,12 +79,14 @@ Since v3.1.1, TDropDownList starts to support prompt text (something li

TRadioButtonList

+

TRadioButtonList is similar to TCheckBoxList in every aspect except that each TRadioButtonList displays a group of radiobuttons. Only one of the radiobuttions can be selected (TCheckBoxList allows multiple selections.)

TBulletedList

+

TBulletedList displays items in a bullet format on a Web page. The style of the bullets can be specified by BulletStyle. When the style is CustomImage, the bullets are displayed as images, which is specified by BulletImageUrl.

@@ -96,4 +101,11 @@ Since v3.1.1, TDropDownList starts to support prompt text (something li +

TRatingList

+ + +

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

+
$Id$
\ No newline at end of file diff --git a/demos/quickstart/protected/pages/Controls/Validation.page b/demos/quickstart/protected/pages/Controls/Validation.page index 74db7b07..cabb9371 100644 --- a/demos/quickstart/protected/pages/Controls/Validation.page +++ b/demos/quickstart/protected/pages/Controls/Validation.page @@ -34,6 +34,8 @@ Validators share a common set of properties, which are defined in the base class

Prado Validation Controls

TRequiredFieldValidator

+ +

TRequiredFieldValidator ensures that the user enters some data in the specified input field. By default, TRequiredFieldValidator will check if the user input is empty or not. The validation fails if the input is empty. By setting InitialValue, the validator can check if the user input is different from InitialValue. If not, the validation fails.

@@ -41,6 +43,8 @@ TRequiredFieldValidator ensures that the user enters some data in the specified

TRegularExpressionValidator

+ +

TRegularExpressionValidator verifies the user input against a regular pattern. The validation fails if the input does not match the pattern. The regular expression can be specified by the RegularExpression property. Some commonly used regular expressions include:

@@ -65,6 +69,8 @@ Note, TRegularExpressionValidator only checks for nonempty user input. Use a TRe

TEmailAddressValidator

+ +

TEmailAddressValidator verifies that the user input is a valid email address. The validator uses a regular expression to check if the input is in a valid email address format. If CheckMXRecord is true, the validator will also check whether the MX record indicated by the email address is valid, provided checkdnsrr() is available in the installed PHP.

@@ -75,6 +81,8 @@ Note, if the input being validated is empty, TEmailAddressValidator will not do

TCompareValidator

+ +

TCompareValidator compares the user input with a constant value specified by ValueToCompare, or another user input specified by ControlToCompare. The Operator property specifies how to compare the values, which includes Equal, NotEqual, GreaterThan, GreaterThanEqual, LessThan and LessThanEqual. Before comparison, the values being compared will be converted to the type specified by DataType listed as follows,

@@ -94,6 +102,8 @@ Note, if the input being validated is empty, TEmailAddressValidator will not do

TDataTypeValidator

+ +

TDataTypeValidator verifies if the input data is of specific type indicated by DataType. The data types that can be checked against are the same as those in TCompareValidator.

@@ -106,6 +116,8 @@ TDataTypeValidator verifies if the input data is of specific type indicated by <

TRangeValidator

+ +

TRangeValidator verifies whether an input value is within a specified range. TRangeValidator uses three key properties to perform its validation. The MinValue and MaxValue properties specify the minimum and maximum values of the valid range. The DataType property specifies the data type of the value being validated. The value will be first converted into the specified type and then compare with the valid range. The data types that can be checked against are the same as those in TCompareValidator.

@@ -124,6 +136,8 @@ are compared as strictly less than the MaxValue and/or strictly greater

TCustomValidator

+ +

TCustomValidator performs user-defined validation (either server-side or client-side or both) on an input control.

@@ -148,6 +162,8 @@ function ValidationFunctionName(sender, parameter)

TValidationSummary

+ +

TValidationSummary displays a summary of validation errors inline on a Web page, in a message box, or both.

-- cgit v1.2.3