BootstrapPageControl Class

Represents a navigation control made up of multiple tabbed pages.

Namespace: DevExpress.Web.Bootstrap

Assembly: DevExpress.Web.Bootstrap.v23.2.dll

NuGet Package: DevExpress.Web.Bootstrap

Declaration

C#

[DXClientDocumentationProviderWeb("BootstrapPageControl")]
[ToolboxTabName("DX.23.2: Bootstrap Controls")]
public class BootstrapPageControl :
    ASPxPageControl,
    ISimpleRenderControl,
    IBootstrapTabControlCssClassesOwner

VB.NET

<ToolboxTabName("DX.23.2: Bootstrap Controls")>
<DXClientDocumentationProviderWeb("BootstrapPageControl")>
Public Class BootstrapPageControl
    Inherits ASPxPageControl
    Implements ISimpleRenderControl,
               IBootstrapTabControlCssClassesOwner

Remarks

Note

The BootstrapPageControl control provides you with comprehensive client-side functionality implemented using JavaScript code:

• The control’s client-side equivalent is represented by the BootstrapClientPageControl object.
• On the client side, the client object can be accessed directly by the name specified via the ASPxTabControlBase.ClientInstanceName property.
• The available client events can be accessed by using the ASPxTabControlBase.ClientSideEvents property.

The control’s client-side API is enabled if the ASPxTabControlBase.EnableClientSideAPI property is set to true, or the ASPxTabControlBase.ClientInstanceName property is defined, or any client event is handled.

Callbacks vs. Postbacks

Use the page control’s ASPxTabControlBase.AutoPostBack property to control whether any end-user manipulation with the control’s elements (page tabs) requires a round trip to the server side for further processing.

Round trips to the server can be performed in the following ways:

• using standard postbacks (the whole page is refreshed)
• using the AJAX-based callback technology.

You can define which way to use to perform round trips to server using the ASPxPageControl.EnableCallBacks property.

Round trips to the server can be cancelled in a handler of the corresponding client-side event.

Usage Notes

If you want to use a navigation control which only provides a tabbed interface but doesn’t contain any pages with child controls, consider using the BootstrapTabControl control.

Example

This example demonstrates the basic functionality of the Page Control.

• Initialize a new instance of the BootstrapPageControl class.
• Add required BootstrapTabPage objects to the BootstrapPageControl.TabPages collection.
• Fill each tab page with the necessary content controls - ContentCollection items.

The image below shows the result:

ASPX

<dx:BootstrapPageControl runat="server">
    <TabPages>
        <dx:BootstrapTabPage Text="Home">
            <ContentCollection>
                <dx:ContentControl runat="server" SupportsDisabledAttribute="True">
                    ...
                </dx:ContentControl>
            </ContentCollection>
        </dx:BootstrapTabPage>
        <dx:BootstrapTabPage Text="Products">
            <ContentCollection>
                <dx:ContentControl runat="server" SupportsDisabledAttribute="True">
                    ...
                </dx:ContentControl>
            </ContentCollection>
        </dx:BootstrapTabPage>
        <dx:BootstrapTabPage Text="Support">
            <ContentCollection>
                <dx:ContentControl runat="server" SupportsDisabledAttribute="True">
                    ...
                </dx:ContentControl>
            </ContentCollection>
        </dx:BootstrapTabPage>
    </TabPages>
</dx:BootstrapPageControl>

Inheritance

Object

Control

WebControl

ASPxWebControlBase

ASPxWebControl

ASPxDataWebControlBase

ASPxHierarchicalDataWebControl

ASPxTabControlBase

ASPxPageControl

BootstrapPageControl