View source for Astrath:createGridList

= DxGridlist:new = {{Client function}} {{FuncDef|element DxGridlist:new ( float posX, float posY, float width, float height, element parent, boolean relative, table columnSize, string font, float fontSize, table color, table headColor, table hoverColor, table activeColor, table scrollColor, table scrollBGColor )}}

'''Description:'''
Creates a new DX-based gridlist element. Gridlists display rows and columns of data, support scrolling, hover effects, row selection, and customizable colors and fonts. Each gridlist instance is automatically registered in the DX library.

'''Parameters:'''
* posX, posY (float) – Position on screen.
* width, height (float) – Size of the gridlist.
* parent (element) – Parent DX element to attach this gridlist to (optional).
* relative (boolean) – Position relative to parent (optional).
* columnSize (table / number / 'auto') – Width of columns, can be 'auto' to divide evenly.
* font (string) – Font used for text (optional, default: "default-bold").
* fontSize (float) – Font size multiplier (optional, default: 1).
* color, headColor, hoverColor, activeColor (table / tocolor) – Main, header, hover, and active row colors (optional).
* scrollColor, scrollBGColor (table / tocolor) – Scrollbar colors (optional).

'''Returns:'''
: Returns the newly created DxGridlist element.

'''Methods:'''
{| class="wikitable" style="width:100%; border:none;"
! Method !! Description
|-
| Ath:destroy() || Destroys the gridlist and all its child elements.
|-
| Ath:setVisible(boolean) || Shows or hides the gridlist.
|-
| Ath:setEnabled(boolean) || Enables or disables the gridlist for interaction.
|-
| Ath:addColumn(title, textAlign, columnSize) || Adds a new column with optional alignment and width.
|-
| Ath:addRow(...) || Adds a new row with the given items.
|-
| Ath:clear() || Clears all rows from the gridlist.
|-
| Ath:setColumnTitle(idOrName, newTitle) || Changes the title of a column by ID or name.
|-
| Ath:setItemText(columnID, rowID, text) || Sets the text of a specific cell.
|-
| Ath:getItemText(columnID, rowID) || Returns the text of a specific cell.
|-
| Ath:getColumnCount() || Returns the total number of columns.
|-
| Ath:getRowCount() || Returns the total number of rows.
|-
| Ath:removeColumn(columnID) || Removes a column by its ID.
|-
| Ath:removeRow(rowID) || Removes a row by its ID.
|-
| Ath:onScrollDown() || Scrolls the list down by one row.
|-
| Ath:onScrollUp() || Scrolls the list up by one row.
|-
| Ath:getRowText(columnID, rowID) || Returns the text of a cell at a given row and column.
|-
| Ath:getSelectedRowID() || Returns the currently selected row ID.
|-
| Ath:getSelectedRowItem() || Returns all items in the currently selected row.
|-
| Ath:setSelectedRowID(id) || Sets the selected row by ID.
|-
| Ath:addChildDxElement(element) || Adds a child element to the gridlist.
|-
| Ath:setHoverable(boolean) || Enables or disables hover effect.
|-
| Ath:setColor(r, g, b, a, type) || Sets colors for main, hover, header, active, or scroll elements.
|}

'''Example:'''
<syntaxhighlight lang="lua">
-- Create a gridlist at position 200x150 with size 400x300
local myGrid = DxGridlist:new(200, 150, 400, 300)

-- Add columns
myGrid:addColumn("ID", "center", 0.1)
myGrid:addColumn("Name", "left", 0.45)
myGrid:addColumn("Score", "right", 0.45)

-- Add rows
myGrid:addRow(1, "Alice", 95)
myGrid:addRow(2, "Bob", 88)
myGrid:addRow(3, "Charlie", 76)

-- Set selected row
myGrid:setSelectedRowID(2)

-- Change main color
myGrid:setColor(50, 50, 50, 255, "mainColor")
</syntaxhighlight>

'''See also:'''
* [[Astrath]] – Main library page
* [[DxButton:new]] – Page for button element reference
* [[DxCombobox:new]] – Page for combobox element reference
* [[onClientRender]] – Event used to render DX elements