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. Through the CommandErrorEventArgs, you can access the following property:
-
Exception: Gets the currently thrown exception.
-
Exception: Gets the currently thrown exception.
-
CommandExecuted: Occurs when a command gets executed. Through the ImageCommandExecutedEventArgs, you can access the following properties:
-
Command: Gets the current executed command.
-
CommandParameter: Gets the current executed command parameter.
-
Command: Gets the current executed command.
-
CommandExecuting: Occurs before a command gets executed. Through the ImageCommandExecutingEventArgs, you can access the following properties:
-
Command: Gets the current executed command.
-
CommandParameter: Gets the current executed command parameter.
-
Command: Gets the current executed command.
ImageViewSizeChanged: Occurs when the ImageViewSize property changes.
ImageViewSize property of the RadImageEditor's holds the actual image size (with scaling) set to the control.
IsReadOnlyChanged: Occurs when the IsReadOnly property changes.
ScaleFactorChanged: Occurs when the ScaleFactor value has changed.
-
ToolCommitted: Occurs when a tool is committed. Through the ToolCommittedEventArgs, you can access the following properties:
- Tool: Gets the current executed tool.
- ExecuteSameToolAfterCommit: Gets or sets a value indicating whether the tool is preserved as a current executing tool. If set to false, the current executing tool will be deactivated.
-
ToolCommitting: Occurs before a tool is committed. Through the ToolCommittingEventArgs, you can access the following property:
-
Tool: Gets the current executed tool.
-
Tool: Gets the current executed tool.
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.