--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/idlefw/plugins/shortcutplugin/inc/caiscuttargetkeylock.h Thu Dec 17 08:54:17 2009 +0200
@@ -0,0 +1,151 @@
+/*
+* Copyright (c) 2005-2006 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "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:
+*
+* Description: Keylock
+*
+*/
+
+
+#ifndef CAISCUTKEYLOCK_H
+#define CAISCUTKEYLOCK_H
+
+#include <aknkeylock.h>
+#include "caiscuttarget.h"
+
+/**
+ * Takes care of locking the keypad.
+ *
+ * @since S60 v3.2
+ */
+class CAiScutTargetKeyLock : public CAiScutTarget
+{
+public: // Constructors and destructor
+
+ /**
+ * Two-phased constructor.
+ * @param
+ * @return new instance.
+ */
+ static CAiScutTargetKeyLock* NewL(
+ CAiScutEngine& aEngine, TShortcutType aType, const TDesC& aTarget);
+
+ /**
+ * Destructor.
+ */
+ virtual ~CAiScutTargetKeyLock();
+
+ /**
+ * Returns the shortcut definition string
+ *
+ * @since S60 v3.2
+ * @return Shortcut definition string
+ */
+ TPtrC Definition() const;
+
+ /**
+ * Returns the shortcut target caption.
+ * Caption can be either a descriptor or a resource id.
+ * If the return value has a non-zero value, it is the resource id.
+ * Zero indicates that the descriptor reference parameter is used.
+ * Default implementation returns KErrNotSupported;
+ *
+ * Getting the target caption and icon utilizes the "lazy evaluation" idiom
+ * which means they are created only when they are first needed. This is because
+ * there are (atleast) two scenarios where they are never needed:
+ * 1. The active theme does not support shortcut captions or icons.
+ * 2. Shortcuts launched using LaunchByValue are never published.
+ *
+ * @since S60 v3.2
+ * @param aDes On return, the descriptor if used
+ * @return The resource id or zero to indicate that the descriptor is used.
+ */
+ TInt GetCaption(TPtrC& aDes, TAiScutAppTitleType aTitleType) const;
+
+ /**
+ * Returns the shortcut target icon.
+ * Icon can be either an icon pointer or a resource id.
+ * If the return value has a non-zero value, it is the resource id.
+ * Zero indicates that the icon pointer is used.
+ * Default implementation returns KErrNotSupported;
+ *
+ * Uses the "lazy evaluation" idiom to get the icon. See Caption()
+ *
+ * @since S60 v3.2
+ * @param aIcon On return, the icon pointer if used
+ * @return The resource id or zero to indicate that the icon pointer is used.
+ */
+ TInt GetIcon(CGulIcon*& aIcon) const;
+
+ /**
+ * Checks if the shortcut target is accessible
+ *
+ * @since S60 v3.2
+ * @param aCheckType Specifies which kind of shortcuts should check its access
+ * @return ETrue if accessible, EFalse if not
+ */
+ TBool IsAccessibleL(TInt aCheckType);
+
+ /**
+ * Launches the shortcut
+ *
+ * @since S60 v3.2
+ */
+ void LaunchL();
+
+ /**
+ * Return application uid this target launches.
+ *
+ * @since S60 v3.2
+ */
+ TUid AppUid() const;
+
+private: // New methods
+
+ /**
+ * Enables keylock.
+ */
+ void EnableKeyLock();
+
+ /**
+ * Checks if keylock is enabled.
+ */
+ TBool IsKeyLockEnabled();
+
+ /**
+ * C++ default constructor.
+ */
+ CAiScutTargetKeyLock(CAiScutEngine& aEngine, TShortcutType aType);
+
+ /**
+ * By default Symbian OS constructor is private.
+ */
+ void ConstructL(const TDesC& aTarget);
+
+private: // Data
+
+ /**
+ * Keylock
+ */
+ RAknKeylock2 iKeyLock;
+
+ /**
+ * Holds the shortcut definition string
+ * Owned.
+ */
+ HBufC* iDefinition;
+
+};
+
+#endif // CAIKEYLOCK_H
+
+// End of File.