Basalt/Dropdown.md at 7c1f94015a5603e459366b17eecb8430faaed7cd

Files

Robert Jelic bb1b1beb79 Basalt 1.7 Update

- New Objects (Flexbox, Graph, Treeview)
- Pluginsystem to add/remove functionality
- Reworked the entire Object system, instead of one big Object Class we have multiple classes: Object, VisualObject, ChangeableObject
- Instead of one big Frame Class we have multiple Frame Classes: BaseFrame, Frame, MovableFrame, ScrollableFrame, MonitorFrame, Flexbox
- Removed the Animation Object, and added a animation plugin instead
- Removed the Graphic Object and merged it's functionality with the image object
- Updated currently existing objects

2023-04-30 17:05:34 +02:00

8.0 KiB

Raw Blame History

Dropdowns are objects where the user can click on a button, this will open a list where the user can choose from.

If you want to access values inside items this is how the table for single items is made (just a example):

item = {
  text="1. Entry", 
  bgCol=colors.black, 
  fgCol=colors.white
  args = {}
}

Remember Dropdown also inherits from Object

addItem

Adds a item into the dropdown

Parameters:

string The entry name
number|color unique default background color - optional
number|color unique default text color - optional
any any value - you could access this later in a :onChange() event (you need to use :getValue()) - optional

Returns:

object The object in use

Usage:

Creates a default dropdown with 3 entries

local mainFrame = basalt.createFrame()
local aDropdown = mainFrame:addDropdown()
aDropdown:addItem("1. Entry")
aDropdown:addItem("2. Entry",colors.yellow)
aDropdown:addItem("3. Entry",colors.yellow,colors.green)

<dropdown>
  <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>
</dropdown>

removeItem

Removes a item from the dropdown

Parameters:

number The index which should get removed

Returns:

object The object in use

Usage:

Creates a default dropdown with 3 entries and removes the second one.

local mainFrame = basalt.createFrame()
local aDropdown = mainFrame:addDropdown()
aDropdown:addItem("1. Entry")
aDropdown:addItem("2. Entry",colors.yellow)
aDropdown:addItem("3. Entry",colors.yellow,colors.green)
aDropdown:removeItem(2)

editItem

Edits a item from the dropdown

Parameters:

number The index which should be edited
string The new item name
number the new item background color - optional
number The new item text color - optional
any New additional information - optional

Returns:

object The object in use

Usage:

Creates a default dropdown with 3 entries and edits the second one.

local mainFrame = basalt.createFrame()
local aDropdown = mainFrame:addDropdown()
aDropdown:addItem("1. Entry")
aDropdown:addItem("2. Entry",colors.yellow)
aDropdown:addItem("3. Entry",colors.yellow,colors.green)
aDropdown:editItem(2, "Still 2. Entry", colors.red)

getItem

Returns a item by index

Parameters:

number The index which should be returned

Returns:

table The item table example: {text="1. Entry", bgCol=colors.black, fgCol=colors.white}

Usage:

Creates a default dropdown with 3 entries and edits the second one.

local mainFrame = basalt.createFrame()
local aDropdown = mainFrame:addDropdown()
aDropdown:addItem("1. Entry")
aDropdown:addItem("2. Entry",colors.yellow)
aDropdown:addItem("3. Entry",colors.yellow,colors.green)
basalt.debug(aDropdown:getItem(2).text)

getItemCount

Returns the current item count

Returns:

number The item list count

Usage:

Creates a default dropdown with 3 entries and prints the current item count.

local mainFrame = basalt.createFrame()
local aDropdown = mainFrame:addDropdown()
aDropdown:addItem("1. Entry")
aDropdown:addItem("2. Entry",colors.yellow)
aDropdown:addItem("3. Entry",colors.yellow,colors.green)
basalt.debug(aDropdown:getItemCount())

getAll

Returns all items as table

Returns:

table All items

Usage:

Creates a default menubar with 3 entries and prints a table.

local mainFrame = basalt.createFrame()
local aDropdown = mainFrame:addDropdown()
aDropdown:addItem("1. Entry")
aDropdown:addItem("2. Entry",colors.yellow)
aDropdown:addItem("3. Entry",colors.yellow,colors.green)
basalt.debug(aDropdown:getAll())

selectItem

selects a item in the dropdown (same as a player would click on a item)

Parameters:

number The index which should get selected

Returns:

object The object in use

Usage:

Creates a default dropdown with 3 entries and selects the second entry.

local mainFrame = basalt.createFrame()
local aDropdown = mainFrame:addDropdown()
aDropdown:addItem("1. Entry")
aDropdown:addItem("2. Entry",colors.yellow)
aDropdown:addItem("3. Entry",colors.yellow,colors.green)
aDropdown:selectItem(2)

clear

Removes all items.

Returns:

object The object in use

Usage:

Creates a default dropdown with 3 entries and removes them immediatley. Which makes no sense.

local mainFrame = basalt.createFrame()
local aDropdown = mainFrame:addDropdown()
aDropdown:addItem("1. Entry")
aDropdown:addItem("2. Entry",colors.yellow)
aDropdown:addItem("3. Entry",colors.yellow,colors.green)
aDropdown:clear()

getItemIndex

returns the item index of the currently selected item

Returns:

number The current index

Usage:

Creates a default dropdown with 3 entries selects the second entry and prints the currently selected index.

local mainFrame = basalt.createFrame()
local aDropdown = mainFrame:addDropdown()
aDropdown:addItem("1. Entry")
aDropdown:addItem("2. Entry",colors.yellow)
aDropdown:addItem("3. Entry",colors.yellow,colors.green)
aDropdown:selectItem(2)
basalt.debug(aDropdown:getItemIndex())

setSelectedItem

Sets the background and the foreground of the item which is currently selected

Parameters:

number|color The background color which should be used
number|color The text color which should be used

Returns:

object The object in use

Usage:

Creates a default dropdown with 4 entries and sets the selection background color to green.

local mainFrame = basalt.createFrame()
local aDropdown = mainFrame:addDropdown()
aDropdown:addItem("1. Entry")
aDropdown:addItem("2. Entry",colors.yellow)
aDropdown:addItem("3. Entry",colors.yellow,colors.green)
aDropdown:addItem("4. Entry")
aDropdown:setSelectedItem(colors.green, colors.red)

<dropdown 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>
</dropdown>

setOffset

Sets the offset of the dropdown (the same as you would scroll) - default is 0

Parameters:

number The offset value

Returns:

object The object in use

Usage:

Creates a default dropdown with 6 entries and sets the offset to 3.

local mainFrame = basalt.createFrame()
local aDropdown = mainFrame:addDropdown()
      :addItem("1. Entry")
      :addItem("2. Entry")
      :addItem("3. Entry")
      :addItem("4. Entry")
      :addItem("5. Entry")
      :addItem("6. Entry")
      :setOffset(3)

<dropdown 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>
</dropdown>

getOffset

Returns the current index offset

Returns:

number offset value

Usage:

Creates a default dropdown with 6 entries and sets the offset to 3, also prints the current offset.

local mainFrame = basalt.createFrame()
local aDropdown = mainFrame:addDropdown()
      :addItem("1. Entry")
      :addItem("2. Entry")
      :addItem("3. Entry")
      :addItem("4. Entry")
      :addItem("5. Entry")
      :addItem("6. Entry")
      :setOffset(3)
basalt.debug(aDropdown:getOffset())

setDropdownSize

Sets the size of the opened dropdown

Parameters:

number The width value
number The height value

Returns:

object The object in use

Usage:

Creates a default dropdown, adds 3 entries and sets the dropdown size to 15w, 8h

local mainFrame = basalt.createFrame()
local aDropdown = mainFrame:addDropdown():setDropdownSize(15,8)
aDropdown:addItem("1. Entry")
aDropdown:addItem("2. Entry")
aDropdown:addItem("3. Entry")

<dropdown dropdownWidth="15" dropdownHeight="8">
  <item><text>1. Entry</text></item>
  <item><text>2. Entry</text></item>
  <item><text>3. Entry</text></item>
</dropdown>

8.0 KiB Raw Blame History

addItem

Parameters:

Returns:

Usage:

removeItem

Parameters:

Returns:

Usage:

editItem

Parameters:

Returns:

Usage:

getItem

Parameters:

Returns:

Usage:

getItemCount

Returns:

Usage:

getAll

Returns:

Usage:

selectItem

Parameters:

Returns:

Usage:

clear

Returns:

Usage:

getItemIndex

Returns:

Usage:

setSelectedItem

Parameters:

Returns:

Usage:

setOffset

Parameters:

Returns:

Usage:

getOffset

Returns:

Usage:

setDropdownSize

Parameters:

Returns:

Usage:

8.0 KiB

Raw Blame History