DgsCreateGridList

From Multi Theft Auto: Wiki

This function creates a grid list DGS element.

Syntax

element dgsCreateGridList( float x, float y, float width, float height, bool relative, [ element parent = nil, float columnHeight = 20, int bgcolor = 0xFFD2D2D2, int columntextcolor = 0xFF000000, int columncolor = 0xFFDCDCDC, int rowdefc = 0xFFC8C8C8, int rowhovc = 0xFF969696, int rowselc = 0xFF00ACF2, element bgimg = nil, element columnimage = nil, element rowdefi = nil, element rowhovi = nil, element rowseli = nil] )

Required Arguments

Example Dx Gridlist.
  • x: A float of the 2D x position of the window on a player's screen. This is affected by the relative argument.
  • y: A float of the 2D y position of the window on a player's screen. This is affected by the relative argument.
  • width: A float of the width of the window. This is affected by the relative argument.
  • height: A float of the height of the window. This is affected by the relative argument.
  • relative: This is whether sizes and positioning are relative. If this is true, then all x, y, width and height floats must be between 0 and 1, representing sizes relative to the parent.

Optional Arguments

NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use. For more information on optional arguments, see optional arguments.

  • parent: This is the parent that the DGS button is attached to. If the relative argument is true, sizes and positioning will be made relative to this parent. If the relative argument is false, positioning will be the number of offset pixels from the parent's origin. If no parent is passed, the parent will become the screen - causing positioning and sizing according to screen positioning.
  • columnHeight: A float of the height of the column.
  • bgcolor: An integer of the background color of the grid list.
  • columntextcolor: An integer of the color of the text of the column.
  • columncolor: An integer of the color of the column.
  • rowdefc: An integer of the color of the row ( no mouse enter and no mouse click ).
  • rowhovc: An integer of the color of the row of the button which your mouse is hovering .
  • rowselc: An integer of the color of the row of the button which is selected.
  • bgimg: A texture element of the background texture of the grid list.
  • columnimage: A texture element of the background texture of the column.
  • rowdefi: A texture element of the background texture of the row ( no mouse enter and no mouse click ).
  • rowhovi: A texture element of the background texture of the row of the button which your mouse is hovering .
  • rowseli: A texture element of the background texture of the row of the button which is selected.

Returns

Returns an element of the created gridlist if it was successfully created, false otherwise.

Example

Example: This example creates a player list on the right of the screen and fills it

DGS = exports.dgs

local playerList = DGS:dgsCreateGridList (346, 163, 433, 403, false )  --Create the grid list element
local column = DGS:dgsGridListAddColumn( playerList, "Player", 0.5 )  --Create a players column in the list
for id, player in ipairs(getElementsByType("player")) do
	local row = DGS:dgsGridListAddRow ( playerList )
	DGS:dgsGridListSetItemText ( playerList, row, column, getPlayerName ( player ) )
end 

See Also

Multi Language Supports

Animation

3D Interface

3D Text

Browser

Button

Check Box

Combo Box

Custom Renderer

Edit

Ellipse Detect Area [Deprecated]

Detect Area

Grid List

Image

Memo

Label

Progress Bar

Radio Button

Scroll Bar

Scroll Pane

Switch Button

Tab Panel

Window

Plugin

Blur Box

Color Picker

Canvas

Effect 3D

Media Browser

Mask

Nine Slice

Object Preview

QRCode

Rounded Rectangle