Dgs-dxcombobox: Difference between revisions

Revision as of 14:07, 20 May 2020

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

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

Main Functions

Properties

arrow

This property stores the arrow shader of the combo box.

dgsSetProperty(combobox,"arrow",arrow)

arrow: a shader.

alignment

Alignment of the caption text within the combo box.

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

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

autoHideAfterSelected

This property determines whether the drop down will be hide automatically after selected.

dgsSetProperty(combobox,"autoHideAfterSelected",autoHideAfterSelected)

autoHideAfterSelected: A bool indicates whether the drop down will be hide automatically after selected.

bgColor

This property determines the background color of the combo box (behind items).

dgsSetProperty(combobox,"bgColor",bgColor)

bgColor: An integer of the color that can be converted by tocolor.

bgImage

This property determines the background image of the combo box (behind items).

dgsSetProperty(combobox,"bgImage",bgImage)

bgImage: A material element that serves as the background image of the combo box (texture/shader/screen source/renderTarget).

buttonLen

This property stores the width of the arrow button.

dgsSetProperty(combobox,"buttonLen",{buttonLen,relative})

buttonLen: A float of the width of arrow button, which is affected by relative.
relative: If set to true, buttonLen will range from 0 to 1 relative to combo box's height, otherwise the buttonLen will be absolute pixels.

captionEdit

This property stores the caption edit when the caption is editable with dgsComboBoxSetEditEnabled.

dgsSetProperty(combobox,"captionEdit",captionEdit)

captionEdit: A dgs-dxedit element.

caption

This property stores the caption text of combo box.

dgsSetProperty(combobox,"caption",caption)

caption: A string of the caption text of the combo box.

clip

Whether the clip property is enabled (include caption text and item text). Learn More dxDrawText

dgsSetProperty(combobox,"clip",clip)

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

color

This property determines the color of the combo box (behind arrow).

dgsSetProperty(combobox,"color",color)

color: An integer of the color that can be converted by tocolor.

colorcoded

Whether the color code is enabled (include caption text and item text). Learn More dxDrawText

dgsSetProperty(combobox,"colorcoded",colorcoded)

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

font

This is equivalent to dgsSetFont/dgsGetFont. Learn More dxDrawText

dgsSetProperty(combobox,"font",font)

font: A string or a dx font element of the text font of the combo box.

scrollBarThick

This property determines the thickness of scroll bar.

dgsSetProperty(combobox,"scrollBarThick",scrollBarThick)

scrollBarThick: An integer of the thickness of scroll bar.

shadow

The shadow of the text of the combo box.

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

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

myBox

Combo box is composed by dgs-dxcombobox and dgs-dxcombobox-Box. This property stores the dgs-combobox-Box of dgs-dxcombobox.

dgsSetProperty(combobox,"myBox",myBox)

myBox: A dgs-dxcombobox-box element.

image

The image of combo box ( under arrow ).

dgsSetProperty(combobox,"image",image)

image: A texture/shader element of the image ofcombo box.

itemAlignment

Alignment of the item text within the combo box.

dgsSetProperty(combobox,"itemAlignment",{alignX,alignY})

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

itemTextPadding

This property determines the item text padding of combo box.

dgsSetProperty(combobox,"itemTextPadding",{paddingX,alignY})

paddingX : An integer of 2D x padding value.
paddingY : An integer of 2D y padding value.

itemColor

This property determines the 3 states' back ground colors of item.

dgsSetProperty(combobox,"itemColor",{colorNormal,colorHoving,colorSelected})

colorNormal: An integer of the color of the item (Normal State).
colorHoving: An integer of the color of the item (Hoving State).
colorSelected: An integer of the color of the item (Selected State).

itemData

This property stores item data.

dgsSetProperty(gridlist,"itemData",itemData)

columnData: A table stores all item data.

Item Structure

{
	 textColor	BackGround Image			BackGround Color			Text	
	{[-2]=color,	[-1]={normal,hovering,selected},	[0]={normal,hovering,selected},		text	},
	{[-2]=color,	[-1]={normal,hovering,selected},	[0]={normal,hovering,selected},		text	},
	{[-2]=color,	[-1]={normal,hovering,selected},	[0]={normal,hovering,selected},		text	},
	{	...												},
}
]]

itemImage

This property determines the 3 states' background image of item.

dgsSetProperty(combobox,"itemImage",{imageDefault,cimageHoving,imageSelected})

imageNormal: A texture of the image of the row (Normal State).
cimageHoving: A texture of the image of the row (Hoving State).
imageSelected: A texture of the image of the row (Selected State).

itemMoveOffset

This property stores the move offset of item that is used to render.

dgsSetProperty(combobox,"itemMoveOffset",itemMoveOffset)

itemMoveOffset: A float stores the move offset of item that is used to render.

itemTextColor

This property determines the color of the item text of the combo box.

dgsSetProperty(combobox,"itemTextColor",itemTextColor)

itemTextColor: An integer of the color that can be converted by tocolor.

itemTextSize

This property determines the scale of the item text of the combo box.

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

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

listState

This property stores the state of combo box which determines whether the combo box is opened(1) or closed(-1). See: dgsComboBoxGetState/dgsComboBoxSetState

dgsSetProperty(combobox,"listState",listState)

listState: An integer of the state of combo box.

moveHardness

This property determines how hard will the combo box moves when scrolling.

dgsSetProperty(combobox,"moveHardness",moveHardness)

moveHardness: A float determins how hard will the combo box moves when scrolling ( should be larger than 0, lower than 1 ).

scrollbar

This property stores the scroll bar of combo box.

dgsSetProperty(combobox,"scrollbar",scrollbar)

scrollbar: a dgs-dxscrollbar element.

select

This property stores the selected item of combo box.

dgsSetProperty(combobox,"select",select)

select: A integer of the index of selected item .

textColor

The color which can be translated by tocolor of the caption text of the combo box.

dgsSetProperty(combobox,"textColor",textColor)

textColor: An integer of the color of the text of the combo box.

textPadding

This property determines the caption text padding of combo box.

dgsSetProperty(combobox,"textPadding",{paddingX,alignY})

paddingX : An integer of 2D x padding value.
paddingY : An integer of 2D y padding value.

textBox

This property determines whether the caption of combo box is enabled or not.

dgsSetProperty(combobox,"textBox",textBox)

textBox: A bool indicates whether the caption of combo box is enabled or not.

wordbreak

Whether the word-break of capiton text is enabled or not. Learn More dxDrawText

dgsSetProperty(capiton ,"wordbreak",wordbreak)

wordbreak: If set to true, the text will wrap to a new line whenever it reaches the right side of the bounding box. If false, the text will always be completely on one line.

Property of dgs-dxcombobox-Box

myCombo

Combo box is composed by dgs-dxcombobox and dgs-dxcombobox-Box. This property stores the dgs-comboboxof dgs-dxcombobox-Box.

dgsSetProperty(myCombo,"myCombo",myCombo)

myComboyBox: A dgs-dxcombobox element.

@@ Line 8: / Line 8: @@
 ==Properties==
+===arrow===
+This property stores the arrow shader of the combo box.
+<syntaxhighlight lang="lua">dgsSetProperty(combobox,"arrow",arrow)</syntaxhighlight>
+*'''arrow:''' a shader.
 ===alignment===
 Alignment of the caption text within the combo box.
@@ Line 28: / Line 33: @@
 <syntaxhighlight lang="lua">dgsSetProperty(combobox,"bgImage",bgImage)</syntaxhighlight>
 *'''bgImage:''' A material element that serves as the background image of the combo box (texture/shader/screen source/renderTarget).
+===buttonLen===
+This property stores the width of the arrow button.
+<syntaxhighlight lang="lua">dgsSetProperty(combobox,"buttonLen",{buttonLen,relative})</syntaxhighlight>
+*'''buttonLen:''' A float of the width of arrow button, which is affected by '''relative'''.
+*'''relative:''' If set to ''true'', '''buttonLen''' will range from 0 to 1 relative to combo box's height, otherwise the '''buttonLen''' will be absolute pixels.
 ===captionEdit===
@@ Line 33: / Line 44: @@
 <syntaxhighlight lang="lua">dgsSetProperty(combobox,"captionEdit",captionEdit)</syntaxhighlight>
 *'''captionEdit:''' A dgs-dxedit element.
+===caption===
+This property stores the caption text of combo box.
+<syntaxhighlight lang="lua">dgsSetProperty(combobox,"caption",caption)</syntaxhighlight>
+*'''caption:''' A string of the caption text of the combo box.
 ===clip===
@@ Line 38: / Line 54: @@
 <syntaxhighlight lang="lua">dgsSetProperty(combobox,"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.
+===color===
+This property determines the color of the combo box (behind arrow).
+<syntaxhighlight lang="lua">dgsSetProperty(combobox,"color",color)</syntaxhighlight>
+*'''color:''' An integer of the color that can be converted by [[tocolor]].
 ===colorcoded===
@@ Line 67: / Line 88: @@
 *'''myBox:''' A dgs-dxcombobox-box element.
-===caption===
+===image===
-This property stores the caption text of combo box.
+The image of combo box ( under arrow ).
-<syntaxhighlight lang="lua">dgsSetProperty(combobox,"caption",caption)</syntaxhighlight>
+<syntaxhighlight lang="lua">dgsSetProperty(combobox,"image",image)</syntaxhighlight>
-*'''caption:''' A string of the caption text of the combo box.
+*'''image:''' A texture/shader element of the image ofcombo box.
 ===itemAlignment===
@@ Line 129: / Line 150: @@
 *'''scaleX:''' A float of the 2D X scale of the text of the item.
 *'''scaleY:''' A float of the 2D Y scale of the text of the item.
+===listState===
+This property stores the state of combo box which determines whether the combo box is opened(1) or closed(-1).
+See: [[dgsComboBoxGetState]]/[[dgsComboBoxSetState]]
+<syntaxhighlight lang="lua">dgsSetProperty(combobox,"listState",listState)</syntaxhighlight>
+*'''listState:''' An integer of the state of combo box.
 ===moveHardness===
@@ Line 134: / Line 161: @@
 <syntaxhighlight lang="lua">dgsSetProperty(combobox,"moveHardness",moveHardness)</syntaxhighlight>
 *'''moveHardness:''' A float determins how hard will the combo box moves when scrolling ( should be larger than 0, lower than 1 ).
+===scrollbar===
+This property stores the scroll bar of combo box.
+<syntaxhighlight lang="lua">dgsSetProperty(combobox,"scrollbar",scrollbar)</syntaxhighlight>
+*'''scrollbar:''' a dgs-dxscrollbar element.
+===select===
+This property stores the selected item of combo box.
+<syntaxhighlight lang="lua">dgsSetProperty(combobox,"select",select)</syntaxhighlight>
+*'''select:''' A integer of the index of selected item .
 ===textColor===