Events
This topic covers the specific events exposed by the RadImageEditor control.
RadImageEditor raises the following events:
-
CommandError: Occurs when an error gets thrown while executing a command. The event handler receives two arguments:
The sender argument contains the RadImageEditor. The argument is of type object but can be cast to the RadImageEditor type.
A CommandErrorEventArgs object which allows you to get the Exception or access whether the error is Handled.
-
CommandExecuted: Occurs when a command gets executed. The event handler receives two arguments:
The sender argument contains the RadImageEditor. The argument is of type object but can be cast to the RadImageEditor type.
A ImageCommandExecutedEventArgs object which allows you to get obtain the command that was executed and its command parameter.
-
CommandExecuting: Occurs before a command gets executed. The event handler receives two arguments:
The sender argument contains the RadImageEditor. The argument is of type object but can be cast to the RadImageEditor type.
A ImageCommandExecutingEventArgs object which allows you to get obtain the command that is to be executed and its command parameter.
-
ImageViewSizeChanged: Occurs when the ImageViewSize property changes. The event handler receives two arguments:
The sender argument contains the RadImageEditor. The argument is of type object but can be cast to the RadImageEditor type.
An EventArgs object.
-
IsReadOnlyChanged: Occurs when the IsReadOnly property changes. The event handler receives two arguments:
The sender argument contains the RadImageEditor. The argument is of type object but can be cast to the RadImageEditor type.
An EventArgs object.
-
ScaleFactorChanged: Occurs when the ScaleFactor value has changed. The event handler receives two arguments:
The sender argument contains the RadImageEditor. The argument is of type object but can be cast to the RadImageEditor type.
An EventArgs object.
-
ToolCommitted: Occurs when a tool is committed. The event handler receives two arguments:
The sender argument contains the RadImageEditor. The argument is of type object but can be cast to the RadImageEditor type.
A ToolCommittedEventArgs object which allows you access to the executed tool and provides an option to specify whether the tool should be executed again.
-
ToolCommitting: Occurs before a tool is committed. The event handler receives two arguments:
The sender argument contains the RadImageEditor. The argument is of type object but can be cast to the RadImageEditor type.
A ToolCommittingEventArgs object which allows you access to the tool being executed and provides an option to cancel the execution.
When a tool is executed, the CommandExecuting/ CommandExecuted events are raised for the ExecuteToolCommand. The specific tool is available from the CommandParameter, however you cannot control its behavior (for example, cancel it). For this purpose the ToolCommitting/ToolCommitted events are raised. You can find a working example of their use in our online SDK reporitory: Handle Tool Commit.