From cd1ffb47a6c07deda47052eff80452e78a52495d Mon Sep 17 00:00:00 2001
From: xue <>
Date: Tue, 14 Feb 2006 21:01:40 +0000
Subject: Added TControl::traverseChildControls().

---
 framework/Web/UI/TControl.php | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)

(limited to 'framework/Web/UI/TControl.php')

diff --git a/framework/Web/UI/TControl.php b/framework/Web/UI/TControl.php
index 660b1c4c..50648d93 100644
--- a/framework/Web/UI/TControl.php
+++ b/framework/Web/UI/TControl.php
@@ -1238,6 +1238,41 @@ class TControl extends TComponent
 		}
 	}
 
+	/**
+	 * Traverse the whole control hierarchy rooted at this control.
+	 * Callback function may be invoked for each control being visited.
+	 * A pre-callback is invoked before traversing child controls;
+	 * A post-callback is invoked after traversing child controls.
+	 * Callback functions can be global functions or class methods.
+	 * They must be of the following signature:
+	 * <code>
+	 * function callback_func($control,$param) {...}
+	 * </code>
+	 * where $control refers to the control being visited and $param
+	 * is the parameter that is passed originally when calling this traverse function.
+	 *
+	 * @param mixed parameter to be passed to callbacks for each control
+	 * @param callback callback invoked before traversing child controls. If null, it is ignored.
+	 * @param callback callback invoked after traversing child controls. If null, it is ignored.
+	 */
+	protected function traverseChildControls($param,$preCallback=null,$postCallback=null)
+	{
+		if($preCallback!==null)
+			call_user_func($preCallback,$this,$param);
+		if($this->getHasControls())
+		{
+			foreach($this->_rf[self::RF_CONTROLS] as $control)
+			{
+				if($control instanceof TControl)
+				{
+					$control->traverseChildControls($param,$preCallback,$postCallback);
+				}
+			}
+		}
+		if($postCallback!==null)
+			call_user_func($postCallback,$this,$param);
+	}
+
 	/**
 	 * Renders the control.
 	 * Only when the control is visible will the control be rendered.
-- 
cgit v1.2.3