PictureEdit.ShowImageEditorDialog() Method

Displays the Image Editor dialog, which allows users to perform basic edit operations on the image (crop, rotate, brightness and contrast adjustment, etc.).

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v20.1.dll

Declaration

public DialogResult ShowImageEditorDialog()
Public Function ShowImageEditorDialog As DialogResult

Returns

Type Description
DialogResult

The DialogResult.OK value if the image has been modified and saved by the PictureEdit control; The DialogResult.Cancel value if changes (if any) made in the editor have been discarded.

Remarks

If the RepositoryItemPictureEdit.ShowEditMenuItem property is set to True, end-users can click the Edit menu command to edit the current image in a separate Image Editor dialog.

The ShowImageEditorDialog method allows you to invoke this dialog from code. When a user modifies an image and then click the Save button, the image is saved back in the PictureEdit control and the ShowImageEditorDialog method returns the DialogResult.OK value.

The Image Editor dialog provides basic image edit operations:

  • Crop and straighten
  • Adjust brightness, contrast and saturation
  • Mirror
  • Rotate
  • etc.

The Image Editor maintains the operation history and provides the undo and redo functionality. Once the editor is closed and changes are saved, the modifications cannot be undone.

Handle the PictureEdit.ImageEditorDialogShowing/RepositoryItemPictureEdit.ImageEditorDialogShowing event to customize the Image Editor dialog.

The PictureEdit.ImageEditorDialogClosed/RepositoryItemPictureEdit.ImageEditorDialogClosed event fires when the dialog is closed.

See Also