MailFileEditor Class

 

Provides a user interface for selecting and editing a mail file name for a property at design time.

Namespace:   System.Web.UI.Design
Assembly:  System.Design (in System.Design.dll)

System::Object
  System.Drawing.Design::UITypeEditor
    System.Web.UI.Design::UrlEditor
      System.Web.UI.Design::MailFileEditor

[SecurityPermissionAttribute(SecurityAction::Demand, Flags = SecurityPermissionFlag::UnmanagedCode)]
public ref class MailFileEditor : UrlEditor

NameDescription
System_CAPS_pubmethodMailFileEditor()

Initializes a new instance of the MailFileEditor class.

NameDescription
System_CAPS_protpropertyCaption

Gets the caption for the editor dialog.(Overrides UrlEditor::Caption.)

System_CAPS_protpropertyFilter

Gets the file filter string for the dialog (such as "*.txt").(Overrides UrlEditor::Filter.)

System_CAPS_pubpropertyIsDropDownResizable

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

System_CAPS_protpropertyOptions

Gets the options for the URL builder to use.(Inherited from UrlEditor.)

NameDescription
System_CAPS_pubmethodEditValue(IServiceProvider^, Object^)

Edits the value of the specified object using the editor style indicated by the GetEditStyle method.(Inherited from UITypeEditor.)

System_CAPS_pubmethodEditValue(ITypeDescriptorContext^, IServiceProvider^, Object^)

Edits the value of the specified object using the editor style provided by the GetEditStyle method.(Inherited from UrlEditor.)

System_CAPS_pubmethodEquals(Object^)

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_protmethodFinalize()

Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)

System_CAPS_pubmethodGetEditStyle()

Gets the editor style used by the EditValue method.(Inherited from UITypeEditor.)

System_CAPS_pubmethodGetEditStyle(ITypeDescriptorContext^)

Gets the editing style of the EditValue method.(Inherited from UrlEditor.)

System_CAPS_pubmethodGetHashCode()

Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethodGetPaintValueSupported()

Indicates whether this editor supports painting a representation of an object's value.(Inherited from UITypeEditor.)

System_CAPS_pubmethodGetPaintValueSupported(ITypeDescriptorContext^)

Indicates whether the specified context supports painting a representation of an object's value within the specified context.(Inherited from UITypeEditor.)

System_CAPS_pubmethodGetType()

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_protmethodMemberwiseClone()

Creates a shallow copy of the current Object.(Inherited from Object.)

System_CAPS_pubmethodPaintValue(Object^, Graphics^, Rectangle)

Paints a representation of the value of the specified object to the specified canvas.(Inherited from UITypeEditor.)

System_CAPS_pubmethodPaintValue(PaintValueEventArgs^)

Paints a representation of the value of an object using the specified PaintValueEventArgs.(Inherited from UITypeEditor.)

System_CAPS_pubmethodToString()

Returns a string that represents the current object.(Inherited from Object.)

The MailFileEditor class is an UITypeEditor object that can be used at design time to select and edit a mail file name as a string, and assign the string to a control property. For example, the EmbeddedMailObject control uses the MailFileEditor class at design time to set the value of the Path property.

Use the EditorAttribute attribute to associate the MailFileEditor with a property. When the associated property is edited in the design surface, the designer host calls the EditValue method. The EditValue method displays a dialog box for selecting a mail file name from a filtered list of files, and returns the file name that is selected by the user. The GetEditStyle method indicates the display style of the user interface.

Derive a class from the MailFileEditor to define a custom editor for a mail file name property. For example, a derived class can override the EditValue method, and display an OpenFileDialog instance with a custom mail file filter or title.

The following code example demonstrates how to associate an instance of the MailFileEditor class with a property that is contained within a custom control. When the control property is edited in the design surface, the MailFileEditor class provides the user interface to select and edit a mail file name for the property value.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 2.0

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

Return to top
Show: