Editing WoW:XML/Dimension

{{uixmltype}}

[[XML/Dimension|Dimension]] is a type used for a variety of purposes for defining values that relate to the UI coordinate system, and is a fundamental UI building block for defining positional layout. See [[XML/Value|Value]] for single value use type. The Dimension type can be used for '''Size''', '''Position''' and others, and can be found on [[XML/LayoutFrame|LayoutFrame]], [[XML/Anchor|Anchor]], and others.

== Inheritance ==
Inherited by: none, Inherits: none, Defined in: multiple

== Elements ==
* <[[XML/AbsDimension|AbsDimension]]> - defines a relative or absolute value, using 'absolute' unit based coordinates
* <[[XML/RelDimension|RelDimension]]> - defines a relative or absolute value, using 'relative' scalar coordinates

== Attributes ==
* x (int) - defines a value thats horizontally opposed
* y (int) - defines a value thats vertically opposed

== Summary ==

[[XML/Dimension|Dimension]] based elements facilitate the 'Layout' mechanism in the WoW UI. When used for <'''Size'''>, along with the <[[XML/Anchors|Anchors]]> element, allow WoW to position all of its visible and interactive elements on the screen, including the 3D views of the world. Dimension works by providing a flexible set of size or positional constructs, by using one of: inline values (X and Y), the [[XML/AbsDimension|AbsDimension]] element, or the [[XML/RelDimension|RelDimension]] element.

=== Example ===
 <Frame name="MyFrame">
   <Size>
     <[[XML/RelDimension|RelDimension]] x="0.5" y="0.5"/>
   </Size>
   <Frames>
     <Frame name="$parentChild">
       <[[XML/Dimension|Size]] x="200" y="100"/>
       <Anchors>
         <Anchor point="TOP">
           <Offset>
             <[[XML/AbsDimension|AbsDimension]] x="0" y="-22" />
           </Offset>
         </Anchor>
       </Anchors>
     </frame>
   </Frames>
 </Frame>

This example will align the top of the 'child' frame to the top of 'MyFrame', and then offset that alignment by -22 vertically. Also demonstrates use of Dimension with '''Size''' and [[XML/Anchor|Anchor]], and using '''Abs''', '''Rel''' and '''inline''' values.

== Details ==