Extenders are components that add, and manage for, properties to other components.

An extender must implements the IExtenderProvider interface allowing it to decide whether a specific component can be extended (at design time) through the CanExtend(component) implementation.

Some extender are not even a separate component. For example, the TableLayoutPanel, FlexLayoutPanel and FlowLayoutPanel are all extenders and add properties to their children. This feature is extremely powerful in a web system, when you drop a control inside a FlexLayoutPanel, that control "gains" new properties such as FillWeight, AlignX, AlignY, etc. These are properties that make sense only when the target control is inside a FlexLayoutPanel.

Other extenders are not controls and do not have a UI. They add features to the control they extend. See the Animation, ToolTip and similar extenders.

IExtenderProvider

The System.ComponentModel.IExtenderProvider is part of the System.ComponentModel infrastructure in .NET. It requires only one method to be implemented:

bool CanExtend(object target)

Return true if the extender wants to extend the target object. There isn't anything more to it and there Microsoft documentation and examples are quite exhaustive.

ProvidePropertyAttribute

An extender class indicates which property wants to add by specifying one or more ProvidePropertyAttribute declarations.

IWisejExtenderProvider

Allows any Wisej control to be rotated around the X, Y, or Z axis.

Features

Rotation

The Rotation component adds a Rotation property to all eligible controls.

Advanced

JavaScript Widget

Wisej Animations make it possible to animate transitions from one style configuration to another.

Features

Animation Timing

The Timing property of the Animation extender contains several preset values.

• Default: The animation has the speed defined in the original definition.

• Linear: The animation has the same speed from start to end.

• Ease: The animation has a slow start, then fast, before it ends slowly.

• EaseIn: The animation has a slow start.

• EaseOut: The animation has both a slow start and a slow end.

Advanced

JavaScript Widget

With the ToolTip class, you can provide hints to a user when the user places the pointer on a control. The ToolTip class is typically used to alert users to the intended use of a control. For example, you can specify ToolTip text for a TextBox control that accepts a name, specifying the format of the name to be typed into the control. In addition to providing hints, you can also use the ToolTip class to provide run time status information. For example, you can use the ToolTip class to display connection speed and line quality data when the user moves the pointer onto a PictureBox control that displays Internet connection status.

Advanced

JavaScript Widget

When added from the Toolbox, the StyleSheet extender adds a CssClass property to all eligible controls. The source for the StyleSheet can be provided in the StyleSheetSource property of the component.

Features

CssClass

The CssClass property added from the extender allows any target control to use a CSS class that's defined in the StyleSheetSource property of the StyleSheet component.

StyleSheet Source:

.myClass {
    background-color: red;
}

Apply the CSS class to a control:

this.styleSheet1.SetCssClass(this.button1, "myClass");

Result:

Advanced

JavaScript Widget

ErrorProvider presents a simple mechanism for indicating to the end user that a control on a form has an error associated with it. If an error description string is specified for the control, an icon appears next to the control. The icon flashes in the manner specified by BlinkStyle, at the rate specified by BlinkRate. When the mouse hovers over the icon, a ToolTip appears showing the error description string.

Typically, you use ErrorProvider in association with data-bound controls. When using ErrorProvider with data-bound controls, you must specify the ContainerControl, either in the constructor or by setting the ContainerControl property.

Features

Validation

When invalid input is detected, the ErrorProvider can show a message to the user alerting them to fix the issue.

Advanced

JavaScript Widget

Allows attachment of JavaScript functionality to each control.

Features

JavaScript Events

The JavaScript extender adds a property, JavaScriptEvents to all controls on the page. This new property allows for attachment to JavaScript events on the client-side widget.

JavaScript Source

The JavaScript extender adds a property, JavaScript and JavaScriptSource to all controls on the page. These new properties allow for execution of JavaScript code upon the widget's initialization. The JavaScript property takes arbitrary JavaScript code. The JavaScriptSource property takes the location of a JavaScript file.

Advanced

JavaScript Widget