Ignite UI API Reference

ui.igPivotDataSelector

ui.igPivotDataSelector_image
igPivotDataSelector is an interactive UI control (jQuery UI widget) that enables users to select data slices, typically, when data is being visualized in an igPivotGrid™. It is a supplementary control working together with the data source components.

Code Sample

 
<!doctype html>
<html>
<head>
    <!-- Infragistics Combined CSS -->
    <link href="css/themes/infragistics/infragistics.theme.css" rel="stylesheet" type="text/css" />
    <link href="css/structure/infragistics.css" rel="stylesheet" type="text/css" />
    <!-- jQuery Core -->
    <script src="js/jquery.js" type="text/javascript"></script>
    <!-- jQuery UI -->
    <script src="js/jquery-ui.js" type="text/javascript"></script>
    <!-- Infragistics Combined Scripts -->
    <script src="js/infragistics.core.js" type="text/javascript"></script>
    <script src="js/infragistics.lob.js" type="text/javascript"></script>
    <script type="text/javascript">
        var data =
                [{ "ProductCategory": "Clothing", "UnitPrice": 12.81, "SellerName": "Stanley Brooker", "Country": "Bulgaria", "City": "Plovdiv", "Date": "01/01/2012", "UnitsSold": 282 },
                { "ProductCategory": "Clothing", "UnitPrice": 49.57, "SellerName": "Elisa Longbottom", "Country": "US", "City": "New York", "Date": "01/05/2013", "UnitsSold": 296 },
                { "ProductCategory": "Bikes", "UnitPrice": 3.56, "SellerName": "Lydia Burson", "Country": "Uruguay", "City": "Ciudad de la Costa", "Date": "01/06/2011", "UnitsSold": 68 },
                { "ProductCategory": "Accessories", "UnitPrice": 85.58, "SellerName": "David Haley", "Country": "UK", "City": "London", "Date": "04/07/2012", "UnitsSold": 293 },
                { "ProductCategory": "Components", "UnitPrice": 18.13, "SellerName": "John Smith", "Country": "Japan", "City": "Yokohama", "Date": "12/08/2012", "UnitsSold": 240 },
                { "ProductCategory": "Clothing", "UnitPrice": 68.33, "SellerName": "Larry Lieb", "Country": "Uruguay", "City": "Ciudad de la Costa", "Date": "05/12/2011", "UnitsSold": 456 },
                { "ProductCategory": "Components", "UnitPrice": 16.05, "SellerName": "Walter Pang", "Country": "Bulgaria", "City": "Sofia", "Date": "02/19/2013", "UnitsSold": 492 }];

        $(function () {
            $('#dataSelector').igPivotDataSelector({
                dataSourceOptions: {
                    flatDataOptions:
                        {
                            dataSource: data,
                            metadata: {
                                cube: {
                                    name: "Sales",
                                    caption: "Sales",
                                    measuresDimension: {
                                        caption: "Measures",
                                        measures: [ //for each measure, name and aggregator are required
                                            {
                                                caption: "Units Sold", name: "UnitsSold",
                                                // returns a function that will be used as sum aggregatro on the 'UnitsSold property' of the data objects
                                                aggregator: $.ig.OlapUtilities.prototype.sumAggregator('UnitsSold')
                                            }]
                                    },
                                    dimensions: [ // for each dimension name and hierarchies are required
                                        {
                                            caption: "Seller", name: "Seller", hierarchies: [{
                                                caption: "Seller", name: "Seller", levels: [
                                                    {
                                                        name: "AllSellers", caption: "All Sellers",
                                                        memberProvider: function (item) { return "All Sellers"; }
                                                    },
                                                    {
                                                        name: "SellerName", caption: "Seller",
                                                        memberProvider: function (item) { return item.SellerName; }
                                                    }]
                                            }]
                                        },
                                        {
                                            caption: "Date", name: "Date", /*displayFolder: "Folder1\\Folder2",*/ hierarchies: [
                                                $.ig.OlapUtilities.prototype.getDateHierarchy(
                                                    "Date", // the source property name
                                                    ["year", "quarter", "month", "date"], // the date parts for which levels will be generated (optional)
                                                    "Dates", // The name for the hierarchy (optional)
                                                    "Date", // The caption for the hierarchy (optional)
                                                    ["Year", "Quarter", "Month", "Day"], // the captions for the levels (optional)
                                                    "All Periods") // the root level caption (optional)
                                            ]
                                        }
                                    ]
                                }
                            }
                        },
                    // Preload hiearhies for the rows, columns, filters and measures
                    rows: "[Date].[Dates]",
                    columns: "[Seller].[Seller]",
                    measures: "[Measures].[UnitsSold]"
                }
            });
        });
    </script>
</head>
<body>
    <div id="dataSelector"></div>
</body>
</html>
    

Related Samples

Related Topics

Dependencies

jquery-1.4.4.js
jquery.ui.core.js
jquery.ui.widget.js
jquery.ui.draggable.js
jquery.ui.droppable.js
infragistics.util.js
infragistics.datasource.js
infragistics.olapxmladatasource.js
infragistics.olapflatdatasource.js
infragistics.templating.js
infragistics.ui.shared.js
infragistics.ui.scroll.js
infragistics.ui.combo.js
infragistics.ui.tree.js
infragistics.ui.pivot.shared.js

Inherits

  • customMoveValidation

    Type:
    function
    Default:
    null

    A function that will be called to determine if an item can be moved in or dropped on an area of the data selector.
    paramType="string" The location where the item will be moved - igPivotGrid, igPivotDataSelector, filters, rows, columns or measures.
    paramType="string" The type of the item - Hierarchy, Measure or MeasureList.
    paramType="string" The unique name of the item.
    returnType="bool" The function must return true if the item should be accepted.

    Code Sample

     
            //Initialize
            $(".selector").igPivotDataSelector({
                customMoveValidation : function(location, itemType, uniqueName) {
                    // disable moving of any element to the columns
                    if (location == 'columns') {
                        return false;
                    }
                    // if the current item is a hierarchy containing the word "Seller" in its uniqueName, disable the move
                    if (itemType == 'Hierarchy'
                        && uniqueName.indexOf("Seller") !== -1) {
                        return false;
                    }
                    
                    // in all other cases allow the move
                    return true;
                }
            });
            
            //Get
            var customValidation = $(".selector").igPivotDataSelector("option", "customMoveValidation");
            
            //Set
            $(".selector").igPivotDataSelector("option", "customMoveValidation", validationFunc);
          
  • dataSource

    Type:
    object
    Default:
    null

    An instance of $.ig.OlapXmlaDataSource or $.ig.OlapFlatDataSource.

    Code Sample

     
            //Initialize
            $(".selector").igPivotDataSelector({
                dataSource : ds
            });
            
            //Get
            var dataSource = $(".selector").igPivotDataSelector("option", "dataSource");
            
            //Set
            $(".selector").igPivotDataSelector("option", "dataSource", ds);
          
  • dataSourceOptions

    Type:
    object
    Default:
    {}

    An object that will be used to create an instance of $.ig.OlapXmlaDataSource or $.ig.OlapFlatDataSource.
    The provided value must contain an object with settings for one of the data source types - xmlaOptions or flatDataOptions.

    Code Sample

     
            //Initialize
            $(".selector").igPivotDataSelector({
                dataSourceOptions: {
                    flatDataOptions:
                        {
                            [{ "ProductCategory": "Clothing", "UnitPrice": 12.81, "SellerName": "Stanley Brooker", "Country": "Bulgaria", "City": "Plovdiv", "Date": "01/01/2012", "UnitsSold": 282 },
                            { "ProductCategory": "Clothing", "UnitPrice": 49.57, "SellerName": "Elisa Longbottom", "Country": "US", "City": "New York", "Date": "01/05/2013", "UnitsSold": 296 },
                            { "ProductCategory": "Bikes", "UnitPrice": 3.56, "SellerName": "Lydia Burson", "Country": "Uruguay", "City": "Ciudad de la Costa", "Date": "01/06/2011", "UnitsSold": 68 },
                            { "ProductCategory": "Accessories", "UnitPrice": 85.58, "SellerName": "David Haley", "Country": "UK", "City": "London", "Date": "04/07/2012", "UnitsSold": 293 },
                            { "ProductCategory": "Components", "UnitPrice": 18.13, "SellerName": "John Smith", "Country": "Japan", "City": "Yokohama", "Date": "12/08/2012", "UnitsSold": 240 },
                            { "ProductCategory": "Clothing", "UnitPrice": 68.33, "SellerName": "Larry Lieb", "Country": "Uruguay", "City": "Ciudad de la Costa", "Date": "05/12/2011", "UnitsSold": 456 },
                            { "ProductCategory": "Components", "UnitPrice": 16.05, "SellerName": "Walter Pang", "Country": "Bulgaria", "City": "Sofia", "Date": "02/19/2013", "UnitsSold": 492 }],
                            metadata: {
                                cube: {
                                    name: "Sales",
                                    caption: "Sales",
                                    measuresDimension: {
                                        caption: "Measures",
                                        measures: [ //for each measure, name and aggregator are required
                                            { caption: "UnitsSold", name: "UnitsSold", aggregator: $.ig.OlapUtilities.prototype.sumAggregator('UnitsSold') }]
                                    },
                                    dimensions: [ // for each dimension name and hierarchies are required
                                        {
                                            caption: "Seller", name: "Seller", hierarchies: [{
                                                caption: "Seller", name: "Seller", levels: [
                                                    {
                                                        name: "AllSellers", caption: "All Sellers",
                                                        memberProvider: function (item) { return "All Sellers"; }
                                                    },
                                                    {
                                                        name: "SellerName", caption: "Seller",
                                                        memberProvider: function (item) { return item.SellerName; }
                                                    }]
                                            }]
                                        },
                                        {
                                            caption: "Date", name: "Date", /*displayFolder: "Folder1\\Folder2",*/ hierarchies: [
                                                $.ig.OlapUtilities.prototype.getDateHierarchy(
                                                    "Date", // the source property name
                                                    ["year", "quarter", "month", "date"], // the date parts for which levels will be generated (optional)
                                                    "Dates", // The name for the hierarchy (optional)
                                                    "Date", // The caption for the hierarchy (optional)
                                                    ["Year", "Quarter", "Month", "Day"], // the captions for the levels (optional)
                                                    "AllPeriods") // the root level caption (optional)
                                            ]
                                        }
                                    ]
                                }
                            }
                        },
                    // Preload hiearhies for the rows, columns, filters and measures
                    rows: "[Date].[Dates]",
                    columns: "[Seller].[Seller]",
                    measures: "[Measures].[UnitsSold]"
                }
            });
            
            //Get
            $(".selector").igPivotDataSelector("option", "dataSourceOptions");
            
            //Set
            $(".selector").igPivotDataSelector("option", "dataSourceOptions", dataOptions);
          
    • columns

      Type:
      string
      Default:
      null

      A list of hierarchy names separated by comma (,). These will be the hierarchies in the columns of the data source.

    • filters

      Type:
      string
      Default:
      null

      A list of hierarchy names separated by comma (,). These will be hierarchies in the filters of the data source.

    • flatDataOptions

      Type:
      object
      Default:
      {}

      Settings for creating an instance of $.ig.OlapFlatDataSource.

      • dataSource

        Type:
        object
        Default:
        null

        Specifies any valid data source accepted by $.ig.DataSource, or an instance of an $.ig.DataSource itself.

      • dataSourceType

        Type:
        string
        Default:
        null

        Explicitly set data source type (such as "json"). Please refer to the documentation of $.ig.DataSource and its type property.

      • dataSourceUrl

        Type:
        string
        Default:
        null

        Specifies a remote URL accepted by $.ig.DataSource in order to request data from it.

      • metadata

        Type:
        object
        Default:
        {}

        Optional="false" An object containing processing instructions for the $.ig.DataSource data.

        • cube

          Type:
          object
          Default:
          {}

          Optional="false" Metadata used for the creation of the cube.

          • caption

            Type:
            string
            Default:
            null

            A caption for the cube.

          • dimensions

            Type:
            array
            Default:
            []
            Elements Type:
            object

            An array of dimension metadata objects.

            • caption

              Type:
              string
              Default:
              null

              A caption for the dimension.

            • hierarchies

              Type:
              array
              Default:
              []
              Elements Type:
              object

              An array of hierarchy metadata objects.

              • caption

                Type:
                string
                Default:
                null

                A caption for the hierarchy.

              • displayFolder

                Type:
                string
                Default:
                null

                The path to be used when displaying the hierarchy in the user interface.
                Nested folders are indicated by a backslash (\).
                The folder hierarchy will appear under parent dimension node.

              • levels

                Type:
                array
                Default:
                []
                Elements Type:
                object

                An array of level metadata objects.

                • caption

                  Type:
                  string
                  Default:
                  null

                  A caption for the level.

                • memberProvider

                  Type:
                  function
                  Default:
                  null

                  A function called for each item of the data source array when level members are created.
                  Based on the item parameter the function should return a value that will form the $.ig.Member’s name and caption.

                • name

                  Type:
                  string
                  Default:
                  null

                  Optional="false" A name for the level.
                  The unique name of the level is formed using the following pattern:
                  {<hierarchy.uniqueName>}.[<levelMetadata.name>].

              • name

                Type:
                string
                Default:
                null

                Optional="false" A name for the hierarchy.
                The unique name of the hierarchy is formed using the following pattern:
                [<parentDimension.name>].[<hierarchyMetadata.name>].

            • name

              Type:
              string
              Default:
              null

              Optional="false" A unique name for the dimension.

          • measuresDimension

            Type:
            object
            Default:
            {}

            An object providing information about the measures' root node.

            • caption

              Type:
              string
              Default:
              null

              A caption for the measures dimension.
              The default value is "Measures".

            • measures

              Type:
              array
              Default:
              []
              Elements Type:
              object

              An array of measure metadata objects.

              • aggregator

                Type:
                function
                Default:
                null

                Optional="false" An aggregator function called when each cell is evaluated.
                Returns a value for the cell. If the returned value is null, no cell will be created in for the data source result.

              • caption

                Type:
                string
                Default:
                null

                A caption for the measure.

              • displayFolder

                Type:
                string
                Default:
                null

                The path used when displaying the measure in the user interface. Nested folders are indicated by a backslash (\).

              • name

                Type:
                string
                Default:
                null

                Optional="false" A unique name for the measure.

            • name

              Type:
              string
              Default:
              null

              A unique name for the measures dimension.
              The default value is "Measures". This name is used to create the names of dimensions using the following pattern:
              [<measuresDimensionMetadata.name>].[<measureMetadata.name>].

          • name

            Type:
            string
            Default:
            null

            Optional="false" A unique name for the cube.

      • responseDataKey

        Type:
        string
        Default:
        null

        See $.ig.DataSource.
        string Specifies the name of the property in which data records are held if the response is wrapped.
        null Option is ignored.

      • responseDataType

        Type:
        string
        Default:
        null

        String Explicitly set data source type (such as "json"). Please refer to the documentation of $.ig.DataSource and its type property.
        null Option is ignored.

    • measures

      Type:
      string
      Default:
      null

      A list of measure names separated by comma (,). These will be the measures of the data source.

    • rows

      Type:
      string
      Default:
      null

      A list of hierarchy names separated by comma (,). These will be the hierarchies in the rows of the data source.

    • xmlaOptions

      Type:
      object
      Default:
      {}

      Settings for creating an instance of $.ig.OlapXmlaDataSource.

      • catalog

        Type:
        string
        Default:
        null

        The catalog name.

      • cube

        Type:
        string
        Default:
        null

        The name of the cube in the data source.

      • discoverProperties

        Type:
        object
        Default:
        null

        Additional properties sent with every discover request.
        The object is treated as a key/value store where each property name is used as the key and the property value as the value.

      • enableResultCache

        Type:
        bool
        Default:
        true

        Enables/disables caching of the XMLA result object.

      • executeProperties

        Type:
        object
        Default:
        null

        Additional properties sent with every execute request.
        The object is treated as a key/value store where each property name is used as the key and the property value as the value.

      • mdxSettings

        Type:
        object
        Default:
        {}

        Optional="true" a javascript object containing information about how the request to the xmla server should be processed.

        • addCalculatedMembersOnColumns

          Type:
          bool
          Default:
          true

          Optional="true" a value indicating whether a members' set expressions on COLUMNS axis should be wrapped with AddCalculatedMembers MDX method. Default value is true.

        • addCalculatedMembersOnRows

          Type:
          bool
          Default:
          true

          Optional="true" a value indicating whether a members' set expressions on ROWS axis should be wrapped with AddCalculatedMembers MDX method. Default value is true.

        • dimensionPropertiesOnColumns

          Type:
          array
          Default:
          []
          Elements Type:
          object

          Optional="true" a string array with the names of intrinsic non-context sensitive member properties applied on COLUMNS axis. By defult CHILDREN_CARDINALITY and PARENT_UNIQUE_NAME properties are always added to DIMENSION PROPERTIES.

        • dimensionPropertiesOnRows

          Type:
          array
          Default:
          []
          Elements Type:
          object

          Optional="true" a string array with the names of intrinsic non-context sensitive member properties applied on ROWS axis. By defult CHILDREN_CARDINALITY and PARENT_UNIQUE_NAME properties are always added to DIMENSION PROPERTIES.

        • nonEmptyOnColumns

          Type:
          bool
          Default:
          true

          Optional="true" a value indicating whether a NON EMPTY clause is present on COLUMNS axis. Default value is true.

        • nonEmptyOnRows

          Type:
          bool
          Default:
          true

          Optional="true" a value indicating whether a NON EMPTY clause is present on ROWS axis. Default value is true.

      • measureGroup

        Type:
        string
        Default:
        null

        The name of the measure group in the data source.

      • requestOptions

        Type:
        object
        Default:
        {}

        An object containing information about how the request to the XMLA server should be processed.

        • beforeSend

          Type:
          function
          Default:
          null

          A callback to be invoked right before the request is send to the server. Extends beforeSend callback of jQuery.ajax’s options object.

        • withCredentials

          Type:
          bool
          Default:
          false

          The value is applied to XmlHttpRequest.withCredentials if supported by the user agent.
          Setting this property to true will allow IE8/IE9 to make authenticated cross-origin requests to tusted domains through XmlHttpRequest instead of XDomainRequest
          and will prompt the user for credentials.

      • serverUrl

        Type:
        string
        Default:
        null

        Optional="false" The URL of the XMLA server.

  • deferUpdate

    Type:
    bool
    Default:
    false

    Setting deferUpdate to true will not apply changes to the data source until the update method is called or the update layout button is clicked.

    Code Sample

     
            //Initialize
            $(".selector").igPivotDataSelector({
                deferUpdate : true
            });
            
            //Get
            var deferUpdate = $(".selector").igPivotDataSelector("option", "deferUpdate");
            
            //Set
            $(".selector").igPivotDataSelector("option", "deferUpdate", true);
            
  • disableColumnsDropArea

    Type:
    bool
    Default:
    false

    Disable the drag and drop for the columns drop area and the ability to use filtering and remove items from it.

    Code Sample

     
            //Initialize
            $('.selector').igPivotDataSelector({
                 disableColumnsDropArea : true
            });
            
            //Get
            var disableColumnsDropArea = $(".selector").igPivotDataSelector("option", "disableColumnsDropArea");
            
            //Set
            $(".selector").igPivotDataSelector("option", "disableColumnsDropArea", true);
          
  • disableFiltersDropArea

    Type:
    bool
    Default:
    false

    Disable the drag and drop for the filters drop area and the ability to use filtering and remove items from it.

    Code Sample

     
            //Initialize
            $('.selector').igPivotDataSelector({
                 disableFiltersDropArea : true
            });
            
            //Get
            var disableFiltersDropArea = $(".selector").igPivotDataSelector("option", "disableFiltersDropArea");
            
            //Set
            $(".selector").igPivotDataSelector("option", "disableFiltersDropArea", true);
            
  • disableMeasuresDropArea

    Type:
    bool
    Default:
    false

    Disable the drag and drop for the measures drop area and the ability to use filtering and remove items from it.

    Code Sample

            //Initialize
            $('.selector').igPivotDataSelector({
                 disableMeasuresDropArea : true
            });
            
            //Get
            var disableMeasuresDropArea = $(".selector").igPivotDataSelector("option", "disableMeasuresDropArea");
            
            //Set
            $(".selector").igPivotDataSelector("option", "disableMeasuresDropArea", true);
          
  • disableRowsDropArea

    Type:
    bool
    Default:
    false

    Disable the drag and drop for the rows drop area and the ability to use filtering and remove items from it.

    Code Sample

     
            //Initialize
            $('.selector').igPivotDataSelector({
                 disableRowsDropArea : true
            });
            
            //Get
            var disableRowsDropArea = $(".selector").igPivotDataSelector("option", "disableRowsDropArea");
            
            //Set
            $(".selector").igPivotDataSelector("option", "disableRowsDropArea", true);
          
  • dragAndDropSettings

    Type:
    object
    Default:
    {}

    Settings for the drag and drop functionality of the igPivotDataSelector.

    Code Sample

     
            //Initialize
            $(".selector").igPivotDataSelector({
                dragAndDropSettings : {
                    appendTo : $("element"),
                    containment : true,
                    zIndex : 10
                }
            });
            
            //Get
            var dragAndDropSettings = $(".selector").igPivotDataSelector("option", "dragAndDropSettings");
            
            //Set
            $(".selector").igPivotDataSelector("option", "dragAndDropSettings", settings );
            
    • appendTo

      Type:
      enumeration
      Default:
      body

      Which element the draggable helper should be appended to while dragging.

    • containment

      Type:
      enumeration
      Default:
      false

      Specifies the containment for the drag helper. The area inside of which the helper is contained would be scrollable while dragging.

    • zIndex

      Type:
      number
      Default:
      10

      Specifies z-index that would be set for the drag helper.

  • dropDownParent

    Type:
    enumeration
    Default:
    body

    Specifies the parent for the drop downs.

  • height

    Type:
    enumeration
    Default:
    null

    This is the total height of the grid, including all UI elements - scroll container with data rows, header, footer, filter row - (if any), etc. .

    Members

    • null
    • Type:object
    • will stretch vertically to fit data, if no other heights are defined.
    • string
    • The widget height can be set in pixels (px) and percentage (%).
    • number
    • The widget height can be set as a number.

    Code Sample

     
            //Initialize
            $('.selector').igPivotDataSelector({
                 height : "600px"
            });
            
            //Get
            $(".selector").igPivotDataSelector("option", "height");
            
            //Set
            $(".selector").igPivotDataSelector("option", "height", "600px");
          
  • width

    Type:
    enumeration
    Default:
    250

    Members

    • null
    • Type:object
    • will stretch to fit data, if no other widths are defined.
    • string
    • The widget width can be set in pixels (px) and percentage (%). The recommended width is 250px.
    • number
    • The widget width can be set as a number.

    Code Sample

     
            //Initialize
            $('.selector').igPivotDataSelector({
                 width : "300px"
            });
            
            //Get
            $(".selector").igPivotDataSelector("option", "width");
            
            //Set
            $(".selector").igPivotDataSelector("option", "width", "300px");
          

For more information on how to interact with the Ignite UI controls' events, refer to
Using Events in Ignite UI.

Note: Calling API methods programmatically does not raise events related to their operation unless specifically stated otherwise by the corresponding API documentation; those events are only raised by their respective user interaction.

Show Details
  • dataSelectorRendered

    Cancellable:
    false

    Fired after the data selector is rendered. Changing the data source instance will re-render the data selector.
    Function takes arguments evt and ui.
    Use ui.owner to get a reference to the data selector.

    Code Sample

     
        //Delegate
        $(document).delegate(".selector", "igpivotdataselectordataselectorrendered", function (evt, ui) {
          //return reference to igPivotDataSelector
          ui.owner;
        });
        
        //Initialize
        $(".selector").igPivotDataSelector({
          dataSelectorRendered: function(evt, ui) {...}
        });
          
  • dataSourceInitialized

    Cancellable:
    false

    Fired after the data source has initialized.
    Function takes arguments evt and ui.
    Use ui.owner to get a reference to the data selector.
    Use ui.dataSource to get a reference to the data source.
    Use ui.error to see if an error has occured during initialization.
    Use ui.metadataTreeRoot to get a reference to the root of the data source metatadata root item.

    Code Sample

     
        //Delegate
        $(document).delegate(".selector", "igpivotdataselectordatasourceinitialized", function (evt, ui) {
          //return reference to the data source
          ui.dataSource;
          //return a bool idicating whether an error has occured during initialization
          ui.error;
          //return a reference to the root of the data source metatadata root item
          ui.metadataTreeRoot;
          //return reference to igPivotDataSelector
          ui.owner;
        });
        
        //Initialize
        $(".selector").igPivotDataSelector({
          dataSourceInitialized: function(evt, ui) {...}
        });
        
  • dataSourceUpdated

    Cancellable:
    false

    Fired after the data source has updated.
    Function takes arguments evt and ui.
    Use ui.owner to get a reference to the data selector.
    Use ui.dataSource to get a reference to the data source.
    Use ui.error to see if an error has occured during update.
    Use ui.result to get the result of the update operation.

    Code Sample

     
        //Delegate
        $(document).delegate(".selector", "igpivotdataselectordatasourceupdated", function (evt, ui) {
          //return reference to the data source
          ui.dataSource;
          //return a bool idicating whether an error has occured during initialization
          ui.error;
          //return a reference to result of the update operation
          ui.result;
          //return reference to igPivotDataSelector
          ui.owner;
        });
        
        //Initialize
        $(".selector").igPivotDataSelector({
          dataSourceUpdated: function(evt, ui) {...}
        });
          
  • deferUpdateChanged

    Cancellable:
    false

    Fired when the defer update checkbox changes.
    Function takes arguments evt and ui.
    Use ui.owner to get a reference to the data selector.
    Use ui.deferUpdate to get the defer update value.

    Code Sample

     
        //Delegate
        $(document).delegate(".selector", "igpivotdataselectordeferupdatechanged", function (evt, ui) {
          //return the value of the deferUpdate option
          ui.deferUpdate;
          //return reference to igPivotDataSelector
          ui.owner;
        });
        
        //Initialize
        $(".selector").igPivotDataSelector({
          deferUpdateChanged: function(evt, ui) {...}
        });
          
  • drag

    Cancellable:
    true

    Fired on drag. Return false to cancel the dragging.
    Use ui.metadata to get a reference to the data.
    Use ui.helper to get a reference to the helper.
    Use ui.offset to get a reference to the offset.
    Use ui.originalPosition to get a reference to the original position of the draggable element.
    Use ui.position to get a reference to the current position of the draggable element.

    Code Sample

     
        //Delegate
        $(document).delegate(".selector", "igpivotdataselectordrag", function (evt, ui) {
          //return a reference to the helper
          ui.helper;
          //return a reference to the offset
          ui.offset;
          //return a reference to the original position of the draggable element
          ui.originalPosition;
          //return a reference to the current position of the draggable element
          ui.position;
        });
        
        //Initialize
        $(".selector").igPivotDataSelector({
          drag: function(evt, ui) {...}
        });
          
  • dragStart

    Cancellable:
    true

    Fired on drag start. Return false to cancel the drag.
    Use ui.metadata to get a reference to the data.
    Use ui.helper to get a reference to the helper.
    Use ui.offset to get a reference to the offset.
    Use ui.originalPosition to get a reference to the original position of the draggable element.
    Use ui.position to get a reference to the current position of the draggable element.

    Code Sample

     
        //Delegate
        $(document).delegate(".selector", "igpivotdataselectordragstart", function (evt, ui) {
          //return a reference to the data
          ui.metadata;
          //return a reference to the helper
          ui.helper;
          //return a reference to the offset
          ui.offset;
          //return a reference to the original position of the draggable element
          ui.originalPosition;
          //return a reference to the current position of the draggable element
          ui.position;
        });
        
        //Initialize
        $(".selector").igPivotDataSelector({
          dragStart: function(evt, ui) {...}
        });
          
  • dragStop

    Cancellable:
    false

    Fired on drag stop.
    Use ui.helper to get a reference to the helper.
    Use ui.offset to get a reference to the offset.
    Use ui.originalPosition to get a reference to the original position of the draggable element.
    Use ui.position to get a reference to the current position of the draggable element.

    Code Sample

     
        //Delegate
        $(document).delegate(".selector", "igpivotdataselectordragstop", function (evt, ui) {
          //return a reference to the helper
          ui.helper;
          //return a reference to the offset
          ui.offset;
          //return a reference to the original position of the draggable element
          ui.originalPosition;
          //return a reference to the current position of the draggable element
          ui.position;
        });
        
        //Initialize
        $(".selector").igPivotDataSelector({
          dragStop: function(evt, ui) {...}
        });
          
  • filterDropDownClosed

    Cancellable:
    false

    Fired after the filter members drop down closes.
    Use ui.hierarchy for a reference to the hierarchy.

    Code Sample

     
        //Delegate
        $(document).delegate(".selector", "igpivotdataselectorfilterdropdownclosed", function (evt, ui) {
          //return a reference to the hierarchy
          ui.hierarchy;
        });
        
        //Initialize
        $(".selector").igPivotDataSelector({
          filterDropDownClosed: function(evt, ui) {...}
        });
          
  • filterDropDownClosing

    Cancellable:
    true

    Fired before the filter members drop down closes. Return false to cancel the closing.
    Use ui.hierarchy for a reference to the hierarchy.
    Use ui.dropDownElement for a reference to the drop down.

    Code Sample

     
        //Delegate
        $(document).delegate(".selector", "igpivotdataselectorfilterdropdownclosing", function (evt, ui) {
          //return a reference to the drop down
          ui.dropDownElement;
          //return a reference to the hierarchy
          ui.hierarchy;
        });
        
        //Initialize
        $(".selector").igPivotDataSelector({
          filterDropDownClosing: function(evt, ui) {...}
        });
          
  • filterDropDownOk

    Cancellable:
    true

    Fired after the OK button in the filter members drop down is clicked. Return false to cancel the applying of the filters.
    Use ui.hierarchy for a reference to the hierarchy.
    Use ui.filterMembers for a collection with the selected filter members. If all filter members are selected the collection will be empty.
    Use ui.dropDownElement for a reference to the drop down.

    Code Sample

     
        //Delegate
        $(document).delegate(".selector", "igpivotdataselectorfilterdropdownok", function (evt, ui) {
          //return a reference to the drop down
          ui.dropDownElement;
          //return the collection with the selected filter members. If all filter members are selected, the collection will be empty.
          ui.filterMembers;
          //return a reference to the hierarchy
          ui.hierarchy;
        });
        
        //Initialize
        $(".selector").igPivotDataSelector({
          filterDropDownOk: function(evt, ui) {...}
        });
          
  • filterDropDownOpened

    Cancellable:
    false

    Fired after the filter members drop down opens.
    Use ui.hierarchy for a reference to the hierarchy.
    Use ui.dropDownElement for a reference to the drop down.

    Code Sample

     
        //Delegate
        $(document).delegate(".selector", "igpivotdataselectorfilterdropdownopened", function (evt, ui) {
          //return a reference to the drop down
          ui.dropDownElement;
          //return a reference to the hierarchy
          ui.hierarchy;
        });
        
        //Initialize
        $(".selector").igPivotDataSelector({
          filterDropDownOpened: function(evt, ui) {...}
        });
          
  • filterDropDownOpening

    Cancellable:
    true

    Fired before the filter members drop down opens. Return false to cancel the opening.
    Use ui.hierarchy for a reference to the hierarchy.

    Code Sample

     
        //Delegate
        $(document).delegate(".selector", "igpivotdataselectorfilterdropdownopening", function (evt, ui) {
          //return a reference to the hierarchy
          ui.hierarchy;
        });
        
        //Initialize
        $(".selector").igPivotDataSelector({
          filterDropDownOpening: function(evt, ui) {...}
        });
          
  • filterMembersLoaded

    Cancellable:
    false

    Fired after the filter members are loaded.
    Use ui.parent to get the parent node or the igTree instance in the initial load.
    Use ui.rootFilterMembers for a collection with the root filter members (deprecated).
    Use ui.filterMembers for a collection with the newly loaded filter members.

    Code Sample

     
        //Delegate
        $(document).delegate(".selector", "igpivotdataselectorfiltermembersloaded", function (evt, ui) {
          //return the collection with the root filter members
          ui.parent;
          //return the collection with the newly loaded filter members
          ui.rootFilterMembers;
        });
        
        //Initialize
        $(".selector").igPivotDataSelector({
          filterMembersLoaded: function(evt, ui) {...}
        });
          
  • metadataDropped

    Cancellable:
    false

    Fired after a metadata item drop.
    Use ui.targetElement for a reference to the drop target.
    Use ui.draggedElement for a reference to the dragged element.
    Use ui.metadata to get a reference to the data.
    Use ui.metadataIndex to get the index at which the metadata is inserted.
    Use ui.helper to get a reference to the helper.
    Use ui.offset to get a reference to the offset.
    Use ui.position to get a reference to the current position of the draggable element.

    Code Sample

     
        //Delegate
        $(document).delegate(".selector", "igpivotdataselectormetadatadropped", function (evt, ui) {
          //return a reference to the dragged element
          ui.draggedElement;
          //return a reference to the drop target
          ui.targetElement;
          //return a reference to the data
          ui.metadata;
          //return the index at which the metadata is inserted
          ui.metadataIndex;
          //return a reference to the helper
          ui.helper;
          //return a reference to the offset
          ui.offset;
          //return a reference to the current position of the draggable element
          ui.position;
        });
        
        //Initialize
        $(".selector").igPivotDataSelector({
          metadataDropped: function(evt, ui) {...}
        });
          
  • metadataDropping

    Cancellable:
    true

    Fired before a metadata item drop. Return false to cancel the drop.
    Use ui.targetElement for a reference to the drop target.
    Use ui.draggedElement for a reference to the dragged element.
    Use ui.metadata to get a reference to the data.
    Use ui.metadataIndex to get the index at which the metadata will be inserted.
    Use ui.helper to get a reference to the helper.
    Use ui.offset to get a reference to the offset.
    Use ui.position to get a reference to the current position of the draggable element.

    Code Sample

     
        //Delegate
        $(document).delegate(".selector", "igpivotdataselectormetadatadropping", function (evt, ui) {
          //return a reference to the dragged element
          ui.draggedElement;
          //return a reference to the drop target
          ui.targetElement;
          //return a reference to the data
          ui.metadata;
          //return the index at which the metadata is inserted
          ui.metadataIndex;
          //return a reference to the helper
          ui.helper;
          //return a reference to the offset
          ui.offset;
          //return a reference to the current position of the draggable element
          ui.position;
        });
        
        //Initialize
        $(".selector").igPivotDataSelector({
          metadataDropping: function(evt, ui) {...}
        });
          
  • metadataRemoved

    Cancellable:
    false

    Fired after a metadata item is removed when the user clicks the close icon.
    Use ui.metadata to get a reference to the data.

    Code Sample

     
        //Delegate
        $(document).delegate(".selector", "igpivotdataselectormetadataremoved", function (evt, ui) {
          //return a reference to the data
          ui.metadata;
        });
        
        //Initialize
        $(".selector").igPivotDataSelector({
          metadataRemoved: function(evt, ui) {...}
        });
          
  • metadataRemoving

    Cancellable:
    true

    Fired before a metadata item is removed when the user clicks the close icon. Return false to cancel the removing.
    Use ui.targetElement for a reference to the dragged element.
    Use ui.metadata to get a reference to the data.

    Code Sample

     
        //Delegate
        $(document).delegate(".selector", "igpivotdataselectormetadataremoving", function (evt, ui) {
          //return a reference to the drop target
          ui.targetElement;
          //return a reference to the data
          ui.metadata;
        });
        
        //Initialize
        $(".selector").igPivotDataSelector({
          metadataRemoving: function(evt, ui) {...}
        });
          
  • destroy

    .igPivotDataSelector( "destroy" );

    Destroy is part of the jQuery UI widget API and does the following:
    1. Remove custom CSS classes that were added.
    2. Unwrap any wrapping elements such as scrolling divs and other containers.
    3. Unbind all events that were bound.

    Code Sample

     
          $(".selector").igPivotDataSelector("destroy");
          
  • update

    .igPivotDataSelector( "update" );

    Updates the data source.

    Code Sample

     
          $(".selector").igPivotDataSelector("update");
          
  • active

    Class applied to the drop areas, which can accept a drop.
  • ui-igpivotdataselector-catalog

    Class applied to the catalog combo.
  • ui-icon ui-icon-pivot-columns

    Classes applied to the columns drop area icon.
  • ui-igpivotdataselector-cube

    Class applied to the cube combo.
  • ui-igpivotdataselector

    Class applied to the the data selector element.
  • ui-igpivotdataselector-root

    Class applied to the root container for the data selector.
  • ui-igpivot-droparea ui-widget-content

    Classes applied to the drop areas.
  • ui-igpivotdataselector-dropareas

    Class applied to the table with the drop areas.
  • ui-state-highlight

    Class applied to the valid drop element.
  • ui-igpivot-filterdropdown ui-widget ui-widget-content

    Classes applied to the filters drop down element.
  • ui-icon ui-icon-pivot-smallfilter

    Classes applied to the filter icon in the metadata items.
  • ui-igpivot-filtermembers

    Class applied to the tree containing the filter members.
  • ui-icon ui-icon-pivot-filters

    Classes applied to the filters drop area icon.
  • ui-igpivot-insertitem ui-state-highlight ui-corner-all

    Classes applied to the insert item indicator in the drop areas.
  • ui-state-error

    Class applied to the invalid drop element.
  • ui-igpivotdataselector-measuregroup

    Class applied to the measure group combo.
  • ui-icon ui-icon-pivot-measures

    Classes applied to the measures drop area icon.
  • ui-igpivotdataselector-metadata ui-widget-content

    Classes applied to the metadata tree.
  • ui-igpivot-metadataitem ui-widget ui-corner-all ui-state-default

    Classes applied to the elements representing metadata items - in the metadata tree and the drop areas.
  • ui-igpivot-metadatadropdown ui-widget ui-widget-content

    Classes applied to the metadata item drop down element.
  • ui-icon ui-icon-pivot-rows

    Classes applied to the rows drop area icon.
  • ui-igpivotdataselector-updatelayout

    Class applied to the update layout button.

Copyright © 1996 - 2024 Infragistics, Inc. All rights reserved.

#