ASPxPopupControl.PopupHorizontalAlign Property
Gets or sets a popup window’s horizontal alignment.
Namespace: DevExpress.Web
Assembly: DevExpress.Web.v24.2.dll
Declaration
[DefaultValue(PopupHorizontalAlign.NotSet)]
public PopupHorizontalAlign PopupHorizontalAlign { get; set; }Property Value
| Type | Default | Description |
|---|---|---|
| PopupHorizontalAlign | NotSet | One of the PopupHorizontalAlign enumeration values. |
Available values:
| Name | Description |
|---|---|
| NotSet | A popup element is displayed on the x-coordinate of the mouse cursor position.
|
| OutsideLeft | A popup element is displayed to the left of the corresponding HTML element, so that the x-coordinate of the popup element’s right border is equal to the x-coordinate of the HTML element’s left border.
|
| LeftSides | A popup element is displayed so that its left border’s x-coordinate equals the x-coordinate of the corresponding HTML element’s left border.
|
| Center | A popup element is displayed so that the x-coordinate of the popup element’s center equals the x-coordinate of the corresponding HTML element’s center.
|
| RightSides | A popup element is displayed so that the x-coordinate of the popup element’s right border equals the x-coordinate of the corresponding HTML element’s right border.
|
| OutsideRight | A popup element is displayed to the right of the corresponding HTML element so that the x-coordinate of the popup element’s left border is equal to the x-coordinate of the HTML element’s right border.
|
| WindowCenter | A popup element is displayed so that it is horizontally aligned at the center of the browser’s window. |
Remarks
The default popup window (or all popup windows from the ASPxPopupControl.Windows collection) is aligned horizontally on the x-coordinate of the mouse cursor position by default. Use the PopupHorizontalAlign property to set the window alignment relative to the corresponding element specified by the ASPxPopupControl.PopupElementID (PopupWindow.PopupElementID) property, or to display the window at the center of the browser’s window.
Note
Use the HorizontalAlign and VerticalAlign properties to align a popup in adaptive mode.
Example
This example demonstrates the following capabilities of the ASPxPopupControl when its popup window is used in modal mode:
The ShowPageScrollbarWhenModal property allows the browser’s vertical scrollbar to be displayed providing users with a capability to scroll the document content while the modal popup window is being shown;
The AutoUpdatePosition property controls whether the popup window’s position should be automatically recalculated after performing some popup window resizing or document scrolling operations.
<dx:ASPxCheckBox ID="cbShowPageScrollbarWhenModal" runat="server" Text="ShowPageScrollbarWhenModal" />
<dx:ASPxCheckBox ID="cbAutoUpdatePosition" runat="server" Text="AutoUpdatePosition" />
<dx:ASPxButton ID="btnShow" runat="server" Text="Show" />
<dx:ASPxPopupControl ID="popup" runat="server" ShowOnPageLoad="true" PopupElementID="ASPxButton1"
Modal="True" ShowPageScrollbarWhenModal="False" PopupHorizontalAlign="WindowCenter"
PopupVerticalAlign="WindowCenter" HeaderText="Gladiator" AllowDragging="True"
AllowResize="True" EnableAnimation="False">
<ContentCollection>
<dx:PopupControlContentControl runat="server">
<span class="Gray"><b>Directed by:</b> Ridley Scott<br />
<b>Year:</b> 2000</span><br />
<br />
<div style="font-family: Tahoma; font-size: 10px; color: #666666;">
When a Roman general is betrayed and his family murdered by a corrupt prince, he
comes to Rome as a gladiator to seek revenge.</div>
</dx:PopupControlContentControl>
</ContentCollection>
<ClientSideEvents Init="function(s, e) { s.Show(); }" />
</dx:ASPxPopupControl>
protected void Page_Load(object sender, EventArgs e) {
if(IsPostBack) {
popup.ShowPageScrollbarWhenModal = cbShowPageScrollbarWhenModal.Checked;
popup.AutoUpdatePosition = cbAutoUpdatePosition.Checked;
}
}
Related GitHub Examples
The following code snippet (auto-collected from DevExpress Examples) contains a reference to the PopupHorizontalAlign property.
Note
The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.