Dgs-dxedit: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
Line 10: Line 10:
===bgcolor===
===bgcolor===
This property determines the background color of the edit.
This property determines the background color of the edit.
<syntaxhighlight lang="lua">dgsSetProperty(edit,"bgcolor",bgcolor)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(edit,"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 edit.
This property determines the background image of the edit.
<syntaxhighlight lang="lua">dgsSetProperty(edit,"bgimage",bgimage)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(edit,"bgImage",bgImage)</syntaxhighlight>
*'''bgimage''' : A material element that serves as the background image of the edit (texture/shader/screen source/renderTarget).
*'''bgImage''' : A material element that serves as the background image of the edit (texture/shader/screen source/renderTarget).


===cursorpos===
===caretPos===
The position where the caret stays.
The position where the caret stays.
<syntaxhighlight lang="lua">dgsSetProperty(edit,"cursorpos",index)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(edit,"caretPos",index)</syntaxhighlight>
*'''index''' : An integer of the index of the text that the caret stays.
*'''index''' : An integer of the index of the text that the caret stays.


Line 33: Line 33:
*'''maxLength''' : An integer indicating the maximum number of characters that can be typed into the edit box.
*'''maxLength''' : An integer indicating the maximum number of characters that can be typed into the edit box.


===textcolor===
===textColor===
The color which can be translated by [[tocolor]] of the text of the edit.
The color which can be translated by [[tocolor]] of the text of the edit.
<syntaxhighlight lang="lua">dgsSetProperty(edit,"textcolor",textcolor)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(edit,"textColor",textColor)</syntaxhighlight>
*'''textcolor''' : An integer of the color of the text of the edit.
*'''textColor''' : An integer of the color of the text of the edit.


===textsize===
===textSize===
The scale of the text of the edit. ''Learn More [[dxDrawText]]''
The scale of the text of the edit. ''Learn More [[dxDrawText]]''
<syntaxhighlight lang="lua">dgsSetProperty(edit,"textsize",{scaleX,scaleY})</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(edit,"textSize",{scaleX,scaleY})</syntaxhighlight>
*'''scaleX''' : A float of the 2D X scale of the text of the edit.
*'''scaleX''' : A float of the 2D X scale of the text of the edit.
*'''scaleY''' : A float of the 2D Y scale of the text of the edit.
*'''scaleY''' : A float of the 2D Y scale of the text of the edit.
Line 54: Line 54:
*'''maskText''' : A string that the masked text will be.
*'''maskText''' : A string that the masked text will be.


===selectfrom===
===selectFrom===
The position from which the text is selected.
The position from which the text is selected.
<syntaxhighlight lang="lua">dgsSetProperty(edit,"selectfrom",{index,line})</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(edit,"selectFrom",{index,line})</syntaxhighlight>
*'''index''' : An integer of the index of the text that selected from.
*'''index''' : An integer of the index of the text that selected from.


Line 69: Line 69:
*'''posX''' : An integer indicates how many pixels of the text are moved to left.
*'''posX''' : An integer indicates how many pixels of the text are moved to left.


===cursorStyle===
===caretStyle===
This is equivalent to [[dgsEditSetCaretStyle]]/[[dgsEditGetCaretStyle]].
This is equivalent to [[dgsEditSetCaretStyle]]/[[dgsEditGetCaretStyle]].


Line 81: Line 81:


This is Text_
This is Text_
<syntaxhighlight lang="lua">dgsSetProperty(edit,"cursorStyle",cursorStyle)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(edit,"caretStyle",caretStyle)</syntaxhighlight>
*'''cursorStyle''' : An integer of the caret style of the edit.
*'''cursorStyle''' : An integer of the caret style of the edit.


===cursorThick===
===caretThick===
This property allows us to change the thickness of caret of the edit.
This property allows us to change the thickness of caret of the edit.
<syntaxhighlight lang="lua">dgsSetProperty(edit,"cursorThick",cursorThick)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(edit,"caretThick",caretThick)</syntaxhighlight>
*'''cursorThick''' : An integer of the thickness of the caret of the edit.
*'''caretThick''' : An integer of the thickness of the caret of the edit.


===cursorOffset===
===caretOffset===
The offset of the caret of the edit.
The offset of the caret of the edit.
<syntaxhighlight lang="lua">dgsSetProperty(edit,"cursorOffset",{offsetX,offsetY})</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(edit,"caretOffset",{offsetX,offsetY})</syntaxhighlight>
*'''offsetX''' : A float of the 2D X position offset of the caret of the edit.
*'''offsetX''' : A float of the 2D X position offset of the caret of the edit.
*'''offsetY''' : A float of the 2D Y position offset of the caret of the edit.
*'''offsetY''' : A float of the 2D Y position offset of the caret of the edit.
Line 110: Line 110:
*'''readOnlyCaretShow''' : A bool indicates whether the caret is shown or hidden when the edit is read-only.
*'''readOnlyCaretShow''' : A bool indicates whether the caret is shown or hidden when the edit is read-only.


===side===
===selectColor===
The border size of the edit.
<syntaxhighlight lang="lua">dgsSetProperty(edit,"side",side)</syntaxhighlight>
*'''side''' : A float of the border size of the edit.
 
===sidecolor===
The border color which can be translated by [[tocolor]] of the edit.
<syntaxhighlight lang="lua">dgsSetProperty(edit,"sidecolor",sidecolor)</syntaxhighlight>
*'''sidecolor''' : An integer of the color of the border of the edit.
 
===selectcolor===
The color which can be translated by [[tocolor]] of the rectangle of test selection of the edit.
The color which can be translated by [[tocolor]] of the rectangle of test selection of the edit.
<syntaxhighlight lang="lua">dgsSetProperty(edit,"selectcolor",selectcolor)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(edit,"selectColor",selectColor)</syntaxhighlight>
*'''selectcolor''' : An integer of the color of the rectangle of test selection of the edit.
*'''selectColor''' : An integer of the color of the rectangle of test selection of the edit.


===sideWhite===
===padding===
This property determines how far it is between the border of the edit and text.
This property determines the padding of the text.
<syntaxhighlight lang="lua">dgsSetProperty(edit,"sideWhite",sideWhite)</syntaxhighlight>
<syntaxhighlight lang="lua">dgsSetProperty(edit,"padding",{paddingX,paddingY})</syntaxhighlight>
*'''selectcolor''' : An integer indicates how far is it between the border of the edit and text.
*'''paddingX''' : An integer of 2D x padding value.
*'''paddingY''' : An integer of 2D y padding value.


===edit===
===edit===

Revision as of 12:20, 14 August 2018

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

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

Main Functions

Properties

bgcolor

This property determines the background color of the edit. 

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

bgImage

This property determines the background image of the edit. 

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

caretPos

The position where the caret stays. 

dgsSetProperty(edit,"caretPos",index)
  • index : An integer of the index of the text that the caret stays.

text

This is equivalent to dgsSetText/dgsGetText. 

dgsSetProperty(edit,"text",text)
  • text : A table of the text of the edit.( Because of multi lines, I use table instead of string )

maxLength

This is equivalent to dgsEditGetMaxLength/dgsEditSetMaxLength 

dgsSetProperty(edit,"maxLength",maxLength)
  • maxLength : An integer indicating the maximum number of characters that can be typed into the edit box.

textColor

The color which can be translated by tocolor of the text of the edit. 

dgsSetProperty(edit,"textColor",textColor)
  • textColor : An integer of the color of the text of the edit.

textSize

The scale of the text of the edit. Learn More dxDrawText 

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

masked

This is equivalent to dgsEditSetMasked/dgsEditGetMasked 

dgsSetProperty(edit,"masked",masked)
  • masked : A boolean value indicating whether masking is to be enabled or disabled.

maskText

This property determines what the masked text will be, and the default is "*". 

dgsSetProperty(edit,"maskText",maskText)
  • maskText : A string that the masked text will be.

selectFrom

The position from which the text is selected. 

dgsSetProperty(edit,"selectFrom",{index,line})
  • index : An integer of the index of the text that selected from.

font

This is equivalent to dgsSetFont/dgsGetFont. Learn More dxDrawText 

dgsSetProperty(edit,"font",font)

showPos

The min value of the x position of the text of the edit starts to show in the render target. ( I don't know how to explain it. XD ) 

dgsSetProperty(edit,"showPos",posX)
  • posX : An integer indicates how many pixels of the text are moved to left.

caretStyle

This is equivalent to dgsEditSetCaretStyle/dgsEditGetCaretStyle.

This property allows us to change the style of caret of the edit. ( 0 is "|"; 1 is "_" )

Example(0):

This is Text|

Example(1):

This is Text_ 

dgsSetProperty(edit,"caretStyle",caretStyle)
  • cursorStyle : An integer of the caret style of the edit.

caretThick

This property allows us to change the thickness of caret of the edit. 

dgsSetProperty(edit,"caretThick",caretThick)
  • caretThick : An integer of the thickness of the caret of the edit.

caretOffset

The offset of the caret of the edit. 

dgsSetProperty(edit,"caretOffset",{offsetX,offsetY})
  • offsetX : A float of the 2D X position offset of the caret of the edit.
  • offsetY : A float of the 2D Y position offset of the caret of the edit.

caretColor

This property determines the color of the caret 

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

readOnly

This is equivalent to dgsEditSetReadOnly/dgsEditGetReadOnly. 

dgsSetProperty(edit,"readOnly",readOnly)
  • readOnly : A bool indicates whether the edit is only readable.

readOnlyCaretShow

Whether the caret of edit will show/hide under read-only mode. 

dgsSetProperty(edit,"readOnlyCaretShow",readOnlyCaretShow)
  • readOnlyCaretShow : A bool indicates whether the caret is shown or hidden when the edit is read-only.

selectColor

The color which can be translated by tocolor of the rectangle of test selection of the edit. 

dgsSetProperty(edit,"selectColor",selectColor)
  • selectColor : An integer of the color of the rectangle of test selection of the edit.

padding

This property determines the padding of the text. 

dgsSetProperty(edit,"padding",{paddingX,paddingY})
  • paddingX : An integer of 2D x padding value.
  • paddingY : An integer of 2D y padding value.

edit

This property stores a gui-edit which is used to input characters. 

dgsSetProperty(edit,"edit",gedit)
  • gedit : A gui-edit.

renderTarget

This property stores a render target of the edit. 

dgsSetProperty(edit,"renderTarget",renderTarget)
  • renderTarget : A render target that is used to render the text.

enableTabSwitch

This property determines whether we can use the key "tab" to switch to another edit. 

dgsSetProperty(edit,"enableTabSwitch",enableTabSwitch)
  • enableTabSwitch : A bool indicates whether we can use the key tab to switch to another edit.

clearSelection

This property determines whether the text selection will be cleared when the edit blurs. 

dgsSetProperty(edit,"clearSelection",clearSelection)
  • clearSelection : A bool indicates whether the text selection will be cleared when the edit blurs.

caretHeight

This property determines what's the height of the caret. 

dgsSetProperty(edit,"caretHeight",caretHeight)
  • caretHeight : A bool indicates what's the height of the caret.

See Also

General Properties

Unique Properties For DGS Core Elements

Extra Properties For DGS Plugins

Retrieved from "https://wiki.multitheftauto.com/wiki/Dgs-dxedit?oldid=58080"