Overriding Properties

Properties cannot be "overridden" directly from the Property Sheet.  Any property name containing a dash is considered an override.  For example, "OnClick" is an allowed property because it sets an attribute, and "Button-Text" is allowed because it overrides a Property, but "Button-OnClick" is not permitted because it overrides an Attribute.

However, a special set of "wrapper" Properties (not Attributes) can be overridden.  Overriding a wrapper Property is equivalent at run-time to overriding the Attribute itself.

Since only public Properties (not Attributes) of a control can be overridden across User Control (panel) boundaries, a control's "wrapped" Attributes can be set declaratively (using properties), even across User Control (panel) boundaries.  For example, a specific page’s Menu's MenuItem's LinkButton's "onBlur" Attribute can be overridden by setting a property similar to the following on the Page's Menu component/tag:

<MenuItem tag name>-Button-HtmlAttributes-onBlur

Trying to set the Attribute directly using "<MenuItem tag name>-Button-onBlur" would have no effect on the LinkButton, because LinkButtons do not have a Public Property named "onBlur".

You can customize the behavior and appearance of paneled controls (e.g. Buttons, MenuItems, and Pagination panel contents) from outside the panel without code customization.  From the Property Sheet, for example, you can:

• Make a button or hyperlink display a confirmation popup when clicked.

• Make a control display text in Internet Explorer’s status area when the user hovers over the control.

• Add advanced client-side behavior to buttons and other controls by overriding the JavaScript event handler attributes such as onClick, onFocus, OnBlur, onMouseMove, onKeyDown, etc.

Examples

Example: Add a Mouse Over Message to a Button Tag

Example: Add a Print Button to a Web Page

Example: Add a Mouse Over Message to a Button Tag

Set the following properties in the Property Sheet for an Image Button, Link Button, or Push Button control:

After building and running the application, watch the browser’s status bar.  You’ll notice the custom message appears when you hover over the button.

Note: The Java Plugin must be installed and running in your system system in order for this example to work properly.

Example: Add a Print Button to a Web Page

Set the following properties in the Property Sheet for an Image Button, Link Button, or Push Button:

After building and running the application, click your “print” button and your browser’s printer selection dialog will appear.

Note: The Java Plugin must be installed and running in your system system in order for this example to work properly.