System.Web 2.0.0.0

The interface provides several UI-oriented properties that enhance the user experience of working with controls. When you create controls that derive from the base class, you get an implementation of all the properties in the interface, because the base class implements this interface.

You can use existing user controls, ASP.NET controls, or custom server controls that do not inherit from the class as part of a Web Parts application, and they can also use these UI-oriented properties declared by the interface. If you place existing server controls in a zone, at run time they are wrapped with a object. Because the class inherits from the base class, it enables existing server controls to act as true controls and it adds to them the properties of the interface.

If you place server controls that are not controls in zones, they can use the properties at run time, and you can also declare values for those properties on server controls in the markup of the page (in page persistence format). However, because these properties are only available to the server controls at run time, design-time coding features such as IntelliSense do not recognize properties that are declared on server controls. Declared properties on these controls still work when you load the page, but Microsoft Visual Studio does not recognize the properties as valid at design time. If you want to add the properties to existing server and user controls to enhance the design-time user experience, you can implement the interface in a server control.

Perhaps the main reason to implement the interface is for controls that do not support the use of expando (custom) properties. Expando properties are strings that can be added to a class dynamically as a property, by means of the interface. Controls that implement this interface, including the class and its children, can use expando properties. Therefore, all ASP.NET server controls, custom controls that derive from them, Web user controls, and controls support the use of expando properties. But custom controls that inherit directly from the base class do not support expando properties. Thus, if you declare these controls within a , you will not be able to declare the common properties on the controls, properties such as and . If you want to use these properties with such controls, you must implement the interface.

Defines common user interface (UI) properties used by ASP.NET controls.

- Property
  System.String To be added.

  Web Parts applications often provide a catalog (or list) of controls that users can add to a page. The property on a control contains the URL to an image that represents the control when it appears in a catalog.

  Gets or sets the URL to an image that represents a control in a catalog of controls.

  2.0.0.0
- Property
  System.String To be added.

  The property value is typically used as a descriptive string for a control in catalogs that provide lists of controls, and as a ToolTip in a control's title bar. The content of the property appears in a ToolTip when a user positions the mouse pointer over the title text in a control's title bar.

  Gets or sets a brief phrase that summarizes what a control does, for use in ToolTips and catalogs of controls.

  2.0.0.0
- Property
  System.String To be added.

  The property is used to return a default subtitle string for a control that is appended to the control's title in the title bar.

  If you provide a default value for the property in a control that implements the interface, the Web Parts control set automatically appends it to the value of the property of the control at run time.

  Gets a string that is concatenated with the property value to form a complete title for a control.

  2.0.0.0
- Property
  System.String To be added.

  The visible title text in a control's title bar is set by the property.

  If you do not supply a title for a control, the Web Parts control set automatically calculates a default string to use as a title. For more information, see . Also, it is possible to provide a default subtitle that is appended to the title string. For details, see .

  Gets or sets the title of a control.

  2.0.0.0
- Property
  System.String To be added.

  The property provides a way to associate an icon with a control. The icon appears in the control's own title bar. For thematic consistency, application developers might want to make this icon similar to the image that represents the control in a catalog of Web Parts controls (the image referenced in the property).

  As it is implemented in the Web Parts control set, the property can be personalized by end users to change the image or icon that appears in a control's title bar.

  Gets or sets the URL to an image used to represent a Web Parts control in the control's own title bar.

  2.0.0.0
- Property
  System.String To be added.

  When you assign a URL to the property, the title of the control becomes a link. The purpose of this property is to provide a convenient way for end users to access additional information about a control. The additional information could provide copyright data, contact data, details about the creator of the control, or a summary of the control's purpose.

  Normally, you would not use the property to link to Help content. The best way to provide a link to Help for a control is to use the property.

  Gets or sets a URL to supplemental information about a control.

  2.0.0.0