inputmethods_pub/ptiengine_iti_api/inc/PtiUserDicEntry.h
changeset 0 eb1f2e154e89
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/inputmethods_pub/ptiengine_iti_api/inc/PtiUserDicEntry.h	Tue Feb 02 01:02:04 2010 +0200
@@ -0,0 +1,112 @@
+/*
+* Copyright (c) 2003-2007 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:               User dictionary interface
+*
+*/
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+#ifndef _PTI_USERDICENTRY_H
+#define _PTI_USERDICENTRY_H
+
+// INCLUDES
+#include <e32base.h>
+
+// CONSTANTS
+const TInt KMaxUserDictionaryEntrySize = 100;
+
+/**
+* An interface class for accessing items in user dictionary.
+*/
+class MPtiUserDictionaryEntry
+    {
+    public:
+        /**
+        * Returns a pointer to the word held by this user dictionary entry.
+        * 
+        * @since S60 V2.6
+        * @return A pointer to user dictionary word.
+        */    
+        virtual TPtrC Word() const = 0;
+        
+        /**
+        * Returns a pointer to latin alphabet "reading" version for this user
+        * dictionary entry. Needed for Japanese input.
+        * 
+        * @since S60 V2.6
+        * @return A pointer to reading word
+        */            
+        virtual TPtrC Reading() const = 0;  // Needed for Japanese input.
+        
+        /**
+        * Sets word for this user dictionary entry. This version also
+        * sets reading text.
+        *
+        * @param aWord    A descriptor containing word to be set.
+        * @param aReading A descriptor containing reading text for aWord.
+        * @since S60 V2.6
+        */            
+        virtual void SetWord(TDesC& aWord, TDesC& aReading) = 0;
+        
+        /**
+        * Sets word for this user dictionary entry. This version
+        * sets reading text to same value as "word":
+        *
+        * @param aWord    A descriptor containing word to be set.        
+        * @since S60 V2.6
+        */            
+		virtual void SetWord(TDesC& aWord) = 0;
+    };
+
+
+/**
+* This is implementation of MPtiUserDictionaryEntry interface
+* for latin languages (or any other language, which needs
+* only one component (=word) for user dictionary entry).
+* Implementation of Reading() method is same as implementation of
+* Word() method.
+*/
+class TPtiUserDictionaryEntry : public MPtiUserDictionaryEntry
+	{
+	public:		
+		inline TPtiUserDictionaryEntry();
+		inline TPtiUserDictionaryEntry(const TDesC& aWord);
+
+	    inline TPtrC Word() const;
+        inline TPtrC Reading() const;
+        inline void SetWord(TDesC& aWord, TDesC& aReading);
+		inline void SetWord(TDesC& aWord);
+
+	private:
+		TBuf<KMaxUserDictionaryEntrySize> iEntry;
+	};
+
+#include "PtiUserDicEntry.inl"
+
+#endif
+
+// End of file
+