1 <?xml version="1.0" encoding="utf-8"?>

     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

     3 <!-- This component and the accompanying materials are made available under the terms of the License 

     4 "Eclipse Public License v1.0" which accompanies this distribution, 

     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

     6 <!-- Initial Contributors:

     7 	Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->  <!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"><concept id="GUID-60B979FB-43BD-480E-8E17-1D3DA2002CB1" xml:lang="en"><title>Slider

    10 pop-up</title><prolog><metadata><keywords></keywords></metadata></prolog><conbody>

    11 <p>The Slider pop-up component can be used for situations where a value is

    12 changed with a slider, for example when changing zoom or volume level. The

    13 common Slider pop-up component has a set of elements from which to select

    14 and modify the slider in question, e.g. value ranges, whether to have current

    15 value as text included, or additional icons related to the slider.</p>

    16 <p>For application specific slider pop-up the application may define ways

    17 to open the pop-up. For common pop-up such as Volume Control, ways to open

    18 the pop-up are defined. The Slider pop-up has default timeout after which

    19 it disappears, but for good reason this timeout can be overridden by the application. </p>

    20 <p>Instead of using the pop-up, the application may define the slider to be

    21 always visible i.e. fixed in the layout. If slider is fixed in the layout,

    22 the pop-up is not shown.</p>

    23 <p>The orientation of the slider pop-up can be either horizontal or vertical.

    24 The orientation and location are always the same across applications, unless

    25 application uses the slider as fixed in the layout. Value growth direction

    26 in Slider is always either up or right depending on the Slider orientation

    27 in the UI. </p>

    28 <section><title>Using slider pop-ups

    29 in C++ applications</title><p>The API to use for the slider pop-up is the Slider

    30 API.</p><p>To use a slider pop-up in your application, create an instance

    31 of the class <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCAknSlider.html" format="application/java-archive"><codeph>CAknSlider</codeph></xref>.</p><p>Use

    32 the method <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCAknSlider.html#522ccd7bdb0fac6707734578e2d4ed7b" format="application/java-archive"><codeph>CAknSlider::SetValueL()</codeph></xref> to set the slider handle's position. To set the range of acceptable

    33 values, use the method <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCAknSlider.html#e6e3b16a15f653eb9fc5b207f7852857" format="application/java-archive"><codeph>CAknSlider::SetRange()</codeph></xref>. To set the step size, use the method <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCAknSlider.html#f72ea3d251c686948dfea1dbcf9be170" format="application/java-archive"><codeph>CAknSlider::SetStepSize()</codeph></xref>.</p><p>To set the texts

    34 for the minimum and maximum values, use the methods <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCAknSlider.html#0359150c9fd3d2390de7c0dd6f7d6063" format="application/java-archive"><codeph>CAknSlider::SetMinimumTextL()</codeph></xref> and <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCAknSlider.html#882ca8ea40249fd2636748a116370fed" format="application/java-archive"><codeph>CAknSlider::SetMaximumTextL()</codeph></xref>. </p><p>To enable drag

    35 events in the slider, use the method <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCAknSlider.html#a3db99850ff68e4a80071de18befdcd1" format="application/java-archive"><codeph>CAknSlider::EnableDrag()</codeph></xref></p><p>To use a custom graphic

    36 in your slider component, use the method <xref href="jar:GUID-759FBC7F-5384-4487-8457-A8D4B76F6AA6.jar!/html/classCAknSlider.html#6161f69289ee1c7e0f47de8fee21ecee" format="application/java-archive"><codeph>CAknSlider::SetGraphics()</codeph></xref>.</p></section>

    37 </conbody></concept>