Tile Systems (MenuQue)

A TileSystem is an automated process that will do the same as certain hardcoded behaviour for the UI. Things like using the mouse wheel to scroll, dragging an element back and forth or a small yet effective textedit box.

General

In order for modders to easily mark an element as a TileSystem they need to use a specific string-constant for the <id> trait of the element in question. Then, whenever the game processes that particular XML the code will pick up on the desired tile system, create the needed background stuff and attach it to the element.

There can be only one per element but a menu can contain any number of systems, even with the same type.

<menu name="DemoMenu">
 	<class> &GenericMenu; </class>
 	<stackingtype> &no_click_past; </stackingtype>
 	<locus> &true; </locus>
 	<explorefade> 0.25 </explorefade>
 
 	<rect name="background">
<include src="generic_background.xml" />

		<id> &TileSystemType; </id> <!-- this will mark the element as a TileSystem -->
		<visible> &true; </visible>
		<depth> 15 </depth>
		<locus> &true; </locus>
		<target> &true; </target>
		<user0> 400 </user0>
		<user1> 580 </user1>
		<x>
			<copy src="screen()" trait="width" />
			<sub src="me()" trait="width" />
			<div> 2 </div>
		</x>
		<y>
			<copy src="screen()" trait="height" />
			<sub src="me()" trait="height" />
			<div> 2 </div>
		</y>
	</rect>
 	
</menu>

Types

There are a number of different types of TileSystems, each one dealing with a different aspect of user-to-UI interaction. Depending on the system an element will also need to have certain <userX> traits in order to function properly.

Scroll

This will respond to the mousewheel and increment or decrement certain <userX> traits. Most common use would be for custom scrollbars but the exact implementation is not really important. REQUIRES: <user5> trait.

Drag

These will respond to the mouse movement while holding down the left mouse button. There are three versions, two for movement along a single axis and one movement along both axis. There is a small limitation in that the moving of the dragged element should not affect the position of its parent element (or anything else higher up the chain).

The element itself does not have to move though. REQUIRES: <user8> and <user9> for horizontal -or- vertical dragging and <user11>, <user12>, <user13> and <user14> for dragging along both axis.

FocusBox

A focus system will react to the active element (e.g. the mouse is over it). It will then get the same <width>,<height>, <x> and <y> traits as the active element. But this only happens if the active element has a "&true;" <focus> and a "&true;" <target> trait. The position offset can be adjusted with the <focusinset> trait. The difference in size can be adjusted with the <focussize> trait. REQUIRES: <user15> trait.

TextEdit

TODO