Changes

Jump to: navigation, search

Custom Field Type: Select One – Combo Box

1,008 bytes added, 18:23, 4 September 2018
<u>'''#REDIRECT [[Custom Field Display'''</u> Type: Select One - Dropdown List]]
==General Description==Displays as a set of values in a combo box. The [[User|user]] can select a single value. The size of scrolling window is controlled by the '''Edit ModeHeight Setting'''.
[[Image:Cf54.png]]
'''View Mode'''
[[Image:Cf55.png]] <u>'''General Description'''</u> ==Field Display==
Displays as a set of values in a combo box. The [[User|userImage:cf_socb_ex1.png]] can select a single value. The size of scrolling window is controlled by the <br />'' '''Height SettingSelect One - Combo Box'''. <u>field, in '''Edit Mode''Field Options'(above)''<br /u>
* '''Allow Empty''': Yes
* '''Default Text''': N/A
* '''Options''': Values
* '''Track Changes''': Yes
* '''Store To Value''': Yes
<u>'''Special Options for Field'''</u>
'''Values''' – the values to be used for each check box delimited by a semi-colon with no spaces.
<u>'''Field Validation'''</u>
* '''Type'''[[Image: Ncf_socb_ex2.png]]<br /A* '''JavaScript Validation''': N/A>* '''Message''': N/A* 'Select One - Combo Box''HTML Tag'field, in '': N/A <u>'View Mode''Field Formatting Options'(above)''<br /u>
* '''Height''': N/A '''Measure''': '''Default''':
* '''Width''': Yes '''Measure''': Pixels '''Default''': N/A
* '''Number Format''': N/A
* '''Style''': Yes
* '''Tool Tip''': Yes
<u>'''Notes'''</u>
Because the value in this field are restricted to [[Image:cf_socb_ex3.png]]<br />'' Setting the semi-colon delimited list in values for the '''ValuesSelect One - Combo Box''' field, the in '''General Settings''Allow Empty'(above)'' field has a slightly different behaviour than usual:
* If '''Allow Empty''' is checked, the first item listed in the '''Values''' list will be the default value for the field.
* If '''Allow Empty''' is not checked, the [[User|user]] cannot save the form without selecting a value other than the first item in the list. The first item should be either a space followed by a semi-colon (if you want the field to start out blank) or an instruction to the user such as -----Select One-----; Please choose; or similar.
{{FieldOptions}}
{{ParentField}}
* '''Values''': The values to be used for each check box delimited by a semi-colon with no spaces{{ToolTip}}{{HideFieldForNewRecord}}{{SmartFieldView}}  {{OptionsTab}}{{AllowEmpty}}{{AppearMandatory}}{{Searchable}}{{TrackChanges}}{{EnableMultipleSelect}}{{ShowDisplayValueInListViews}}{{ShowAsRadioButtons}}{{EnableKML}}{{DisableQuickEdit}}{{DisableFromGlobalSearch}}  {{Validation}}  {{Formatting}}{{CaptionStyle}} * '''Width''': Enables the user to set the width of the Lookup field in pixels{{CustomHTMLTag}}   ==Value Storage=={{ValueStoresTo}}  {{CFPermissionsTab}}   ==Configuration Best Practices=={{CFComboBoxBP}}   ==Referencing the Value==: <span style="font-size: medium;">'''@''fieldname''@''' </span>: <span style="font-size: medium;">'''@''fieldname''.combovalue@''' </span>or: <span style="font-size: medium;">'''@#''fieldid''#@''' </span>: <span style="font-size: medium;">'''@#''fieldid''.combovalue#@''' </span>When trying to reference the values of this custom field type, you must use '''@fieldname@''' or '''@fieldname.combovalue@''', depending on how the field is setup. Typically, you can use @fieldname@ but there is a special case where you must use @fieldname.combovalue@ when the values in the combo box are 1=Yes;2=No;3=Maybe.Using @fieldname@ will return the Yes, No, or Maybe. But using @fieldname.combovalue@ will return 1, 2, or 3. Using @''fieldname''.value@ will display the full HTML of the field; in other words, a dropdown box containing the values of the field will be displayed.<!-- ssRetiredOption ssRetiredOptions --> ==Notes=={{StoredValue}} * The first value listed will be the default value when a new record is created.* This technique is important when translating to other languages. The '''StoreValue''' must be the same in all languages. See [[Custom Field Language Settings|here]] for further information. {{AllowEmptyDescription}} {{RetiredOptions}} ==See Also==* [[Category:Custom FieldsField Language Settings]] {{CustomFieldPageFooter}}
0
edits

Navigation menu