pradosoft / prado

framework/Web/UI/ActiveControls/TCallbackClientScript.php

Doc Comments +6 added lines

@@ -185,6 +185,9 @@ 
 		);
 	}
 
+	/**
+	 * @param TControl $control
+	 */
 	private function getSelectionControlType($control)
 	{
 		if (is_string($control)) {
@@ -199,6 +202,9 @@ 
 		return 'select';
 	}
 
+	/**
+	 * @param TControl $control
+	 */
 	private function getSelectionControlIsListType($control)
 	{
 		return $control instanceof TListControl;

framework/Web/UI/ActiveControls/TCallbackEventParameter.php

Doc Comments +1 added lines, -1 removed lines

@@ -73,7 +73,7 @@
 	}
 
 	/**
-	 * @param mixed $value callback response data.
+	 * @param boolean $value callback response data.
 	 */
 	public function setResponseData($value)
 	{

framework/Web/UI/ActiveControls/TInPlaceTextBox.php

Doc Comments +1 added lines, -1 removed lines

@@ -97,7 +97,7 @@
 	/**
 	 * Calls the client-side static method for this control class.
 	 * @param string $func static method name
-	 * @param mixed $value method parmaeter
+	 * @param boolean $value method parmaeter
 	 */
 	protected function callClientFunction($func, $value)
 	{

framework/Web/UI/JuiControls/TJuiAutoComplete.php

Doc Comments +2 added lines, -2 removed lines

@@ -254,7 +254,7 @@ 
 	 * The method raises 'OnSuggest' event. If you override this
 	 * method, be sure to call the parent implementation so that the event
 	 * handler can be invoked.
-	 * @param TCallbackEventParameter $param event parameter to be passed to the event handlers
+	 * @param TJuiAutoCompleteEventParameter $param event parameter to be passed to the event handlers
 	 */
 	public function onSuggest($param)
 	{
@@ -266,7 +266,7 @@ 
 	 * The method raises 'OnSuggestionSelected' event. If you override this
 	 * method, be sure to call the parent implementation so that the event
 	 * handler can be invoked.
-	 * @param TCallbackEventParameter $param event parameter to be passed to the event handlers
+	 * @param TJuiAutoCompleteEventParameter $param event parameter to be passed to the event handlers
 	 */
 	public function onSuggestionSelected($param)
 	{

framework/Web/UI/JuiControls/TJuiControlAdapter.php

Doc Comments +1 added lines, -1 removed lines

@@ -80,7 +80,7 @@
 
 	/**
 	 * Publish the jQuery-ui style Css asset file.
-	 * @param file $file name
+	 * @param string $file name
 	 * @return string Css file url.
 	 */
 	public function publishJuiStyle($file)

framework/Web/UI/JuiControls/TJuiControlOptions.php

Doc Comments +1 added lines, -1 removed lines

@@ -126,7 +126,7 @@
 
 	/**
 	 * Only serialize the options itself, not the corresponding parent control.
-	 * @return mixed array with the names of all variables of that object that should be serialized.
+	 * @return string[] array with the names of all variables of that object that should be serialized.
 	 */
 	public function __sleep()
 	{

framework/Web/UI/TControl.php

Doc Comments +9 added lines, -9 removed lines

@@ -214,7 +214,7 @@ 
 	 * the control ID will take the precedence.
 	 *
 	 * @param string $name the property name or control ID
-	 * @return bool wether the control or property exists
+	 * @return boolean|null wether the control or property exists
 	 * @see __get
 	 */
 	public function __isset($name)
@@ -471,7 +471,7 @@ 
 	}
 
 	/**
-	 * @return bool if a skin is applied.
+	 * @return integer if a skin is applied.
 	 */
 	public function getIsSkinApplied()
 	{
@@ -648,7 +648,7 @@ 
 	}
 
 	/**
-	 * @param mixed $name
+	 * @param string $name
 	 * @return bool whether the named attribute exists
 	 */
 	public function hasAttribute($name)
@@ -661,7 +661,7 @@ 
 	}
 
 	/**
-	 * @param mixed $name
+	 * @param string $name
 	 * @return string attribute value, null if attribute does not exist
 	 */
 	public function getAttribute($name)
@@ -698,7 +698,7 @@ 
 	}
 
 	/**
-	 * @param mixed $checkParents
+	 * @param boolean $checkParents
 	 * @return bool whether viewstate is enabled
 	 */
 	public function getEnableViewState($checkParents = false)
@@ -733,7 +733,7 @@ 
 	 * This function is mainly used in defining getter functions for control properties
 	 * that must be kept in controlstate.
 	 * @param string $key the name of the controlstate value to be returned
-	 * @param mixed $defaultValue the default value. If $key is not found in controlstate, $defaultValue will be returned
+	 * @param integer|null $defaultValue the default value. If $key is not found in controlstate, $defaultValue will be returned
 	 * @return mixed the controlstate value corresponding to $key
 	 */
 	protected function getControlState($key, $defaultValue = null)
@@ -749,7 +749,7 @@ 
 	 * Make sure that the controlstate value must be serializable and unserializable.
 	 * @param string $key the name of the controlstate value
 	 * @param mixed $value the controlstate value to be set
-	 * @param null|mixed $defaultValue default value. If $value===$defaultValue, the item will be cleared from controlstate
+	 * @param integer $defaultValue default value. If $value===$defaultValue, the item will be cleared from controlstate
 	 */
 	protected function setControlState($key, $value, $defaultValue = null)
 	{
@@ -1084,7 +1084,7 @@ 
 	 * A registered object can be accessed like a public member variable.
 	 * This method should only be used by framework and control developers.
 	 * @param string $name name of the object
-	 * @param object $object object to be declared
+	 * @param \Prado\TComponent $object object to be declared
 	 * @see __get
 	 */
 	public function registerObject($name, $object)
@@ -1160,7 +1160,7 @@ 
 	 * A component with explicit ID on a template will be registered to
 	 * the template owner. This method allows you to obtain this component
 	 * with the ID.
-	 * @param mixed $name
+	 * @param string $name
 	 * @return mixed the named registered object. Null if object is not found.
 	 */
 	public function getRegisteredObject($name)

Spacing +12 added lines, -12 removed lines

@@ -114,17 +114,17 @@ 
 	 * Indexes for the rare fields.
 	 * In order to save memory, rare fields will only be created if they are needed.
 	 */
-	const RF_CONTROLS = 0;			// child controls
-	const RF_CHILD_STATE = 1;			// child state field
-	const RF_NAMED_CONTROLS = 2;		// list of controls whose namingcontainer is this control
-	const RF_NAMED_CONTROLS_ID = 3;	// counter for automatic id
-	const RF_SKIN_ID = 4;				// skin ID
-	const RF_DATA_BINDINGS = 5;		// data bindings
-	const RF_EVENTS = 6;				// event handlers
-	const RF_CONTROLSTATE = 7;		// controlstate
-	const RF_NAMED_OBJECTS = 8;		// controls declared with ID on template
-	const RF_ADAPTER = 9;				// adapter
-	const RF_AUTO_BINDINGS = 10;		// auto data bindings
+	const RF_CONTROLS = 0; // child controls
+	const RF_CHILD_STATE = 1; // child state field
+	const RF_NAMED_CONTROLS = 2; // list of controls whose namingcontainer is this control
+	const RF_NAMED_CONTROLS_ID = 3; // counter for automatic id
+	const RF_SKIN_ID = 4; // skin ID
+	const RF_DATA_BINDINGS = 5; // data bindings
+	const RF_EVENTS = 6; // event handlers
+	const RF_CONTROLSTATE = 7; // controlstate
+	const RF_NAMED_OBJECTS = 8; // controls declared with ID on template
+	const RF_ADAPTER = 9; // adapter
+	const RF_AUTO_BINDINGS = 10; // auto data bindings
 
 	/**
 	 * @var string control ID
@@ -402,7 +402,7 @@ 
 	public function getUniqueID()
 	{
 		if ($this->_uid === '' || $this->_uid === null) {	// need to build the UniqueID
-			$this->_uid = '';  // set to not-null, so that clearCachedUniqueID() may take action
+			$this->_uid = ''; // set to not-null, so that clearCachedUniqueID() may take action
 			if ($namingContainer = $this->getNamingContainer()) {
 				if ($this->getPage() === $namingContainer) {
 					return ($this->_uid = $this->_id);

framework/Web/UI/TPage.php

Doc Comments +6 added lines, -3 removed lines

@@ -290,6 +290,9 @@ 
 		$this->unloadRecursive();
 	}
 
+	/**
+	 * @param string $enc
+	 */
 	protected static function decodeUTF8($data, $enc)
 	{
 		if (is_array($data)) {
@@ -970,7 +973,7 @@ 
 
 	/**
 	 * @internal This method is invoked by TForm at the beginning of its rendering
-	 * @param mixed $writer
+	 * @param THtmlWriter $writer
 	 */
 	public function beginFormRender($writer)
 	{
@@ -984,7 +987,7 @@ 
 
 	/**
 	 * @internal This method is invoked by TForm  at the end of its rendering
-	 * @param mixed $writer
+	 * @param THtmlWriter $writer
 	 */
 	public function endFormRender($writer)
 	{
@@ -1003,7 +1006,7 @@ 
 
 	/**
 	 * Sets input focus on a control after the page is rendered to users.
-	 * @param string|TControl $value control to receive focus, or the ID of the element on the page to receive focus
+	 * @param TControl $value control to receive focus, or the ID of the element on the page to receive focus
 	 */
 	public function setFocus($value)
 	{

framework/Web/UI/TPageStateFormatter.php

Doc Comments +1 added lines, -1 removed lines

@@ -55,7 +55,7 @@
 	/**
 	 * @param TPage $page
 	 * @param string $data serialized data
-	 * @return mixed unserialized state data, null if data is corrupted
+	 * @return string unserialized state data, null if data is corrupted
 	 */
 	public static function unserialize($page, $data)
 	{