ShowFontFormCommand.ForceExecute(ICommandUIState) Method

Executes the command specifying the UI state explicitly.

Namespace: DevExpress.XtraRichEdit.Commands

Assembly: DevExpress.RichEdit.v24.2.Core.dll

NuGet Package: DevExpress.RichEdit.Core

Declaration

C#

public override void ForceExecute(
    ICommandUIState state
)

VB.NET

Public Overrides Sub ForceExecute(
    state As ICommandUIState
)

Parameters

Name	Type	Description
state	ICommandUIState	An object which implements the ICommandUIState interface.

Remarks

The Command.Execute method performs the UI state check implicitly, so you cannot bring the command to action arbitrarily. Unlike the Execute method, the ForceExecute method enables you to check the UI state for the command, and then deliberately and unconditionally start its execution, or decline it.

The following code sample illustrates how you can invoke the Font form for the read-only RichEdit control, to change the selection font. You can check the ICommandUIState of the command., decide whether it should be changed and change it to execute the command.

C#

using DevExpress.Utils.Commands;
using DevExpress.XtraRichEdit.Commands;
// ...
ShowFontFormCommand cmd = new ShowFontFormCommand(richEditControl1);
ICommandUIState state = cmd.CreateDefaultCommandUIState();
cmd.UpdateUIState(state);
if (!state.Enabled && richEditControl1.ReadOnly) state.Enabled = true;
cmd.ForceExecute(state);

VB.NET

Imports DevExpress.Utils.Commands
Imports DevExpress.XtraRichEdit.Commands
' ...
Private Sub simpleButton3_Click(ByVal sender As Object, ByVal e As EventArgs)
Dim cmd As ShowFontFormCommand = New ShowFontFormCommand(richEditControl1)
Dim state As ICommandUIState = cmd.CreateDefaultCommandUIState()
cmd.UpdateUIState(state)
If (Not state.Enabled) AndAlso richEditControl1.ReadOnly Then
state.Enabled = True
End If
cmd.ForceExecute(state)
End Sub