From bde46114892be8cfa12aedd267f2b07b83ec0303 Mon Sep 17 00:00:00 2001
From: Robert Jelic <36573031+NoryiE@users.noreply.github.com>
Date: Sun, 1 May 2022 22:10:31 +0200
Subject: [PATCH] Updated Object (markdown)
---
Object.md | 106 +++++++++++++++++++++++++++---------------------------
1 file changed, 53 insertions(+), 53 deletions(-)
diff --git a/Object.md b/Object.md
index ed20062..362ba3e 100644
--- a/Object.md
+++ b/Object.md
@@ -8,8 +8,8 @@ local mainFrame = basalt.createFrame("myFirstFrame"):show()
local button = mainFrame:addButton("myFirstButton")
button:show()
````
-**args:** -
-**returns:** the object
+**parameters:** -
+**returns:** self
## hide
hides the object
@@ -18,16 +18,16 @@ local mainFrame = basalt.createFrame("myFirstFrame"):show()
local button = mainFrame:addButton("myFirstButton"):setText("Close"):onClick(function() mainFrame:hide() end)
button:show()
````
-**args:** -
-**returns:** the object
+**parameters:** -
+**returns:** self
## setPosition
Changes the position relative to its parent frame
````lua
local mainFrame = basalt.createFrame("myFirstFrame"):setPosition(2,3)
````
-**args:** int x, int y[, "r"], "r" as third parameter means it will add x and y to current position instead of set it
-**returns:** the frame object
+**parameters:** number x, number y[, boolean relative], if relative is set to true it will add/remove instead of set x, y
+**returns:** self
@@ -36,24 +36,24 @@ Changes the object background color
````lua
local mainFrame = basalt.createFrame("myFirstFrame"):setBackground(colors.lightGray)
````
-**args:** int color
-**returns:** the object
+**parameters:** number color
+**returns:** self
## setForeground
Changes the object text color
````lua
local mainFrame = basalt.createFrame("myFirstFrame"):setForeground(colors.black)
````
-**args:** int color
-**returns:** the object
+**parameters:** number color
+**returns:** self
## setSize
Changes the object size
````lua
local mainFrame = basalt.createFrame("myFirstFrame"):setSize(15,5)
````
-**args:** width, length
-**returns:** the object
+**parameters:** number width, number length
+**returns:** self
## setFocus
sets the object to be the focused object
@@ -61,8 +61,8 @@ sets the object to be the focused object
local mainFrame = basalt.createFrame("myFirstFrame"):show()
local aButton = mainFrame:addButton("myFirstButton"):setFocus():show()
````
-**args:** -
-**returns:** the object
+**parameters:** -
+**returns:** self
## setZIndex
changes the z index (higher z index do have higher draw/event priority) 10 is more important than 5 or 1. You are also able to add multiple objects to the same z index, which means if you create a couple of buttons, you set their z index to 10, everything below 10 is less important, everything above 10 is more important. On the same z index: the last object which gets created is the most important one.
@@ -70,8 +70,8 @@ changes the z index (higher z index do have higher draw/event priority) 10 is mo
local mainFrame = basalt.createFrame("myFirstFrame"):show()
local aButton = mainFrame:addButton("myFirstButton"):setZIndex(1):show()
````
-**args:** index
-**returns:** the object
+**parameters:** number index
+**returns:** self
## setParent
changes the frame parent of that object
@@ -80,8 +80,8 @@ local mainFrame = basalt.createFrame("myFirstFrame"):show()
local aRandomFrame = basalt.createFrame("aRandomFrame"):show()
local aButton = mainFrame:addButton("myFirstButton"):onClick(function() aRandomFrame:setParent(mainFrame) end):show()
````
-**args:** frame object
-**returns:** the object
+**parameters:** frame object
+**returns:** self
## isFocused
returns if the object is currently the focused object of the parent frame
@@ -91,8 +91,8 @@ local mainFrame = basalt.createFrame("myFirstFrame"):show()
local aButton = mainFrame:addButton("myFirstButton"):show()
basalt.debug(aButton:isFocused()) -- shows true or false as a debug message
````
-**args:** -
-**returns:** true or false
+**parameters:** -
+**returns:** boolean
## getAnchorPosition
converts the x,y coordinates into the anchor coordinates of that object
@@ -102,8 +102,8 @@ local mainFrame = basalt.createFrame("myFirstFrame"):setSize(15,15):show()
local aButton = mainFrame:addButton("myFirstButton"):setAnchor("right","bottom"):setSize(8,1):setPosition(1,1):show()
basalt.debug(aButton:getAnchorPosition()) -- returns 7,14 (framesize - own size) instead of 1,1
````
-**args:** x,y or nothing - if nothing it uses the object x,y
-**returns:** converted coordinates
+**parameters:** number x, number y - or nothing (if nothing it uses the object's x, y)
+**returns:** number x, number y (converted)
## setAnchor
sets the anchor of that object
@@ -112,8 +112,8 @@ sets the anchor of that object
local mainFrame = basalt.createFrame("myFirstFrame"):setAnchor("right"):show()
local aButton = mainFrame:addButton("myFirstButton"):setAnchor("bottom","right"):setSize(8,1):setPosition(1,1):show()
````
-**args:** "left", "right", "top", "bottom" - doesn't matter which order
-**returns:** the object
+**parameters:** string sides - ("left", "right", "top", "bottom") you can stack positions like so ..:setAnchor("right", "bottom")
+**returns:** self
## getAbsolutePosition
converts the relative coordinates into absolute coordinates
@@ -122,8 +122,8 @@ local mainFrame = basalt.createFrame("myFirstFrame"):setPosition(3,3):show()
local aButton = mainFrame:addButton("myFirstButton"):setSize(8,1):setPosition(4,2):show()
basalt.debug(aButton:getAbsolutePosition()) -- returns 7,5 (frame coords + own coords) instead of 4,2
````
-**args:** x,y or nothing - if nothing it uses the object x,y
-**returns:** the object
+**parameters:** number x, number y - or nothing (if nothing it uses the object's x, y)
+**returns:** self
## setTextAlign
sets the align of the object (as example buttons)
@@ -131,8 +131,8 @@ sets the align of the object (as example buttons)
local mainFrame = basalt.createFrame("myFirstFrame"):show()
local aButton = mainFrame:addButton("myFirstButton"):setSize(12,3):setTextAlign("right", "center"):setText("Dont't..."):show()
````
-**args:** horizontal,vertical you can use "left", "center", "right"
-**returns:** the object
+**parameters:** string horizontal, string vertical - ("left", "center", "right")
+**returns:** self
## setValue
sets the value of that object (input, label, checkbox, textfield, scrollbar,...)
@@ -140,8 +140,8 @@ sets the value of that object (input, label, checkbox, textfield, scrollbar,...)
local mainFrame = basalt.createFrame("myFirstFrame"):show()
local aCheckbox = mainFrame:addCheckbox("myFirstCheckbox"):setValue(true):show()
````
-**args:** value (text,checked,number,...)
-**returns:** the object
+**parameters:** any value
+**returns:** self
## getValue
returns the currently saved value
@@ -150,18 +150,18 @@ local mainFrame = basalt.createFrame("myFirstFrame"):show()
local aCheckbox = mainFrame:addCheckbox("myFirstCheckbox"):setValue(true):show()
basalt.debug(aCheckbox:getValue()) -- returns true
````
-**args:**-
-**returns:** the value
+**parameters:**-
+**returns:** any value
## getHeight/getWidth
-returns the height or width of that object
+returns the height or width
````lua
local mainFrame = basalt.createFrame("myFirstFrame"):show()
local aButton = mainFrame:addButton("myFirstButton"):setSize(5,8):show()
basalt.debug(aButton:getHeight()) -- returns 8
````
-**args:**-
-**returns:** returns the height or the width
+**parameters:**-
+**returns:** number height/width
## isVisible
returns if the object is currently visible
@@ -170,8 +170,8 @@ local mainFrame = basalt.createFrame("myFirstFrame"):show()
local aButton = mainFrame:addButton("myFirstButton"):setSize(5,8):show()
basalt.debug(aButton:isVisible()) -- returns true
````
-**args:**-
-**returns:** returns the visible state of that object
+**parameters:**-
+**returns:** boolean
## getName
returns the given name of that object
@@ -179,8 +179,8 @@ returns the given name of that object
local mainFrame = basalt.createFrame("myFirstFrame"):show()
basalt.debug(mainFrame:getName()) -- returns myFirstFrame
````
-**args:**-
-**returns:** returns the name
+**parameters:**-
+**returns:** string name
# Object Events
These object events are available for all objects, if a object got some unique events, you can see them in their own category
@@ -191,8 +191,8 @@ creates a mouse_click event
local mainFrame = basalt.createFrame("myFirstFrame"):show()
local aButton = mainFrame:addButton("myFirstButton"):setSize(10,3):onClick(function(self,event,button,x,y) basalt.debug("Hellooww UwU") end):show()
````
-**args:** function
-**returns:** the object
+**parameters:** function func
+**returns:** self
## onClickUp
creates a click_up event
@@ -200,8 +200,8 @@ creates a click_up event
local mainFrame = basalt.createFrame("myFirstFrame"):show()
local aButton = mainFrame:addButton("myFirstButton"):setSize(10,3):onClickUp(function(self,event,button,x,y) basalt.debug("Byeeeee UwU") end):show()
````
-**args:** function
-**returns:** the object
+**parameters:** function func
+**returns:** self
## onMouseDrag
creates a mouse_drag event
@@ -209,8 +209,8 @@ creates a mouse_drag event
local mainFrame = basalt.createFrame("myFirstFrame"):show()
local aButton = mainFrame:addButton("myFirstButton"):setSize(10,3):onClickUp(function(self,event,button,x,y) basalt.debug("Byeeeee UwU") end):show()
````
-**args:** function
-**returns:** the object
+**parameters:** function func
+**returns:** self
## onChange
creates a change event (fires as soon as the value gets changed)
@@ -218,29 +218,29 @@ creates a change event (fires as soon as the value gets changed)
local mainFrame = basalt.createFrame("myFirstFrame"):show()
local aCheckbox = mainFrame:addCheckbox("myFirstCheckbox"):onChange(function(self) basalt.debug("i got changed into "..self:getValue()) end):show()
````
-**args:** function
-**returns:** the object
+**parameters:** function func
+**returns:** self
## onKey
creates a key(board) - event can be key or char
````lua
local mainFrame = basalt.createFrame("myFirstFrame"):onKey(function(self,event,key) basalt.debug("you clicked "..key) end):show()
````
-**args:** function
-**returns:** the object
+**parameters:** function func
+**returns:** self
## onLoseFocus
creates a lose focus event
````lua
local mainFrame = basalt.createFrame("myFirstFrame"):onLoseFocus(function(self) basalt.debug("please come back..") end):show()
````
-**args:** function
-**returns:** the object
+**parameters:** function func
+**returns:** self
## onGetFocus
creates a get focus event
````lua
local mainFrame = basalt.createFrame("myFirstFrame"):onGetFocus(function(self) basalt.debug("thanks!") end):show()
````
-**args:** function
-**returns:** the object
\ No newline at end of file
+**parameters:** function func
+**returns:** self
\ No newline at end of file