Categories: Symbian C++ | Code Examples | Hardware | S60 3rd Edition, Feature Pack 1

This page was last modified 08:19, 2 May 2008.

From Forum Nokia Wiki

Knowledge Base Home

Overview

This code snippet demonstrates the following use cases regarding enabling and disabling keypad lock:

1. Offering the user to enable the key lock.
2. Enabling the key lock and showing a notification ("Keypad locked" or similar).
3. Enabling the key lock without showing a notification.
4. Disabling the key lock and showing a notification ("Keypad unlocked" or similar).
5. Disabling the key lock without showing a notification.
6. Locking the device keys similarly to device lock (unlocking requires a lock code).

This snippet can be self-signed.

MMP file

The following libraries are required:

LIBRARY  avkon.lib

Source file

#include <aknkeylock.h>  // RAknKeyLock

RAknKeyLock keyLock;
// Connect to the notifier server so that key lock state notifications can be
// displayed
User::LeaveIfError(keyLock.Connect());
 
 
// USE CASE 1
// If the key lock is not enabled, ask the user whether it should be
if (!keyLock.IsKeyLockEnabled())
    {
    keyLock.OfferKeyLock();
    }
 
 
// USE CASE 2
// If the key lock is not enabled, enable it and show a notification
if (!keyLock.IsKeyLockEnabled())
    {
    keyLock.EnableKeyLock();
    }
 
 
// USE CASE 3
// If the key lock is not enabled, enable it without showing a notification
if (!keyLock.IsKeyLockEnabled())
    {
    keyLock.EnableWithoutNote();
    }
 
 
// USE CASE 4
// If the key lock is enabled, disable it and show a notification
if (keyLock.IsKeyLockEnabled())
    {
    keyLock.DisableKeyLock();
    }
 
 
// USE CASE 5
// If the key lock is enabled, disable it without showing a notification
if (keyLock.IsKeyLockEnabled())
    {
    keyLock.DisableWithoutNote();
    }
 
 
// USE CASE 6
// Lock the device keys similarly to device lock (unlocking requires a lock
// code)
keyLock.EnableAutoLockEmulation();
 
 
// Close the session with the notifier server
keyLock.Close();