Add some deprecation notices

6 files changed, 27 insertions, 2 deletions

diff --git a/demos/quickstart/protected/pages/ActiveControls/AutoComplete.page b/demos/quickstart/protected/pages/ActiveControls/AutoComplete.page
index 898822a0..525904cd 100755
--- a/demos/quickstart/protected/pages/ActiveControls/AutoComplete.page
+++ b/demos/quickstart/protected/pages/ActiveControls/AutoComplete.page
@@ -3,6 +3,10 @@
 <com:DocLink ClassPath="System.Web.UI.ActiveControls.TAutoComplete" />

 

 <p class="block-content">

+This widget is deprecated. Please use <a href="?page=JuiControls.Widgets#TJuiAutoComplete">TJuiAutoComplete</a> instead.

+</p>

+

+<p class="block-content">

 <tt>TAutoComplete</tt> is an extended <tt>ActiveTextBox</tt> that provides a list of suggestions on the current partial word typed in the textbox. The suggestions are requested using callbacks. The <tt>Frequency</tt> and <tt>MinChars</tt> properties sets the delay and minimum number of characters typed, respectively, before requesting for sugggestions. An embedded <tt>TRepeater</tt> is used to Display the list of suggestions. It can be accessed and styled through the <tt>Suggestions</tt> property and its sub-properties.<p id="900022" class="block-content">

 

 <p class="block-content">

diff --git a/demos/quickstart/protected/pages/ActiveControls/DragDrop.page b/demos/quickstart/protected/pages/ActiveControls/DragDrop.page
index 8ad0f730..16f48666 100755
--- a/demos/quickstart/protected/pages/ActiveControls/DragDrop.page
+++ b/demos/quickstart/protected/pages/ActiveControls/DragDrop.page
@@ -2,6 +2,10 @@
 <h1 id="188035">TDropContainer</h1>
 <com:DocLink ClassPath="System.Web.UI.ActiveControls.TDropContainer" />
 
+<p class="block-content">
+This widget is deprecated. Please use <a href="?page=JuiControls.Interactions#TJuiDroppable">TJuiDroppable</a> instead.
+</p>
+
 <p class="block-content"><tt>TDropContainer</tt> represent an area where 
 <tt>TDraggable</tt> controls can be dropped.
 When a <tt>TDraggable</tt> is dropped,  a
@@ -14,6 +18,10 @@ the <tt>OnDrop</tt> event.
 <h1 id="188036">TDraggable</h1>
 <com:DocLink ClassPath="System.Web.UI.ActiveControls.TDraggable" />
 
+<p class="block-content">
+This widget is deprecated. Please use <a href="?page=JuiControls.Interactions#TJuiDraggable">TJuiDraggable</a> instead.
+</p>
+
 <p class="block-content"><tt>TDraggable</tt> will make its child controls 'draggable'.
 When a <tt>TDraggable</tt> is dropped,  a
 callback request is initiated. The <tt>OnCallback</tt> event is raised
diff --git a/demos/quickstart/protected/pages/ActiveControls/Home.page b/demos/quickstart/protected/pages/ActiveControls/Home.page
index 25590089..eabfe78f 100755
--- a/demos/quickstart/protected/pages/ActiveControls/Home.page
+++ b/demos/quickstart/protected/pages/ActiveControls/Home.page
@@ -165,7 +165,7 @@ TActiveButton</a> control. See also the later part of the <a href="?page=Tutoria
 

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

 	<li>

-	<a href="?page=ActiveControls.AutoComplete">TAutoComplete</a>

+	<a href="?page=ActiveControls.AutoComplete">TAutoComplete</a> (deprecated)

 	extends TActiveTextBox to offer text completion suggestions.

 	</li>

 

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

 

 	<li>

-	<a href="?page=ActiveControls.DragDrop">TDropContainer &amp; TDraggable</a> represents drag and drop containers.

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

diff --git a/framework/Web/UI/ActiveControls/TAutoComplete.php b/framework/Web/UI/ActiveControls/TAutoComplete.php
index e396e114..e80d587e 100644
--- a/framework/Web/UI/ActiveControls/TAutoComplete.php
+++ b/framework/Web/UI/ActiveControls/TAutoComplete.php
@@ -18,6 +18,9 @@ Prado::using('System.Web.UI.ActiveControls.TCallbackEventParameter');
 /**
  * TAutoComplete class.
  *
+ * Warning: this class is deprecatd and will be removed in a future release.
+ * We suggest you to investigate using {@link TJuiAutoComplete} instead.
+ *
  * TAutoComplete is a textbox that provides a list of suggestion on
  * the current partial word typed in the textbox. The suggestions are
  * requested using callbacks, and raises the {@link onSuggestion OnSuggestion}
@@ -78,6 +81,7 @@ Prado::using('System.Web.UI.ActiveControls.TCallbackEventParameter');
  * @author Wei Zhuo <weizhuo[at]gmail[dot]com>
  * @package System.Web.UI.ActiveControls
  * @since 3.1
+ * @deprecated Use TJuiAutoComplete instead
  */
 class TAutoComplete extends TActiveTextBox implements INamingContainer
 {
diff --git a/framework/Web/UI/ActiveControls/TDraggable.php b/framework/Web/UI/ActiveControls/TDraggable.php
index 3f6008bc..830200e3 100755
--- a/framework/Web/UI/ActiveControls/TDraggable.php
+++ b/framework/Web/UI/ActiveControls/TDraggable.php
@@ -11,6 +11,9 @@
 /**
  * TDraggable is a control which can be dragged
  *
+ * Warning: this class is deprecatd and will be removed in a future release.
+ * We suggest you to investigate using {@link TJuiDraggable} instead.
+ *
  * This control will make "draggable" control.
  * Properties :
  *
@@ -25,6 +28,7 @@
  * @copyright Copyright &copy; 2008, PradoSoft
  * @license https://github.com/pradosoft/prado/blob/master/COPYRIGHT
  * @package System.Web.UI.ActiveControls
+ * @deprecated Use TJuiDraggable instead
  */
 class TDraggable extends TPanel
 {
diff --git a/framework/Web/UI/ActiveControls/TDropContainer.php b/framework/Web/UI/ActiveControls/TDropContainer.php
index 49eb0db6..216d3dba 100755
--- a/framework/Web/UI/ActiveControls/TDropContainer.php
+++ b/framework/Web/UI/ActiveControls/TDropContainer.php
@@ -21,6 +21,10 @@ Prado::using('System.Web.UI.ActiveControls.TActivePanel');
 
 /**
  * TDropContainer is a panel where TDraggable controls can be dropped.
+ *
+ * Warning: this class is deprecatd and will be removed in a future release.
+ * We suggest you to investigate using {@link TJuiDroppable} instead.
+ *
  * When a TDraggable component is dropped into a TDropContainer, the {@link OnDrop OnDrop} event is raised.
  * The {@link TDropContainerEventParameter} param will contain the dropped control.
  *
@@ -39,6 +43,7 @@ Prado::using('System.Web.UI.ActiveControls.TActivePanel');
  * @copyright Copyright &copy; 2008, PradoSoft
  * @license https://github.com/pradosoft/prado/blob/master/COPYRIGHT
  * @package System.Web.UI.ActiveControls
+ * @deprecated Use TJuiDroppable instead
  */
 class TDropContainer extends TPanel implements IActiveControl, ICallbackEventHandler
 {