Class ImfManager

Definition

Namespace:: Tizen.NUI

Assembly:: Tizen.NUI.dll

Specifically manages the input method framework which enables the virtual or hardware keyboards.

public class ImfManager : BaseHandle, IDisposable

Inheritance: object

BaseHandle

ImfManager

Implements: System.IDisposable

Constructors

View Source

ImfManager()

The constructor.

Declaration

public ImfManager()

Methods

View Source

Activate()

Activates the IMF.
It means that the text editing is started somewhere.
If the hardware keyboard isn't connected, then it will show the virtual keyboard.

Declaration

public void Activate()

View Source

AutoEnableInputPanel(bool)

Enables to show the input panel automatically when focused.

Declaration

public void AutoEnableInputPanel(bool enabled)

Parameters

Type	Name	Description
bool	enabled	If true, the input panel will be shown when focused.

View Source

Deactivate()

Deactivates the IMF.
It means that the text editing is finished somewhere.

Declaration

public void Deactivate()

View Source

Get()

Retrieves a handle to the instance of the ImfManager.

Declaration

public static ImfManager Get()

Returns

Type	Description
ImfManager	A handle to the ImfManager.

View Source

GetCursorPosition()

Gets the cursor position stored in VirtualKeyboard, this is required by the IMF context.

Declaration

public uint GetCursorPosition()

Returns

Type	Description
uint	The current position of the cursor.

View Source

GetInputMethodArea()

Provides the size and the position of the keyboard.
The position is relative to whether the keyboard is visible or not.
If the keyboard is not visible, then the position will be off the screen.
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().

Declaration

public Rectangle GetInputMethodArea()

Returns

Type	Description
Rectangle	Rectangle which is keyboard panel x, y, width, height.

View Source

GetInputPanelLocale()

Gets the current language locale of the input panel.
For example, en_US, en_GB, en_PH, fr_FR, ...

Declaration

public string GetInputPanelLocale()

Returns

Type	Description
string	The current language locale of the input panel.

View Source

GetInputPanelState()

Gets the state of the current active input panel.

Declaration

public ImfManager.State GetInputPanelState()

Returns

Type	Description
ImfManager.State	The state of the input panel.

View Source

GetInputPanelUserData(out string)

Gets the specific data of the current active input panel.

Declaration

public void GetInputPanelUserData(out string text)

Parameters

Type	Name	Description
string	text	The specific data to be received from the input panel.

View Source

GetKeyboardType()

Gets the keyboard type.
The default keyboard type is SoftwareKeyboard.

Declaration

public ImfManager.KeyboardType GetKeyboardType()

Returns

Type	Description
ImfManager.KeyboardType	The keyboard type.

View Source

GetSurroundingText()

Gets the current text string set within the IMF manager, this is used to offer predictive suggestions.

Declaration

public string GetSurroundingText()

Returns

Type	Description
string	The surrounding text.

View Source

GetTextDirection()

Returns the text direction of the keyboard's current input language.

Declaration

public ImfManager.TextDirection GetTextDirection()

Returns

Type	Description
ImfManager.TextDirection	The direction of the text.

View Source

HideInputPanel()

Hides the input panel.

Declaration

public void HideInputPanel()

View Source

NotifyCursorPosition()

Notifies the IMF context that the cursor position has changed, required for features like auto-capitalization.

Declaration

public void NotifyCursorPosition()

View Source

NotifyTextInputMultiLine(bool)

Notifies the IMF context that text input is set to multiline or not.

Declaration

public void NotifyTextInputMultiLine(bool multiLine)

Parameters

Type	Name	Description
bool	multiLine	True if multiline text input is used.

View Source

Reset()

Sends a message reset to the preedit state or the IMF module.

Declaration

public void Reset()

View Source

RestoreAfterFocusLost()

Gets the restoration status which controls if the keyboard is restored after the focus is lost and then regained.
If true, then the keyboard will be restored (activated) after focus is regained.

Declaration

public bool RestoreAfterFocusLost()

Returns

Type	Description
bool	The restoration status.

View Source

SetCursorPosition(uint)

Sets the cursor position stored in VirtualKeyboard, this is required by the IMF context.

Declaration

public void SetCursorPosition(uint cursorPosition)

Parameters

Type	Name	Description
uint	cursorPosition	The position of the cursor.

View Source

SetInputPanelUserData(string)

Sets up the input-panel specific data.

Declaration

public void SetInputPanelUserData(string text)

Parameters

Type	Name	Description
string	text	The specific data to be set to the input panel.

View Source

SetRestoreAfterFocusLost(bool)

Sets the status whether the IMF has to restore the keyboard after losing focus.

Declaration

public void SetRestoreAfterFocusLost(bool toggle)

Parameters

Type	Name	Description
bool	toggle	True means that keyboard should be restored after the focus is lost and regained.

View Source

SetReturnKeyState(bool)

Sets the return key on the input panel to be visible or invisible.
The default is true.

Declaration

public void SetReturnKeyState(bool visible)

Parameters

Type	Name	Description
bool	visible	True if the return key is visible (enabled), false otherwise.

View Source

SetSurroundingText(string)

A method to store the string required by the IMF, this is used to provide predictive word suggestions.

Declaration

public void SetSurroundingText(string text)

Parameters

Type	Name	Description
string	text	The text string surrounding the current cursor point.

View Source

ShowInputPanel()

Shows the input panel.

Declaration

public void ShowInputPanel()

Events

View Source

Activated

ImfManager activated.

Declaration

public event EventHandler<ImfManager.ActivatedEventArgs> Activated

Event Type

Type	Description
System.EventHandler<TEventArgs><ImfManager.ActivatedEventArgs>

View Source

EventReceived

ImfManager event received.

Declaration

public event EventHandlerWithReturnType<object, ImfManager.EventReceivedEventArgs, ImfManager.ImfCallbackData> EventReceived

Event Type

Type	Description
EventHandlerWithReturnType<object, ImfManager.EventReceivedEventArgs, ImfManager.ImfCallbackData>

View Source

KeyboardTypeChanged

ImfManager keyboard type changed.

Declaration

public event EventHandler<ImfManager.KeyboardTypeChangedEventArgs> KeyboardTypeChanged

Event Type

Type	Description
System.EventHandler<TEventArgs><ImfManager.KeyboardTypeChangedEventArgs>

View Source

LanguageChanged

ImfManager language changed.

Declaration

public event EventHandler<ImfManager.LanguageChangedEventArgs> LanguageChanged

Event Type

Type	Description
System.EventHandler<TEventArgs><ImfManager.LanguageChangedEventArgs>

View Source

Resized

ImfManager resized.

Declaration

public event EventHandler<ImfManager.ResizedEventArgs> Resized

Event Type

Type	Description
System.EventHandler<TEventArgs><ImfManager.ResizedEventArgs>

View Source

StatusChanged

ImfManager status changed.

Declaration

public event EventHandler<ImfManager.StatusChangedEventArgs> StatusChanged

Event Type

Type	Description
System.EventHandler<TEventArgs><ImfManager.StatusChangedEventArgs>

Implements

System.IDisposable