Share via

ConversionModeChangedEventArgs.NewConversionMode Property

Definition

Namespace:
Windows.UI.Input.Preview.Text
Edit

Important

The Windows.UI.Input.Preview.Text APIs are part of a Limited Access Feature (see LimitedAccessFeatures class). Use the LAF Access Token Request Form to request an unlock token.

Gets the new conversion mode for the focused textbox after the conversion mode change event.

Note

To use this API in a Windows app being published to the Windows Store, you must declare the Text Input Method custom capability (Microsoft.appCategory.textInputMethod_8wekyb3d8bbwe) and request approval during the app submission process. See Custom capabilities for more info.

The Text Input Method capability enables several advanced features related to text input, including events for input focus (determining when to enter and exit) and the ability to read and write text within the current input focus's edit control.

public:
 property TextConversionMode NewConversionMode { TextConversionMode get(); };
TextConversionMode NewConversionMode();
public TextConversionMode NewConversionMode { get; }
var textConversionMode = conversionModeChangedEventArgs.newConversionMode;
Public ReadOnly Property NewConversionMode As TextConversionMode

Property Value

TextConversionMode

A TextConversionMode value that represents the new conversion mode state for the focused textbox.

Remarks

This property indicates the conversion mode that has been applied to the focused textbox as a result of user actions, application changes, or focus movement. The conversion mode determines how keyboard input is processed and converted by the Input Method Editor (IME).

The conversion mode change can occur due to:

  • User switching between different input modes
  • Application programmatically changing the conversion mode
  • Focus moving between textboxes with different input requirements
  • Changes in the textbox's input scope or settings

Applies to

See also