GnDropDown

Inherited classes

View

Android class type

Spinner

Child elements

EditText, Button

Widget XML tag

<com.ginstr.widgets.GnDropDown>

Widget provides the entry of dropdown values.

GnDropDown has two ways of functioning. It can receive values either from local resources or from the database. When it’s connected to a database it needs to have a definition of the data. See action for fill dropdown.

XML Attributes Description

Note: An attribute marked with asterisk (*) is a mandatory parameter when creating widget.

Attribute	Description
gn:s_sourceType*	Sets source for data load into dropdown. If the attribute is omitted it sets database as source
gn:singleItemMode	Enables table with single row to be set as source
gn:data_queryType	If queries.xml dbRequest that is used for populate dropdown defines query keys, then this attribute can be used to sort the query result
gn:textColor	Changes color of zero item
gn:s_ZeroItemText	Sets text of choice for zero item of the dropdown
gn:s_title	Adds title to selection box of dropdown which is displayed after click on dropdown
gn:s_dataFilters	GnDropdown supports filtering like GnListView, please read here how to use filters.
gn:s_sortColumn	Defines column from associated dbRequest used to sort dropdown data
gn:s_sortOrder	Toggles sort order between ascending & descending provided gn:s_sortColumn is defined
gn:zeroItemEventEnabled	Executes gn:act_setItemSelect actions also when first item in list
android:enabled	Used to disable GnDropdown so that user can not interact with it
gn:s_listSelector	Sets the color of selector when user clicks on row in GnListView
gn:event_afterDropdownClosed	Defines Action Set to be executed when dropdown selection window is closed.

Local sourceType and saving to database

When GnDropDown has sourceType="local", the following attributes are necessary in order to perform a correct save:

gn:data_request

dbRequest to which data is written

(String) values = tableName

gn:data_field

column to which data is saved

(String) values = column-Name

gn:data_source_request

this attribute that points to dbRequest is not used but it’s necessary because of ginstr launcher internals, it will be removed later. At present it’s necessary that this attribute is provided which points to some dbRequest in queries.xml, the dbRequest should not be used.

i.e. <source lang="xml"> <com.ginstr.widgets.GnDropDown gn:s_sourceType=”local” gn:data_field= “columnOne” gn:data_request=”tableName” gn:data_source_key_local=”@array/drop_values” gn:data_source_request=”unusedDbRequest” gn:act_afterLoad=”[gn:act_fill_dropdown]|[@+id/dropdown]” </source>

The above example will populate a dropdown with local values from “drop_values” array and a save to the database is performed, data will be saved to table “tableName” into “columnOne”.

Database sourceType and saving to database

When GnDropDown has sourceType="database", the following attributes are necessary for correct save:

gn:data_request

dbRequest to which data is written

(String) values = tableName

gn:data_field

column to which data is saved

(String) values = column-Name

gn:data_source_field

name of database field which will be displayed as value

(String) values = columnName

gn:data_source_request

name of dbRequest from which data is retrieved, values

(String) values = tableName