Differences

This shows you the differences between two versions of the page.

--- built_in:spinner [2014/12/19 16:11]
octazid [Methods]
+++ built_in:spinner [2015/04/02 16:30]
octazid [Spinner control]
@@ Line 1: / Line 1: @@
 ====== Spinner control ======
+//(Description and Example taken from the DroidScript documentation)//
+=====Description=====
+Create Spinners using the **CreateSpinner** method of the [[built_in:app|app]] object:
+<code>spin = app.CreateSpinner( list, width, height, options );</code>
+You can allow the Spinner to auto-size by leaving out the dimensions or you can specify a width and/or height as decimal fractions of the screen's width and height.
+Use the **SetOnChange** method of your spinner to set the name of a function you want to be called when the user selects an item.
+You can get the current selection of the Spinner button at any time using the **GetText** method and replace the option list at any time by using the SetList method.
+Use the **SelectItem** method to select a particular item in code
+=====Example=====
+<code javascript>
+function OnStart()
+{
+  lay = app.CreateLayout( "Linear", "VCenter,FillXY" );
+  spin = app.CreateSpinner( "Bilbo,Frodo,Gandalf", 0.4 );
+  spin.SetOnChange( ShowSelection );
+  spin.SelectItem( "Frodo" );
+  lay.AddChild( spin );
+  app.AddLayout( lay );
+}
+function ShowSelection( item )
+{
+  app.ShowPopup( "Selected = " + item );
+}
+</code>
 ===== Methods =====
-^Method ^Description ^
+Some controls use the same methods.\\
-|Spinner.Destroy() | |
+For examples of the **[[same methods]]** look here.
-|Spinner.GetAbsHeight() | |
+^ Method                                                 ^ Description   ^
-|Spinner.GetAbsWidth() | |
+| Spinner.GetAbsHeight()                                 |               |
-|Spinner.GetHeight() | |
+| Spinner.GetAbsWidth()                                  |               |
-|Spinner.GetPosition() | |
+| Spinner.GetHeight()                                    |               |
-|Spinner.GetText() | |
+| Spinner.GetPosition()                                  |               |
-|Spinner.GetTextSize( mode ) | |
+| Spinner.GetText()                                      |               |
-|Spinner.GetType() | |
+| Spinner.GetTextSize( mode )                            |               |
-|Spinner.GetVisibility() | |
+| Spinner.GetType()                                      |               |
-|Spinner.GetWidth() | |
+| Spinner.GetVisibility()                                |               |
-|Spinner.Release() | |
+| Spinner.GetWidth()                                     |               |
-|Spinner.SelectItem( p1 ) | |
+| Spinner.SelectItem( item )                             | See the info  |
-|Spinner.SetBackColor( p1 ) | |
+| Spinner.SetBackColor( colorcode )                      |               |
-|Spinner.SetBackGradient( p1,p2,p3,p4,p5,p6,p7 ) | |
+| Spinner.SetBackGradient( p1,p2,p3,p4,p5,p6,p7 )        |               |
-|Spinner.SetBackGradientRadial( p1,p2,p3,p4,p5,p6,p7 ) | |
+| Spinner.SetBackGradientRadial( p1,p2,p3,p4,p5,p6,p7 )  |               |
-|Spinner.SetBackground( p1,p2 ) | |
+| Spinner.SetList( list, p2 )                            |               |
-|Spinner.SetList( p1, p2 ) | |
+| Spinner.SetMargins( left,top,right,bottom )            |               |
-|Spinner.SetMargins( left,top,right,bottom ) | |
+| Spinner.SetOnChange( callback )                        |               |
-|Spinner.SetOnChange( p1 ) | |
+| Spinner.SetOnTouch( callback )                         |               |
-|Spinner.SetOnTouch( p1 ) | |
+| Spinner.SetPadding( left,top,right,bottom )            |               |
-|Spinner.SetPadding( p1,p2,p3,p4 ) | |
+| Spinner.SetPosition( left,top,width,height )           |               |
-|Spinner.SetPosition( p1,p2,p3,p4 ) | |
+| Spinner.SetScale( x,y )                                |               |
-|Spinner.SetScale( x,y ) | |
+| Spinner.SetSize( width,height )                        |               |
-|Spinner.SetSize( p1,p2 ) | |
+| Spinner.SetText( text )                                |               |
-|Spinner.SetText( p1 ) | |
+| Spinner.SetTextColor( colorcode )                      |               |
-|Spinner.SetTextColor( p1 ) | |
+| Spinner.SetTextSize( size,mode )                       |               |
-|Spinner.SetTextSize( size,mode ) | |
+| Spinner.SetVisibility( HideShow )                      |               |
-|Spinner.SetVisibility( p1 ) | |
+----
+===== Info to Version 1.15 and before =====
+If the SelectItem method is called before the spinner and the layout is added to the app-object the OnChange event of the spinner is fired only after the second manual selection change.
+<code JavaScript spinnerSelectItem.js>
+function OnStart()
+{
+  lay = app.CreateLayout( "Linear", "VCenter,FillXY" );
+  spin = app.CreateSpinner( "Bilbo,Frodo,Gandalf", 0.4 );
+  spin.SetOnChange( ShowSelection );
+  //spin.SelectItem( "Frodo" ); Dont write it here!
+  lay.AddChild( spin );
+  app.AddLayout( lay );
+  //Select the Item after app.AddLayout or
+  //it will not work right!
+  spin.SelectItem( "Frodo" );
+}
+function ShowSelection( item )
+{
+  app.ShowPopup( "Selected = " + item );
+}
+</code>

DroidScript Wiki

User Tools

Site Tools

Differences

Page Tools