DgsCreateGridList: Difference between revisions

Revision as of 03:37, 18 August 2017

Syntax

element dgsDxCreateGridList( 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. Not completed

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 1: This example creates a player list on the right of the screen and fills it

DGS = exports.dgs
	--Create the grid list element
	local playerList = DGS:dgsDxCreateGridList (346, 163, 433, 403, false )
	--Create a players column in the list
	local column = DGS:dgsDxGridListAddColumn( playerList, "Player", 0.5 )
		for id, player in ipairs(getElementsByType("player")) do
			local row = DGS:dgsDxGridListAddRow ( playerList )
			DGS:dgsDxGridListSetItemText ( playerList, row, column, getPlayerName ( player ), false, false )
end

Custom Cursor Functions

Multi Language Supports

Animation

3D Element

3D Interface

3D Line

3D Image

3D Text

Browser

dgsCreateBrowser

Button

Check Box

Combo Box

Custom Renderer

Edit

Detect Area

Drag'N Drop

Grid List

Image

Memo

Label

Layout

Line

Progress Bar

Radio Button

Scale Pane

Scroll Bar

Scroll Pane

Selector

Style

Switch Button

Tab Panel

Window

Basic Shape Plugins

Circle

Quadrilateral

Rounded Rectangle

Other Plugins

Blur Box

Canvas

dgsCreateCanvas

Chart

Color Picker

Effect 3D

Gradient

Mask

Media Browser

Nine Slice

Object Preview Supports

Paste Handler

QRCode

Remote Image

Screen Source

SVG

Tooltips

@@ Line 35: / Line 35: @@
 <syntaxhighlight lang="lua">
 DGS = exports.dgs
-function createPlayerList ()
 	--Create the grid list element
-	local playerList = DGS:dgsDxCreateGridList ( 0.80, 0.10, 0.15, 0.60, true )
+	local playerList = DGS:dgsDxCreateGridList (346, 163, 433, 403, false )
 	--Create a players column in the list
-	local column = DGS:dgsDxGridListAddColumn( playerList, "Player", 0.85 )
+	local column = DGS:dgsDxGridListAddColumn( playerList, "Player", 0.5 )
-	if ( column ) then --If the column has been created, fill it with players
 		for id, player in ipairs(getElementsByType("player")) do
 			local row = DGS:dgsDxGridListAddRow ( playerList )
 			DGS:dgsDxGridListSetItemText ( playerList, row, column, getPlayerName ( player ), false, false )
-		end
+end
-	end
-end
 </syntaxhighlight>
 ==See Also==
 {{DGSFUNCTIONS}}