Expand a row to see the employee and customer related to this order.


In some scenarios you may need to display several child tables at the same level. This may include subgrids, custom html, etc. Let's consider the common scenario, where we list all Orders. We also want to drill-down and expand each Order, showing both the Employee handling it and the Customer the order should be shipped to at the same time.

The approach to achieve that is very similar to what is needed in a classic 2 or 3-level hierarchy. The key here is to set the HierarchySettings.HierarchyMode of the parent grid to Parent and to hook its client-side event SubGridRowExpanded.

The showSubGrid javascript event handler is responsible for showing the child grid. Similar to what you would do in a 2 or 3-level scenario, just call the autogenerated showSubGrid_JQGrid2 and showSubGrid_JQGrid2 functions. The difference however is that you need to pass two additional parameters - the message to be shown next to the grid and the ID of the grid (must be unique).

The second and third grid - Employee and Customer - should be at the same level (children of the parent Orders grid). Therefore, we need to set their HierarchySettings.HierarchyMode to Child. Note how we form the SQL query - we need a join clause to find all employees and customers responsible for the selected parent order. 
<%@ Page Language="C#" AutoEventWireup="true" CodeBehind="default.aspx.cs" Inherits="GridTest.examples.hierarchy.several_subgrids._default" %>
<%@ Register Assembly="Trirand.Web" TagPrefix="trirand" Namespace="Trirand.Web.UI.WebControls" %>

<!DOCTYPE html>
<html lang="en-us">
<head id="Head1" runat="server">
    <meta charset="utf-8">
    <title>jqGrid for ASP.NET WebForms - several child grids on the same level</title>
    <!-- The jQuery UI theme that will be used by the grid -->
    <link rel="stylesheet" type="text/css" media="screen" href="http://ajax.aspnetcdn.com/ajax/jquery.ui/1.11.4/themes/redmond/jquery-ui.css" />
    <!-- The jQuery UI theme extension jqGrid needs -->
    <link rel="stylesheet" type="text/css" media="screen" href="/themes/ui.jqgrid.css" />
    <!-- jQuery runtime minified -->
    <script src="http://ajax.microsoft.com/ajax/jquery/jquery-2.2.0.min.js" type="text/javascript"></script>
    <!-- The localization file we need, English in this case -->
    <script src="/js/trirand/i18n/grid.locale-en.js" type="text/javascript"></script>
    <!-- The jqGrid client-side javascript -->
    <script src="/js/trirand/jquery.jqGrid.min.js" type="text/javascript"></script>
    
    <style type="text/css">
        body, html  { font-size: 80%; }
    </style>
</head>
<body>
    <form id="form1" runat="server">    
    
    <asp:SqlDataSource runat="server" ID="SqlDataSource1" ConnectionString="<%$ ConnectionStrings:SQL2008_449777_fhsConnectionString %>"
        SelectCommand="SELECT [OrderID], [CustomerID], [EmployeeID], [RequiredDate], [ShipCity], [Freight] FROM [Orders]">        
    </asp:SqlDataSource>
    <asp:SqlDataSource runat="server" ID="SqlDataSource2" ConnectionString="<%$ ConnectionStrings:SQL2008_449777_fhsConnectionString %>"        
        SelectCommand="SELECT Employees.EmployeeID,[LastName],[FirstName],[Title],[ReportsTo] FROM [Employees],[Orders]
                        WHERE (Employees.EmployeeID = Orders.EmployeeID AND Orders.OrderID = @OrderID)">
        <SelectParameters>
            <asp:Parameter Name="OrderID" Type="Int32" />
        </SelectParameters>
    </asp:SqlDataSource>
    <asp:SqlDataSource runat="server" ID="SqlDataSource3" ConnectionString="<%$ ConnectionStrings:SQL2008_449777_fhsConnectionString %>"
        SelectCommand="SELECT Customers.CustomerID, [CompanyName], [ContactName], [Phone], [City] FROM [Customers],[Orders]
                        WHERE (Customers.CustomerID = Orders.CustomerID AND Orders.OrderID = @OrderID)">
        <SelectParameters>
            <asp:Parameter Name="OrderID" Type="Int32" />
        </SelectParameters>
    </asp:SqlDataSource>

    <span style="font-size: 135%; font-family: Verdana; font-weight: bold">Expand a row to see the employee and customer related to this order.</span>
    <trirand:JQGrid runat="server" ID="JQGrid1" DataSourceID="SqlDataSource1" Width="650px" Height="100%">        
        <Columns>
            <trirand:JQGridColumn DataField="OrderID" HeaderText="Order ID" PrimaryKey="True" Width="50" />
            <trirand:JQGridColumn DataField="CustomerID" Width="100" />
            <trirand:JQGridColumn DataField="EmployeeID" Width="100" />                                    
            <trirand:JQGridColumn DataField="ShipCity" Width="100" />
            <trirand:JQGridColumn DataField="Freight" Width="100" />
        </Columns>
        <ClientSideEvents SubGridRowExpanded="showSubGrids" />
        <HierarchySettings HierarchyMode="Parent" />
    </trirand:JQGrid>
    
    <trirand:JQGrid runat="server" ID="JQGrid2" DataSourceID="SqlDataSource2"
        Width="100%" Height="100%"        
        OnDataRequesting="JQGrid2_DataRequesting">
        <Columns>
            <trirand:JQGridColumn DataField="EmployeeID" PrimaryKey="True" />
            <trirand:JQGridColumn DataField="LastName" />
            <trirand:JQGridColumn DataField="FirstName" />
            <trirand:JQGridColumn DataField="Title" />            
        </Columns>        
        <HierarchySettings HierarchyMode="Child" />        
    </trirand:JQGrid>
    
    <trirand:JQGrid runat="server" ID="JQGrid3" DataSourceID="SqlDataSource3" Width="100%" Height="100%"
        OnDataRequesting="JQGrid3_DataRequesting">
        <Columns>
            <trirand:JQGridColumn DataField="CustomerID" HeaderText="ID" PrimaryKey="True" Width="50" />            
            <trirand:JQGridColumn DataField="ContactName" />
            <trirand:JQGridColumn DataField="Phone" />
            <trirand:JQGridColumn DataField="City" />
        </Columns>
        <HierarchySettings HierarchyMode="Child" />        
    </trirand:JQGrid>
    
    
    
    <script type="text/javascript">
        function showSubGrids(subgrid_id, row_id) {
            // the "showSubGrid_JQGrid2" function is autogenerated and available globally on the page by the second child grid. 
            // Calling it will place the child grid below the parent expanded row and will call the OnDataRequesting event 
            // of the child grid, with ID equal to the ID of the parent expanded row
            showSubGrid_JQGrid2(subgrid_id, row_id, "<br><b>Employee responsible for this order</b><br><br>", "JQGrid2");
            showSubGrid_JQGrid3(subgrid_id, row_id, "<br><b>This order should be shipped to this customer</b><br><br>", "JQGrid3");
        }   
    </script>

    <br />
    <br />
    <trirand:codetabs runat="server" ID="tabs"></trirand:codetabs>
    </form>
</body>
</html>
using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using Trirand.Web.UI.WebControls;

namespace GridTest.examples.hierarchy.several_subgrids
{
    public partial class _default : System.Web.UI.Page
    {
        public void JQGrid2_DataRequesting(object sender, JQGridDataRequestEventArgs e)
        {
            SqlDataSource2.SelectParameters["OrderID"].DefaultValue = e.ParentRowKey;
        }

        public void JQGrid3_DataRequesting(object sender, JQGridDataRequestEventArgs e)
        {
            SqlDataSource3.SelectParameters["OrderID"].DefaultValue = e.ParentRowKey;
        }
    }
}
Switch theme:


Theming is based on the very popular jQuery ThemeRoller standard. This is the same theming mechanism used by jQuery UI and is now a de-facto standard for jQuery based components. The benefits of using ThemeRoller are huge. We can offer a big set of ready to use themes created by professional designers, including Windows-like themes (Redmond), Apple-like theme (Cupertino), etc. In addition to that any jQuery UI controls on the same page will pick the same theme.

Last, but not least, you can always roll your own ThemeRoller theme, using the superb Theme Editor

To use a theme, simply reference 2 Css files in your Html <head> section - the ThemeRoller theme you wish to use, and the jqGrid own ThemeRoller Css file. For example (Redmond theme):

<link rel="stylesheet" type="text/css" media="screen" href="/themes/redmond/jquery-ui-1.8.2.custom.css" />
<link rel="stylesheet" type="text/css" media="screen" href="/themes/ui.jqgrid.css" />