This documentation is archived and is not being maintained.

ImageEditor Class

Provides a user interface for selecting an image for a property in a property grid.

Namespace:  System.Drawing.Design
Assembly:  System.Drawing.Design (in System.Drawing.Design.dll)

[SecurityPermissionAttribute(SecurityAction.Demand, Flags = SecurityPermissionFlag.UnmanagedCode)]
public class ImageEditor : UITypeEditor

The ImageEditor type exposes the following members.

Public methodImageEditorInitializes a new instance of the ImageEditor class.

Public propertyIsDropDownResizableGets a value indicating whether drop-down editors should be resizable by the user. (Inherited from UITypeEditor.)

Protected methodStatic memberCreateExtensionsStringCreates a string of file name extensions using the specified array of file extensions and the specified separator.
Protected methodStatic memberCreateFilterEntryCreates a filter entry for a file dialog box's file list.
Public methodEditValue(IServiceProvider, Object)Edits the value of the specified object using the editor style indicated by the GetEditStyle method. (Inherited from UITypeEditor.)
Public methodEditValue(ITypeDescriptorContext, IServiceProvider, Object)Edits the specified object value using the edit style provided by the GetEditStyle method. (Overrides UITypeEditor.EditValue(ITypeDescriptorContext, IServiceProvider, Object).)
Public methodEquals(Object)Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetEditStyle()Gets the editor style used by the EditValue method. (Inherited from UITypeEditor.)
Public methodGetEditStyle(ITypeDescriptorContext)Gets the editing style of the EditValue method. (Overrides UITypeEditor.GetEditStyle(ITypeDescriptorContext).)
Protected methodGetExtensionsGets the extensions for the file-list filter that this editor initially uses to filter the file list.
Protected methodGetFileDialogDescriptionGets the description for the default file-list filter provided by this editor.
Public methodGetHashCodeServes as a hash function for a particular type. (Inherited from Object.)
Protected methodGetImageExtendersGets an array of supported image types.
Public methodGetPaintValueSupported()Indicates whether this editor supports painting a representation of an object's value. (Inherited from UITypeEditor.)
Public methodGetPaintValueSupported(ITypeDescriptorContext)Gets a value indicating whether this editor supports painting a representation of an object's value. (Overrides UITypeEditor.GetPaintValueSupported(ITypeDescriptorContext).)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodLoadFromStreamLoads an image from the specified stream.
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodPaintValue(PaintValueEventArgs)Paints a value indicated by the specified PaintValueEventArgs. (Overrides UITypeEditor.PaintValue(PaintValueEventArgs).)
Public methodPaintValue(Object, Graphics, Rectangle)Paints a representation of the value of the specified object to the specified canvas. (Inherited from UITypeEditor.)
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)

An ImageEditor is a UITypeEditor that provides a user interface for the user to select an image for a property. When the user starts the editor, it displays an Open File dialog box that enables the user to navigate to a directory and select a file. The file list is initially filtered by the default file name extensions for the editor.

The following code example uses an EditorAttribute to associate the ImageEditor with a property.

[EditorAttribute(typeof(System.Drawing.Design.ImageEditor), typeof(System.Drawing.Design.UITypeEditor))]
public Image testImage
        return testImg;
        testImg = value;
private Image testImg;                

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.