ConversionModeChangedEventArgs Class
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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.
Provides event data for the ConversionModeChanged event that occurs when the conversion mode changes for the focused textbox.
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 ref class ConversionModeChangedEventArgs sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.UI.Input.Preview.Text.PreviewTextContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ConversionModeChangedEventArgs final[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.UI.Input.Preview.Text.PreviewTextContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ConversionModeChangedEventArgsPublic NotInheritable Class ConversionModeChangedEventArgs- Inheritance
- Attributes
Windows requirements
| Requirements | Description |
|---|---|
| Device family |
Windows Desktop Extension SDK (introduced in 10.0.26100.0)
|
| API contract |
Windows.UI.Input.Preview.Text.PreviewTextContract (introduced in v1.0)
|
Remarks
This class is used as the event argument for the ConversionModeChanged event in the KeyboardInputProcessor class. The conversion mode change can occur due to user actions, application changes, or focus movement between textboxes with different input requirements.
The conversion mode determines how keyboard input is processed and converted by the Input Method Editor (IME). For more information about keyboard IME conversion modes, see IME Conversion Mode Values.
Properties
| Name | Description |
|---|---|
| NewConversionMode |
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. |