Docs 1.6

Accidentally uploaded outdated 1.6 docs

docs/docs1_6/objects/Menubar/addItem.md

@@ -0,0 +1,28 @@
+## addItem
+Adds a item into the list
+
+#### Parameters: 
+1. `string` The entry name
+2. `number|color` unique default background color - optional
+3. `number|color` unique default text color - optional
+4. `any` any value - you could access this later in a :onChange() event (you need to use :getValue()) - optional
+
+#### Returns:
+1. `object` The object in use
+
+#### Usage:
+* Creates a default menubar with 3 entries
+```lua
+local main = basalt.createFrame()
+local aMenubar = main:addMenubar()
+  :addItem("1. Entry")
+  :addItem("2. Entry",colors.yellow)
+  :addItem("3. Entry",colors.yellow,colors.green)
+```
+```xml
+<menubar>
+  <item><text>1. Entry</text></item>
+  <item><text>2. Entry</text><bg>yellow</bg></item>
+  <item><text>3. Entry</text><bg>yellow</bg><fg>green</fg></item>
+</menubar>
+```

docs/docs1_6/objects/Menubar/clear.md

@@ -0,0 +1,16 @@
+## clear
+Removes all items.
+
+#### Returns:
+1. `object` The object in use
+
+#### Usage:
+* Creates a default menubar with 3 entries and removes them immediatley. Which makes no sense.
+```lua
+local main = basalt.createFrame()
+local aMenubar = main:addMenubar()
+  :addItem("1. Entry")
+  :addItem("2. Entry",colors.yellow)
+  :addItem("3. Entry",colors.yellow,colors.green)
+aMenubar:clear()
+```

docs/docs1_6/objects/Menubar/editItem.md

@@ -0,0 +1,23 @@
+## editItem
+Edits a item from the menubar
+
+#### Parameters: 
+1. `number` The index which should be edited
+2. `string` The new item name
+3. `number` the new item background color - optional
+4. `number` The new item text color - optional
+5. `any` New additional information - optional
+
+#### Returns:
+1. `object` The object in use
+
+#### Usage:
+* Creates a default menubar with 3 entries and edits the second one.
+```lua
+local main = basalt.createFrame()
+local aMenubar = main:addMenubar()
+  :addItem("1. Entry")
+  :addItem("2. Entry",colors.yellow)
+  :addItem("3. Entry",colors.yellow,colors.green)
+aMenubar:editItem(2, "Still 2. Entry", colors.red)
+```

docs/docs1_6/objects/Menubar/getAll.md

@@ -0,0 +1,16 @@
+## getAll
+Returns all items as table
+
+#### Returns:
+1. `table` All items
+
+#### Usage:
+* Creates a default menubar with 3 entries and prints a table.
+```lua
+local main = basalt.createFrame()
+local aMenubar = main:addMenubar()
+    :addItem("1. Entry")
+    :addItem("2. Entry",colors.yellow)
+    :addItem("3. Entry",colors.yellow,colors.green)
+basalt.debug(aMenubar:getAll())
+```

docs/docs1_6/objects/Menubar/getItem.md

@@ -0,0 +1,19 @@
+## getItem
+Returns a item by index
+
+#### Parameters: 
+1. `number` The index which should be returned
+
+#### Returns:
+1. `table` The item table example: {text="1. Entry", bgCol=colors.black, fgCol=colors.white}
+
+#### Usage:
+* Creates a default menubar with 3 entries and edits the second one.
+```lua
+local main = basalt.createFrame()
+local aMenubar = main:addMeubar()
+    :addItem("1. Entry")
+    :addItem("2. Entry",colors.yellow)
+    :addItem("3. Entry",colors.yellow,colors.green)
+basalt.debug(aMenubar:getItem(2).text)
+```

docs/docs1_6/objects/Menubar/getItemCount.md

@@ -0,0 +1,16 @@
+## getItemCount
+Returns the current item count
+
+#### Returns:
+1. `number` The item list count
+
+#### Usage:
+* Creates a default menubar with 3 entries and prints the current item count.
+```lua
+local main = basalt.createFrame()
+local aMenubar = main:addMenubar()
+    :addItem("1. Entry")
+    :addItem("2. Entry",colors.yellow)
+    :addItem("3. Entry",colors.yellow,colors.green)
+basalt.debug(aMenubar:getItemCount())
+```

docs/docs1_6/objects/Menubar/getItemIndex.md

@@ -0,0 +1,17 @@
+## getItemIndex
+returns the item index of the currently selected item
+
+#### Returns:
+1. `number` The current index
+
+#### Usage:
+* Creates a default menubar with 3 entries selects the second entry and prints the currently selected index.
+```lua
+local main = basalt.createFrame()
+local aMenubar = main:addMenubar()
+    :addItem("1. Entry")
+    :addItem("2. Entry",colors.yellow)
+    :addItem("3. Entry",colors.yellow,colors.green)
+    :selectItem(2)
+basalt.debug(aMenubar:getItemIndex())
+```

docs/docs1_6/objects/Menubar/getOffset.md

@@ -0,0 +1,22 @@
+## getOffset
+Returns the current index offset
+
+#### Returns:
+1. `number` offset value
+
+#### Usage:
+* Creates a default menubar with 6 entries and sets the offset to 3, also prints the current offset.
+```lua
+local main = basalt.createFrame()
+local aMenubar = main:addMenubar()
+      :addItem("1. Entry")
+      :addItem("2. Entry")
+      :addItem("3. Entry")
+      :addItem("4. Entry")
+      :addItem("5. Entry")
+      :addItem("6. Entry")
+      :addItem("7. Entry")
+      :addItem("8. Entry")
+      :setOffset(3)
+basalt.debug(aMenubar:getOffset())
+```

docs/docs1_6/objects/Menubar/removeItem.md

@@ -0,0 +1,19 @@
+## removeItem
+Removes a item from the menubar
+
+#### Parameters: 
+1. `number` The index which should get removed
+
+#### Returns:
+1. `object` The object in use
+
+#### Usage:
+* Creates a default menubar with 3 entries and removes the second one.
+```lua
+local main = basalt.createFrame()
+local aMenubar = main:addMenubar()
+    :addItem("1. Entry")
+    :addItem("2. Entry",colors.yellow)
+    :addItem("3. Entry",colors.yellow,colors.green)
+    :removeItem(2)
+```

docs/docs1_6/objects/Menubar/selectItem.md

@@ -0,0 +1,19 @@
+## selectItem
+selects a item in the menubar (same as a player would click on a item)
+
+#### Parameters: 
+1. `number` The index which should get selected
+
+#### Returns:
+1. `object` The object in use
+
+#### Usage:
+* Creates a default menubar with 3 entries and selects the second entry.
+```lua
+local main = basalt.createFrame()
+local aMenubar = main:addMenubar()
+    :addItem("1. Entry")
+    :addItem("2. Entry",colors.yellow)
+    :addItem("3. Entry",colors.yellow,colors.green)
+    :selectItem(2)
+```

docs/docs1_6/objects/Menubar/setOffset.md

@@ -0,0 +1,32 @@
+## setOffset
+Sets the offset of the menubar (the same as you would scroll) - default is 0
+
+#### Parameters: 
+1. `number` The offset value
+
+#### Returns:
+1. `object` The object in use
+
+#### Usage:
+* Creates a default menubar with 6 entries and sets the offset to 3.
+```lua
+local main = basalt.createFrame()
+local aMenubar = main:addMenubar()
+      :addItem("1. Entry")
+      :addItem("2. Entry")
+      :addItem("3. Entry")
+      :addItem("4. Entry")
+      :addItem("5. Entry")
+      :addItem("6. Entry")
+      :setOffset(3)
+```
+```xml
+<menubar offset="3">
+  <item><text>1. Entry</text></item>
+  <item><text>2. Entry</text></item>
+  <item><text>3. Entry</text></item>
+  <item><text>4. Entry</text></item>
+  <item><text>5. Entry</text></item>
+  <item><text>6. Entry</text></item>
+</menubar>
+```

docs/docs1_6/objects/Menubar/setScrollable.md

@@ -0,0 +1,38 @@
+## setScrollable
+Makes it possible to scroll while the mouse is over the menubar
+
+#### Parameters: 
+1. `boolean` If the menubar should be scrollable or not
+
+#### Returns:
+1. `object` The object in use
+
+#### Usage:
+* Creates a new menubar and makes it scrollable
+```lua
+local main = basalt.createFrame()
+local aMenubar = main:addMenubar():setScrollable(true)
+  :addItem("1. Entry")
+  :addItem("2. Entry")
+  :addItem("3. Entry")
+  :addItem("4. Entry")
+  :addItem("5. Entry")
+  :addItem("6. Entry")
+  :addItem("7. Entry")
+  :addItem("8. Entry")
+  :addItem("9. Entry")
+
+```
+```xml
+<menubar scrollable="true">
+  <item><text>1. Entry</text></item>
+  <item><text>2. Entry</text></item>
+  <item><text>3. Entry</text></item>
+  <item><text>4. Entry</text></item>
+  <item><text>5. Entry</text></item>
+  <item><text>6. Entry</text></item>
+  <item><text>7. Entry</text></item>
+  <item><text>8. Entry</text></item>
+  <item><text>9. Entry</text></item>
+</menubar>
+```

docs/docs1_6/objects/Menubar/setSelectedItem.md

@@ -0,0 +1,28 @@
+## setSelectedItem
+Sets the background and the foreground of the item which is currently selected
+
+#### Parameters: 
+1. `number|color` The background color which should be used
+2. `number|color` The text color which should be used
+
+#### Returns:
+1. `object` The object in use
+
+#### Usage:
+* Creates a default menubar with 4 entries and sets the selection background color to green.
+```lua
+local main = basalt.createFrame()
+local aMenubar = main:addMenubar()
+  :addItem("1. Entry")
+  :addItem("2. Entry",colors.yellow)
+  :addItem("3. Entry",colors.yellow,colors.green)
+  :addItem("4. Entry")
+  :setSelectedItem(colors.green, colors.red)
+```
+```xml
+<menubar selectionBG="green" selectionFG="red">
+  <item><text>1. Entry</text></item>
+  <item><text>2. Entry</text><bg>yellow</bg></item>
+  <item><text>2. Entry</text><bg>yellow</bg><fg>green</fg></item>
+</menubar>
+```

docs/docs1_6/objects/Menubar/setSpace.md

@@ -0,0 +1,27 @@
+## setSpace
+Sets the background and the foreground of the item which is currently selected
+
+#### Parameters: 
+1. `number` The space you want between the entries
+
+#### Returns:
+1. `object` The object in use
+
+#### Usage:
+* Creates a default menubar with 4 entries and sets the space to 3.
+```lua
+local main = basalt.createFrame()
+local aMenubar = main:addMenubar()
+  :addItem("1. Entry")
+  :addItem("2. Entry",colors.yellow)
+  :addItem("3. Entry",colors.yellow,colors.green)
+  :addItem("4. Entry")
+  :setSpace(3)
+```
+```xml
+<menubar selectionBG="green" selectionFG="red" space="3">
+  <item><text>1. Entry</text></item>
+  <item><text>2. Entry</text><bg>yellow</bg></item>
+  <item><text>2. Entry</text><bg>yellow</bg><fg>green</fg></item>
+</menubar>
+```