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.
  • 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.
  • 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.
  • 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.

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.

See Also

In this article
Not finding the help you need? Improve this article