Dgs-dxselector

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

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

Main Functions

• dgsSetProperty
• dgsGetProperty

Properties

alignment

Alignment of the text within the selector.

The functions as follows are based on this property.

dgsSelectorSetHorizontalAlign/dgsSelectorGetHorizontalAlign

dgsSelectorSetVerticalAlign/dgsSelectorGetVerticalAlign

dgsSetProperty(selector,"alignment",{alignX,alignY})

• alignX: Horizontal alignment of the text within the selector. Can be "left", "center" or "right".
• alignY: Vertical alignment of the text within the selector. Can be "top", "center" or "bottom".

clip

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

dgsSetProperty(selector,"clip",clip)

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

colorcoded

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

dgsSetProperty(selector,"colorcoded",colorcoded)

• colorcoded: Set to true to enable embedded #FFFFFF color codes.

enableScroll

Enable/disable mouse wheel scroll items.

dgsSetProperty(selector,"enableScroll",enableScroll)

• enableScroll: A bool indicates whether to enable wheel scrolling on selector.

font

This is equivalent to dgsSetFont/dgsGetFont. Learn More dxDrawText

dgsSetProperty(selector,"font",font)

• font: A string or a dx font element of the text font of the selector.

isHorizontal

This proeprty determines whether the selector is horizontal or vertical.

dgsSetProperty(selector,"isHorizontal",isHorizontal)

• isHorizontal: A bool indicates whether the selector is horizontal or vertical.

isReversed

This property determines whether the selector is reversed ( mirrorred ).

dgsSetProperty(selector,"isReversed",isReversed)

• isReversed: A bool indicates whether the selector is reversed ( mirrorred ).

itemData

This property stores item data.

dgsSetProperty(selector,"itemData",itemData)

• itemData: A table stores all item data.

Data Structure:

{
	{text,alignment,color,colorcoded,sizex,sizey,font,translationTest,data,imageData},
	{text,alignment,color,colorcoded,sizex,sizey,font,translationTest,data,imageData},
	{text,alignment,color,colorcoded,sizex,sizey,font,translationTest,data,imageData},
}

itemTextColor

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

dgsSetProperty(selector,"itemTextColor",itemTextColor)

• itemTextColor: An integer of the color of the text of the selector.

itemTextSize

The scale of the item text of the selector. Learn More dxDrawText

dgsSetProperty(selector,"itemTextSize",{scaleX,scaleY})

• scaleX: A float of the 2D X scale of the item text of the selector.
• scaleY: A float of the 2D Y scale of the item text of the selector.

placeHolder

This property determines what text will be when there's no items in selector

dgsSetProperty(selector,"placeHolder",placeHolder)

• placeHolder: A string of the text of the placeHolder of the selector.

select

This property stores the selected item of the selector.

dgsSetProperty(selector,"select",select)

• select: A integer of the index of selected item .

selectorSize

This property determines the size of selector button.

dgsSetProperty(selector,"selectorSize",{selectorSizeX,selectorSizeY,relative})

• selectorSizeX: A float of the 2D X size of selector button, set to nil to use selectorSizeY.
• selectorSizeY: A float of the 2D Y size of selector button, set to nil to use selectorSizeX.
• relative: A bool of whether the selectorSize is relative to the size of selector or absolute pixels.

selectorText

The text of selector button of the selector.

dgsSetProperty(selector,"selectorText",{selectorTextLeft,selectorTextRight})

• selectorTextLeft: A string of the text of left selector button of the selector.
• selectorTextRight: A string of the text of right selector button of the selector.

selectorTextColor

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

dgsSetProperty(selector,"selectorTextColor",{normalColor,hoveringColor,clickedColor})

• normalColor: An integer of the color of the text of selector button of the selector ( neither hovering nor clicked by mouse ).
• hoveringColor: An integer of the color of the text of selector button of the selector which is hovering.
• clickedColor: An integer of the color of the text of selector button of the selector which is clicked.

selectorTextSize

The scale of the text of the button of the selector. Learn More dxDrawText

dgsSetProperty(selector,"selectorTextSize",{scaleX,scaleY})

• scaleX: A float of the 2D X scale of the text of the selector button of the selector.
• scaleY: A float of the 2D Y scale of the text of the selector button of the selector.

shadow

The shadow text of the selector.

dgsSetProperty(selector,"shadow",{offsetX,offsetY,color,outline})

• offsetX: A float of the 2D X offset of the shadow text of the selector.
• offsetY: A float of the 2D Y offset of the shadow text of the selector.
• color: An integer of the color of the shadow text of the selector.
• outline: A bool of the outline state of the shadow text.

subPixelPositioning

This property determines whether the subPixelPositioning is enabled or not, by default, it is disable. Learn More dxDrawText

subPixelPositioning Will make positioning and resizing animation looks better, but you should know, it may blur your static text with unrounded position and size, or alignment.

If you are using dgs animation library, you'd better turn this on.

dgsSetProperty(selector,"subPixelPositioning",subPixelPositioning)

• subPixelPositioning: A bool indicates whether to enable subPixelPositioning or not.

text

This is equivalent to dgsSetText/dgsGetText.

dgsSetProperty(selector,"text",text)

• text: A string of the text of the selector.

textColor

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

dgsSetProperty(selector,"textColor",textColor)

• textColor: An integer of the color of the text of the selector.

textSize

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

dgsSetProperty(selector,"textSize",{scaleX,scaleY})

• scaleX: A float of the 2D X scale of the text of the selector.
• scaleY: A float of the 2D Y scale of the text of the selector.

See Also

General Properties

• DGS General Basic Properties

Unique Properties For DGS Core Elements

• dgs-dx3dinterface
• dgs-dx3dimage
• dgs-dx3dtext
• dgs-dx3dline
• dgs-dxbutton
• dgs-dxcheckbox
• dgs-dxcombobox
• dgs-dxdetectarea
• dgs-dxedit
• dgs-dxgridlist
• dgs-dximage
• dgs-dxlabel
• dgs-dxline
• dgs-dxmemo
• dgs-dxprogressbar
• dgs-dxradiobutton
• dgs-dxscrollbar
• dgs-dxscrollpane
• dgs-dxselector
• dgs-dxswitchbutton
• dgs-dxtabpanel
• dgs-dxtab
• dgs-dxwindow