Rename IGUIElement::setRelativePosition(const core::rect<f32>&) to...

Rename IGUIElement::setRelativePosition(const core::rect<f32>&) to setProportionalPosition().  Tested with a modified example 05.

git-svn-id: svn://svn.code.sf.net/p/irrlicht/code/trunk@1777 dfc29bdd-3216-0410-991c-e03cc46cb475

changes.txt

 Changes in version 1.5 (... 2008)
 
+ - Renamed IGUIElement::setRelativePosition(const core::rect<f32>& r) to setProportionalPosition(), as it has radically different functionality from setRelativePosition(const core::rect<s32>& r)
+
+ - Added IGUIElement::setRelativePosition(const core::position2di & position) to set a new position while retaining the existing height and width.
+
  - Camera scene node rotation and target can now be bound together so that changing one automatically changes the other (as the FPS camera has always done). See ICameraSceneNode::bindTargetAndRotation()
 
  - Removed VS6 .dsw / .dsp project files - VS6 is no longer supported.

include/IGUIElement.h

@@ -117,10 +117,12 @@ public:
 	}
 
 
-
 	//! Sets the relative rectangle of this element as a proportion of its parent's area.
-	/** \param r  The rectangle to set, interpreted as a proportion of the parent's area */
-	void setRelativePosition(const core::rect<f32>& r)
+	/** \note This method used to be 'void setRelativePosition(const core::rect<f32>& r)'
+	\param r  The rectangle to set, interpreted as a proportion of the parent's area. 
+	Meaningful values are in the range [0...1], unless you intend this element to spill
+	outside its parent. */
+	void setProportionalPosition(const core::rect<f32>& r) 
 	{
 		if (!Parent)
 			return;
@@ -138,6 +140,7 @@ public:
 		updateAbsolutePosition();
 	}
 
+
 	//! Gets the absolute rectangle of this element
 	core::rect<s32> getAbsolutePosition() const
 	{