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.

The control above is initialized with this code. The italic properties 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 <HideAction Visible="true" /> to display the popup along with any other visual effects.
  • OnHide - The OnHide animation will be played each time the popup is hidden.