EditingCommands.Backspace Property

Definition

Namespace:

System.Windows.Documents

Assembly:

PresentationFramework.dll

Represents the Backspace command, which requests that a backspace be entered at the current position or over the current selection.

public:
 static property System::Windows::Input::RoutedUICommand ^ Backspace { System::Windows::Input::RoutedUICommand ^ get(); };

public static System.Windows.Input.RoutedUICommand Backspace { get; }

static member Backspace : System.Windows.Input.RoutedUICommand

Public Shared ReadOnly Property Backspace As RoutedUICommand

Property Value

RoutedUICommand

The requested command. The default key gesture for this command is Backspace.

Examples

The following example demonstrates how to invoke an editing command on an object that supports the command.

For this example, a RichTextBox serves as the command target. Note that RichTextBox implements the IInputElement interface (inherited from FrameworkElement), and that it includes native support for many editing commands.

The first argument for the Execute method is a command parameter. Most editing commands ignore the command parameter; in general, this parameter should be null for editing commands.

The second argument specifies the object to which the command will be routed. This object must implement the IInputElement interface, and should include a handler for the specified command. Generally, a command is ignored when invoked on an object that does not handle the command.

RichTextBox rTB = new RichTextBox();

EditingCommands.ToggleInsert.Execute(null, rTB);

Dim rTB As New RichTextBox()

EditingCommands.ToggleInsert.Execute(Nothing, rTB)

Remarks

When invoked on an empty selection, this command deletes the character or paragraph separator just before the caret. When invoked on a non-empty selection, this command deletes the selection.

This command retains any formatting from the deleted selection for content immediately inserted at the same location after this command is invoked. Contrast with the Delete command, which does not retain previous formatting.

There is not necessarily an actual implementation that responds to this command on any given object; in many cases the implementation that responds to a command is the responsibility of the application writer.

This command is natively supported by RichTextBox, TextBox, and PasswordBox.

XAML Attribute Usage

<object property="Backspace"/>