ASPxPopupControl.ShowPageScrollbarWhenModal Property

Gets or sets a value that specifies whether a browser’s scroll bars can be displayed when the default popup window is shown in modal mode.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v19.1.dll

Declaration

C#
VB.NET

[DefaultValue(false)]
public bool ShowPageScrollbarWhenModal { get; set; }

<DefaultValue(False)>
Public Property ShowPageScrollbarWhenModal As Boolean

Property Value

Type	Default	Description
Boolean	false	true if a browser’s scroll bars are available; otherwise, false.

Remarks

The ShowPageScrollbarWhenModal property controls the availability of a browser’s scroll bars when the ASPxPopupControl’s default popup window is used in modal mode.

To learn more, see the following example:E1080

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 end-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.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-use-the-aspxpopupcontrols-showpagescrollbarwhenmodal-and-autoupdateposition-propertie-e1080

<%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" %>

<%@ Register Assembly="DevExpress.Web.v9.1" Namespace="DevExpress.Web.ASPxPopupControl" TagPrefix="dxpc" %>
<%@ Register Assembly="DevExpress.Web.ASPxEditors.v9.1" Namespace="DevExpress.Web.ASPxEditors" TagPrefix="dxe" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
        <div>
            <dxe:ASPxCheckBox ID="cbShowPageScrollbarWhenModal" runat="server" Text="ShowPageScrollbarWhenModal" />
            <br />
            <dxe:ASPxCheckBox ID="cbAutoUpdatePosition" runat="server" Text="AutoUpdatePosition" />
            <br />
            <dxe:ASPxButton ID="btnShow" runat="server" Text="Show">
            </dxe:ASPxButton>
            <dxpc: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>
                    <dxpc: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>
                    </dxpc:PopupControlContentControl>
                </ContentCollection>
               <ClientSideEvents Init="function(s, e) { s.Show(); }" />
            </dxpc:ASPxPopupControl>
            <div style="height: 2000px" />
        </div>
    </form>
</body>
</html>

using System;
using System.Data;
using System.Configuration;
using System.Collections;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;

public partial class _Default : System.Web.UI.Page {
    protected void Page_Load(object sender, EventArgs e) {
        if(IsPostBack) {
            popup.ShowPageScrollbarWhenModal = cbShowPageScrollbarWhenModal.Checked;
            popup.AutoUpdatePosition = cbAutoUpdatePosition.Checked;
        }
    }
}

Imports Microsoft.VisualBasic
Imports System
Imports System.Data
Imports System.Configuration
Imports System.Collections
Imports System.Web
Imports System.Web.Security
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts
Imports System.Web.UI.HtmlControls

Partial Public Class _Default
    Inherits System.Web.UI.Page
    Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
        If IsPostBack Then
            popup.ShowPageScrollbarWhenModal = cbShowPageScrollbarWhenModal.Checked
            popup.AutoUpdatePosition = cbAutoUpdatePosition.Checked
        End If
    End Sub
End Class

<%@ Page Language="vb" AutoEventWireup="true" CodeFile="Default.aspx.vb" Inherits="_Default" %>

<%@ Register Assembly="DevExpress.Web.v9.1" Namespace="DevExpress.Web.ASPxPopupControl" TagPrefix="dxpc" %>
<%@ Register Assembly="DevExpress.Web.ASPxEditors.v9.1" Namespace="DevExpress.Web.ASPxEditors" TagPrefix="dxe" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
        <div>
            <dxe:ASPxCheckBox ID="cbShowPageScrollbarWhenModal" runat="server" Text="ShowPageScrollbarWhenModal" />
            <br />
            <dxe:ASPxCheckBox ID="cbAutoUpdatePosition" runat="server" Text="AutoUpdatePosition" />
            <br />
            <dxe:ASPxButton ID="btnShow" runat="server" Text="Show">
            </dxe:ASPxButton>
            <dxpc:ASPxPopupControl ID="popup" runat="server" ShowOnPageLoad="true" Modal="True"
                ShowPageScrollbarWhenModal="False" PopupHorizontalAlign="WindowCenter" PopupVerticalAlign="WindowCenter" HeaderText="Gladiator" AllowDragging="True" AllowResize="True" EnableAnimation="False">
                <ContentCollection>
                    <dxpc: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>
                    </dxpc:PopupControlContentControl>
                </ContentCollection>
                                                                <ClientSideEvents Init="function(s, e) { s.Show(); }" />
            </dxpc:ASPxPopupControl>
            <div style="height: 2000px" />
        </div>
    </form>
</body>
</html>

Controls

Tools

Controls and Extensions

Tools

Maintenance Mode

Controls

Tools

Controls and Extensions

Tools

Maintenance Mode

ASPxPopupControl.ShowPageScrollbarWhenModal Property

Declaration

Property Value

Remarks

Example