====== Seekbars ======

//(Information and examples taken from the DroidScript documentation)//

===== Description =====
Create SeekBars using the **CreateSeekBar** method of the **[[built_in:app|app]]** object:
<code>skb = app.CreateSeekBar( width, height );</code>
The **SetRange** method of the SeekBar object to sets the value range of the SeekBar and the **SetValue** method sets the current value.

Use the **SetOnTouch** method of the SeekBar object to set the name of a function you want to be called when the SeekBar is touched. You can read the 'value' parameter in your callback function to get the position value of the SeekBar

====Example====
<code javascript>
function OnStart()
{
  lay = app.CreateLayout( "Linear", "VCenter,FillXY" );

  skb = app.CreateSeekBar( 0.8 );
  skb.SetRange( 1.0 );
  skb.SetValue( 0.5 );
  skb.SetOnTouch( skb_OnTouch );
  lay.AddChild( skb );

  app.AddLayout( lay );
}

function skb_OnTouch( value )
{
  app.ShowPopup( "Value = " + value );
}
</code>

===== Methods =====
Some controls use the same methods.\\
For examples of the **[[same methods]]** look here.
^ Method                                                          ^ Description                                                                                                                                                                                                                                                                                              ^
| SeekBar.Destroy()                                               |                                                                                                                                                                                                                                                                                                          |
| SeekBar.GetAbsHeight()                                          |                                                                                                                                                                                                                                                                                                          |
| SeekBar.GetAbsWidth()                                           |                                                                                                                                                                                                                                                                                                          |
| SeekBar.GetHeight()                                             |                                                                                                                                                                                                                                                                                                          |
| SeekBar.GetPosition()                                           |                                                                                                                                                                                                                                                                                                          |
| SeekBar.GetType()                                               |                                                                                                                                                                                                                                                                                                          |
| SeekBar.GetValue()                                              |                                                                                                                                                                                                                                                                                                          |
| SeekBar.GetVisibility()                                         |                                                                                                                                                                                                                                                                                                          |
| SeekBar.GetWidth()                                              |                                                                                                                                                                                                                                                                                                          |
| SeekBar.Release()                                               |                                                                                                                                                                                                                                                                                                          |
| SeekBar.SetBackColor( color )                                   | Sets the background color of the seekbar to the given color. The color is defined by a 6 or 8 character hexidecimal color code string, e.g. "#99A055" or "#A099A055". The string has the format #RRGGBB or #AARRGGBB, where A is the alpha (transparency) channel, R is red, G is green, and B is blue.  |
| SeekBar.SetBackGradient( color1,color2,color3,p4,p5,p6,p7 )     |                                                                                                                                                                                                                                                                                                          |
| SeekBar.SetBackGradientRadial( x,y,r,color1,color2,color3,p7 )  |                                                                                                                                                                                                                                                                                                          |
| SeekBar.SetBackground( imagefile,options )                      |                                                                                                                                                                                                                                                                                                          |
| SeekBar.SetMargins( left,top,right,bottom )                     |                                                                                                                                                                                                                                                                                                          |
| SeekBar.SetMaxRate( ms )                                        | Sets the maximum rate at which the OnTouch event can occur. At least ms milliseconds must pass between each occurance of the OnTouch event. If not set, ms defaults to 0.                                                                                                                                |
| SeekBar.SetOnTouch( callback )                                  |                                                                                                                                                                                                                                                                                                          |
| SeekBar.SetPadding( width,height,top,bottom )                   |                                                                                                                                                                                                                                                                                                          |
| SeekBar.SetPosition( left,top,width,height )                    |                                                                                                                                                                                                                                                                                                          |
| SeekBar.SetRange( range )                                       | Sets the maximum value of the seekbar. The minimum value is 0.                                                                                                                                                                                                                                           |
| SeekBar.SetScale( x,y )                                         | Multiplies the horizontal and vertical size of the seekbar by x and y respectively.                                                                                                                                                                                                                      |
| SeekBar.SetSize( width,height )                                 |                                                                                                                                                                                                                                                                                                          |
| SeekBar.SetValue( value )                                       | Sets the value of the seekbar to the given value. If the given value is outside the seekbar's range, the seekbar value is set to the min or max value, whichever is closer.                                                                                                                              |
| SeekBar.SetVisibility( HideShow )                               |                                                                                                                                                                                                                                                                                                          |

=====Sample=====
[[tips_tricks:seekbar_setontouchup|Seekbar SetOnTouchUp workaround]]