Dgs-dxgridlist: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
Line 8: Line 8:


==Properties==
==Properties==
===autoSort===
This property determines whether auto sort is enabled. ''See [[dgsGridListSetAutoSortEnabled]]/[[dgsGridListGetAutoSortEnabled]]''
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"autoSort",autoSort)</syntaxhighlight>
*'''autoSort:''' A bool of auto sort state.
===backgroundOffset===
This property determines the offset between the left border and row background.
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"backgroundOffset",backgroundOffset)</syntaxhighlight>
*'''backgroundOffset:''' An integer of the offset between the left border and row background.
===bgColor===
===bgColor===
This property determines the background color of the grid list.
This property determines the background color of the grid list.
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"bgColor",bgColor)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"bgColor",bgColor)</syntaxhighlight>
*'''bgColor''' : An integer of the color that can be converted by [[tocolor]].
*'''bgColor:''' An integer of the color that can be converted by [[tocolor]].


===bgImage===
===bgImage===
This property determines the background image of the grid list.
This property determines the background image of the grid list.
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"bgImage",bgImage)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"bgImage",bgImage)</syntaxhighlight>
*'''bgImage''' : A material element that serves as the background image of the grid list (texture/shader/screen source/renderTarget).
*'''bgImage:''' A material element that serves as the background image of the grid list (texture/shader/screen source/renderTarget).
 
===clip===
Whether the clip property is enabled or not. ''Learn More [[dxDrawText]]''
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"clip",clip)</syntaxhighlight>
*'''clip:''' If set to true, the parts of the text that don't fit within the bounding box will be cut off.


===columnImage===
===columnImage===
This property determines the background image of the column of the grid list.
This property determines the background image of the column of the grid list.
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"columnImage",columnImage)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"columnImage",columnImage)</syntaxhighlight>
*'''bgImage''' : A material element that serves as the background image of the column of the grid list (texture/shader/screen source/renderTarget).
*'''bgImage:''' A material element that serves as the background image of the column of the grid list (texture/shader/screen source/renderTarget).


===columnColor===
===columnColor===
This property determines the background color of the column of the grid list.
This property determines the background color of the column of the grid list.
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"columnColor",columnColor)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"columnColor",columnColor)</syntaxhighlight>
*'''columnColor''' : An integer of the color that can be converted by [[tocolor]].
*'''columnColor:''' An integer of the color that can be converted by [[tocolor]].


===columnTextColor===
===columnTextColor===
This property determines the color of the column text of the grid list.
This property determines the color of the column text of the grid list.
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"columnTextColor",columnTextColor)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"columnTextColor",columnTextColor)</syntaxhighlight>
*'''columnTextColor''' : An integer of the color that can be converted by [[tocolor]].
*'''columnTextColor:''' An integer of the color that can be converted by [[tocolor]].


===columnTextSize===
===columnTextSize===
This property determines the scale of the column text of the grid list.
This property determines the scale of the column text of the grid list.
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"columnTextSize",{scaleX,scaleY})</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"columnTextSize",{scaleX,scaleY})</syntaxhighlight>
*'''scaleX''' : A float of the 2D X scale of the text of the column.
*'''scaleX:''' A float of the 2D X scale of the text of the column.
*'''scaleY''' : A float of the 2D Y scale of the text of the column.
*'''scaleY:''' A float of the 2D Y scale of the text of the column.


===columnOffset===
===columnOffset===
This property determines the global offset between the left border and column text.
This property determines the global offset between the left border and column text.
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"columnOffset",columnOffset)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"columnOffset",columnOffset)</syntaxhighlight>
*'''columnOffset''' : An integer of offset of the column.
*'''columnOffset:''' An integer of offset of the column.


===columnData===
===columnData===
This property stores column data.
This property stores column data.
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"columnData",columnData)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"columnData",columnData)</syntaxhighlight>
*'''columnData''' : A table stores all column data.
*'''columnData:''' A table stores all column data.
'''Data Structure'''
'''Data Structure'''
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
Line 61: Line 76:
This property adjusts the offset of the text of the column, which can solve text misplacing caused by font.
This property adjusts the offset of the text of the column, which can solve text misplacing caused by font.
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"columnTextPosOffset",{offsetX,offsetY})</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"columnTextPosOffset",{offsetX,offsetY})</syntaxhighlight>
*'''offsetX''' : A float of the 2D X offset of the text of the column.
*'''offsetX:''' A float of the 2D X offset of the text of the column.
*'''offsetY''' : A float of the 2D Y offset of the text of the column.
*'''offsetY:''' A float of the 2D Y offset of the text of the column.


===columnRelative===
===columnRelative===
This property determines whether the column length is relative or not. ''See [[dgsGridListSetColumnRelative]]/[[dgsGridListGetColumnRelative]]''
This property determines whether the column length is relative or not. ''See [[dgsGridListSetColumnRelative]]/[[dgsGridListGetColumnRelative]]''
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"columnRelative",columnRelative)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"columnRelative",columnRelative)</syntaxhighlight>
*'''columnRelative''' : A bool of the relative state of the column length.
*'''columnRelative:''' A bool of the relative state of the column length.


===columnShadow===
===columnShadow===
The shadow text of the column.
The shadow text of the column.
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"columnShadow",{offsetX,offsetY,color})</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"columnShadow",{offsetX,offsetY,color})</syntaxhighlight>
*'''offsetX''' : A float of the 2D X offset of the shadow text of the column.
*'''offsetX:''' A float of the 2D X offset of the shadow text of the column.
*'''offsetY''' : A float of the 2D Y offset of the shadow text of the column.
*'''offsetY:''' A float of the 2D Y offset of the shadow text of the column.
*'''color''' : An integer of the color of the shadow text of the column.
*'''color:''' An integer of the color of the shadow text of the column.


===columnHeight===
===columnHeight===
This property determines the column height of the grid list.
This property determines the column height of the grid list.
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"columnHeight",columnHeight)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"columnHeight",columnHeight)</syntaxhighlight>
*'''columnHeight''' : An integer of column height of the grid list.
*'''columnHeight:''' An integer of column height of the grid list.
 
===colorcoded===
Whether the color code is enabled or not. ''Learn More [[dxDrawText]]''
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"colorcoded",colorcoded)</syntaxhighlight>
*'''colorcoded:''' Set to true to enable embedded #FFFFFF color codes.
 
===defaultColumnOffset===
This property determines offset of normal row column (is different from but works with columnOffset). ''See [[dgsGridListSetRowAsSection]]''
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"defaultColumnOffset",defaultColumnOffset)</syntaxhighlight>
*'''defaultColumnOffset:''' An integer of the offset of normal row column.
 
===font===
This is equivalent to [[dgsSetFont]]/[[dgsGetFont]]. ''Learn More [[dxDrawText]]''
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"font",font)</syntaxhighlight>
*'''font:''' A [[Element/DX_font|dx font element]] of the default text font of the gridlist.


===selectedColumn===
===leading===
This property stores the index of which column the cursor is hovering. ''See [[dgsGridListGetEnterColumn]]''
This property determines the space between rows.
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"selectedColumn",selectedColumn)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"leading",leading)</syntaxhighlight>
*'''columnHeight''' : Column Index.
*'''leading:''' How many pixels between rows
 
===multiSelection===
This property determines whether multi selection is enabled or not. ''See [[dgsGridListSetMultiSelectionEnabled]]/[[dgsGridListGetMultiSelectionEnabled]]''
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"multiSelection",multiSelection)</syntaxhighlight>
*'''multiSelection:''' A bool of the state of the multi selection.
 
===mode===
This property determines the render mode of grid list.
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"mode",mode)</syntaxhighlight>
*'''mode:''' A bool of the state of render mode. Detail:
**'''true:''' No render target mode (Crappy and have a lot of bugs but doesn't take video memory)
**'''false:''' Render target mode (Great quality but takes video memory)
 
===mouseSelectButton ===
This property allows which button on the mouse can select items of grid list.
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"mouseSelectButton",{canLeftButton,canMiddleButton,canRightButton})</syntaxhighlight>
*'''canLeftButton:''' A bool of whether left mouse button can select the grid list (default is true)
*'''canMiddleButton:''' A bool of whether middle mouse button can select the grid list (default is false)
*'''canRightButton:''' A bool of whether right mouse button can select the grid list (default is false)
 
===preSelect===
This property stores the item id the cursor is hovering on.
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"preSelect",{rowIndex,columnIndex})</syntaxhighlight>
*'''rowIndex:''' Row Index
*'''columnIndex:''' Column Index


===rowColor===
===rowColor===
Line 92: Line 147:
*'''colorHoving:''' An integer of the color of the row (Hoving State).
*'''colorHoving:''' An integer of the color of the row (Hoving State).
*'''colorSelected:''' An integer of the color of the row (Selected State).
*'''colorSelected:''' An integer of the color of the row (Selected State).
===rowImage===
This property determines the default 3 states' background image of row. ''See [[dgsGridListGetRowBackGroundImage]]/[[dgsGridListSetRowBackGroundImage]]''
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"rowImage",{imageDefault,cimageHoving,imageSelected})</syntaxhighlight>
*'''imageDefault:''' A texture of the image of the row (Default State).
*'''cimageHoving:''' A texture of the image of the row (Hoving State).
*'''imageSelected:''' A texture of the image of the row (Selected State).
===rowTextColor===
This property determines the default color of the row text of the grid list.
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"rowTextColor",rowTextColor)</syntaxhighlight>
*'''rowTextColor''' : An integer of the color that can be converted by [[tocolor]].
===rowTextPosOffset===
This property adjusts the offset of the text of the row, which can solve text misplacing caused by font.
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"rowTextPosOffset",{offsetX,offsetY})</syntaxhighlight>
*'''offsetX''' : A float of the 2D X offset of the text of the row.
*'''offsetY''' : A float of the 2D Y offset of the text of the row.
===rowTextSize===
This property determines the default scale of the row text of the grid list.
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"rowTextSize",{scaleX,scaleY})</syntaxhighlight>
*'''scaleX''' : A float of the 2D X scale of the text of the row.
*'''scaleY''' : A float of the 2D Y scale of the text of the row.


===rowData===
===rowData===
This property stores row data.
This property stores row data.
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"rowData",rowData)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"rowData",rowData)</syntaxhighlight>
*'''rowData''' : A table stores all row data.
*'''rowData:''' A table stores all row data.
'''Data Structure'''
'''Data Structure'''
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
Line 147: Line 178:
}
}
</syntaxhighlight>
</syntaxhighlight>
===rowShadow===
The shadow text of the row.
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"rowShadow",{offsetX,offsetY,color})</syntaxhighlight>
*'''offsetX''' : A float of the 2D X offset of the shadow text of the row.
*'''offsetY''' : A float of the 2D Y offset of the shadow text of the row.
*'''color''' : An integer of the color of the shadow text of the row.


===rowHeight===
===rowHeight===
This property determines the row height of the grid list.
This property determines the row height of the grid list.
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"rowHeight",rowHeight)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"rowHeight",rowHeight)</syntaxhighlight>
*'''rowHeight''' : An integer of row height of the grid list.
*'''rowHeight:''' An integer of row height of the grid list.


===sortEnabled===
===rowImage===
This property determines whether sort is enabled. ''See [[dgsGridListSetSortEnabled]]/[[dgsGridListGetSortEnabled]]''
This property determines the default 3 states' background image of row. ''See [[dgsGridListGetRowBackGroundImage]]/[[dgsGridListSetRowBackGroundImage]]''
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"sortEnabled",sortEnabled)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"rowImage",{imageDefault,cimageHoving,imageSelected})</syntaxhighlight>
*'''sortEnabled''' : A bool of sort state.
*'''imageDefault:''' A texture of the image of the row (Default State).
*'''cimageHoving:''' A texture of the image of the row (Hoving State).
*'''imageSelected:''' A texture of the image of the row (Selected State).
 
===rowSelect===
This property stores the selected rows.
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"rowSelect",data)</syntaxhighlight>
*'''data:''' the data.
'''Data Structure'''
<syntaxhighlight lang="lua">
{
[Column1] = {
Row1,
Row2,
...
},
[Column2] = {
Row1,
Row2,
...
},
...
}
</syntaxhighlight>
 
===rowShadow===
The shadow text of the row.
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"rowShadow",{offsetX,offsetY,color})</syntaxhighlight>
*'''offsetX:''' A float of the 2D X offset of the shadow text of the row.
*'''offsetY:''' A float of the 2D Y offset of the shadow text of the row.
*'''color:''' An integer of the color of the shadow text of the row.


===autoSort===
===rowTextColor===
This property determines whether auto sort is enabled. ''See [[dgsGridListSetAutoSortEnabled]]/[[dgsGridListGetAutoSortEnabled]]''
This property determines the default color of the row text of the grid list.
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"autoSort",autoSort)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"rowTextColor",rowTextColor)</syntaxhighlight>
*'''autoSort''' : A bool of auto sort state.
*'''rowTextColor:''' An integer of the color that can be converted by [[tocolor]].


===sortColumn===
===rowTextPosOffset===
This property determines target sort column. ''See [[dgsGridListSetSortColumn]]''
This property adjusts the offset of the text of the row, which can solve text misplacing caused by font.
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"sortColumn",sortColumn)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"rowTextPosOffset",{offsetX,offsetY})</syntaxhighlight>
*'''sortColumn''' : An integer of the specific column to be sorted by.
*'''offsetX:''' A float of the 2D X offset of the text of the row.
*'''offsetY:''' A float of the 2D Y offset of the text of the row.


===sectionColumnOffset===
===rowTextSize===
This property determines offset of section row column (is different from but works with columnOffset). ''See [[dgsGridListSetRowAsSection]]''
This property determines the default scale of the row text of the grid list.
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"sectionColumnOffset",sectionColumnOffset)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"rowTextSize",{scaleX,scaleY})</syntaxhighlight>
*'''sectionColumnOffset''' : An integer of the offset of section row column.
*'''scaleX:''' A float of the 2D X scale of the text of the row.
*'''scaleY:''' A float of the 2D Y scale of the text of the row.


===defaultColumnOffset===
===scrollBarState===
This property determines offset of normal row column (is different from but works with columnOffset). ''See [[dgsGridListSetRowAsSection]]''
This property forces the visibility of scroll bar. ''See [[dgsGridListSetScrollBarState]]/[[dgsGridListGetScrollBarState]]''
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"defaultColumnOffset",defaultColumnOffset)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"scrollBarState",{vertical,horizontal})</syntaxhighlight>
*'''defaultColumnOffset''' : An integer of the offset of normal row column.
*'''vertical:''' A bool of the state of the vertical scroll bar.
*'''horizontal:''' A bool of the state of the horizontal scroll bar.
**'''true:''' Force to be visible
**'''false:''' Force to be invisible
**'''nil:''' Auto


===scrollBarThick===
===scrollBarThick===
This property determines the thickness of scroll bar.
This property determines the thickness of scroll bar.
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"scrollBarThick",scrollBarThick)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"scrollBarThick",scrollBarThick)</syntaxhighlight>
*'''scrollBarThick''' : An integer of the thickness of scroll bar.
*'''scrollBarThick:''' An integer of the thickness of scroll bar.


===font===
===sectionColumnOffset===
This is equivalent to [[dgsSetFont]]/[[dgsGetFont]]. ''Learn More [[dxDrawText]]''
This property determines offset of section row column (is different from but works with columnOffset). ''See [[dgsGridListSetRowAsSection]]''
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"font",font)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"sectionColumnOffset",sectionColumnOffset)</syntaxhighlight>
*'''font''' : A [[Element/DX_font|dx font element]] of the default text font of the gridlist.
*'''sectionColumnOffset:''' An integer of the offset of section row column.


===sectionFont===
===sectionFont===
This property determines the font of the text of which row is in section mode. ''Learn More [[dxDrawText]]''
This property determines the font of the text of which row is in section mode. ''Learn More [[dxDrawText]]''
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"sectionFont",sectionFont)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"sectionFont",sectionFont)</syntaxhighlight>
*'''sectionFont''' : A [[Element/DX_font|dx font element]] of the text of which row is in section mode.
*'''sectionFont:''' A [[Element/DX_font|dx font element]] of the text of which row is in section mode.
 
===colorcoded===
Whether the color code is enabled or not. ''Learn More [[dxDrawText]]''
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"colorcoded",colorcoded)</syntaxhighlight>
*'''colorcoded''' : Set to true to enable embedded #FFFFFF color codes.


===selectionMode===
===selectionMode===
This property stores current selection mode of grid list. ''See [[dgsGridListSetSelectionMode]]/[[dgsGridListGetSelectionMode]]''
This property stores current selection mode of grid list. ''See [[dgsGridListSetSelectionMode]]/[[dgsGridListGetSelectionMode]]''
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"selectionMode",selectionMode)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"selectionMode",selectionMode)</syntaxhighlight>
*'''selectionMode''' : The mode of the selection.  Can be the following values:
*'''selectionMode:''' The mode of the selection.  Can be the following values:
**'''1:''' row selection
**'''1:''' row selection
**'''2:''' column selection
**'''2:''' column selection
**'''3:''' cell selection
**'''3:''' cell selection


===multiSelection===
===selectedColumn===
This property determines whether multi selection is enabled or not. ''See [[dgsGridListSetMultiSelectionEnabled]]/[[dgsGridListGetMultiSelectionEnabled]]''
This property stores the index of which column the cursor is hovering. ''See [[dgsGridListGetEnterColumn]]''
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"multiSelection",multiSelection)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"selectedColumn",selectedColumn)</syntaxhighlight>
*'''multiSelection''' : A bool of the state of the multi selection.
*'''columnHeight:''' Column Index.


===mode===
===sortColumn===
This property determines the render mode of grid list.
This property determines target sort column. ''See [[dgsGridListSetSortColumn]]''
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"mode",mode)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"sortColumn",sortColumn)</syntaxhighlight>
*'''mode''' : A bool of the state of render mode. Detail:
*'''sortColumn:''' An integer of the specific column to be sorted by.
**'''true''' : No render target mode (Crappy and have a lot of bugs but doesn't take video memory)
**'''false''' : Render target mode (Great quality but takes video memory)


===clip===
===sortEnabled===
Whether the clip property is enabled or not. ''Learn More [[dxDrawText]]''
This property determines whether sort is enabled. ''See [[dgsGridListSetSortEnabled]]/[[dgsGridListGetSortEnabled]]''
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"clip",clip)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"sortEnabled",sortEnabled)</syntaxhighlight>
*'''clip''' : If set to true, the parts of the text that don't fit within the bounding box will be cut off.
*'''sortEnabled:''' A bool of sort state.
 
===scrollBarState===
This property forces the visibility of scroll bar. ''See [[dgsGridListSetScrollBarState]]/[[dgsGridListGetScrollBarState]]''
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"scrollBarState",{vertical,horizontal})</syntaxhighlight>
*'''vertical''' : A bool of the state of the vertical scroll bar.
*'''horizontal''' : A bool of the state of the horizontal scroll bar.
**'''true''' : Force to be visible
**'''false''' : Force to be invisible
**'''nil''' : Auto
 
===backgroundOffset===
This property determines the offset between the left border and row background.
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"backgroundOffset",backgroundOffset)</syntaxhighlight>
*'''backgroundOffset''' : An integer of the offset between the left border and row background.
 
===rowSelect===
This property stores the selected rows.
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"rowSelect",data)</syntaxhighlight>
*'''data''' : the data.
'''Data Structure'''
<syntaxhighlight lang="lua">
{
[Column1] = {
Row1,
Row2,
...
},
[Column2] = {
Row1,
Row2,
...
},
...
}
</syntaxhighlight>
 
===preSelect===
This property stores the item id the cursor is hovering on.
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"preSelect",{rowIndex,columnIndex})</syntaxhighlight>
*'''rowIndex''' : Row Index
*'''columnIndex''': Column Index
 
===leading===
This property determines the space between rows.
<syntaxhighlight lang="lua">dgsSetProperty(gridlist,"leading",leading)</syntaxhighlight>
*'''leading''' : How many pixels between rows


==See Also==
==See Also==
{{DGSPROPERTIES}}
{{DGSPROPERTIES}}

Revision as of 11:25, 31 July 2019

DGS Properties is always used to change the gui style and make it more fantastic.

This page shows the properties of dgs-dxgridlist that you could use.

Main Functions

Properties

autoSort

This property determines whether auto sort is enabled. See dgsGridListSetAutoSortEnabled/dgsGridListGetAutoSortEnabled 

dgsSetProperty(gridlist,"autoSort",autoSort)
  • autoSort: A bool of auto sort state.

backgroundOffset

This property determines the offset between the left border and row background. 

dgsSetProperty(gridlist,"backgroundOffset",backgroundOffset)
  • backgroundOffset: An integer of the offset between the left border and row background.

bgColor

This property determines the background color of the grid list. 

dgsSetProperty(gridlist,"bgColor",bgColor)
  • bgColor: An integer of the color that can be converted by tocolor.

bgImage

This property determines the background image of the grid list. 

dgsSetProperty(gridlist,"bgImage",bgImage)
  • bgImage: A material element that serves as the background image of the grid list (texture/shader/screen source/renderTarget).

clip

Whether the clip property is enabled or not. Learn More dxDrawText 

dgsSetProperty(gridlist,"clip",clip)
  • clip: If set to true, the parts of the text that don't fit within the bounding box will be cut off.

columnImage

This property determines the background image of the column of the grid list. 

dgsSetProperty(gridlist,"columnImage",columnImage)
  • bgImage: A material element that serves as the background image of the column of the grid list (texture/shader/screen source/renderTarget).

columnColor

This property determines the background color of the column of the grid list. 

dgsSetProperty(gridlist,"columnColor",columnColor)
  • columnColor: An integer of the color that can be converted by tocolor.

columnTextColor

This property determines the color of the column text of the grid list. 

dgsSetProperty(gridlist,"columnTextColor",columnTextColor)
  • columnTextColor: An integer of the color that can be converted by tocolor.

columnTextSize

This property determines the scale of the column text of the grid list. 

dgsSetProperty(gridlist,"columnTextSize",{scaleX,scaleY})
  • scaleX: A float of the 2D X scale of the text of the column.
  • scaleY: A float of the 2D Y scale of the text of the column.

columnOffset

This property determines the global offset between the left border and column text. 

dgsSetProperty(gridlist,"columnOffset",columnOffset)
  • columnOffset: An integer of offset of the column.

columnData

This property stores column data. 

dgsSetProperty(gridlist,"columnData",columnData)
  • columnData: A table stores all column data.

Data Structure 

{
	{ text, Width, AllWidthFront, Alignment, color, colorcoded, sizeX, sizeY, font },
	{ text, Width, AllWidthFront, Alignment, color, colorcoded, sizeX, sizeY, font },
	{ text, Width, AllWidthFront, Alignment, color, colorcoded, sizeX, sizeY, font },
	...
}

columnTextPosOffset

This property adjusts the offset of the text of the column, which can solve text misplacing caused by font. 

dgsSetProperty(gridlist,"columnTextPosOffset",{offsetX,offsetY})
  • offsetX: A float of the 2D X offset of the text of the column.
  • offsetY: A float of the 2D Y offset of the text of the column.

columnRelative

This property determines whether the column length is relative or not. See dgsGridListSetColumnRelative/dgsGridListGetColumnRelative 

dgsSetProperty(gridlist,"columnRelative",columnRelative)
  • columnRelative: A bool of the relative state of the column length.

columnShadow

The shadow text of the column. 

dgsSetProperty(gridlist,"columnShadow",{offsetX,offsetY,color})
  • offsetX: A float of the 2D X offset of the shadow text of the column.
  • offsetY: A float of the 2D Y offset of the shadow text of the column.
  • color: An integer of the color of the shadow text of the column.

columnHeight

This property determines the column height of the grid list. 

dgsSetProperty(gridlist,"columnHeight",columnHeight)
  • columnHeight: An integer of column height of the grid list.

colorcoded

Whether the color code is enabled or not. Learn More dxDrawText 

dgsSetProperty(gridlist,"colorcoded",colorcoded)
  • colorcoded: Set to true to enable embedded #FFFFFF color codes.

defaultColumnOffset

This property determines offset of normal row column (is different from but works with columnOffset). See dgsGridListSetRowAsSection 

dgsSetProperty(gridlist,"defaultColumnOffset",defaultColumnOffset)
  • defaultColumnOffset: An integer of the offset of normal row column.

font

This is equivalent to dgsSetFont/dgsGetFont. Learn More dxDrawText 

dgsSetProperty(gridlist,"font",font)

leading

This property determines the space between rows. 

dgsSetProperty(gridlist,"leading",leading)
  • leading: How many pixels between rows

multiSelection

This property determines whether multi selection is enabled or not. See dgsGridListSetMultiSelectionEnabled/dgsGridListGetMultiSelectionEnabled 

dgsSetProperty(gridlist,"multiSelection",multiSelection)
  • multiSelection: A bool of the state of the multi selection.

mode

This property determines the render mode of grid list. 

dgsSetProperty(gridlist,"mode",mode)
  • mode: A bool of the state of render mode. Detail:
    • true: No render target mode (Crappy and have a lot of bugs but doesn't take video memory)
    • false: Render target mode (Great quality but takes video memory)

mouseSelectButton

This property allows which button on the mouse can select items of grid list. 

dgsSetProperty(gridlist,"mouseSelectButton",{canLeftButton,canMiddleButton,canRightButton})
  • canLeftButton: A bool of whether left mouse button can select the grid list (default is true)
  • canMiddleButton: A bool of whether middle mouse button can select the grid list (default is false)
  • canRightButton: A bool of whether right mouse button can select the grid list (default is false)

preSelect

This property stores the item id the cursor is hovering on. 

dgsSetProperty(gridlist,"preSelect",{rowIndex,columnIndex})
  • rowIndex: Row Index
  • columnIndex: Column Index

rowColor

This property determines the default 3 states' colors of row. See dgsGridListSetRowBackGroundColor/dgsGridListGetRowBackGroundColor 

dgsSetProperty(gridlist,"rowColor",{colorDefault,colorHoving,colorSelected})
  • colorDefault: An integer of the color of the row (Default State).
  • colorHoving: An integer of the color of the row (Hoving State).
  • colorSelected: An integer of the color of the row (Selected State).

rowData

This property stores row data. 

dgsSetProperty(gridlist,"rowData",rowData)
  • rowData: A table stores all row data.

Data Structure 

{

	[1] = {
		[-4] = columnOffset,				--columnOffset
		[-3] = {normal,hovering,selected},		--bgImage
		[-2] = true/false,				--selectable
		[-1] = true/false,				--clickable
		[0] = {normal,hovering,selected},		--bgColor
		[1] = {text,color,colorcoded,scalex,scaley,font,{image,color,imagex,imagey,imagew,imageh},unselectable,unclickable},	--Column 1
		[2] = {text,color,colorcoded,scalex,scaley,font,{image,color,imagex,imagey,imagew,imageh},unselectable,unclickable},	--Column 2
		...
	},		--Row 1
	[2] = {
		[-4] = columnOffset,				--columnOffset
		[-3] = {normal,hovering,selected},		--bgImage
		[-2] = true/false,				--selectable
		[-1] = true/false,				--clickable
		[0] = {normal,hovering,selected},		--bgColor
		[1] = {text,color,colorcoded,scalex,scaley,font,{image,color,imagex,imagey,imagew,imageh},unselectable,unclickable},	--Column 1
		[2] = {text,color,colorcoded,scalex,scaley,font,{image,color,imagex,imagey,imagew,imageh},unselectable,unclickable},	--Column 2
		...
	},		--Row 2
}

rowHeight

This property determines the row height of the grid list. 

dgsSetProperty(gridlist,"rowHeight",rowHeight)
  • rowHeight: An integer of row height of the grid list.

rowImage

This property determines the default 3 states' background image of row. See dgsGridListGetRowBackGroundImage/dgsGridListSetRowBackGroundImage 

dgsSetProperty(gridlist,"rowImage",{imageDefault,cimageHoving,imageSelected})
  • imageDefault: A texture of the image of the row (Default State).
  • cimageHoving: A texture of the image of the row (Hoving State).
  • imageSelected: A texture of the image of the row (Selected State).

rowSelect

This property stores the selected rows. 

dgsSetProperty(gridlist,"rowSelect",data)
  • data: the data.

Data Structure 

{
	[Column1] = {
		Row1,
		Row2,
		...
	},
	[Column2] = {
		Row1,
		Row2,
		...
	},
	...
}

rowShadow

The shadow text of the row. 

dgsSetProperty(gridlist,"rowShadow",{offsetX,offsetY,color})
  • offsetX: A float of the 2D X offset of the shadow text of the row.
  • offsetY: A float of the 2D Y offset of the shadow text of the row.
  • color: An integer of the color of the shadow text of the row.

rowTextColor

This property determines the default color of the row text of the grid list. 

dgsSetProperty(gridlist,"rowTextColor",rowTextColor)
  • rowTextColor: An integer of the color that can be converted by tocolor.

rowTextPosOffset

This property adjusts the offset of the text of the row, which can solve text misplacing caused by font. 

dgsSetProperty(gridlist,"rowTextPosOffset",{offsetX,offsetY})
  • offsetX: A float of the 2D X offset of the text of the row.
  • offsetY: A float of the 2D Y offset of the text of the row.

rowTextSize

This property determines the default scale of the row text of the grid list. 

dgsSetProperty(gridlist,"rowTextSize",{scaleX,scaleY})
  • scaleX: A float of the 2D X scale of the text of the row.
  • scaleY: A float of the 2D Y scale of the text of the row.

scrollBarState

This property forces the visibility of scroll bar. See dgsGridListSetScrollBarState/dgsGridListGetScrollBarState 

dgsSetProperty(gridlist,"scrollBarState",{vertical,horizontal})
  • vertical: A bool of the state of the vertical scroll bar.
  • horizontal: A bool of the state of the horizontal scroll bar.
    • true: Force to be visible
    • false: Force to be invisible
    • nil: Auto

scrollBarThick

This property determines the thickness of scroll bar. 

dgsSetProperty(gridlist,"scrollBarThick",scrollBarThick)
  • scrollBarThick: An integer of the thickness of scroll bar.

sectionColumnOffset

This property determines offset of section row column (is different from but works with columnOffset). See dgsGridListSetRowAsSection 

dgsSetProperty(gridlist,"sectionColumnOffset",sectionColumnOffset)
  • sectionColumnOffset: An integer of the offset of section row column.

sectionFont

This property determines the font of the text of which row is in section mode. Learn More dxDrawText 

dgsSetProperty(gridlist,"sectionFont",sectionFont)
  • sectionFont: A dx font element of the text of which row is in section mode.

selectionMode

This property stores current selection mode of grid list. See dgsGridListSetSelectionMode/dgsGridListGetSelectionMode 

dgsSetProperty(gridlist,"selectionMode",selectionMode)
  • selectionMode: The mode of the selection. Can be the following values:
    • 1: row selection
    • 2: column selection
    • 3: cell selection

selectedColumn

This property stores the index of which column the cursor is hovering. See dgsGridListGetEnterColumn 

dgsSetProperty(gridlist,"selectedColumn",selectedColumn)
  • columnHeight: Column Index.

sortColumn

This property determines target sort column. See dgsGridListSetSortColumn 

dgsSetProperty(gridlist,"sortColumn",sortColumn)
  • sortColumn: An integer of the specific column to be sorted by.

sortEnabled

This property determines whether sort is enabled. See dgsGridListSetSortEnabled/dgsGridListGetSortEnabled 

dgsSetProperty(gridlist,"sortEnabled",sortEnabled)
  • sortEnabled: A bool of sort state.

See Also

General Properties

Unique Properties For DGS Core Elements

Extra Properties For DGS Plugins

Retrieved from "https://wiki.multitheftauto.com/wiki/Dgs-dxgridlist?oldid=63552"