Release 4.0.0-preview1-00301
[platform/core/csapi/tizenfx.git] / src / Tizen.NUI / src / public / ImfManager.cs
index 16f5728..32b86fd 100755 (executable)
@@ -1,25 +1,27 @@
-/** Copyright (c) 2017 Samsung Electronics Co., Ltd.
-*
-* Licensed under the Apache License, Version 2.0 (the "License");
-* you may not use this file except in compliance with the License.
-* You may obtain a copy of the License at
-*
-* http://www.apache.org/licenses/LICENSE-2.0
-*
-* Unless required by applicable law or agreed to in writing, software
-* distributed under the License is distributed on an "AS IS" BASIS,
-* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-* See the License for the specific language governing permissions and
-* limitations under the License.
-*
-*/
+/*
+ * Copyright(c) 2017 Samsung Electronics Co., Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
 using System;
 using System.Runtime.InteropServices;
+using System.ComponentModel;
 
 namespace Tizen.NUI
 {
     /// <summary>
-    /// Specifically manages the ecore input method framework which enables the virtual or hardware keyboards.
+    /// Specifically manages the input method framework which enables the virtual or hardware keyboards.
     /// </summary>
     public class ImfManager : BaseHandle
     {
@@ -35,6 +37,11 @@ namespace Tizen.NUI
             return (obj == null) ? new global::System.Runtime.InteropServices.HandleRef(null, IntPtr.Zero) : obj.swigCPtr;
         }
 
+        /// <summary>
+        /// Dispose
+        /// </summary>
+        /// <param name="type">Dispose Type</param>
+        /// <since_tizen> 3 </since_tizen>
         protected override void Dispose(DisposeTypes type)
         {
             if (disposed)
@@ -54,7 +61,37 @@ namespace Tizen.NUI
             //You should not access any managed member here except static instance.
             //because the execution order of Finalizes is non-deterministic.
 
-            if (swigCPtr.Handle != IntPtr.Zero)
+            if (_keyboardTypeChangedEventCallback != null)
+            {
+                KeyboardTypeChangedSignal().Disconnect(_keyboardTypeChangedEventCallback);
+            }
+
+            if (_imfManagerLanguageChangedEventCallback != null)
+            {
+                LanguageChangedSignal().Disconnect(_imfManagerLanguageChangedEventCallback);
+            }
+
+            if (_imfManagerResizedEventCallback != null)
+            {
+                ResizedSignal().Disconnect(_imfManagerResizedEventCallback);
+            }
+
+            if (_imfManagerStatusChangedEventCallback != null)
+            {
+                StatusChangedSignal().Disconnect(_imfManagerStatusChangedEventCallback);
+            }
+
+            if (_imfManagerEventReceivedEventCallback != null)
+            {
+                EventReceivedSignal().Disconnect(_imfManagerEventReceivedEventCallback);
+            }
+
+            if (_imfManagerActivatedEventCallback != null)
+            {
+                ActivatedSignal().Disconnect(_imfManagerActivatedEventCallback);
+            }
+
+            if (swigCPtr.Handle != global::System.IntPtr.Zero)
             {
                 if (swigCMemOwn)
                 {
@@ -73,6 +110,10 @@ namespace Tizen.NUI
         public class ImfEventData : global::System.IDisposable
         {
             private global::System.Runtime.InteropServices.HandleRef swigCPtr;
+            /// <summary>
+            /// swigCMemOwn
+            /// </summary>
+            /// <since_tizen> 3 </since_tizen>
             protected bool swigCMemOwn;
 
             internal ImfEventData(IntPtr cPtr, bool cMemoryOwn)
@@ -88,10 +129,16 @@ namespace Tizen.NUI
 
             //A Flag to check who called Dispose(). (By User or DisposeQueue)
             private bool isDisposeQueued = false;
-            //A Flat to check if it is already disposed.
+            /// <summary>
+            /// A Flat to check if it is already disposed.
+            /// </summary>
+            /// <since_tizen> 3 </since_tizen>
             protected bool disposed = false;
 
-
+            /// <summary>
+            /// Dispose.
+            /// </summary>
+            /// <since_tizen> 3 </since_tizen>
             ~ImfEventData()
             {
                 if (!isDisposeQueued)
@@ -102,8 +149,9 @@ namespace Tizen.NUI
             }
 
             /// <summary>
-            /// Dispose pattern
+            /// The dispose pattern.
             /// </summary>
+            /// <since_tizen> 3 </since_tizen>
             public void Dispose()
             {
                 //Throw excpetion if Dispose() is called in separate thread.
@@ -123,6 +171,10 @@ namespace Tizen.NUI
                 }
             }
 
+            /// <summary>
+            /// Dispose.
+            /// </summary>
+            /// <since_tizen> 3 </since_tizen>
             protected virtual void Dispose(DisposeTypes type)
             {
                 if (disposed)
@@ -163,29 +215,32 @@ namespace Tizen.NUI
             }
 
             /// <summary>
-            /// Default Constructor
+            /// The default constructor.
             /// </summary>
+            /// <since_tizen> 3 </since_tizen>
             public ImfEventData() : this(NDalicManualPINVOKE.new_ImfManager_ImfEventData__SWIG_0(), true)
             {
                 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
             }
 
             /// <summary>
-            /// Constructor
+            /// The constructor.
             /// </summary>
             /// <param name="aEventName">The name of the event from the IMF.</param>
-            /// <param name="aPredictiveString">The pre-edit or commit string.</param>
-            /// <param name="aCursorOffset">Start position from the current cursor position to start deleting characters.</param>
+            /// <param name="aPredictiveString">The pre-edit or the commit string.</param>
+            /// <param name="aCursorOffset">Start the position from the current cursor position to start deleting characters.</param>
             /// <param name="aNumberOfChars">The number of characters to delete from the cursorOffset.</param>
+            /// <since_tizen> 3 </since_tizen>
             public ImfEventData(ImfManager.ImfEvent aEventName, string aPredictiveString, int aCursorOffset, int aNumberOfChars) : this(NDalicManualPINVOKE.new_ImfManager_ImfEventData__SWIG_1((int)aEventName, aPredictiveString, aCursorOffset, aNumberOfChars), true)
             {
                 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
             }
 
             /// <summary>
-            /// The pre-edit or commit string.
+            /// The pre-edit or the commit string.
             /// </summary>
-            [Obsolete("Please do not use! this will be deprecated")]
+            /// /// <since_tizen> 3 </since_tizen>
+            [EditorBrowsable(EditorBrowsableState.Never)]
             public string predictiveString
             {
                 set
@@ -202,8 +257,9 @@ namespace Tizen.NUI
             }
 
             /// <summary>
-            /// The pre-edit or commit string.
+            /// The pre-edit or the commit string.
             /// </summary>
+            /// <since_tizen> 4 </since_tizen>
             public string PredictiveString
             {
                 set
@@ -222,7 +278,8 @@ namespace Tizen.NUI
             /// <summary>
             /// The name of the event from the IMF.
             /// </summary>
-            [Obsolete("Please do not use! this will be deprecated")]
+            //Please do not use! this will be deprecated
+            [EditorBrowsable(EditorBrowsableState.Never)]
             public ImfManager.ImfEvent eventName
             {
                 set
@@ -241,6 +298,7 @@ namespace Tizen.NUI
             /// <summary>
             /// The name of the event from the IMF.
             /// </summary>
+            /// <since_tizen> 4 </since_tizen>
             public ImfManager.ImfEvent EventName
             {
                 set
@@ -257,9 +315,10 @@ namespace Tizen.NUI
             }
 
             /// <summary>
-            /// Start position from the current cursor position to start deleting characters.
+            /// The start position from the current cursor position to start deleting characters.
             /// </summary>
-            [Obsolete("Please do not use! this will be deprecated")]
+            //Please do not use! this will be deprecated
+            [EditorBrowsable(EditorBrowsableState.Never)]
             public int cursorOffset
             {
                 set
@@ -276,8 +335,9 @@ namespace Tizen.NUI
             }
 
             /// <summary>
-            /// Start position from the current cursor position to start deleting characters.
+            /// The start position from the current cursor position to start deleting characters.
             /// </summary>
+            /// <since_tizen> 4 </since_tizen>
             public int CursorOffset
             {
                 set
@@ -294,9 +354,10 @@ namespace Tizen.NUI
             }
 
             /// <summary>
-            /// Number of characters to delete from the cursorOffset.
+            /// The number of characters to delete from the cursorOffset.
             /// </summary>
-            [Obsolete("Please do not use! this will be deprecated")]
+            //Please do not use! this will be deprecated
+            [EditorBrowsable(EditorBrowsableState.Never)]
             public int numberOfChars
             {
                 set
@@ -313,8 +374,9 @@ namespace Tizen.NUI
             }
 
             /// <summary>
-            /// Number of characters to delete from the cursorOffset.
+            /// The number of characters to delete from the cursorOffset.
             /// </summary>
+            /// <since_tizen> 4 </since_tizen>
             public int NumberOfChars
             {
                 set
@@ -333,11 +395,15 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Data required by IMF from the callback.
+        /// Data required by the IMF from the callback.
         /// </summary>
         public class ImfCallbackData : global::System.IDisposable
         {
             private global::System.Runtime.InteropServices.HandleRef swigCPtr;
+            /// <summary>
+            /// swigCMemOwn
+            /// </summary>
+            /// <since_tizen> 3 </since_tizen>
             protected bool swigCMemOwn;
 
             internal IntPtr GetImfCallbackDataPtr()
@@ -358,10 +424,17 @@ namespace Tizen.NUI
 
             //A Flag to check who called Dispose(). (By User or DisposeQueue)
             private bool isDisposeQueued = false;
-            //A Flat to check if it is already disposed.
+            /// <summary>
+            /// A Flat to check if it is already disposed.
+            /// </summary>
+            /// <since_tizen> 3 </since_tizen>
             protected bool disposed = false;
 
 
+            /// <summary>
+            /// Dispose.
+            /// </summary>
+            /// <since_tizen> 3 </since_tizen>
             ~ImfCallbackData()
             {
                 if (!isDisposeQueued)
@@ -372,8 +445,9 @@ namespace Tizen.NUI
             }
 
             /// <summary>
-            /// Dispose pattern
+            /// The dispose pattern.
             /// </summary>
+            /// <since_tizen> 3 </since_tizen>
             public void Dispose()
             {
                 //Throw excpetion if Dispose() is called in separate thread.
@@ -393,6 +467,10 @@ namespace Tizen.NUI
                 }
             }
 
+            /// <summary>
+            /// Dispose.
+            /// </summary>
+            /// <since_tizen> 3 </since_tizen>
             protected virtual void Dispose(DisposeTypes type)
             {
                 if (disposed)
@@ -433,29 +511,32 @@ namespace Tizen.NUI
             }
 
             /// <summary>
-            /// Default Constructor
+            /// The default constructor.
             /// </summary>
+            /// <since_tizen> 3 </since_tizen>
             public ImfCallbackData() : this(NDalicManualPINVOKE.new_ImfManager_ImfCallbackData__SWIG_0(), true)
             {
                 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
             }
 
             /// <summary>
-            /// Constructor
+            /// The constructor.
             /// </summary>
-            /// <param name="aUpdate">True if cursor position needs to be updated.</param>
-            /// <param name="aCursorPosition">New position of cursor.</param>
-            /// <param name="aCurrentText">Current text string.</param>
+            /// <param name="aUpdate">True if the cursor position needs to be updated.</param>
+            /// <param name="aCursorPosition">The new position of the cursor.</param>
+            /// <param name="aCurrentText">The current text string.</param>
             /// <param name="aPreeditResetRequired">Flag if preedit reset is required.</param>
+            /// <since_tizen> 3 </since_tizen>
             public ImfCallbackData(bool aUpdate, int aCursorPosition, string aCurrentText, bool aPreeditResetRequired) : this(NDalicManualPINVOKE.new_ImfManager_ImfCallbackData__SWIG_1(aUpdate, aCursorPosition, aCurrentText, aPreeditResetRequired), true)
             {
                 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
             }
 
             /// <summary>
-            /// Current text string.
+            /// The current text string.
             /// </summary>
-            [Obsolete("Please do not use! this will be deprecated")]
+            //Please do not use! this will be deprecated
+            [EditorBrowsable(EditorBrowsableState.Never)]
             public string currentText
             {
                 set
@@ -472,8 +553,9 @@ namespace Tizen.NUI
             }
 
             /// <summary>
-            /// Current text string.
+            /// The current text string.
             /// </summary>
+            /// <since_tizen> 4 </since_tizen>
             public string CurrentText
             {
                 set
@@ -490,9 +572,10 @@ namespace Tizen.NUI
             }
 
             /// <summary>
-            /// Current text string.
+            /// The current text string.
             /// </summary>
-            [Obsolete("Please do not use! this will be deprecated")]
+            //Please do not use! this will be deprecated
+            [EditorBrowsable(EditorBrowsableState.Never)]
             public int cursorPosition
             {
                 set
@@ -509,8 +592,9 @@ namespace Tizen.NUI
             }
 
             /// <summary>
-            /// Current text string.
+            /// The current text string.
             /// </summary>
+            /// <since_tizen> 4 </since_tizen>
             public int CursorPosition
             {
                 set
@@ -527,9 +611,10 @@ namespace Tizen.NUI
             }
 
             /// <summary>
-            /// If cursor position needs to be updated.
+            /// If the cursor position needs to be updated.
             /// </summary>
-            [Obsolete("Please do not use! this will be deprecated")]
+            //Please do not use! this will be deprecated
+            [EditorBrowsable(EditorBrowsableState.Never)]
             public bool update
             {
                 set
@@ -546,8 +631,9 @@ namespace Tizen.NUI
             }
 
             /// <summary>
-            /// If cursor position needs to be updated.
+            /// If the cursor position needs to be updated.
             /// </summary>
+            /// <since_tizen> 4 </since_tizen>
             public bool Update
             {
                 set
@@ -564,9 +650,10 @@ namespace Tizen.NUI
             }
 
             /// <summary>
-            /// Flag if preedit reset is required.
+            /// Flags if preedit reset is required.
             /// </summary>
-            [Obsolete("Please do not use! this will be deprecated")]
+            //Please do not use! this will be deprecated
+            [EditorBrowsable(EditorBrowsableState.Never)]
             public bool preeditResetRequired
             {
                 set
@@ -583,8 +670,9 @@ namespace Tizen.NUI
             }
 
             /// <summary>
-            /// Flag if preedit reset is required.
+            /// Flags if preedit reset is required.
             /// </summary>
+            /// <since_tizen> 4 </since_tizen>
             public bool PreeditResetRequired
             {
                 set
@@ -603,9 +691,10 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Retrieve a handle to the instance of ImfManager.
+        /// Retrieves a handle to the instance of the ImfManager.
         /// </summary>
         /// <returns>A handle to the ImfManager.</returns>
+        /// <since_tizen> 3 </since_tizen>
         public static ImfManager Get()
         {
             ImfManager ret = new ImfManager(NDalicManualPINVOKE.ImfManager_Get(), true);
@@ -614,10 +703,11 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Activate the IMF.<br/>
-        /// It means that the text editing is started at somewhere.<br/>
-        /// If the H/W keyboard isn't connected then it will show the virtual keyboard.
+        /// Activates the IMF.<br/>
+        /// It means that the text editing is started somewhere.<br/>
+        /// If the hardware keyboard isn't connected, then it will show the virtual keyboard.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public void Activate()
         {
             NDalicManualPINVOKE.ImfManager_Activate(swigCPtr);
@@ -625,9 +715,10 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Deactivate the IMF.<br/>
-        /// It means that the text editing is finished at somewhere.
+        /// Deactivates the IMF.<br/>
+        /// It means that the text editing is finished somewhere.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public void Deactivate()
         {
             NDalicManualPINVOKE.ImfManager_Deactivate(swigCPtr);
@@ -635,10 +726,11 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Get the restoration status, which controls if the keyboard is restored after the focus lost then regained.<br/>
-        /// If true then keyboard will be restored (activated) after focus is regained.
+        /// Gets the restoration status which controls if the keyboard is restored after the focus is lost and then regained.<br/>
+        /// If true, then the keyboard will be restored (activated) after focus is regained.
         /// </summary>
-        /// <returns>Restoration status.</returns>
+        /// <returns>The restoration status.</returns>
+        /// <since_tizen> 3 </since_tizen>
         public bool RestoreAfterFocusLost()
         {
             bool ret = NDalicManualPINVOKE.ImfManager_RestoreAfterFocusLost(swigCPtr);
@@ -647,9 +739,10 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Set status whether the IMF has to restore the keyboard after losing focus.
+        /// Sets the status whether the IMF has to restore the keyboard after losing focus.
         /// </summary>
-        /// <param name="toggle">True means that keyboard should be restored after focus lost and regained.</param>
+        /// <param name="toggle">True means that keyboard should be restored after the focus is lost and regained.</param>
+        /// <since_tizen> 3 </since_tizen>
         public void SetRestoreAfterFocusLost(bool toggle)
         {
             NDalicManualPINVOKE.ImfManager_SetRestoreAfterFocusLost(swigCPtr, toggle);
@@ -657,8 +750,9 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Send message reset the pred-edit state / imf module.
+        /// Sends a message reset to the preedit state or the IMF module.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public new void Reset()
         {
             NDalicManualPINVOKE.ImfManager_Reset(swigCPtr);
@@ -666,8 +760,9 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Notifies IMF context that the cursor position has changed, required for features like auto-capitalisation.
+        /// Notifies the IMF context that the cursor position has changed, required for features like auto-capitalization.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public void NotifyCursorPosition()
         {
             NDalicManualPINVOKE.ImfManager_NotifyCursorPosition(swigCPtr);
@@ -675,9 +770,10 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Sets cursor position stored in VirtualKeyboard, this is required by the IMF context.
+        /// Sets the cursor position stored in VirtualKeyboard, this is required by the IMF context.
         /// </summary>
-        /// <param name="cursorPosition">Position of cursor.</param>
+        /// <param name="cursorPosition">The position of the cursor.</param>
+        /// <since_tizen> 3 </since_tizen>
         public void SetCursorPosition(uint cursorPosition)
         {
             NDalicManualPINVOKE.ImfManager_SetCursorPosition(swigCPtr, cursorPosition);
@@ -685,9 +781,10 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Gets cursor position stored in VirtualKeyboard, this is required by the IMF context.
+        /// Gets the cursor position stored in VirtualKeyboard, this is required by the IMF context.
         /// </summary>
-        /// <returns>Current position of cursor</returns>
+        /// <returns>The current position of the cursor.</returns>
+        /// <since_tizen> 3 </since_tizen>
         public uint GetCursorPosition()
         {
             uint ret = NDalicManualPINVOKE.ImfManager_GetCursorPosition(swigCPtr);
@@ -696,9 +793,10 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Method to store the string required by the IMF, this is used to provide predictive word suggestions.
+        /// A method to store the string required by the IMF, this is used to provide predictive word suggestions.
         /// </summary>
         /// <param name="text">The text string surrounding the current cursor point.</param>
+        /// <since_tizen> 3 </since_tizen>
         public void SetSurroundingText(string text)
         {
             NDalicManualPINVOKE.ImfManager_SetSurroundingText(swigCPtr, text);
@@ -706,9 +804,10 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Gets current text string set within the IMF manager, this is used to offer predictive suggestions.
+        /// Gets the current text string set within the IMF manager, this is used to offer predictive suggestions.
         /// </summary>
-        /// <returns>Surrounding text.</returns>
+        /// <returns>The surrounding text.</returns>
+        /// <since_tizen> 3 </since_tizen>
         public string GetSurroundingText()
         {
             string ret = NDalicManualPINVOKE.ImfManager_GetSurroundingText(swigCPtr);
@@ -717,9 +816,10 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Notifies IMF context that text input is set to multi line or not.
+        /// Notifies the IMF context that text input is set to multiline or not.
         /// </summary>
         /// <param name="multiLine">True if multiline text input is used.</param>
+        /// <since_tizen> 3 </since_tizen>
         public void NotifyTextInputMultiLine(bool multiLine)
         {
             NDalicManualPINVOKE.ImfManager_NotifyTextInputMultiLine(swigCPtr, multiLine);
@@ -727,9 +827,10 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Returns text direction of the keyboard's current input language.
+        /// Returns the text direction of the keyboard's current input language.
         /// </summary>
         /// <returns>The direction of the text.</returns>
+        /// <since_tizen> 3 </since_tizen>
         public ImfManager.TextDirection GetTextDirection()
         {
             ImfManager.TextDirection ret = (ImfManager.TextDirection)NDalicManualPINVOKE.ImfManager_GetTextDirection(swigCPtr);
@@ -738,13 +839,14 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Provides size and position of keyboard.<br/>
-        /// Position is relative to whether keyboard is visible or not.<br/>
-        /// If keyboard is not visible then position will be off the screen.<br/>
-        /// If keyboard is not being shown when this method is called the keyboard is partially setup (IMFContext) to get<br/>
-        /// the values then taken down.  So ideally GetInputMethodArea() should be called after Show().
+        /// Provides the size and the position of the keyboard.<br/>
+        /// The position is relative to whether the keyboard is visible or not.<br/>
+        /// If the keyboard is not visible, then the position will be off the screen.<br/>
+        /// If the keyboard is not being shown when this method is called, the keyboard is partially setup (IMFContext) to get/>
+        /// the values then taken down. So ideally, GetInputMethodArea() should be called after Show().
         /// </summary>
-        /// <returns>Rectangle which is keyboard panel x, y, width, height</returns>
+        /// <returns>Rectangle which is keyboard panel x, y, width, height.</returns>
+        /// <since_tizen> 3 </since_tizen>
         public Rectangle GetInputMethodArea()
         {
             Rectangle ret = new Rectangle(NDalicManualPINVOKE.ImfManager_GetInputMethodArea(swigCPtr), true);
@@ -762,6 +864,7 @@ namespace Tizen.NUI
         /// Sets up the input-panel specific data.
         /// </summary>
         /// <param name="text">The specific data to be set to the input panel.</param>
+        /// <since_tizen> 3 </since_tizen>
         public void SetInputPanelUserData(string text)
         {
             NDalicManualPINVOKE.ImfManager_SetInputPanelUserData(swigCPtr, text);
@@ -771,7 +874,8 @@ namespace Tizen.NUI
         /// <summary>
         /// Gets the specific data of the current active input panel.
         /// </summary>
-        /// <param name="text">The specific data to be got from the input panel.</param>
+        /// <param name="text">The specific data to be received from the input panel.</param>
+        /// <since_tizen> 3 </since_tizen>
         public void GetInputPanelUserData(out string text)
         {
             NDalicManualPINVOKE.ImfManager_GetInputPanelUserData(swigCPtr, out text);
@@ -782,6 +886,7 @@ namespace Tizen.NUI
         /// Gets the state of the current active input panel.
         /// </summary>
         /// <returns>The state of the input panel.</returns>
+        /// <since_tizen> 3 </since_tizen>
         public ImfManager.State GetInputPanelState()
         {
             ImfManager.State ret = (ImfManager.State)NDalicManualPINVOKE.ImfManager_GetInputPanelState(swigCPtr);
@@ -793,7 +898,8 @@ namespace Tizen.NUI
         /// Sets the return key on the input panel to be visible or invisible.<br/>
         /// The default is true.
         /// </summary>
-        /// <param name="visible">True if the return key is visible(enabled), false otherwise.</param>
+        /// <param name="visible">True if the return key is visible (enabled), false otherwise.</param>
+        /// <since_tizen> 3 </since_tizen>
         public void SetReturnKeyState(bool visible)
         {
             NDalicManualPINVOKE.ImfManager_SetReturnKeyState(swigCPtr, visible);
@@ -801,9 +907,10 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Enable to show the input panel automatically when focused.
+        /// Enables to show the input panel automatically when focused.
         /// </summary>
         /// <param name="enabled">If true, the input panel will be shown when focused.</param>
+        /// <since_tizen> 3 </since_tizen>
         public void AutoEnableInputPanel(bool enabled)
         {
             NDalicManualPINVOKE.ImfManager_AutoEnableInputPanel(swigCPtr, enabled);
@@ -813,6 +920,7 @@ namespace Tizen.NUI
         /// <summary>
         /// Shows the input panel.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public void ShowInputPanel()
         {
             NDalicManualPINVOKE.ImfManager_ShowInputPanel(swigCPtr);
@@ -822,6 +930,7 @@ namespace Tizen.NUI
         /// <summary>
         /// Hides the input panel.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public void HideInputPanel()
         {
             NDalicManualPINVOKE.ImfManager_HideInputPanel(swigCPtr);
@@ -832,7 +941,8 @@ namespace Tizen.NUI
         /// Gets the keyboard type.<br/>
         /// The default keyboard type is SoftwareKeyboard.
         /// </summary>
-        /// <returns>The keyboard type</returns>
+        /// <returns>The keyboard type.</returns>
+        /// <since_tizen> 4 </since_tizen>
         public ImfManager.KeyboardType GetKeyboardType()
         {
             ImfManager.KeyboardType ret = (ImfManager.KeyboardType)NDalicManualPINVOKE.ImfManager_GetKeyboardType(swigCPtr);
@@ -842,9 +952,10 @@ namespace Tizen.NUI
 
         /// <summary>
         /// Gets the current language locale of the input panel.<br/>
-        /// Ex) en_US, en_GB, en_PH, fr_FR, ...
+        /// For example, en_US, en_GB, en_PH, fr_FR, ...
         /// </summary>
         /// <returns>The current language locale of the input panel.</returns>
+        /// <since_tizen> 4 </since_tizen>
         public string GetInputPanelLocale()
         {
             string ret = NDalicManualPINVOKE.ImfManager_GetInputPanelLocale(swigCPtr);
@@ -853,8 +964,9 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Constructor
+        /// The constructor.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public ImfManager() : this(NDalicManualPINVOKE.new_ImfManager(), true)
         {
             if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
@@ -863,9 +975,14 @@ namespace Tizen.NUI
         /// <summary>
         /// ImfManager activated event arguments.
         /// </summary>
-        [Obsolete("Please do not use! this will be deprecated")]
+        //Please do not use! this will be deprecated
+        [EditorBrowsable(EditorBrowsableState.Never)]
         public class ImfManagerActivatedEventArgs : EventArgs
         {
+            /// <summary>
+            /// ImfManager
+            /// </summary>
+            /// <since_tizen> 3 </since_tizen>
             public ImfManager ImfManager
             {
                 get;
@@ -881,7 +998,8 @@ namespace Tizen.NUI
         /// <summary>
         /// ImfManager activated event.
         /// </summary>
-        [Obsolete("Please do not use! this will be deprecated")]
+        //Please do not use! this will be deprecated
+        [EditorBrowsable(EditorBrowsableState.Never)]
         public event EventHandler<ImfManagerActivatedEventArgs> ImfManagerActivated
         {
             add
@@ -925,6 +1043,10 @@ namespace Tizen.NUI
         /// </summary>
         public class ActivatedEventArgs : EventArgs
         {
+            /// <summary>
+            /// ImfManager
+            /// </summary>
+            /// <since_tizen> 3 </since_tizen>
             public ImfManager ImfManager
             {
                 get;
@@ -940,6 +1062,7 @@ namespace Tizen.NUI
         /// <summary>
         /// ImfManager activated.
         /// </summary>
+        /// <since_tizen> 4 </since_tizen>
         public event EventHandler<ActivatedEventArgs> Activated
         {
             add
@@ -981,7 +1104,8 @@ namespace Tizen.NUI
         /// <summary>
         /// ImfManager activated signal.
         /// </summary>
-        [Obsolete("Please do not use! this will be internal")]
+        //Please do not use! this will be internal
+        [EditorBrowsable(EditorBrowsableState.Never)]
         public ActivatedSignalType ActivatedSignal()
         {
             ActivatedSignalType ret = new ActivatedSignalType(NDalicManualPINVOKE.ImfManager_ActivatedSignal(swigCPtr), false);
@@ -992,9 +1116,14 @@ namespace Tizen.NUI
         /// <summary>
         /// ImfManager event received event arguments.
         /// </summary>
-        [Obsolete("Please do not use! this will be deprecated")]
+        //Please do not use! this will be deprecated
+        [EditorBrowsable(EditorBrowsableState.Never)]
         public class ImfManagerEventReceivedEventArgs : EventArgs
         {
+            /// <summary>
+            /// ImfManager
+            /// </summary>
+            /// <since_tizen> 3 </since_tizen>
             public ImfManager ImfManager
             {
                 get;
@@ -1009,7 +1138,8 @@ namespace Tizen.NUI
         /// <summary>
         /// ImfManager event received.
         /// </summary>
-        [Obsolete("Please do not use! this will be deprecated")]
+        //Please do not use! this will be deprecated
+        [EditorBrowsable(EditorBrowsableState.Never)]
         public event EventHandler<ImfManagerEventReceivedEventArgs> ImfManagerEventReceived
         {
             add
@@ -1053,12 +1183,20 @@ namespace Tizen.NUI
         /// </summary>
         public class EventReceivedEventArgs : EventArgs
         {
+            /// <summary>
+            /// ImfManager
+            /// </summary>
+            /// <since_tizen> 3 </since_tizen>
             public ImfManager ImfManager
             {
                 get;
                 set;
             }
 
+            /// <summary>
+            /// ImfEventData
+            /// </summary>
+            /// <since_tizen> 3 </since_tizen>
             public ImfEventData ImfEventData
             {
                 get;
@@ -1073,6 +1211,7 @@ namespace Tizen.NUI
         /// <summary>
         /// ImfManager event received.
         /// </summary>
+        /// <since_tizen> 4 </since_tizen>
         public event EventHandlerWithReturnType<object, EventReceivedEventArgs, ImfCallbackData> EventReceived
         {
             add
@@ -1128,7 +1267,8 @@ namespace Tizen.NUI
         /// <summary>
         /// ImfManager event received signal.
         /// </summary>
-        [Obsolete("Please do not use! this will be internal")]
+           //Please do not use! this will be internal
+          [EditorBrowsable(EditorBrowsableState.Never)]
         public ImfEventSignalType EventReceivedSignal()
         {
             ImfEventSignalType ret = new ImfEventSignalType(NDalicManualPINVOKE.ImfManager_EventReceivedSignal(swigCPtr), false);
@@ -1139,9 +1279,14 @@ namespace Tizen.NUI
         /// <summary>
         /// ImfManager status changed event arguments.
         /// </summary>
-        [Obsolete("Please do not use! this will be deprecated")]
+        //Please do not use! this will be deprecated
+        [EditorBrowsable(EditorBrowsableState.Never)]
         public class ImfManagerStatusChangedEventArgs : EventArgs
         {
+            /// <summary>
+            /// ImfManager
+            /// </summary>
+            /// <since_tizen> 3 </since_tizen>
             public ImfManager ImfManager
             {
                 get;
@@ -1156,7 +1301,8 @@ namespace Tizen.NUI
         /// <summary>
         /// ImfManager status changed.
         /// </summary>
-        [Obsolete("Please do not use! this will be deprecated")]
+        //Please do not use! this will be deprecated
+        [EditorBrowsable(EditorBrowsableState.Never)]
         public event EventHandler<ImfManagerStatusChangedEventArgs> ImfManagerStatusChanged
         {
             add
@@ -1200,6 +1346,10 @@ namespace Tizen.NUI
         /// </summary>
         public class StatusChangedEventArgs : EventArgs
         {
+            /// <summary>
+            /// ImfManager status
+            /// </summary>
+            /// <since_tizen> 3 </since_tizen>
             public bool StatusChanged
             {
                 get;
@@ -1214,6 +1364,7 @@ namespace Tizen.NUI
         /// <summary>
         /// ImfManager status changed.
         /// </summary>
+        /// <since_tizen> 4 </since_tizen>
         public event EventHandler<StatusChangedEventArgs> StatusChanged
         {
             add
@@ -1252,7 +1403,8 @@ namespace Tizen.NUI
         /// <summary>
         /// ImfManager status changed signal.
         /// </summary>
-        [Obsolete("Please do not use! this will be internal")]
+        //Please do not use! this will be internal
+        [EditorBrowsable(EditorBrowsableState.Never)]
         public StatusSignalType StatusChangedSignal()
         {
             StatusSignalType ret = new StatusSignalType(NDalicManualPINVOKE.ImfManager_StatusChangedSignal(swigCPtr), false);
@@ -1263,9 +1415,14 @@ namespace Tizen.NUI
         /// <summary>
         /// ImfManager resized event arguments.
         /// </summary>
-        [Obsolete("Please do not use! this will be deprecated")]
+        //Please do not use! this will be deprecated
+        [EditorBrowsable(EditorBrowsableState.Never)]
         public class ImfManagerResizedEventArgs : EventArgs
         {
+            /// <summary>
+            /// ImfManager
+            /// </summary>
+            /// <since_tizen> 3 </since_tizen>
             public ImfManager ImfManager
             {
                 get;
@@ -1280,7 +1437,8 @@ namespace Tizen.NUI
         /// <summary>
         /// ImfManager resized event.
         /// </summary>
-        [Obsolete("Please do not use! this will be deprecated")]
+        //Please do not use! this will be deprecated
+        [EditorBrowsable(EditorBrowsableState.Never)]
         public event EventHandler<ImfManagerResizedEventArgs> ImfManagerResized
         {
             add
@@ -1326,6 +1484,7 @@ namespace Tizen.NUI
         /// <summary>
         /// ImfManager resized.
         /// </summary>
+        /// <since_tizen> 4 </since_tizen>
         public event EventHandler Resized
         {
             add
@@ -1360,7 +1519,8 @@ namespace Tizen.NUI
         /// <summary>
         /// ImfManager resized signal.
         /// </summary>
-        [Obsolete("Please do not use! this will be internal")]
+        //Please do not use! this will be internal
+        [EditorBrowsable(EditorBrowsableState.Never)]
         public ImfVoidSignalType ResizedSignal()
         {
             ImfVoidSignalType ret = new ImfVoidSignalType(NDalicManualPINVOKE.ImfManager_ResizedSignal(swigCPtr), false);
@@ -1371,9 +1531,14 @@ namespace Tizen.NUI
         /// <summary>
         /// ImfManager language changed event arguments.
         /// </summary>
-        [Obsolete("Please do not use! this will be deprecated")]
+        //Please do not use! this will be deprecated
+        [EditorBrowsable(EditorBrowsableState.Never)]
         public class ImfManagerLanguageChangedEventArgs : EventArgs
         {
+            /// <summary>
+            /// ImfManager
+            /// </summary>
+            /// <since_tizen> 3 </since_tizen>
             public ImfManager ImfManager
             {
                 get;
@@ -1388,7 +1553,8 @@ namespace Tizen.NUI
         /// <summary>
         /// ImfManager language changed event.
         /// </summary>
-        [Obsolete("Please do not use! this will be deprecated")]
+        //Please do not use! this will be deprecated
+        [EditorBrowsable(EditorBrowsableState.Never)]
         public event EventHandler<ImfManagerLanguageChangedEventArgs> ImfManagerLanguageChanged
         {
             add
@@ -1434,6 +1600,7 @@ namespace Tizen.NUI
         /// <summary>
         /// ImfManager language changed.
         /// </summary>
+        /// <since_tizen> 4 </since_tizen>
         public event EventHandler LanguageChanged
         {
             add
@@ -1468,7 +1635,8 @@ namespace Tizen.NUI
         /// <summary>
         /// ImfManager language changed signal.
         /// </summary>
-        [Obsolete("Please do not use! this will be internal")]
+        //Please do not use! this will be internal
+        [EditorBrowsable(EditorBrowsableState.Never)]
         public ImfVoidSignalType LanguageChangedSignal()
         {
             ImfVoidSignalType ret = new ImfVoidSignalType(NDalicManualPINVOKE.ImfManager_LanguageChangedSignal(swigCPtr), false);
@@ -1481,6 +1649,10 @@ namespace Tizen.NUI
         /// </summary>
         public class KeyboardTypeChangedEventArgs : EventArgs
         {
+            /// <summary>
+            /// ImfManager keyboard type
+            /// </summary>
+            /// <since_tizen> 3 </since_tizen>
             public KeyboardType KeyboardType
             {
                 get;
@@ -1495,6 +1667,7 @@ namespace Tizen.NUI
         /// <summary>
         /// ImfManager keyboard type changed.
         /// </summary>
+        /// <since_tizen> 4 </since_tizen>
         public event EventHandler<KeyboardTypeChangedEventArgs> KeyboardTypeChanged
         {
             add
@@ -1538,8 +1711,9 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// The direction of text.
+        /// The direction of the text.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public enum TextDirection
         {
             /// <summary>
@@ -1555,6 +1729,7 @@ namespace Tizen.NUI
         /// <summary>
         /// Events that are generated by the IMF.
         /// </summary>
+        /// <since_tizen> 4 </since_tizen>
         public enum ImfEvent
         {
             /// <summary>
@@ -1566,15 +1741,15 @@ namespace Tizen.NUI
             /// </summary>
             Preedit,
             /// <summary>
-            /// Commit recieved.
+            /// Commit received.
             /// </summary>
             Commit,
             /// <summary>
-            /// Event to delete a range of characters from the string.
+            /// An event to delete a range of characters from the string.
             /// </summary>
             DeleteSurrounding,
             /// <summary>
-            /// Event to query string and cursor position.
+            /// An event to query string and the cursor position.
             /// </summary>
             GetSurrounding,
             /// <summary>
@@ -1584,8 +1759,9 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Enumeration for state of the input panel.
+        /// Enumeration for the state of the input panel.
         /// </summary>
+        /// <since_tizen> 4 </since_tizen>
         public enum State
         {
             /// <summary>
@@ -1607,12 +1783,13 @@ namespace Tizen.NUI
         }
 
         /// <summary>
-        /// Enumeration for the type of Keyboard.
+        /// Enumeration for the types of keyboard.
         /// </summary>
+        /// <since_tizen> 4 </since_tizen>
         public enum KeyboardType
         {
             /// <summary>
-            /// Software keyboard (Virtual keyboard) is default.
+            /// Software keyboard (virtual keyboard) is default.
             /// </summary>
             SoftwareKeyboard,
             /// <summary>
@@ -1621,4 +1798,4 @@ namespace Tizen.NUI
             HardwareKeyboard
         }
     }
-}
+}
\ No newline at end of file