New to Telerik UI for WinFormsStart a free 30-day trial

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.UI.dll

Syntax:

C#
[TelerikToolboxCategory("Editors")]
[Docking(DockingBehavior.Ask)]
public class RadImageEditor : RadControl, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IAnalyticsProvider

Inheritance: objectMarshalByRefObjectComponentControlScrollableControlRadControlRadImageEditor...

Implements: IAnalyticsProviderIBindableComponentIComponentIComponentTreeHandlerIDisposableIDropTargetILayoutHandlerINotifyPropertyChangedISupportInitializeISupportInitializeNotificationISynchronizeInvokeIWin32Window...

Inherited Members RadControl.isResizing2RadControl.isDisposing2RadControl.invalidResizeRectRadControl.isAccessibilityRequestedRadControl.Dispose(bool)RadControl.Construct()RadControl.CreateBehavior()RadControl.CreateRootElement()RadControl.InitializeRootElement(RootRadElement)RadControl.LoadElementTree()RadControl.LoadElementTree(Size)RadControl.SetBackColorThemeOverrides()RadControl.ResetBackColorThemeOverrides()RadControl.SetForeColorThemeOverrides()RadControl.ResetForeColorThemeOverrides()RadControl.OnPreviewKeyDown(PreviewKeyDownEventArgs)RadControl.OnClick(EventArgs)RadControl.OnDoubleClick(EventArgs)RadControl.OnMouseCaptureChanged(EventArgs)RadControl.OnGotFocus(EventArgs)RadControl.OnLostFocus(EventArgs)RadControl.OnCreateControl()RadControl.OnHandleDestroyed(EventArgs)RadControl.OnParentChanged(EventArgs)RadControl.OnVisibleChanged(EventArgs)RadControl.OnFontChanged(EventArgs)RadControl.OnForeColorChanged(EventArgs)RadControl.OnBackColorChanged(EventArgs)RadControl.OnEnabledChanged(EventArgs)RadControl.OnBindingContextChanged(EventArgs)RadControl.OnLocationChanged(EventArgs)RadControl.OnPaddingChanged(EventArgs)RadControl.OnRightToLeftChanged(EventArgs)RadControl.OnPaint(PaintEventArgs)RadControl.OnLayout(LayoutEventArgs)RadControl.OnAutoSizeChanged(EventArgs)RadControl.WndProc(ref Message)RadControl.OnInvalidated(RadElement)RadControl.OnLoad(Size)RadControl.OnCaptureLosing()RadControl.OnToolTipTextNeeded(object, ToolTipTextNeededEventArgs)RadControl.OnScreenTipNeeded(object, ScreenTipNeededEventArgs)RadControl.OnThemeNameChanged(ThemeNameChangedEventArgs)RadControl.ProcessMnemonic(char)RadControl.ProcessFocusRequested(RadElement)RadControl.ProcessCaptureChangeRequested(RadElement, bool)RadControl.ProcessAutoSizeChanged(bool)RadControl.IsInputKey(Keys)RadControl.GetInputElement()RadControl.BeginInit()RadControl.EndInit()RadControl.OnNotifyPropertyChanged(string)RadControl.OnNotifyPropertyChanged(PropertyChangedEventArgs)RadControl.GetPreferredSize(Size)RadControl.SetBoundsCore(int, int, int, int, BoundsSpecified)RadControl.GetRootElementDesiredSize(int, int, int, int)RadControl.OnZoomGesture(ZoomGestureEventArgs)RadControl.OnRotateGesture(RotateGestureEventArgs)RadControl.OnPanGesture(PanGestureEventArgs)RadControl.OnTwoFingerTapGesture(GestureEventArgs)RadControl.OnPressAndTapGesture(PressAndTapGestureEventArgs)RadControl.OnGesture(GestureEventArgs)RadControl.ProcessGesture(Message)RadControl.EnableGesture(GestureType)RadControl.DisableGesture(GestureType)RadControl.Refresh()RadControl.SuspendUpdate()RadControl.ResumeUpdate()RadControl.ResumeUpdate(bool)RadControl.InvokeLayoutCallback(LayoutCallback)RadControl.RegisterHostedControl(RadHostItem)RadControl.UnregisterHostedControl(RadHostItem, bool)RadControl.ResolveStyleGroupForElement(StyleGroup, RadObject)RadControl.GetPlainText()RadControl.ShouldSerializeProperty(RadProperty)RadControl.ShouldSerializeProperty(RadProperty, RadObject)RadControl.ResetProperty(RadProperty, RadObject)RadControl.CanEditElementAtDesignTime(RadElement)RadControl.ProcessCodedUIMessage(ref IPCMessage)RadControl.FindPropertyInChildren(RadControl, IPCMessage)RadControl.ScaleControl(SizeF, BoundsSpecified)RadControl.PerformRadAutoScale(BoundsSpecified?)RadControl.GetMonitorDpiScaleFactor(Control)RadControl.SetRadAutoScale(bool)RadControl.EnableDpiScalingRadControl.EnableRadAutoScaleRadControl.EnableRadFormInitialDpiScalingRadControl.EnableImageDpiScalingRadControl.EnableSvgImagesRadControl.IsLoadedRadControl.ElementTreeRadControl.UseCompatibleTextRenderingDefaultValueRadControl.BehaviorRadControl.RootElementRadControl.PaddingRadControl.ThemeNameRadControl.TextRadControl.EnableThemingRadControl.ThemeClassNameRadControl.ImageListRadControl.ImageScalingSizeRadControl.UseCompatibleTextRenderingRadControl.AutoSizeRadControl.MaximumSizeRadControl.MinimumSizeRadControl.FocusableRadControl.SiteRadControl.CausesValidationRadControl.IsInitializingRadControl.SmallImageListRadControl.SmallImageScalingSizeRadControl.IsDesignModeRadControl.IsDisplayedRadControl.FocusedElementRadControl.AllowShowFocusCuesRadControl.ShowItemToolTipsRadControl.CommandBindingsRadControl.EnableKeyMapRadControl.BackColorRadControl.ForeColorRadControl.FontRadControl.ValidationCancelRadControl.EnableAnalyticsRadControl.AnalyticsNameRadControl.EnableRadAccessibilityObjectsRadControl.EnableCodedUITestsRadControl.EnableCodedUITestsDefaultValueRadControl.EnableUIAutomationRadControl.EnableUIAutomationDefaultValueRadControl.ElementInvalidatedRadControl.ToolTipTextNeededRadControl.ScreenTipNeededRadControl.ThemeNameChangedRadControl.InitializedRadControl.PropertyChangedRadControl.ZoomGestureRadControl.RotateGestureRadControl.PanGestureRadControl.TwoFingerTapGestureRadControl.PressAndTapGesture...

Constructors

Initializes a new instance of the RadImageEditor class.

C#
public RadImageEditor()

Properties

Gets or sets the path that will be used for save operations.

C#
public string BitmapPath { get; set; }

Gets or sets the current bitmap. If you want to open an image for edit use one of the OpenImage methods.

C#
public Bitmap CurrentBitmap { get; set; }

Gets the default size for this RadImageEditor control.

C#
protected override Size DefaultSize { get; }

Overrides: Control.DefaultSize

Gets the main element of the editor.

C#
public RadImageEditorElement ImageEditorElement { get; }

Gets or sets the zoom factor of the editor.

C#
public SizeF ZoomFactor { get; set; }

Methods

Cancels the asynchronous loading operation.

C#
public virtual void CancelAsync()

Creates the child items for this RadImageEditor control.

C#
protected override void CreateChildItems(RadElement parent)
Parameters:parentRadElement

The parent element to add child items to.

Overrides: RadControl.CreateChildItems(RadElement)

Creates the main image editor element for this control.

C#
protected virtual RadImageEditorElement CreateImageEditorElement()
Returns:

RadImageEditorElement

A new RadImageEditorElement instance.

Loads an image asynchronously.

C#
public virtual void LoadAsync()

Loads an image asynchronously from the specified URL.

C#
public virtual void LoadAsync(string url)
Parameters:urlstring

The URL of the image to load.

Raises the event and opens the dropped image file.

C#
protected override void OnDragDrop(DragEventArgs e)
Parameters:eDragEventArgs

The event arguments containing the drag and drop data.

Overrides: Control.OnDragDrop(DragEventArgs)

Raises the event and sets the drag effect for file drops.

C#
protected override void OnDragEnter(DragEventArgs e)
Parameters:eDragEventArgs

The event arguments containing the drag and drop data.

Overrides: Control.OnDragEnter(DragEventArgs)

Raises the event.

C#
protected override void OnKeyDown(KeyEventArgs e)
Parameters:eKeyEventArgs

The KeyEventArgs instance containing the event data.

Overrides: RadControl.OnKeyDown(KeyEventArgs)

Raises the event.

C#
protected override void OnKeyPress(KeyPressEventArgs e)
Parameters:eKeyPressEventArgs

The KeyPressEventArgs instance containing the event data.

Overrides: RadControl.OnKeyPress(KeyPressEventArgs)

Raises the event.

C#
protected override void OnKeyUp(KeyEventArgs e)
Parameters:eKeyEventArgs

The KeyEventArgs instance containing the event data.

Overrides: RadControl.OnKeyUp(KeyEventArgs)

Raises the MouseClick event.

C#
protected override void OnMouseClick(MouseEventArgs e)
Parameters:eMouseEventArgs

An MouseEventArgs that contains the event data.

Overrides: Control.OnMouseClick(MouseEventArgs)

Raises the MouseDoubleClick event.

C#
protected override void OnMouseDoubleClick(MouseEventArgs e)
Parameters:eMouseEventArgs

An MouseEventArgs that contains the event data.

Overrides: Control.OnMouseDoubleClick(MouseEventArgs)

Raises the event.

C#
protected override void OnMouseDown(MouseEventArgs e)
Parameters:eMouseEventArgs

The MouseEventArgs instance containing the event data.

Overrides: RadControl.OnMouseDown(MouseEventArgs)

Raises the event.

C#
protected override void OnMouseEnter(EventArgs e)
Parameters:eEventArgs

The EventArgs instance containing the event data.

Overrides: RadControl.OnMouseEnter(EventArgs)

Raises the event.

C#
protected override void OnMouseHover(EventArgs e)
Parameters:eEventArgs

The EventArgs instance containing the event data.

Overrides: RadControl.OnMouseHover(EventArgs)

Raises the event.

C#
protected override void OnMouseLeave(EventArgs e)
Parameters:eEventArgs

The EventArgs instance containing the event data.

Overrides: RadControl.OnMouseLeave(EventArgs)

Raises the event.

C#
protected override void OnMouseMove(MouseEventArgs e)
Parameters:eMouseEventArgs

The MouseEventArgs instance containing the event data.

Overrides: RadControl.OnMouseMove(MouseEventArgs)

Raises the event.

C#
protected override void OnMouseUp(MouseEventArgs e)
Parameters:eMouseEventArgs

The MouseEventArgs instance containing the event data.

Overrides: RadControl.OnMouseUp(MouseEventArgs)

Raises the event.

C#
protected override void OnMouseWheel(MouseEventArgs e)
Parameters:eMouseEventArgs

The MouseEventArgs instance containing the event data.

Overrides: RadControl.OnMouseWheel(MouseEventArgs)

Raises the event and updates auto zoom if applicable.

C#
protected override void OnSizeChanged(EventArgs e)
Parameters:eEventArgs

The event arguments.

Overrides: Control.OnSizeChanged(EventArgs)

Raises the event and updates command icons.

C#
protected override void OnThemeChanged()

Overrides: RadControl.OnThemeChanged()

Opens an image file for editing using a file dialog.

C#
public virtual void OpenImage()

Opens a bitmap image for editing.

C#
public virtual void OpenImage(Bitmap bitmap)
Parameters:bitmapBitmap

The bitmap to open.

Opens an image file for editing.

C#
public virtual void OpenImage(string fileName)
Parameters:fileNamestring

The name of the file to open.

Saves the current image to the default path.

C#
public virtual void SaveImage()

Saves the current image to the specified stream with the specified format.

C#
public virtual void SaveImage(Stream stream, ImageFormat imageFormat)
Parameters:streamStream

The stream to save the image to.

imageFormatImageFormat

The format in which to save the image.

Saves the current image to the specified stream.

C#
public virtual void SaveImage(Stream stream)
Parameters:streamStream

The stream to save the image to.

Saves the current image to the specified path with the specified format.

C#
public virtual void SaveImage(string path, ImageFormat imageFormat)
Parameters:pathstring

The path where the image will be saved.

imageFormatImageFormat

The format in which to save the image.

Saves the current image to the specified path.

C#
public virtual void SaveImage(string path)
Parameters:pathstring

The path where the image will be saved.

Saves an image using a file dialog.

C#
public virtual void SaveImageAs()

Shows the blur filter dialog for applying blur effects.

C#
public virtual void ShowBlurDialog()

Shows the canvas resize dialog for changing canvas dimensions and background.

C#
public virtual void ShowCanvasResizeDialog()

Shows the contrast adjustment dialog for modifying image contrast and brightness.

C#
public virtual void ShowContrastDialog()

Shows the free drawing dialog for freehand drawing on the image.

C#
public virtual void ShowDrawDialog()

Shows the shape drawing dialog for adding geometric shapes to the image.

C#
public virtual void ShowDrawShapeDialog()

Shows the text drawing dialog for adding text to the image.

C#
public virtual void ShowDrawTextDialog()

Shows the hue shift dialog for adjusting image hue values.

C#
public virtual void ShowHueDialog()

Shows the resize dialog for changing image dimensions.

C#
public virtual void ShowResizeDialog()

Shows the round corners dialog for applying rounded corner effects.

C#
public virtual void ShowRoundCornersDialog()

Shows the saturation adjustment dialog for modifying image saturation levels.

C#
public virtual void ShowSaturationDialog()

Shows the sharpen filter dialog for applying sharpening effects.

C#
public virtual void ShowSharpenDialog()

Events

Occurs after a specific operation is performed over the image.

C#
public event ImageChangedEventHandler CurrentImageChanged

Occurs when the progress of an async load operation changes.

C#
public event ProgressChangedEventHandler ImageLoadAsyncProgressChanged

Occurs after an image is loaded in the editor.

C#
public event AsyncCompletedEventHandler ImageLoaded

Occurs after an image is saved.

C#
public event EventHandler ImageSaved

Occurs when an operation results in an error or an exception.

C#
public event ErrorEventHandler OperationError