From 67666aaccb4b4743a084b214722e1173e827e9d1 Mon Sep 17 00:00:00 2001
From: "ctrlaltca@gmail.com" <>
Date: Wed, 1 Jun 2011 22:14:00 +0000
Subject: upported recent documentation changes from branch/3.1 to trunk/
---
.gitattributes | 29 ++++++++
.../pages/ActiveControls/ActiveImage.page | 16 ++++
.../pages/ActiveControls/ActiveImageButton.page | 17 +++++
.../pages/ActiveControls/ActiveLabel.page | 16 ++++
.../pages/ActiveControls/ActiveLinkButton.page | 19 +++++
.../pages/ActiveControls/ActiveMultiView.page | 14 ++++
.../pages/ActiveControls/ActivePanel.page | 24 ++++++
.../pages/ActiveControls/ActiveRadioButton.page | 20 +++++
.../pages/ActiveControls/ActiveTextBox.page | 15 ++++
.../protected/pages/ActiveControls/Home.page | 60 ++++++++-------
.../Samples/TActiveImage/HelloWorld.html | 8 ++
.../ActiveControls/Samples/TActiveImage/Home.page | 20 +++++
.../ActiveControls/Samples/TActiveImage/Home.php | 17 +++++
.../Samples/TActiveImage/hello_world.gif | Bin 0 -> 1602 bytes
.../Samples/TActiveImage/hello_world2.gif | Bin 0 -> 662 bytes
.../Samples/TActiveImageButton/Home.page | 49 ++++++++++++
.../Samples/TActiveImageButton/Home.php | 18 +++++
.../Samples/TActiveImageButton/hello_world.gif | Bin 0 -> 1602 bytes
.../ActiveControls/Samples/TActiveLabel/Home.page | 34 +++++++++
.../ActiveControls/Samples/TActiveLabel/Home.php | 16 ++++
.../Samples/TActiveLinkButton/Home.page | 46 ++++++++++++
.../Samples/TActiveLinkButton/Home.php | 14 ++++
.../Samples/TActiveMultiView/Home.page | 37 ++++++++++
.../Samples/TActiveMultiView/Home.php | 15 ++++
.../ActiveControls/Samples/TActivePanel/Home.page | 24 ++++++
.../ActiveControls/Samples/TActivePanel/Home.php | 21 ++++++
.../Samples/TActiveRadioButton/Home.page | 82 +++++++++++++++++++++
.../Samples/TActiveRadioButton/Home.php | 27 +++++++
.../Samples/TActiveTextBox/Home.page | 31 ++++++++
.../ActiveControls/Samples/TActiveTextBox/Home.php | 16 ++++
.../protected/pages/Controls/ColorPicker.page | 29 +++++++-
.../quickstart/protected/pages/Controls/Head.page | 34 ++++++++-
.../pages/Controls/Samples/TColorPicker/Home.page | 37 ++++++++++
.../protected/pages/Controls/Standard.page | 4 +-
.../Web/UI/ActiveControls/TActiveImageButton.php | 2 +-
framework/Web/UI/ActiveControls/TActiveTextBox.php | 4 +-
framework/Web/UI/WebControls/TColorPicker.php | 25 ++++++-
framework/Web/UI/WebControls/TDatePicker.php | 2 +-
framework/Web/UI/WebControls/THead.php | 2 +-
39 files changed, 802 insertions(+), 42 deletions(-)
create mode 100644 demos/quickstart/protected/pages/ActiveControls/ActiveImage.page
create mode 100644 demos/quickstart/protected/pages/ActiveControls/ActiveImageButton.page
create mode 100644 demos/quickstart/protected/pages/ActiveControls/ActiveLabel.page
create mode 100644 demos/quickstart/protected/pages/ActiveControls/ActiveLinkButton.page
create mode 100644 demos/quickstart/protected/pages/ActiveControls/ActiveMultiView.page
create mode 100644 demos/quickstart/protected/pages/ActiveControls/ActivePanel.page
create mode 100644 demos/quickstart/protected/pages/ActiveControls/ActiveRadioButton.page
create mode 100644 demos/quickstart/protected/pages/ActiveControls/ActiveTextBox.page
create mode 100644 demos/quickstart/protected/pages/ActiveControls/Samples/TActiveImage/HelloWorld.html
create mode 100644 demos/quickstart/protected/pages/ActiveControls/Samples/TActiveImage/Home.page
create mode 100644 demos/quickstart/protected/pages/ActiveControls/Samples/TActiveImage/Home.php
create mode 100644 demos/quickstart/protected/pages/ActiveControls/Samples/TActiveImage/hello_world.gif
create mode 100644 demos/quickstart/protected/pages/ActiveControls/Samples/TActiveImage/hello_world2.gif
create mode 100644 demos/quickstart/protected/pages/ActiveControls/Samples/TActiveImageButton/Home.page
create mode 100644 demos/quickstart/protected/pages/ActiveControls/Samples/TActiveImageButton/Home.php
create mode 100644 demos/quickstart/protected/pages/ActiveControls/Samples/TActiveImageButton/hello_world.gif
create mode 100644 demos/quickstart/protected/pages/ActiveControls/Samples/TActiveLabel/Home.page
create mode 100644 demos/quickstart/protected/pages/ActiveControls/Samples/TActiveLabel/Home.php
create mode 100644 demos/quickstart/protected/pages/ActiveControls/Samples/TActiveLinkButton/Home.page
create mode 100644 demos/quickstart/protected/pages/ActiveControls/Samples/TActiveLinkButton/Home.php
create mode 100644 demos/quickstart/protected/pages/ActiveControls/Samples/TActiveMultiView/Home.page
create mode 100644 demos/quickstart/protected/pages/ActiveControls/Samples/TActiveMultiView/Home.php
create mode 100644 demos/quickstart/protected/pages/ActiveControls/Samples/TActivePanel/Home.page
create mode 100644 demos/quickstart/protected/pages/ActiveControls/Samples/TActivePanel/Home.php
create mode 100644 demos/quickstart/protected/pages/ActiveControls/Samples/TActiveRadioButton/Home.page
create mode 100644 demos/quickstart/protected/pages/ActiveControls/Samples/TActiveRadioButton/Home.php
create mode 100644 demos/quickstart/protected/pages/ActiveControls/Samples/TActiveTextBox/Home.page
create mode 100644 demos/quickstart/protected/pages/ActiveControls/Samples/TActiveTextBox/Home.php
create mode 100644 demos/quickstart/protected/pages/Controls/Samples/TColorPicker/Home.page
diff --git a/.gitattributes b/.gitattributes
index 716d26e5..0d0b1761 100644
--- a/.gitattributes
+++ b/.gitattributes
@@ -1290,7 +1290,15 @@ demos/quickstart/protected/pages/ActiveControls/ActiveButton.page -text
demos/quickstart/protected/pages/ActiveControls/ActiveCheckBox.page -text
demos/quickstart/protected/pages/ActiveControls/ActiveCustomValidator.page -text
demos/quickstart/protected/pages/ActiveControls/ActiveHyperLink.page -text
+demos/quickstart/protected/pages/ActiveControls/ActiveImage.page -text
+demos/quickstart/protected/pages/ActiveControls/ActiveImageButton.page -text
+demos/quickstart/protected/pages/ActiveControls/ActiveLabel.page -text
+demos/quickstart/protected/pages/ActiveControls/ActiveLinkButton.page -text
+demos/quickstart/protected/pages/ActiveControls/ActiveMultiView.page -text
demos/quickstart/protected/pages/ActiveControls/ActivePager.page -text
+demos/quickstart/protected/pages/ActiveControls/ActivePanel.page -text
+demos/quickstart/protected/pages/ActiveControls/ActiveRadioButton.page -text
+demos/quickstart/protected/pages/ActiveControls/ActiveTextBox.page -text
demos/quickstart/protected/pages/ActiveControls/AutoComplete.page -text
demos/quickstart/protected/pages/ActiveControls/DragDrop.page -text
demos/quickstart/protected/pages/ActiveControls/Home.page -text
@@ -1320,7 +1328,25 @@ demos/quickstart/protected/pages/ActiveControls/Samples/TActiveDataGrid/Sample6.
demos/quickstart/protected/pages/ActiveControls/Samples/TActiveHyperLink/Home.page -text
demos/quickstart/protected/pages/ActiveControls/Samples/TActiveHyperLink/Home.php -text
demos/quickstart/protected/pages/ActiveControls/Samples/TActiveHyperLink/hello_world.gif -text
+demos/quickstart/protected/pages/ActiveControls/Samples/TActiveImage/HelloWorld.html -text
+demos/quickstart/protected/pages/ActiveControls/Samples/TActiveImage/Home.page -text
+demos/quickstart/protected/pages/ActiveControls/Samples/TActiveImage/Home.php -text
+demos/quickstart/protected/pages/ActiveControls/Samples/TActiveImage/hello_world.gif -text
+demos/quickstart/protected/pages/ActiveControls/Samples/TActiveImage/hello_world2.gif -text
+demos/quickstart/protected/pages/ActiveControls/Samples/TActiveImageButton/Home.page -text
+demos/quickstart/protected/pages/ActiveControls/Samples/TActiveImageButton/Home.php -text
+demos/quickstart/protected/pages/ActiveControls/Samples/TActiveImageButton/hello_world.gif -text
+demos/quickstart/protected/pages/ActiveControls/Samples/TActiveLabel/Home.page -text
+demos/quickstart/protected/pages/ActiveControls/Samples/TActiveLabel/Home.php -text
+demos/quickstart/protected/pages/ActiveControls/Samples/TActiveLinkButton/Home.page -text
+demos/quickstart/protected/pages/ActiveControls/Samples/TActiveLinkButton/Home.php -text
+demos/quickstart/protected/pages/ActiveControls/Samples/TActiveMultiView/Home.page -text
+demos/quickstart/protected/pages/ActiveControls/Samples/TActiveMultiView/Home.php -text
demos/quickstart/protected/pages/ActiveControls/Samples/TActivePager/Home.page -text
+demos/quickstart/protected/pages/ActiveControls/Samples/TActivePanel/Home.page -text
+demos/quickstart/protected/pages/ActiveControls/Samples/TActivePanel/Home.php -text
+demos/quickstart/protected/pages/ActiveControls/Samples/TActiveRadioButton/Home.page -text
+demos/quickstart/protected/pages/ActiveControls/Samples/TActiveRadioButton/Home.php -text
demos/quickstart/protected/pages/ActiveControls/Samples/TActiveRepeater/RegionDisplay.php -text
demos/quickstart/protected/pages/ActiveControls/Samples/TActiveRepeater/RegionDisplay.tpl -text
demos/quickstart/protected/pages/ActiveControls/Samples/TActiveRepeater/Sample1.page -text
@@ -1335,6 +1361,8 @@ demos/quickstart/protected/pages/ActiveControls/Samples/TActiveRepeater/Sample5.
demos/quickstart/protected/pages/ActiveControls/Samples/TActiveRepeater/Sample5.php -text
demos/quickstart/protected/pages/ActiveControls/Samples/TActiveTableRow/Home.page -text
demos/quickstart/protected/pages/ActiveControls/Samples/TActiveTableRow/Home.php -text
+demos/quickstart/protected/pages/ActiveControls/Samples/TActiveTextBox/Home.page -text
+demos/quickstart/protected/pages/ActiveControls/Samples/TActiveTextBox/Home.php -text
demos/quickstart/protected/pages/ActiveControls/Samples/TAutoComplete/Home.page -text
demos/quickstart/protected/pages/ActiveControls/Samples/TAutoComplete/Home.php -text
demos/quickstart/protected/pages/ActiveControls/Samples/config.xml -text
@@ -1512,6 +1540,7 @@ demos/quickstart/protected/pages/Controls/Samples/TCheckBoxList/Home.page -text
demos/quickstart/protected/pages/Controls/Samples/TCheckBoxList/Home.php -text
demos/quickstart/protected/pages/Controls/Samples/TClientSideValidator/Home.page -text
demos/quickstart/protected/pages/Controls/Samples/TClientSideValidator/Home.php -text
+demos/quickstart/protected/pages/Controls/Samples/TColorPicker/Home.page -text
demos/quickstart/protected/pages/Controls/Samples/TCompareValidator/Home.page -text
demos/quickstart/protected/pages/Controls/Samples/TCompareValidator/Home.php -text
demos/quickstart/protected/pages/Controls/Samples/TConditional/Home.page -text
diff --git a/demos/quickstart/protected/pages/ActiveControls/ActiveImage.page b/demos/quickstart/protected/pages/ActiveControls/ActiveImage.page
new file mode 100644
index 00000000..8cce8c9e
--- /dev/null
+++ b/demos/quickstart/protected/pages/ActiveControls/ActiveImage.page
@@ -0,0 +1,16 @@
+
+TActiveImage is the active control counter part to TImage. TActiveImage displays an image on a page. The image is specified via the ImageUrl property which takes a relative or absolute URL to the image file. The alignment of the image displayed is set by the ImageAlign property. To set alternate text or long description of the image, use AlternateText or DescriptionUrl, respectively.
+
+TActiveImage allows the AlternateText, ImageAlign, ImageUrl
+and DescriptionUrl to be updated during a callback request.
+
+TActiveImageButton is the active counterpart of TImageButton.
+When a TActiveImageButton is clicked, rather than a normal post back request a callback request is initiated.
+TheOnCallback event is raised during a callback request and it is raised after the OnClick event.
+
+TActiveImageButton is similar to TActiveButton, except that TActiveImageButton displays the button as an image. The image is specified via ImageUrl, and the alternate text is specified by Text. In addition, it is possible to obtain the coordinate of the point where the image is clicked. The coordinate information is contained in the event parameter of the OnClick event (not OnCallback).
+
+TActiveLabel is the active control counterpart of TLabel component. When
+ActiveControl.EnableUpdate property is true during a callback request, setting Text
+property will also set the text of the label on the client upon callback
+completion. Similarly, setting ForControl will also set
+the client-side "for" attribute on the label.
+
+TActiveLinkButton is the active control counter part to TLinkButton.
+When a TActiveLinkButton is clicked, rather than a normal post back request a
+callback request is initiated.
+The OnCallback event is raised during a callback request
+and it is raise after the OnClick event.
+When the ActiveControl.EnableUpdate
+property is true, changing the Text property during callback request
+will update the link text upon callback response completion.
+
+TActiveMultiView is the active counterpart to the original TMultiView control.
+TActiveMultiView serves as a container for a group of TView controls, which can be retrieved by the Views property. Each view contains child controls. TActiveMultiView determines which view and its child controls are visible. At any time, at most one view is visible (called active). To make a view active, set ActiveView or ActiveViewIndex. Note, by default there is no active view.
+TActiveMultiView is able to render itself on Callback when ActiveView or ActiveViewIndex properties are changed.
+
+
+TActivePanel is the TPanel active control counterpart.
+TActivePanel allows the client-side panel contents to be updated during a
+callback response using the render method.
+Example: Assume $param is an instance of TCallbackEventParameter attached to
+the OnCallback event of a TCallback with ID "callback1", and
+"panel1" is the ID of a TActivePanel.
+
+
+TActiveRadioButton is the active control counter part to TRadioButton.
+The AutoPostBack property is set to true by default. Thus, when the radio button is clicked a
+OnCallback event is raise after OnCheckedChanged event.
+
+The Text and Checked properties can be changed during a callback.
+The GroupName property may NOT be changed during callback because the client-side
+name attribute is read-only and can not be changed using javascript.
+
+TActiveTextBox is the active control counterpart of TTextBox component.
+TActiveTextBox allows the Text property of the textbox to
+be changed during callback. When AutoPostBack property
+is true, changes to the textbox contents will perform a callback request causing
+OnTextChanged to be fired first followed by OnCallback event.
+TActiveImage
+TActiveImageButton
+TActiveLabel
+TActiveLinkButton
+TActiveMultiView
+TActivePanel
+TRadioButton
+TActiveTextBox
+
+ImageUrl being changed on callback request: + |
+ |
+A click image button showing the click location: + |
+ |
+A callback image button: + |
+ |
+An image button causing validation: + |
+ |
+An active label text being set as the result of a callback: + |
+ |
+Upon button click, the textbox contents will be set on the label. Note that text needs to be properly escaped to avoid html injections: + |
+ |
+Link button with only body content: + |
+ |
+A click link button: + |
+ |
+A callback link button: + |
+ |
+A button causing validation: + |
+ |
Please enter a memo:
+Please choose a color:
++Active panel updated on callback: + |
+ a checkbox: a textbox: a label: +When you press the button, the panel contents will change. Note that out of the +panel and the button, all the other controls are not active but gets updated +anyway since they are placed inside the active panel. + |
+A callback radiobutton: + |
+ |
+A radiobutton causing validation on a textbox: + |
+ |
+A radiobutton validated by a required field validator: + |
+ |
+A radiobutton group: + |
+ + |
+An active textbox being set as the result of a callback: + |
+ |
+An active textbox with AutoPostBack="true"; Pressing Enter/Return, the textbox contents will be set on the label. +Note that text needs to be properly escaped to avoid html injections: + |
+ |
-TBD +
+TColorPicker displays a text box for color input purpose.
+Next to the textbox there's a button filled with the current chosen color.
+Users can write a color name directly in the text box as an hex triplet (also known as HTML notation, eg: #FF00FF).
+
Alternatively, if the ShowColorPicker property is enabled (it is by default), users can click the button
+to have a color picker UI appear. A color chan be chosen directly by clicking on the color picker.
+TColorPicker has three different color picker UI Modes:
+The CssClass property can be used to override the CSS class name +for the color picker panel. The ColorStyle property changes the overall color picker style. +The following ColorStyle values are available:
+If the Mode property is set to Full, the color picker panel will +display an "Ok" and "Cancel" buttons. You can customize the button labels setting the OKButtonText +and CancelButtonText properties.
+ +-TBD +THead displays a head element on a page. It displays the content +enclosed in its body and the page title set by the Title property. +
+ ++In addition, stylesheets and JavaScripts registered via +
+THead also manages and displays meta tags through its MetaTags +property. You can add a meta object to the collection in code dynamically, +or add it in template using the following syntax +
+ ++Note, TPage has a property Head that refers to +the THead control currently on the page. A page can have at most one THead +control. Although not required, it is recommended to place a THead on your page. +Without a THead on the page, stylesheets and javascripts in the current page +theme will not be rendered.
Default TColorPicker, Mode="Basic" | +
+ |
+
Mode="Simple" pre-selected red color |
+
+ |
+
Mode="Full" | +
+ |
+
Disabled color picker panel: ShowColorPicker="false" | +
+ |
+