CoreTextSelectionRequest
CoreTextSelectionRequest
CoreTextSelectionRequest
CoreTextSelectionRequest
Class
Definition
Represents information about a SelectionRequested event.
public : sealed class CoreTextSelectionRequest : ICoreTextSelectionRequestpublic sealed class CoreTextSelectionRequest : ICoreTextSelectionRequestPublic NotInheritable Class CoreTextSelectionRequest Implements ICoreTextSelectionRequest// You can use this class in JavaScript.
- Attributes
| Device family |
Windows 10 (introduced v10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduced v1)
|
Remarks
An object of this type can be obtained from the CoreTextSelectionRequestedEventArgs.Request property inside a handler for the CoreTextEditContext.SelectionRequested event handler.
Properties
IsCanceled IsCanceled IsCanceled IsCanceled
Gets a value that indicates whether the selection request operation is canceled.
public : PlatForm::Boolean IsCanceled { get; }public bool IsCanceled { get; }Public ReadOnly Property IsCanceled As bool// You can use this property in JavaScript.
- Value
- PlatForm::Boolean bool bool bool
true if the selection request operation is canceled; otherwise, false.
Examples
// Notify Windows that the deferred operation is beginning
if (!args.IsCanceled)
{
// Perform deferred operation
// …
// Notify Windows that the deferred operation is complete
deferral.Complete();
}
Remarks
If the app defers the operation, it is possible for it to be canceled before the app responds to it. For this reason, you should read this property, only once, immediately before responding to a deferred operation.
Note
The "getter" for the IsCanceled property notifies Windows that the app is beginning the deferred operation. You should consider reading this property as a required step before you perform the deferred operation. Use the pattern shown in the example when reading IsCanceled.
Selection Selection Selection Selection
Gets or sets the selection range that the text input server is requesting. The application should set the current range of selection before returning from the event handler.
public : CoreTextRange Selection { get; set; }public CoreTextRange Selection { get; set; }Public ReadWrite Property Selection As CoreTextRange// You can use this property in JavaScript.
The selection range that the server is requesting. The default is null.
Methods
GetDeferral() GetDeferral() GetDeferral() GetDeferral()
Requests that the selection request operation be delayed. Call this method if your text input control is hosted on a worker thread rather than on the UI thread.
public : Deferral GetDeferral()public Deferral GetDeferral()Public Function GetDeferral() As Deferral// You can use this method in JavaScript.