Symbian3/PDK/Source/GUID-DEF5784C-FE4A-57FE-834D-3C4C0E179007.dita
author Dominic Pinkman <dominic.pinkman@nokia.com>
Fri, 02 Jul 2010 12:51:36 +0100
changeset 11 5072524fcc79
parent 5 f345bda72bc4
child 14 578be2adaf3e
permissions -rw-r--r--
Fixing terminology

<?xml version="1.0" encoding="utf-8"?>
<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
<!-- This component and the accompanying materials are made available under the terms of the License 
"Eclipse Public License v1.0" which accompanies this distribution, 
and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
<!-- Initial Contributors:
    Nokia Corporation - initial contribution.
Contributors: 
-->
<!DOCTYPE task
  PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<task xml:lang="en" id="GUID-DEF5784C-FE4A-57FE-834D-3C4C0E179007"><title>Moving a Device to a New Position in the List</title><shortdesc>This topic shows you how to move a device to a new position in the list. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody><context><p>Each device in the list has a position index. The higher the position index, the lower the priority the device has in the list. When a device is moved to a new position, any other devices in the list are shifted as required to allow the device to occupy the requested position. </p> </context> <steps-unordered><step id="GUID-386DB0D1-6883-5A93-B053-EF66A3EAA9C8"><cmd>Call <xref href="GUID-2D92CE4A-3784-35E6-969F-504888DFA4FF.dita#GUID-2D92CE4A-3784-35E6-969F-504888DFA4FF/GUID-5EA6796D-86BB-3635-8EDD-9A46C1EBD839"><apiname>CLbsBtGpsConfig::ReorderDevice(TLbsBtGpsEntryKey,
                TInt)</apiname></xref>. This function takes the unique key that identifies the device and the new position index for the device in the list. </cmd> <stepxmp><codeblock id="GUID-EF96B85F-98F4-51A6-9637-DE5579BAF8E8" xml:space="preserve">// Move the device to the 8th place in the list
// or to the end of the list if there are currently less than 8 devices in the list. 
iConfig-&gt;ReorderDevice(key, 7);</codeblock> </stepxmp> <stepresult>This step returns <codeph>KErrNone</codeph> upon success. </stepresult> </step> </steps-unordered> <result><p>The device is moved to the required position in the list. </p> </result> <postreq><p><xref href="GUID-375CA8E2-DD7A-532A-88F0-004BFAB3F8DE.dita">Removing a Device from the List</xref>  </p> </postreq> </taskbody><related-links><link href="GUID-5CAF1B85-853F-5450-B79B-7E768DFA44EC.dita"><linktext>Bluetooth
                GPS PSY Configuration API Overview</linktext> </link> </related-links></task>