Ajax Control Toolkit Popup

Modified on 2010/04/16 00:58 by Stephen Walther — Categorized as: Uncategorized

PopupControl is an ASP.NET AJAX extender that can be attached to any control in order to open a popup window that displays additional content. This popup window will probably be interactive and will probably be within an ASP.NET AJAX UpdatePanel, so it will be able to perform complex server-based processing (including postbacks) without affecting the rest of the page. The popup window can contain any content, including ASP.NET server controls, HTML elements, etc. Once the work of the popup window is done, a simple server-side call dismisses it and triggers any relevant script on the client to run and update the page dynamically.

PopUp Server Properties

The properties in italics are optional.

<ajaxToolkit:PopupControlExtender ID="PopEx" runat="server"
    TargetControlID="DateTextBox"
    PopupControlID="Panel1"
    Position="Bottom" />

TargetControlID - The ID of the control to attach to
PopupControlID - The ID of the control to display
Position - Optional setting specifying where the popup should be positioned relative to the target control. (Left, Right, Top, Bottom, Center)
CommitProperty - Optional setting specifying the property on the control being extended that should be set with the result of the popup
CommitScript - Optional setting specifying additional script to run after setting the result of the popup
OffsetX/OffsetY - The number of pixels to offset the Popup from its default position, as specified by Position.
Animations - Generic animations for the PopupControlExtender. See the Using Animations walkthrough and Animation Reference for more details.
- OnShow - The OnShow animation will be played each time the popup is displayed. The popup will be positioned correctly but hidden. The animation can use to display the popup along with any other visual effects.
- OnHide - The OnHide animation will be played each time the popup is hidden.