lbSetCurSel: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(merged command variations)
m (Some wiki formatting)
 
(69 intermediate revisions by 15 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| ofp |= Game name
|game1= ofp
|version1= 1.75


|1.5|= Game version
|game2= ofpe
|version2= 1.00


|arg= local |= Arguments in MP
|game3= arma1
|version3= 1.00


|eff= local |= Effects in MP
|game4= arma2
____________________________________________________________________________________________
|version4= 1.00


| Selects the item with the given index of the listbox or combobox with id idc of the topmost user [[dialog]]. |= Description
|game5= arma2oa
____________________________________________________________________________________________
|version5= 1.50


| '''lbSetCurSel''' [idc, index] |= Syntax
|game6= tkoh
|p1= [idc, index]: [[Array]] |= Parameter 1
|version6= 1.00
|p2= idc: [[Number]] of control |= Parameter 2
|p3= index: [[Number]] |= Parameter 3
| [[Nothing]] |= Return value


|s2= control '''lbSetCurSel''' index |= Syntax
|game7= arma3
|p21= control: [[Control]] |= Parameter 1
|version7= 0.50
|p22= index: [[Number]] |= Parameter 2
|r2= [[Nothing]] |= Return value
____________________________________________________________________________________________
 
|x1= <pre>lbSetCurSel [101, 0]</pre> |= Example 1
____________________________________________________________________________________________


| [[lbCurSel]] |= See also
|gr1= GUI Control - ListBox


|descr= Selects the item with the given index in the listbox, listnbox, combobox, xcombobox, xlistbox<br>
{{Feature|important|'''The following only applies to the {{Link|#Syntax 2|Alternative Syntax}} when used with [[CT_LISTBOX]] and [[CT_LISTNBOX]].'''<br>
To deselect all entries, use -1: <sqf inline>_ctrl lbSetCurSel -1;</sqf> For listbox of style LB_MULTI use [[lbSetSelected]] instead.<br>
[[CT_COMBO]] does not allow deselecting entries, it will instead select the first one as it is not a combobox usual behaviour.
If you really need to deselect a combobox, see {{Link|#Notes|DreadedEntity's note}}.
}}
}}


<h3 style="display:none">Notes</h3>
|s1= [[lbSetCurSel]] [idc, index]
<dl class="command_description">
<!-- Note Section BEGIN -->


<!-- Note Section END -->
|p1= idc: [[Number]] - control's IDC
</dl>


<h3 style="display:none">Bottom Section</h3>
|p2= index: [[Number]]
[[Category:Scripting Commands|LBSETCURSEL]]
 
[[Category:Scripting Commands OFP 1.96|LBSETCURSEL]]
|r1= [[Nothing]]
[[Category:Scripting Commands ArmA|LBSETCURSEL]]
 
[[Category:Command_Group:_GUI_Control|{{uc:{{PAGENAME}}}}]]
|s2= control [[lbSetCurSel]] index
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
 
|p21= control: [[Control]]
 
|p22= index: [[Number]]
 
|r2= [[Nothing]]
 
|x1= <sqf>lbSetCurSel [101, 0];</sqf>
 
|x2= <sqf>_control lbSetCurSel 0;</sqf>
 
|seealso= [[lbCurSel]]
}}
 
{{Note
|user= DreadedEntity
|timestamp= 20141129234000
|text= '''Prior to ArmA 1.90''' lbSetCurSel -1 had no effect while the listbox was populated. You needed to use [[lbClear]] first, then lbSetCurSel -1, then re-populate the listbox.
}}
 
{{Note
|user= Longbow
|timestamp= 20150301183700
|text= Keep in mind that running this command will fire the 'onLBSelChanged' event handler.
}}

Latest revision as of 16:43, 27 July 2023

Hover & click on the images for description

Description

Description:
Selects the item with the given index in the listbox, listnbox, combobox, xcombobox, xlistbox
The following only applies to the Alternative Syntax when used with CT_LISTBOX and CT_LISTNBOX.

To deselect all entries, use -1: _ctrl lbSetCurSel -1; For listbox of style LB_MULTI use lbSetSelected instead.
CT_COMBO does not allow deselecting entries, it will instead select the first one as it is not a combobox usual behaviour.

If you really need to deselect a combobox, see DreadedEntity's note.
Groups:
GUI Control - ListBox

Syntax

Syntax:
lbSetCurSel [idc, index]
Parameters:
idc: Number - control's IDC
index: Number
Return Value:
Nothing

Alternative Syntax

Syntax:
control lbSetCurSel index
Parameters:
control: Control
index: Number
Return Value:
Nothing

Examples

Example 1:
lbSetCurSel [101, 0];
Example 2:
_control lbSetCurSel 0;

Additional Information

See also:
lbCurSel

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note
DreadedEntity - c
Posted on Nov 29, 2014 - 23:40 (UTC)
Prior to ArmA 1.90 lbSetCurSel -1 had no effect while the listbox was populated. You needed to use lbClear first, then lbSetCurSel -1, then re-populate the listbox.
Longbow - c
Posted on Mar 01, 2015 - 18:37 (UTC)
Keep in mind that running this command will fire the 'onLBSelChanged' event handler.