Custom Toolbar Close Dialog

RAPID PUBLISHING ARTICLES PROVIDE INFORMATION DIRECTLY FROM WITHIN THE MICROSOFT SUPPORT ORGANIZATION. THE INFORMATION CONTAINED HEREIN IS CREATED IN RESPONSE TO EMERGING OR UNIQUE TOPICS, OR IS INTENDED SUPPLEMENT OTHER KNOWLEDGE BASE INFORMATION.

The Guidelines and Requirements for Add-ons that extend Internet Explorer document discusses the behavior of add-ons with respect to the toolbar close button.

Some add-on vendors would like to show their own UI when the user clicks the IE toolbar close button. Microsoft recommends not altering this user experience. Software that does alter this user experience must include a way to launch the IE Toolbar Close dialog.

This topic discusses the following subjects:

• Neutral presentation of the disable option
• Behavior of the disable option

Neutral presentation of the disable option

When the user clicks on the toolbar close button and the add-on has built a custom Toolbar Close dialog, an option to disable the add-on must be neutrally presented when compared to any other options the add-on offers.

Here is an example that demonstrates neutral presentation:

This example uses command links. The same design principles would apply to radio buttons as well.

The option to disable the add-on is visible without the need to scroll or expand sections, it can be selected with one click and its hit target is the same size as the other options. The options may be in any order with the first being the default.

Behavior of the disable option

When the user chooses the Disable option on a Custom Toolbar Close dialog, it must invoke the IE toolbar close dialog and comply with the user's selections.

To accomplish this, the "Disable Add-on" button performs the following when clicked:

1. Dismisses the add-on's custom Toolbar Close dialog.
2. Sets a flag so that the add-on does not hook the IE toolbar close button the next time it is clicked.
3. Programmatically clicks the IE toolbar close button.
   1. Add-ons can intercept the UI in several different ways. To invoke the IE Toolbar Close dialog, the add-on can use its intercept technique but perform a click rather than launching the Custom Toolbar Close dialog.

MICROSOFT AND/OR ITS SUPPLIERS MAKE NO REPRESENTATIONS OR WARRANTIES ABOUT THE SUITABILITY, RELIABILITY OR ACCURACY OF THE INFORMATION CONTAINED IN THE DOCUMENTS AND RELATED GRAPHICS PUBLISHED ON THIS WEBSITE (THE �MATERIALS�) FOR ANY PURPOSE. THE MATERIALS MAY INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICAL ERRORS AND MAY BE REVISED AT ANY TIME WITHOUT NOTICE.

TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, MICROSOFT AND/OR ITS SUPPLIERS DISCLAIM AND EXCLUDE ALL REPRESENTATIONS, WARRANTIES, AND CONDITIONS WHETHER EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO REPRESENTATIONS, WARRANTIES, OR CONDITIONS OF TITLE, NON INFRINGEMENT, SATISFACTORY CONDITION OR QUALITY, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, WITH RESPECT TO THE MATERIALS.