User Tools

Site Tools


built_in:spinner

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
built_in:spinner [2015/03/22 12:48]
octazid [Table]
built_in:spinner [2016/06/04 01:02] (current)
Line 1: Line 1:
 ====== Spinner control ====== ====== 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 ===== ===== Methods =====
 Some controls use the same methods.\\ Some controls use the same methods.\\
 For examples of the **[[same methods]]** look here. For examples of the **[[same methods]]** look here.
-^ Method                                                 ^ Description   ^ +^ Method                                                 ^ Description                                                                
-| Spinner.Destroy()                                      |               | +| Spinner.GetAbsHeight()                                                                                                            
-| Spinner.GetAbsHeight()                                               +| Spinner.GetAbsWidth()                                  |                                                                            
-| Spinner.GetAbsWidth()                                  |               +| Spinner.GetHeight()                                    |                                                                            
-| Spinner.GetHeight()                                    |               +| Spinner.GetPosition()                                  |                                                                            
-| Spinner.GetPosition()                                  |               +| Spinner.GetText()                                      |                                                                            
-| Spinner.GetText()                                      |               +| Spinner.GetTextSize( mode )                            |                                                                            
-| Spinner.GetTextSize( mode )                            |               +| Spinner.GetType()                                      |                                                                            
-| Spinner.GetType()                                      |               +| Spinner.GetVisibility()                                |                                                                            
-| Spinner.GetVisibility()                                |               +| Spinner.GetWidth()                                                                                                                
-| Spinner.GetWidth()                                                   | +| Spinner.SelectItem( item                             | See the info                                                               
-| Spinner.Release()                                      |               +| Spinner.SetBackColor( colorcode )                      |                                                                            
-| Spinner.SelectItem( p1                               | See the info  +| Spinner.SetBackGradient( p1,p2,p3,p4,p5,p6,p7 )        |                                                                            
-| Spinner.SetBackColor( colorcode )                      |               +| Spinner.SetBackGradientRadial( p1,p2,p3,p4,p5,p6,p7 )  |                                                                            
-| Spinner.SetBackGradient( p1,p2,p3,p4,p5,p6,p7 )        |               +| Spinner.SetList( list, p2 )                            |                                                                            
-| Spinner.SetBackGradientRadial( p1,p2,p3,p4,p5,p6,p7 )  |               | +| Spinner.SetMargins( left,top,right,bottom )            |                                                                            
-| Spinner.SetBackground( p1,p2 )                                       +| Spinner.SetOnChange( callback )                        | Note: callback runs only when selection changes, not necessarily touched.  
-| Spinner.SetList( list, p2 )                            |               +| Spinner.SetOnTouch( callback )                         Deprecated: same as SetOnChange                                            
-| Spinner.SetMargins( left,top,right,bottom )            |               +| Spinner.SetPadding( left,top,right,bottom )            |                                                                            
-| Spinner.SetOnChange( callback )                        |               +| Spinner.SetPosition( left,top,width,height )                                                                                      
-| Spinner.SetOnTouch( callback )                                       +| Spinner.SetScale( x,y )                                |                                                                            
-| Spinner.SetPadding( left,top,right,bottom )            |               +| Spinner.SetSize( width,height )                        |                                                                            
-| Spinner.SetPosition( left,top,width,height )                         +| Spinner.SetText( text )                                |                                                                            
-| Spinner.SetScale( x,y )                                |               +| Spinner.SetTextColor( colorcode )                      |                                                                            
-| Spinner.SetSize( width,height )                        |               +| Spinner.SetTextSize( size,mode )                                                                                                  
-| Spinner.SetText( text )                                |               +| Spinner.SetVisibility( HideShow )                      |                                                                            | 
-| Spinner.SetTextColor( colorcode )                      |               + 
-| Spinner.SetTextSize( size,mode )                                     + 
-| Spinner.SetVisibility( HideShow )                      |               |+----
  
 ===== Info to Version 1.15 and before ===== ===== Info to Version 1.15 and before =====
Line 59: Line 94:
 } }
 </code> </code>
- 
built_in/spinner.1427028531.txt.gz · Last modified: 2015/03/22 20:48 (external edit)