Section

Remarks

UXGridView provides a flexible way to display a collection of data in rows and columns. The built-in column types include a text box column, a check box column, combo box column and template column for hosting custom content. The built-in row type includes a drop-down details section that you can use to display additional content below the cell values.

To bind UXGridView to data, set the ItemsSource property to an object that implements IEnumerable. Each row in the UXGridView is bound to an object in the data source, and each column in the UXGridView is bound to a property of the data object. In order for the UXGridView user interface to update automatically when items are added to or removed from the source data, UXGridView must be bound to a collection that implements INotifyCollectionChanged, such as an ObservableCollection<T>. In addition, for the user interface to automatically reflect property changes, the objects in the source collection must implement the INotifyPropertyChanged interface.

The following code shows a simple UXGridView with data binding in XAML.

Code Block

title	XAML
language	xml

<Intersoft:UXGridView ItemsSource="{Binding Products}"/>

For more information about UXGridView, see UXGridView Overview.

Example

The following code shows a simple UXGridView with data binding in XAML.

Code Block

title	XAML
language	xml

<Intersoft:UXGridView ItemsSource="{Binding Products}"/>

Working with AutoGenerateColumns Property and Columns Property

By default, the UXGridView control generates columns automatically when you set the ItemsSource property. The generated columns are of type UXGridViewCheckBoxColumn for bound Boolean (and nullable Boolean) properties, and of type UXGridViewTextColumn for all other properties. If a property does not have a string or numeric value type, the generated text box columns are read-only and display the data object's ToString value.

You can prevent automatic column generation by setting the AutoGenerateColumns property to false. This is useful when you want to create and configure all columns explicitly. Alternatively, you can let the data grid generate the columns, but handle the AutoGeneratingColumn event to customize columns after they are instantiated. To rearrange the display order of the columns, you can set the DisplayIndex property to the desired value for each individual column.

Generated columns recognize the DisplayAttribute if it is present on the source object. The DisplayAttribute.ShortName property is used to specify column header text. The DisplayAttribute.Order property is used to specify the order in which columns appear. The DisplayAttribute.AutoGenerateField property is used to specify whether the field has a column generated for it.

Regardless of how you generate the columns, you can access the Columns collection to programmatically add, insert, remove, and change any columns in the control at run time. Alternatively, you can specify columns in XAML, in which case you should set AutoGenerateColumns to false. Creating your own columns enables you to use additional column types, such as the UXGridViewCheckBoxColumn, UXGridViewExpanderColumn, UXGridViewSelectColumn, UXGridViewTemplateColumn or other custom column type that inherited from UXGridViewColumn.

The following list describes the built-in column types available in UXGridView.

UXGridViewCheckBoxColumn type provides an easy way to enable editing using combo box. You can provide the data for the editing combo box through the provided ValueListSource property, and determine the DisplayMemberPath and ValueMemberPath for the display and value object respectively.

Code Block

title	XAML
language	xml

<Intersoft:UXGridView.Columns>
    <Intersoft:UXGridViewComboBoxColumn Header="Category ID"
										DisplayMemberPath="CategoryName"
										ValueMemberPath="CategoryID" Width="120"
                                        Binding="{Binding CategoryID,
											Converter={StaticResource CategoryConverter}}"
                                        ValueListSource="{Binding Categories,
											Source={StaticResource CategoriesViewModel}}"/>
</Intersoft:UXGridView.Columns>

UXGridViewExpanderColumn type provides an easy way to expand and collapse a row details if you enable row details in UXGridView.

Code Block

title	XAML
language	xml

<Intersoft:UXGridView.Columns>
    <Intersoft:UXGridViewExpanderColumn />
    <Intersoft:UXGridViewTextColumn Header="Customer ID" Binding="{Binding CustomerID}"/>
    <Intersoft:UXGridViewTextColumn Header="Contact Name" Binding="{Binding ContactName}"/>
    <Intersoft:UXGridViewTextColumn Header="Contact Title" Binding="{Binding ContactTitle}"/>
    <Intersoft:UXGridViewTextColumn Header="CompanyName" Binding="{Binding CompanyName}"/>
</Intersoft:UXGridView.Columns>

UXGridViewSelectColumn type provides an easy way to enable selector column which allows you to check or uncheck a row in UXGridView. The checked items are accessible in theCheckedItems property. This column type also automatically adds a checkbox in the column header, allowing users to easily toggle the checked state of all the rows in the view.

Code Block

title	XAML
language	xml

<Intersoft:UXGridView.Columns>
    <Intersoft:UXGridViewSelectColumn/>
    <Intersoft:UXGridViewTextColumn Header="Customer ID" Binding="{Binding CustomerID}"/>
    <Intersoft:UXGridViewTextColumn Header="Contact Name" Binding="{Binding ContactName}"/>
    <Intersoft:UXGridViewTextColumn Header="Contact Title" Binding="{Binding ContactTitle}"/>
    <Intersoft:UXGridViewTextColumn Header="CompanyName" Binding="{Binding CompanyName}"/>
</Intersoft:UXGridView.Columns>

UXGridViewTemplateColumn type provides full flexibility to create custom columns with specific behaviors that meet your application's requirements. The CellTemplate and CellEditingTemplate properties enable you to specify the content templates for both display and editing mode.

Code Block

title	XAML
language	xml

<Intersoft:UXGridViewTextColumn Header="Birth Date"
		Binding="{Binding BirthDate, StringFormat=MM/dd/yyyy}">
    <Intersoft:UXGridViewTextColumn.CellEditingTemplate>
        <DataTemplate>
            <Grid Background="White" Margin="1">
                <Intersoft:UXDateTimePicker
					Value="{Binding BirthDate, Mode=TwoWay}"
					EditMask="MM/dd/yyyy" BorderThickness="0"
					UseEditMaskAsDisplayMask="True"
					VerticalAlignment="Center" HorizontalAlignment="Stretch"/>
            </Grid>
        </DataTemplate>
    </Intersoft:UXGridViewTextColumn.CellEditingTemplate>
</Intersoft:UXGridViewTextColumn>

Modern note
TheCellTemplate and CellEditingTemplate properties are also available in all built-in column types, allowing you to change the display and editing template for the desired columns.

Working with CanUserAddRows Property, CanUserDeleteRows Property and CanUserEditRows Property

Data editing in UXGridView involves three fundamental processes, Create, Update and Delete (CUD). You can enable each editing feature by setting the property CanUserAddRows, CanUserEditRows and CanUserDeleteRows respectively.

Code Block

title	Example Title
language	xml

<Intersoft:UXGridView CanUserAddRows="True" CanUserDeleteRows="True" CanUserEditRows="True"/>

A NewRow element will appear in the top of the UXGridView user interface when you set the CanUserAddRows property to true, such as shown in the following illustration.

In addition, you can also delete and edit the selected item by setting both the CanUserEditRows and CanUserDeleteRows properties to true.

Working with CanUserExport Property

To enable data exporting in UXGridView, you simply set the CanUserExport property of UXGridView to true.

When enabled, an Export dropdown button will appear in the status bar element of UXGridView.

You can also select the format of the exported results from the context menu as shown in the figure above. The supported export format are:

HTML
Excel
CSV
Text

Furthermore, you can also customize which element to export through the provided ExportOptions property. The following code shows how to include column footers and group footers in the data export results.

Modern note
IncludeColumnFooters and IncludeGroupFooters are only applicable for HTML format.

Code Block

title	XAML
language	xml

<Intersoft:UXGridView CanUserExport="{Binding CanUserExport}">
    <Intersoft:UXGridView.ExportOptions>
        <Intersoft:UXGridViewExportOptions IncludeColumnFooters="True"
			IncludeColumnHeaders="True" IncludeGroupFooters="True" />
    </Intersoft:UXGridView.ExportOptions>
</Intersoft:UXGridView>

Working with CanUserGroupColumns Property

Code Block

title	XAML
language	xml

<Intersoft:UXGridView CanUserGroupColumns="False">
    <Intersoft:UXGridView.Columns>
        <Intersoft:UXGridViewTextColumn Header="Customer ID"
			Binding="{Binding CustomerID}"/>
        <Intersoft:UXGridViewTextColumn Header="Contact Name"
			Binding="{Binding ContactName}"/>
        <Intersoft:UXGridViewTextColumn Header="Contact Title"
			Binding="{Binding ContactTitle}" CanUserGroup="True"/>
        <Intersoft:UXGridViewTextColumn Header="CompanyName"
			Binding="{Binding CompanyName}"/>
    </Intersoft:UXGridView.Columns>
</Intersoft:UXGridView>

Working with CanUserPage Property

To enable data sorting in UXGridView, you set the CanUserPage property to true and the PageSize property to the number of records per page in UXGridView.

Code Block

title	XAML
language	xml

<Intersoft:UXGridView CanUserPage="True" PageSize="30"/>

When enabled, a data pager user interface will appear in the status bar element of UXGridView.

Depending on the QueryOperation property, the data paging can be handled in either client or server side.

Working with CanUserSortColumns Property

To enable data sorting in UXGridView, you set the CanUserSortColumns property of UXGridView to true. If you prefer to enable sorting only on certain columns, set the CanUserSort property of the UXGridColumn to true.

Code Block

title	XAML
language	xml

<Intersoft:UXGridView CanUserSortColumns="True">
    <Intersoft:UXGridView.Columns>
        <Intersoft:UXGridViewTextColumn Header="Customer ID"
			Binding="{Binding CustomerID}" CanUserSort="False"/>
        <Intersoft:UXGridViewTextColumn Header="Contact Name"
			Binding="{Binding ContactName}"/>
        <Intersoft:UXGridViewTextColumn Header="Contact Title"
			Binding="{Binding ContactTitle}"/>
        <Intersoft:UXGridViewTextColumn Header="CompanyName"
			Binding="{Binding CompanyName}"/>
    </Intersoft:UXGridView.Columns>
</Intersoft:UXGridView>

Depending on the value of the QueryOperation property, the data sorting can be handled in either client or server side.

Working with CellEditingTemplateSelector Property

A rather unique scenario is where the users would like to have different editing control for the same column that depends on the data that currently being edited. This can be achieved elegantly in UXGridView by using CellEditingTemplateSelector. It works similarly to any other template selectors.

The following code shows how to create the editing template selector and used it in UXGridView.

Code Block

title	Cell Editing Template Selector
language	c#

using System.Windows;
using Intersoft.Client.Framework;
using Intersoft.Client.UI.Data;

namespace UXGridView.Samples.Selectors
{
    public class CellEditingSelector: DataTemplateSelector
    {
        public DataTemplate NumericEditor { get; set; }
        public DataTemplate SliderEditor { get; set; }

        public override DataTemplate SelectTemplate(object item,
                 DependencyObject container)
        {
            UXGridViewCell cell = container as UXGridViewCell;
            UXGridViewRowBase rowBase = cell.OwningRowBase;
            UXGridViewRow row = rowBase as UXGridViewRow;

            switch (cell.OwningColumn.PropertyName)
            {
                case "UnitsInStock":
                    if (rowBase.IsNewRow || (row != null && row.Index % 2 != 0))
                        return this.SliderEditor;
                    else
                        return this.NumericEditor;
            }

            return null;
        }
    }
}

Code Block

title	View
language	xml

<Grid.Resources>
    <DataTemplate x:Key="NumericEditor">
        <Intersoft:UXNumericUpDown Maximum="100" Value="{Binding UnitsInStock, Mode=TwoWay}"
                                      HorizontalAlignment="Stretch" VerticalAlignment="Stretch"/>
 </DataTemplate>
    <DataTemplate x:Key="SliderEditor">
        <Intersoft:UXSliderBar Value="{Binding UnitsInStock, Mode=TwoWay}"
                                  SmallChange="10" LargeChange="20" Maximum="100"/>
    </DataTemplate> 
    <Selectors:CellEditingSelector x:Key="CellEditingSelector"
               NumericEditor="{StaticResource NumericEditor}"
               SliderEditor="{StaticResource SliderEditor}"/>
</Grid.Resources>

<Intersoft:UXGridView CellEditingTemplateSelector="{StaticResource CellEditingSelector}">

Working with ColumnFooterVisibility Property

Code Block

title	XAML
language	xml

<Intersoft:UXGridView ColumnFooterVisibility="Visible" ItemsSource="{Binding Products}" >
    <Intersoft:UXGridView.Columns>
        <Intersoft:UXGridViewTextColumn Header="Category ID" Binding="{Binding CategoryID}"/>
        <Intersoft:UXGridViewTextColumn Header="Product ID" Binding="{Binding ProductID}"
			Aggregate="Count" FooterFormatString="Count = {0}"/>
        <Intersoft:UXGridViewTextColumn Header="Product Name" Binding="{Binding ProductName}"/>
        <Intersoft:UXGridViewTextColumn Header="Units In Stock" Binding="{Binding UnitsInStock}"
			Aggregate="Max" FooterFormatString="Max = {0}"/>
        <Intersoft:UXGridViewTextColumn Header="Unit Price" Binding="{Binding UnitPrice}"
			Aggregate="Avg" FooterFormatString="Avg = {0:n2}"/>
        <Intersoft:UXGridViewTextColumn Header="Units On Order" Binding="{Binding UnitsOnOrder}"
			Aggregate="Min" FooterFormatString="Min = {0}"/>
        <Intersoft:UXGridViewTextColumn Header="Quantity Per Unit"
			Binding="{Binding QuantityPerUnit}"/>
    </Intersoft:UXGridView.Columns>
</Intersoft:UXGridView>

Working with DeleteRowCommand Property, InsertRowCommand Property, PrepareNewRowCommand Property, RejectChangesCommand Property, RejectRowCommand Property, SaveChangesCommand Property, UpdateCellCommand Property, UpdateRowCommand Property and ValidateRowCommand Property

To handle the CUD operation, UXGridView provides several command-related properties that you can bind to your ViewModel to execute a method depending on the actions. These command-related properties are listed as follows:

PrepareNewRowCommand
Called when you begin edit at the NewRow element. Used to initialized the NewItem.
ValidateRowCommand
Validate the row before the row is committed.
InsertRowCommand
Called when a new row is committed. You can directly save the changes and/or refresh the UXGridView if necessary.
UpdateCellCommand
Called when the cell is committed.
UpdateRowCommand
Called when an existing row is committed. You can directly save the changes and/or refresh the UXGridView if necessary.
DeleteRowCommand
Called when a row is deleted. You can directly save the changes and / or refresh the UXGridView if necessary.
RejectRowCommand
Called when the changes in the row is cancelled. This command is used to reject the changes in the data entity if required (such as in DevForce).
SaveChangesCommand
Called when the save changes command is executed. You handle this command to save all the pending changes made in the UXGridView.
RejectChangesCommand
Called when the reject changes command is executed. You handle this command to reject all the pending changes made in the UXGridView.

You need to bind these command properties to your ViewModel and handle each of the action. Beside these command, UXGridView also provide HasChanges that you can use to determine whether there are existing changes in the data.

The following code example shows how to define and bind the editing commands from ViewModel to UXGridView.

Code Block

title	View Model
language	c#

using System.Collections;
using Intersoft.Client.Framework;
using Intersoft.Client.Framework.Input;
using Intersoft.Client.UI.Data;
using UXGridView.Samples.ModelServices;

namespace UXGridView.Samples.ViewModels
{
    public class ServerEditingViewModel : ViewModelBase
    {
        public ServerEditingViewModel()
            : base()
        {
            this.Manager = new NorthwindDomainContext();
            this.QueryDescriptor = new QueryDescriptor();
            
            this.ExportCommand = new DelegateCommand(ExecuteExportCommand);
            this.DeleteRowCommand = new DelegateCommand(ExecuteDeleteRow);
            this.InsertRowCommand = new DelegateCommand(ExecuteInsertRow);
            this.PrepareNewRowCommand = new DelegateCommand(ExecutePrepareNewRow);
            this.UpdateCellCommand = new DelegateCommand(ExecuteUpdateCell);
            this.UpdateRowCommand = new DelegateCommand(ExecuteUpdateRow);
            this.RejectRowCommand = new DelegateCommand(ExecuteRejectRow);
            this.RejectChangesCommand = new DelegateCommand(ExecuteRejectChanges);
            this.SaveChangesCommand = new DelegateCommand(ExecuteSaveChanges);
            this.ValidateRowCommand = new DelegateCommand(ExecuteValidateRow);
        }

        #region Fields

        private bool _hasChanges;
        private bool _isBusy;
        private bool _isRefreshed;
        private object _newProduct;
        private IEnumerable _products;
        private QueryDescriptor _queryDescriptor;
        
        #endregion

        #region Properties

        private NorthwindDomainContext Manager { get; set; }

        public IEnumerable Products
        {
            get { return this._products; }
            set
            {
                if (this._products != value)
                {
                    this._products = value;
                    this.OnPropertyChanged("Products");
                }
            }
        }

        public QueryDescriptor QueryDescriptor
        {
            get
            {
                return this._queryDescriptor;
            }
            set
            {
                if (this._queryDescriptor != value)
                {
                    if (this._queryDescriptor != null)
                        this._queryDescriptor.QueryChanged -=
							new System.EventHandler(OnQueryChanged);

                    this._queryDescriptor = value;
                    this._queryDescriptor.QueryChanged +=
						new System.EventHandler(OnQueryChanged);

                    this.OnPropertyChanged("QueryDescriptor");
                }
            }
        }

        #endregion

        #region Selection and Editing Properties

        public object NewProduct
        {
            get { return this._newProduct; }
            set
            {
                if (this._newProduct != value)
                {
                    this._newProduct = value;
                    this.OnPropertyChanged("NewProduct");
                }
            }
        }      

        public bool IsBusy
        {
            get { return this._isBusy; }
            set
            {
                if (this._isBusy != value)
                {
                    this._isBusy = value;
                    this.OnPropertyChanged("IsBusy");
                }
            }
        }

        public bool IsRefreshed
        {
            get { return this._isRefreshed; }
            set
            {
                if (this._isRefreshed != value)
                {
                    this._isRefreshed = value;
                    this.OnPropertyChanged("IsRefreshed");
                }
            }
        }

        public bool HasChanges
        {
            get { return _hasChanges; }
            set
            {
                if (_hasChanges != value)
                {
                    _hasChanges = value;
                    OnPropertyChanged("HasChanges");
                }
            }
        }

        #endregion

        #region Commands

        public DelegateCommand DeleteRowCommand { get; set; }
        public DelegateCommand InsertRowCommand { get; set; }
        public DelegateCommand PrepareNewRowCommand { get; set; }
        public DelegateCommand UpdateCellCommand { get; set; }
        public DelegateCommand UpdateRowCommand { get; set; }
        public DelegateCommand RejectRowCommand { get; set; }
        public DelegateCommand RejectChangesCommand { get; set; }
        public DelegateCommand SaveChangesCommand { get; set; }
        public DelegateCommand ValidateRowCommand { get; set; }

        #endregion

        #region Methods

        public void SaveChanges()
        {

        }

        public void ExecuteDeleteRow(object parameter)
        {

        }

        public void ExecuteInsertRow(object parameter)
        {

        }

        public void ExecutePrepareNewRow(object parameter)
        {
            
        }

        public void ExecuteUpdateCell(object parameter)
        {
            
        }

        public void ExecuteValidateRow(object parameter)
        {
            
        }

        public void ExecuteUpdateRow(object parameter)
        {
            
        }

        public void ExecuteRejectRow(object parameter)
        {
            
        }

        public void ExecuteRejectChanges(object parameter)
        {
            
        }

        public void ExecuteSaveChanges(object parameter)
        {
            
        }

        public virtual void LoadProducts()
        {
            if (Intersoft.Client.Framework.ISControl.IsInDesignModeStatic)
                return;

            var query = this.Manager.GetProductsQuery().
							OrderBy(p => p.ProductID).Parse(this.QueryDescriptor);
            query.IncludeTotalCount = true;

            this.Manager.Load(
               query,
               op =>
               {
                   if (op.IsComplete)
                   {
                       this.Products = new Intersoft.Client.Data.
											ComponentModel.PagedCollectionView(op.Entities);
                       this.QueryDescriptor.PageDescriptor.TotalItemCount = op.TotalEntityCount;
                   }
                   else
                   {
                       MessageBox.Show(op.Error.ToString());
                   }
               },

               true);
        }

        private void OnQueryChanged(object sender, System.EventArgs e)
        {            
            this.LoadProducts();
        }

        #endregion
    }
}

Code Block

title	View
language	xml

<Intersoft:UXGridView
    AutoGenerateColumns="False" QueryOperation="Server"
    CanUserPage="True" PageSize="20"
    RowHeaderVisibility="Visible"
    IsBusy="{Binding IsBusy, Mode=TwoWay}"
    IsRefreshed="{Binding IsRefreshed, Mode=TwoWay}"
    ItemsSource="{Binding Products}"
    SortDescriptors="{Binding QueryDescriptor.SortDescriptors, Mode=TwoWay}"
    PageDescriptor="{Binding QueryDescriptor.PageDescriptor}"
    GroupFootersVisibility="Visible" GroupByBoxVisibility="Visible"
    CanUserAddRows="True"
    CanUserDeleteRows="True"
    CanUserEditRows="True"
    NewItem="{Binding NewProduct, Mode=TwoWay}"
    ValidateRowCommand="{Binding ValidateRowCommand}"
    InsertRowCommand="{Binding InsertRowCommand}"
    DeleteRowCommand="{Binding DeleteRowCommand}"
    PrepareNewRowCommand="{Binding PrepareNewRowCommand}"
    UpdateCellCommand="{Binding UpdateCellCommand}"
    UpdateRowCommand="{Binding UpdateRowCommand}"
    SaveChangesCommand="{Binding SaveChangesCommand}"
    RejectRowCommand="{Binding RejectRowCommand}"
    RejectChangesCommand="{Binding RejectChangesCommand}"
    HasChanges="{Binding HasChanges}">

    <Intersoft:UXGridView.GroupDescriptors>
        <Intersoft:UXGridViewGroupDescriptor PropertyName="CategoryID"/>
    </Intersoft:UXGridView.GroupDescriptors>

    <Intersoft:UXGridView.Columns>
        <Intersoft:UXGridViewTextColumn Header="Category ID" Binding="{Binding CategoryID}"/>
        <Intersoft:UXGridViewTextColumn Header="Product ID" Binding="{Binding ProductID}"
                                        IsReadOnly="True" Aggregate="Count"
										FooterFormatString="Count = {0}"/>
        <Intersoft:UXGridViewTextColumn Header="Product Name" Binding="{Binding ProductName}"/>
        <Intersoft:UXGridViewTextColumn Header="Units In Stock" Binding="{Binding UnitsInStock}" 
                                        Aggregate="Max" FooterFormatString="Max = {0}"/>
        <Intersoft:UXGridViewTextColumn Header="Unit Price" Binding="{Binding UnitPrice}" 
                                        Aggregate="Avg" FooterFormatString="Avg = {0:n2}"/>
        <Intersoft:UXGridViewTextColumn Header="Units On Order" Binding="{Binding UnitsOnOrder}"
                                        Aggregate="Min" FooterFormatString="Min = {0}"/>
        <Intersoft:UXGridViewTextColumn Header="Quantity Per Unit"
										Binding="{Binding QuantityPerUnit}"/>
    </Intersoft:UXGridView.Columns>
</Intersoft:UXGridView>

Working with EditEnterKeyAction Property, EditKeyGesture Property and EnterKeyAction Property

The keyboard gesture is determined by several properties such as EditKeyGesture, EnterKeyAction and EditEnterKeyAction. Each property has specific action that you can customize. The following list details the action of each property.

EditEnterKeyAction:

CommitAndMovetoNextRow
Commit the changes made in the edited row and move to the next row.
ExitEdit
Exit the editing of the selected cell.
MoveToNextEditableCell
Move to next editable cell. (Will move to next row’s cell when it reach the end of the row).

EditKeyGesture:

F2
Directly begin edit on the currently selected cell using F2 key.
AnyKeystroke
Directly begin edit on the currently selected cell from any key stroke.

EnterKeyAction:

EnterEdit
Directly begin edit on the selected cell using Enter key.
MoveToNextRow
Move to next row (does not edit the cell).

Working with EditMouseGesture Property

The mouse gesture is determined by the EditMouseGesture property. The following options are available to customize the edit mouse gesture.

SingleClick
Directly begin edit on the selected cell.
SecondClick
Begin edit on the selected cell after the row is selected.
DoubleClick
Directly begin edit on the selected cell when double click fires.

Working with EmptyRowsVisibility Property and NewRowPosition Property

The rows of UXGridView are determined by the number of items specified in items source. If the number of items in items source is less than the available screen estate it will show blank white space.

Setting the EmptyRowsVisibility to Visible enables UXGridView to show empty rows in this blank white space area, to give a better look and feel.

When CanUserAddRows is enabled and EmptyRowsVisibility is set to Visible, you can change the new row position to bottom through NewRowPosition property.

Modern note
Note that some features are not compatible when CanUserAddRows is enabled and EmptyRowsVisibility is set to Visible such as paging and grouping.

The following are several ways to enter edit mode when the new row position is set to Bottom:
Press down key on last row.
Press tab key on last column of the last row.
Double click on any empty rows when EnterNewRowOnClick is set to False.
Click on any on any empty rows when EnterNewRowOnClick is set to True.
Working with ExpandedItem Property
When you expand the row details using any of the methods described above, the ExpandedItem property will be set to the data context of the expanded row. You can use this property for more advanced user interaction, such as displaying a hierarchical grid view.
The following code shows how to create hierarchical grid view using row details.
Code Block
title XAML
language xml
<Intersoft:UXGridView AutoGenerateColumns="False" ExpandedItem="{Binding ExpandedItem, Mode=TwoWay}" EnableRowVirtualization="False" ItemsSource="{Binding Employees}"> <Intersoft:UXGridView.Columns> <Intersoft:UXGridViewExpanderColumn/> <Intersoft:UXGridViewTextColumn Header="Employee ID" Binding="{Binding EmployeeID}"/> <Intersoft:UXGridViewTextColumn Header="First Name" Binding="{Binding FirstName}"/> <Intersoft:UXGridViewTextColumn Header="Last Name" Binding="{Binding LastName}"/> <Intersoft:UXGridViewTextColumn Header="Title" Binding="{Binding Title}"/> </Intersoft:UXGridView.Columns> <Intersoft:UXGridView.RowDetailsTemplate> <DataTemplate> <Border Margin="0,1,1,1" Background="#FFF7F7F7" BorderBrush="#FFAFAFAF" BorderThickness="0,1,0,0"> <Grid> <Border BorderBrush="#FFAFAFAF" BorderThickness="1,0,0,1" HorizontalAlignment="Left" Width="20" VerticalAlignment="Top" Height="24" Margin="10,0,0,0"/> <Intersoft:UXGridView ItemsSource="{Binding Orders}" Margin="20,10,12,12" CanUserPage="True" PageSize="5" AutoGenerateColumns="False"> <Intersoft:UXGridView.Columns> <Intersoft:UXGridViewTextColumn Header="Order ID" Binding="{Binding OrderID}"/> <Intersoft:UXGridViewTextColumn Header="Order Date" Binding="{Binding OrderDate}"/> <Intersoft:UXGridViewTextColumn Header="Required Date" Binding="{Binding RequiredDate}"/> <Intersoft:UXGridViewTextColumn Header="Shipped Date" Binding="{Binding ShippedDate}"/> </Intersoft:UXGridView.Columns> </Intersoft:UXGridView> </Grid> </Border> </DataTemplate> </Intersoft:UXGridView.RowDetailsTemplate> </Intersoft:UXGridView>
The above code shows how to define the row details to create hierarchical grid view and bind the ExpandedItem property to the ViewModel. In the ViewModel, you write a custom logic to load the child data whenever the ExpandedItem property is set.
Code Block
title CS
language c#
public object ExpandedItem { get { return this._expandedItem; } set { if (this._expandedItem != value) { this._expandedItem = value; this.OnPropertyChanged("ExpandedItem"); // this.LoadOrders(value); } } }
Working with ExportCommand Property and ExportItems Property
By default, the exporting processes only the data available in the client. Therefore if you enable server paging, you might not be able to export the complete data correctly. To address this challenge, you can implement the ExportCommand in the ViewModel and provide the desired data to the ExportItems property.
The following code shows you how to bind ExportItems and ExportCommand in the ViewModel and supply the data to export.
Code Block
title View Model
language c#
using System.Collections; using System.ServiceModel.DomainServices.Client; using System.Windows; using HowToSamples.Web; using Intersoft.Client.Data.ComponentModel; using Intersoft.Client.Data.Provider.Ria; using Intersoft.Client.Framework.Input; namespace HowToSamples.ViewModels { public class ExportingViewModel: ViewModelBase { public ExportingViewModel() { this.Manager = new NorthwindDomainContext(); this.CanUserExport = true; this.QueryDescriptor = new QueryDescriptor(); this.ExportCommand = new DelegateCommand(ExecuteExportCommand); } private bool _canUserExport; private IEnumerable _exportItems; private IEnumerable _products; private QueryDescriptor _queryDescriptor; private NorthwindDomainContext Manager { get; set; } public bool CanUserExport { get { return this._canUserExport; } set { if (this._canUserExport != value) { this._canUserExport = value; this.OnPropertyChanged("CanUserExport"); } } } public DelegateCommand ExportCommand { get; set; } public IEnumerable ExportItems { get { return this._exportItems; } set { if (this._exportItems != value) { this._exportItems = value; this.OnPropertyChanged("ExportItems"); } } } public IEnumerable Products { get { return this._products; } set { if (this._products != value) { this._products = value; this.OnPropertyChanged("Products"); } } } public QueryDescriptor QueryDescriptor { get { return this._queryDescriptor; } set { if (this._queryDescriptor != value) { if (this._queryDescriptor != null) this._queryDescriptor.QueryChanged -= new System.EventHandler(OnQueryChanged); this._queryDescriptor = value; this._queryDescriptor.QueryChanged += new System.EventHandler(OnQueryChanged); this.OnPropertyChanged("QueryDescriptor"); } } } public void ExecuteExportCommand(object parameter) { Intersoft.Client.Data.ComponentModel.QueryDescriptor queryDescriptor = this.QueryDescriptor.CreateCopy(true, true, false); // copy the query descriptor, but exclude the page descriptor var query = this.Manager.GetProductsQuery(). OrderBy(p => p.ProductID).Parse(queryDescriptor); this.Manager.Load( query, op => { if (op.IsComplete) { Intersoft.Client.Data.ComponentModel.PagedCollectionView current = this.Products as Intersoft.Client.Data. ComponentModel.PagedCollectionView; Intersoft.Client.Data.ComponentModel.PagedCollectionView exportedItems = new Intersoft.Client.Data. ComponentModel.PagedCollectionView(op.Entities); exportedItems.CopyDefinitionsFrom(current, true, false, false, false); this.ExportItems = exportedItems; // supply the export process with correct collection. } else { MessageBox.Show(op.Error.ToString()); } }, true); } public virtual void LoadProducts() { if (Intersoft.Client.Framework.ISControl.IsInDesignModeStatic) return; var query = this.Manager.GetProductsQuery(). OrderBy(p => p.ProductID).Parse(this.QueryDescriptor); query.IncludeTotalCount = true; this.Manager.Load( query, op => { if (op.IsComplete) { this.Products = new Intersoft.Client.Data. ComponentModel.PagedCollectionView(op.Entities); this.QueryDescriptor.PageDescriptor.TotalItemCount = op.TotalEntityCount; } else { MessageBox.Show(op.Error.ToString()); } }, true); } private void OnQueryChanged(object sender, System.EventArgs e) { this.LoadProducts(); } } }
Code Block
title View
language xml
<UserControl x:Class="HowToSamples.Exporting" xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" xmlns:d="http://schemas.microsoft.com/expression/blend/2008" xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" xmlns:Intersoft="http://intersoft.clientui.com/schemas" xmlns:ViewModels="clr-namespace:HowToSamples.ViewModels" mc:Ignorable="d" d:DesignHeight="300" d:DesignWidth="400"> <Grid x:Name="LayoutRoot" Background="White"> <Grid.DataContext> <ViewModels:ExportingViewModel/> </Grid.DataContext> <Intersoft:UXGridView AutoGenerateColumns="False" QueryOperation="Server" CanUserPage="True" PageSize="20" ItemsSource="{Binding Products}" SortDescriptors="{Binding QueryDescriptor. SortDescriptors, Mode=TwoWay}" PageDescriptor="{Binding QueryDescriptor.PageDescriptor}" CanUserExport="{Binding CanUserExport}" ExportCommand="{Binding ExportCommand}" ExportItems="{Binding ExportItems}"> <Intersoft:UXGridView.GroupDescriptors> <Intersoft:UXGridViewGroupDescriptor PropertyName="CategoryID"/> </Intersoft:UXGridView.GroupDescriptors> <Intersoft:UXGridView.Columns> <Intersoft:UXGridViewTextColumn Header="Category ID" Binding="{Binding CategoryID}"/> <Intersoft:UXGridViewTextColumn Header="Product ID" Binding="{Binding ProductID}" Aggregate="Count" FooterFormatString="Count = {0}"/> <Intersoft:UXGridViewTextColumn Header="Product Name" Binding="{Binding ProductName}"/> <Intersoft:UXGridViewTextColumn Header="Units In Stock" Binding="{Binding UnitsInStock}" Aggregate="Max" FooterFormatString="Max = {0}"/> <Intersoft:UXGridViewTextColumn Header="Unit Price" Binding="{Binding UnitPrice}" Aggregate="Avg" FooterFormatString="Avg = {0:n2}"/> <Intersoft:UXGridViewTextColumn Header="Units On Order" Binding="{Binding UnitsOnOrder}" Aggregate="Min" FooterFormatString="Min = {0}"/> <Intersoft:UXGridViewTextColumn Header="Quantity Per Unit" Binding="{Binding QuantityPerUnit}"/> </Intersoft:UXGridView.Columns> </Intersoft:UXGridView> </Grid> </UserControl>
Working with FrozenColumnCount Property
Code Block
title XAML
language xml
<Intersoft:UXGridView ItemsSource="{Binding Products}" FrozenColumnCount="2"/>
Working with GroupByBoxVisibility Property
Alternatively, you can also drag the header of a column to the group box. The group box's visibility can also be toggled from the column's context menu. It can be displayed initially by setting the GroupByBoxVisibility to Visible.
Working with GroupDescriptors Property
Code Block
title XAML
language xml
<Intersoft:UXGridView AutoGenerateColumns="False" ItemsSource="{Binding Products}"> <Intersoft:UXGridView.GroupDescriptors> <Intersoft:UXGridViewGroupDescriptor PropertyName="CategoryID" SortDirection="Descending"/ </Intersoft:UXGridView.GroupDescriptors> </Intersoft:UXGridView>
Working with GroupFootersVisibility Property
Code Block
title XAML
language xml
<Intersoft:UXGridView GroupFooterVisibility="Visible" GroupByBoxVisibility="Visible" CanUserGroupColumns="True" ItemsSource="{Binding Products}" > <Intersoft:UXGridView.Columns> <Intersoft:UXGridViewTextColumn Header="Category ID" Binding="{Binding CategoryID}"/> <Intersoft:UXGridViewTextColumn Header="Product ID" Binding="{Binding ProductID}" Aggregate="Count" FooterFormatString="Count = {0}"/> <Intersoft:UXGridViewTextColumn Header="Product Name" Binding="{Binding ProductName}"/> <Intersoft:UXGridViewTextColumn Header="Units In Stock" Binding="{Binding UnitsInStock}" Aggregate="Max" FooterFormatString="Max = {0}"/> <Intersoft:UXGridViewTextColumn Header="Unit Price" Binding="{Binding UnitPrice}" Aggregate="Avg" FooterFormatString="Avg = {0:n2}"/> <Intersoft:UXGridViewTextColumn Header="Units On Order" Binding="{Binding UnitsOnOrder}" Aggregate="Min" FooterFormatString="Min = {0}"/> <Intersoft:UXGridViewTextColumn Header="Quantity Per Unit" Binding="{Binding QuantityPerUnit}"/> </Intersoft:UXGridView.Columns> </Intersoft:UXGridView>
You can also set multiple values on the Aggregate property such as shown in the following example.
Code Block
title XAML
language xml
<Intersoft:UXGridViewTextColumn Header="Unit Price" Binding="{Binding UnitPrice}" Aggregate="Avg,Max,Min" FooterFormatString="Avg = {0} | Max = {0} | Min = {0}"/>
Working with IsReadOnlyBinding Property
The following code shows how to implement the IsReadOnlyBinding to achieve the above scenario.
Code Block
title XAML
language xml
<Intersoft:UXGridView IsReadOnlyBinding="{Binding Discontinued}"> <Intersoft:UXGridView.Columns> <Intersoft:UXGridViewCheckBoxColumn Header="Discontinued" Binding="{Binding Discontinued}"/> <Intersoft:UXGridViewTextColumn Header="Category ID" Binding="{Binding CategoryID}" IsReadOnlyBinding="{Binding Discontinued}"/> <Intersoft:UXGridViewTextColumn Header="Product ID" Binding="{Binding ProductID}" IsReadOnly="True" Aggregate="Count" FooterFormatString="Count = {0}"/> <Intersoft:UXGridViewTextColumn Header="Product Name" Binding="{Binding ProductName}"/> </Intersoft:UXGridView.Columns> </Intersoft:UXGridView>
Working with ScrollIndicatorBinding Property
The following code shows how to use the ScrollIndicatorBinding to customize the data display in the scroll indicator element.
Code Block
title XAML
language xml
<Intersoft:UXGridView ItemsSource="{Binding Products}" HorizontalScrollMode="Deferred" VerticalScrollMode="Deferred" ScrollIndicatorBinding="{Binding ProductName}"> <Intersoft:UXGridView.Columns> <Intersoft:UXGridViewTextColumn Header="Category ID" Binding="{Binding CategoryID}"/> <Intersoft:UXGridViewTextColumn Header="Product ID" Binding="{Binding ProductID}"/> <Intersoft:UXGridViewTextColumn Header="Product Name" Binding="{Binding ProductName}"/> <Intersoft:UXGridViewTextColumn Header="Unit Price" Binding="{Binding UnitPrice}"/> <Intersoft:UXGridViewTextColumn Header="Units In Stock" Binding="{Binding UnitsInStock}"/> <Intersoft:UXGridViewTextColumn Header="Units On Order" Binding="{Binding UnitsOnOrder}"/> <Intersoft:UXGridViewTextColumn Header="Quantity Per Unit" Binding="{Binding QuantityPerUnit}"/> </Intersoft:UXGridView.Columns> </Intersoft:UXGridView>
Working with SelectedItem Property, SelectedItems Property, SelectionMode Property and SelectionUnit Property
UXGridView has three type of SelectionMode that you can choose from.
Single
Only one item can be selected.
Multiple
Allow multiple item to be selected.
Extended
Allow multiple item to be selected. You need to hold Shift and / or Ctrl modifier to perform the multiple selection.
When a row is selected, the SelectedItem and SelectedItems property will be automatically synchronized. You can bind these properties to your ViewModel to capture the currently selected items.
Furthermore, you can also customize the SelectionUnit to one of the possible three values: Row, Cell or RowAndCell.
Working with SortDescriptions Property
The following example shows how to implement predefined sorting with client data operation.
Code Block
title XAML
language xml
xmlns:Intersoft="http://intersoft.clientui.com/schemas" xmlns:ComponentModel="clr-namespace:System.ComponentModel;assembly=System.Windows" <Intersoft:UXGridView AutoGenerateColumns="False" ItemsSource="{Binding Products}"> <Intersoft:UXGridView.SortDescriptions> <ComponentModel:SortDescription PropertyName="ProductName" Direction="Ascending"/> </Intersoft:UXGridView.SortDescriptions> </Intersoft:UXGridView>

...

The following table summarizes the members exposed in this class.

Public Constructors

UXGridView Constructor()

Initializes a new instance of UXGridView class.

Public Properties

AlternatingRowBackground	Gets or sets the Brush that is used to paint the background of odd-numbered rows.
AreRowDetailsFrozen	Gets or sets a value that indicates whether the row details sections remain fixed at the width of the display area or can scroll horizontally.
AreRowGroupHeadersFrozen	Gets or sets a value that indicates whether the row group header sections remain fixed at the width of the display area or can scroll horizontally.
AutoEditOperation	Gets or sets a value that indicates whether UXGridView should try perform IEditableCollectionView.CommitEdit or IEditableObject.EndEdit after each data editing operation.
AutoFocusOnError	Gets or sets a value that indicates whether UXGridView should auto focus on cell when there is validation error.
AutoGenerateColumns	Gets or sets a value that indicates whether columns are created automatically when the ItemsSource property is set.
BusyLatency	Gets or sets the latency, in seconds, before the busy indicator is displayed when IsBusy is set to true.
BusyOverlayBackground	Gets or sets the brush to apply to the overlay background.
CanUserAddRows	Gets or sets a value that indicates whether the user can add new rows.
CanUserBatchUpdate	Gets or sets a value that indicates whether the UXGridView can perform batch update.
CanUserDeleteRows	Gets or sets a value that indicates whether the user can delete rows.
CanUserEditRows	Gets or sets a value that indicates whether the user can edit rows.
CanUserExport	Gets or sets a value that indicates whether the user can export data.
CanUserFilterColumns	Gets or sets a value that indicates whether the user can filter data based on columns.
CanUserGroupColumns	Gets or sets a value that indicates whether the user can group columns
CanUserPage	Gets or sets a value that indicates whether the user can paging the data.
CanUserReorderColumns	Gets or sets a value that indicates whether the user can change the column display order by dragging column headers with the mouse.
CanUserResizeColumns	Gets or sets a value that indicates whether the user can adjust column widths using the mouse.
CanUserSortColumns	Gets or sets a value that indicates whether the user can sort columns by clicking the column header.
CellBusyTemplate	Gets or sets the template selector that is used to display the busy indicator for cell.
CellEditingTemplateSelector	Gets or sets the template selector that is used to display the contents of a cell that is in editing mode.
CellStyle	Gets or sets the style that is used when rendering the gridview cells.
CellStyleSelector	Gets or sets the style selector that is used when rendering the gridview cells.
CellTemplateSelector	Gets or sets the template selector that is used when rendering the gridview cells.
CheckedItems	Gets or sets the checked items.
ClipboardCopyMode	Gets or sets a value that indicates how data is copied to the clipboard.
ColumnFooterCellStyle	Gets or sets the style that is used when rendering the gridview column footer cell.
ColumnFooterCellStyleSelector	Gets or sets the style selector that is used when rendering the gridview column footer cell.
ColumnFooterStyle	Gets or sets the style that is used when rendering the gridview column footer.
ColumnFooterVisibility	Gets or sets a value that determines whether the column footer is visible.
ColumnHeaderHeight	Gets or sets the height of the column headers row.
ColumnHeaderStyle	Gets or sets the style that is used when rendering the column headers.
ColumnHeaderStyleSelector	Gets or sets the style selector that is used when rendering the column headers.
ColumnHeaderTemplateSelector	Gets or sets the template selector that is used when rendering the column headers.
ColumnHeaderVisibility	Gets or sets a value that determines whether the column header is visible.
Columns	Gets a collection that contains all the columns in the control.
ColumnWidth	Gets or sets the standard width or automatic sizing mode of columns in the control.
ContextMenuStyle	Gets or sets the style that is used when rendering the context menu element.
CornerRadius	Represents the radius of a border's corner. The radius can't be negative.
CurrentColumn	Gets or sets the column that contains the current cell.
DeleteRowCommand	Gets or sets command that will be invoked when deleting a row.
DoubleClickCommand	Gets or sets the command that will be invoked when validating a row.
DragIndicatorStyle	Gets or sets the style that is used when rendering the drag indicator that is displayed while dragging column headers.
DropLocationIndicatorStyle	Gets or sets the style that is used when rendering the column headers.
EditEnterKeyAction	Gets or sets a value that determines the action when enter key is pressed during editing mode.
EditKeyGesture	Gets or sets a value that determines the key gesture used to enter the editing mode.
EditMouseGesture	Gets or sets a value that determines the mouse gesture used to enter the editing mode.
EmptyRowsVisibility	Gets or sets a value that determines the visibility of empty rows.
EnableContextMenu	Gets or sets a value that determines whether context menus is enabled.
EnableRowVirtualization	Gets or sets a value that determines whether row virtualization is enabled.
EnterKeyAction	Gets or sets a value that determines the action when enter key is pressed.
EnterNewRowOnClick	Gets or sets the a value that determine whether UXGridView will enter edit on new empty row on single click.
ErrorStatusVisibility	Gets or sets a value that determines whether the error status is visible.
ExpandedItem	Gets or sets the expanded item.
ExportCommand	Gets or sets command that will be invoked when exporting data.
ExportCssStyleSelector	Gets or sets the css style selector using for HTML exporting.
ExportItems	Gets or sets the items to be exported.
ExportOptions	Gets or sets the export options.
FilterDescriptors	Gets or sets the descriptor object that encapsulates the filtering related information.
FrozenColumnCount	Gets or sets the number of columns that the user cannot scroll horizontally.
GridLinesVisibility	Gets or sets a value that indicates which grid lines separating inner cells are shown.
GroupByBoxStyle	Gets or sets the style that is used when rendering the group by box element.
GroupByBoxVisibility	Gets or sets a value that determines whether the group by box is visible.
GroupDescriptors	Gets collection of group descriptors.
GroupFootersVisibility	Gets or sets a value that determines whether the group footer is visible.
HasChanges	Gets or sets a value that indicates whether there are data changes or not.
HeaderAndRowSeparatorBrush	Gets or sets the Brush that is used to paint lines separating rows and column header.
HorizontalGridLinesBrush	Gets or sets the Brush that is used to paint grid lines separating rows.
HorizontalScrollBarVisibility	Gets or sets a value that indicates how the horizontal scroll bar is displayed.
HorizontalScrollMode	Gets or sets a value that determine the horizontal scroll mode.
InsertRowCommand	Gets or sets command that will be invoked when inserting row.
IsBusy	Gets or sets a value that indicates whether the control is busy.
IsInsertingNewRow	Gets or sets a value that indicates whether the UXGridView new row is activated.
IsReadOnlyBinding	Gets or sets the binding that associates the IsReadOnly attribute with a property in the data source.
IsRefreshed	Gets or sets a value that indicates whether the UXGridView is refreshed.
IsRowDirtyBinding	Gets or sets the binding that associates the IsReadOnly attribute with a property in the data source.
IsValid	Gets a value that indicates whether data in the grid is valid.
ItemsSource	Gets or sets a collection that is used to generate the content of the control.
LostFocusAction	Gets or sets a value that determine the lost focus action when user lost focus during row editing.
MaxColumnWidth	Gets or sets the maximum width of columns in the UXGridView.
MinColumnWidth	Gets or sets the minimum width of columns in the UXGridView.
NewItem	Gets or sets the new item to be added.
NewRowLostFocusAction	Gets or sets a value that determine the lost focus action when user lost focus during new row editing.
NewRowPosition	Gets or sets a value that determine the position of new row.
NoDataTemplate	Gets or sets the no data template.
PageDescriptor	Gets or sets the descriptor object that encapsulates the paging related information.
PagerAutoEllipsis	Gets or sets a value that indicates whether to use an ellipsis as the last numeric button of UXDataPager.
PagerDisplayMode	Gets or sets a value that indicates how the UXDataPager user interface is displayed.
PagerNumericButtonCount	Gets or sets a value that indicates the number of page buttons shown on the UXDataPager user interface.
PagerStyle	Gets or sets the style that is used when rendering the UXDataPager.
PageSize	Gets or sets a value that indicates the number of items displayed on a page.
PrepareNewRowCommand	Gets or sets command that will be invoked when preparing new row.
QueryOperation	Gets or sets a value that determines whether the filtering operation should be performed in client-side or server-side.
RefreshCommand	Gets or sets command that will be invoked when refreshing data.
RefreshCommandParameter	Gets or sets the parameter to pass to the RefreshCommand property.
RejectChangesCommand	Gets or sets command that will be invoked when data changes is rejected.
RejectRowCommand	Gets or sets command that will be invoked when row changes is rejected.
ResourceOverride	Gets or sets the individual resource object to override the existing localized resource.
RowBackground	Gets or sets the Brush that is used to paint row backgrounds.
RowDetailsTemplate	Gets or sets the template that is used to display the content of the details section of rows.
RowDetailsTemplateSelector	Gets or sets the template selector that is used to display the content of the details section of rows.
RowDetailsVisibilityMode	Gets or sets a value that indicates when the details sections of rows are displayed.
RowGroupFooterCellStyle	Gets or sets the style that is used when rendering the row group footer cell.
RowGroupFooterCellStyleSelector	Gets or sets the style selector that is used when rendering the row group footer cell.
RowGroupFooterStyle	Gets or sets the style that is used when rendering the row group footer.
RowGroupFooterStyleSelector	Gets or sets the style selector that is used when rendering the row group footer.
RowGroupHeaderStyle	Gets or sets the style that is used when rendering the row group header.
RowGroupHeaderStyleSelector	Gets or sets the style selector that is used when rendering the row group header.
RowGroupHeaderTemplateSelector	Gets or sets the template selector that is used when rendering the row group headers.
RowHeaderStyle	Gets or sets the style that is used when rendering the row header.
RowHeaderVisibility	Gets or sets a value that determines whether the row header is visible.
RowHeaderWidth	Gets or sets the width of the row header column.
RowHeight	Gets or sets the standard height of rows in the control.
RowStyle	Gets or sets the style that is used when rendering the rows.
RowStyleSelector	Gets or sets the style selector that is used when rendering the rows.
RowTemplate	Gets or sets the template that is used when rendering the rows.
RowTemplateSelector	Gets or sets the template selector that is used when rendering the rows.
SaveChangesCommand	Gets or sets command that will be invoked when data changes is accepted.
ScrollBarStyle	Gets or sets the style that is used when rendering the scrollbar.
ScrollCornerBackground	Gets or sets the Brush that is used to paint scroll corner element.
ScrollIndicatorBinding	Gets or sets the binding that associates the scroll indicator with property in the data source.
ScrollIndicatorStyle	Gets or sets the style that is used when rendering the scroll indicator.
ScrollIndicatorTemplate	Gets or sets the template that is used when rendering the scroll indicator.
SelectedIndex	Gets or sets the index of the current selection.
SelectedItem	Gets or sets the data item corresponding to the selected row.
SelectedItems	Gets a list that contains the data items corresponding to the selected rows.
SelectionMode	Gets or sets the selection behavior of the gridview.
SelectionUnit	Gets or sets the selection unit of gridview.
SortDescriptions	Gets or sets the sort descriptions object that encapsulates the sorting related information.
SortDescriptors	Gets or sets the descriptor object that encapsulates the sorting related information.
StatusBarCommandTemplate	Gets or sets the data template to apply to the StatusBarCommand.
StatusBarStyle	Gets or sets the style that is used when rendering the statusbar.
StatusBarVisibility	Gets or sets a value that determines whether the status bar is visible.
UpdateCellCommand	Gets or sets command that will be invoked when updating a cell.
UpdateRowCommand	Gets or sets command that will be invoked when updating a row.
ValidateRowCommand	Gets or sets the command that will be invoked when validating a row.
ValidationResults	Gets or sets the validation results.
VerticalGridLinesBrush	Gets or sets the Brush that is used to paint grid lines separating columns.
VerticalScrollBarVisibility	Gets or sets a value that indicates how the vertical scroll bar is displayed.
VerticalScrollMode	Gets or sets a value that indicates the vertical scroll mode.

Protected Properties

CurrentItem	Gets the data item bound to the row that contains the current cell.
Product	Product Info.

Fields

AlternatingRowBackgroundProperty	Identifies the AlternatingRowBackground dependency property.
AreRowDetailsFrozenProperty	Identifies the AreRowDetailsFrozen dependency property.
AreRowGroupHeadersFrozenProperty	Identifies the AreRowGroupHeadersFrozen dependency property.
AutoEditOperationProperty	Identifies the AutoEditOperation dependency property.
AutoFocusOnErrorProperty	Identifies the AutoFocusOnError dependency property.
AutoGenerateColumnsProperty	Identifies the AutoGenerateColumns dependency property.
BusyLatencyProperty	Identifies the BusyLatency dependency property.
BusyOverlayBackgroundProperty	Identifies the BusyOverlayBackground dependency property.
CanUserAddRowsProperty	Identifies the CanUserAddRows dependency property.
CanUserBatchUpdateProperty	Identifies the CanUserBatchUpdate dependency property.
CanUserDeleteRowsProperty	Identifies the CanUserDeleteRows dependency property.
CanUserEditRowsProperty	Identifies the CanUserEditRows dependency property.
CanUserExportProperty	Identifies the CanUserExport dependency property.
CanUserFilterColumnsProperty	Identifies the CanUserFilterColumns dependency property.
CanUserGroupColumnsProperty	Identifies the CanUserGroupColumns dependency property.
CanUserPageProperty	Identifies the CanUserPage dependency property.
CanUserReorderColumnsProperty	Identifies the CanUserReorderColumns dependency property.
CanUserResizeColumnsProperty	Identifies the CanUserResizeColumns dependency property.
CanUserSortColumnsProperty	Identifies the CanUserSortColumns dependency property.
CellBusyTemplateProperty	Identifies the CellBusyTemplate dependency property.
CellEditingTemplateSelectorProperty	Identifies the CellEditingTemplateSelector dependency property.
CellStyleProperty	Identifies the CellStyle dependency property.
CellStyleSelectorProperty	Identifies the CellStyleSelector dependency property.
CellTemplateSelectorProperty	Identifies the CellTemplateSelector dependency property.
CheckedItemsProperty	Identifies the CheckedItems dependency property.
ClipboardCopyModeProperty	Identifies the ClipboardCopyMode dependency property.
ColumnFooterCellStyleProperty	Identifies the ColumnFooterCellStyle dependency property.
ColumnFooterCellStyleSelectorProperty	Identifies the ColumnFooterCellStyleSelector dependency property.
ColumnFooterStyleProperty	Identifies the ColumnFooterStyle dependency property.
ColumnFooterVisibilityProperty	Identifies the ColumnFooterVisibility dependency property.
ColumnHeaderHeightProperty	Identifies the ColumnHeaderHeight dependency property.
ColumnHeaderStyleProperty	Identifies the ColumnHeaderStyle dependency property.
ColumnHeaderStyleSelectorProperty	Identifies the ColumnHeaderStyleSelector dependency property.
ColumnHeaderTemplateSelectorProperty	Identifies the ColumnHeaderTemplateSelector dependency property.
ColumnHeaderVisibilityProperty	Identifies the ColumnHeaderVisibility dependency property.
ColumnsProperty	Identifies the Columns dependency property.
ColumnWidthProperty	Identifies the ColumnWidth dependency property.
ContextMenuStyleProperty	Identifies the ContextMenuStyle dependency property.
CornerRadiusProperty	Identifies the CornerRadius dependency property.
DeleteRowCommandProperty	Identifies the DeleteRowCommand dependency property.
DoubleClickCommandProperty	Identifies the DoubleClickCommand dependency property.
DragIndicatorStyleProperty	Identifies the DragIndicatorStyle dependency property.
DropLocationIndicatorStyleProperty	Identifies the DropLocationIndicatorStyle dependency property.
EditEnterKeyActionProperty	Identifies the EditEnterKeyAction dependency property.
EditKeyGestureProperty	Identifies the EditKeyGesture dependency property.
EditMouseGestureProperty	Identifies the EditMouseGesture dependency property.
EmptyRowsVisibilityProperty	Identifies the EmptyRowsVisibility dependency property.
EnableContextMenuProperty	Identifies the EnableContextMenu dependency property.
EnableRowVirtualizationProperty	Identifies the EnableRowVirtualization dependency property.
EnterKeyActionProperty	Identifies the EnterKeyAction dependency property.
EnterNewRowOnClickProperty	Identifies the EnterNewRowOnClick dependency property.
ErrorStatusVisibilityProperty	Identifies the ErrorStatusVisibility dependency property.
ExpandedItemProperty	Identifies the ExpandedItem dependency property.
ExportCommandProperty	Identifies the ExportCommand dependency property.
ExportCssStyleSelectorProperty	Identifies the ExportCssStyleSelector dependency property.
ExportItemsProperty	Identifies the ExportItems dependency property.
ExportOptionsProperty	Identifies the ExportOptions dependency property.
FilterDescriptorsProperty	Identifies the FilterDescriptors dependency property.
FrozenColumnCountProperty	Identifies the FrozenColumnCount dependency property.
GridLinesVisibilityProperty	Identifies the GridLinesVisibility dependency property.
GroupByBoxStyleProperty	Identifies the GroupByBoxStyle dependency property.
GroupByBoxVisibilityProperty	Identifies the GroupByBoxVisibility dependency property.
GroupFootersVisibilityProperty	Identifies the GroupFootersVisibility dependency property.
HasChangesProperty	Identifies the HasChanges dependency property.
HeaderAndRowSeparatorBrushProperty	Identifies the HeaderAndRowSeparatorBrush dependency property.
HorizontalGridLinesBrushProperty	Identifies the HorizontalGridLinesBrush dependency property.
HorizontalScrollBarVisibilityProperty	Identifies the HorizontalScrollBarVisibility dependency property.
HorizontalScrollModeProperty	Identifies the HorizontalScrollMode dependency property.
InsertRowCommandProperty	Identifies the InsertRowCommand dependency property.
IsBusyProperty	Identifies the IsBusy dependency property.
IsInsertingNewRowProperty	Identifies the IsInsertingNewRow dependency property.
IsRefreshedProperty	Identifies the IsRefreshed dependency property.
IsValidProperty	Identifies the IsValid dependency property.
ItemsSourceProperty	Identifies the ItemsSource dependency property.
LostFocusActionProperty	Identifies the LostFocusAction dependency property.
MaxColumnWidthProperty	Identifies the MaxColumnWidth dependency property.
MinColumnWidthProperty	Identifies the MinColumnWidth dependency property.
NewItemProperty	Identifies the NewItem dependency property.
NewRowLostFocusActionProperty	Identifies the NewRowLostFocusAction dependency property.
NewRowPositionProperty	Identifies the NewRowPosition dependency property.
NoDataTemplateProperty	Identifies the NoDataTemplate dependency property.
PageDescriptorProperty	Identifies the QueryDescriptor dependency property.
PagerAutoEllipsisProperty	Identifies the PagerAutoEllipsis dependency property.
PagerDisplayModeProperty	Identifies the PagerDisplayMode dependency property.
PagerNumericButtonCountProperty	Identifies the PagerNumericButtonCount dependency property.
PagerStyleProperty	Identifies the PagerStyle dependency property.
PageSizeProperty	Identifies the PageSize dependency property.
PrepareNewRowCommandProperty	Identifies the PrepareNewRowCommand dependency property.
QueryOperationProperty	Identifies the QueryOperation dependency property.
RefreshCommandParameterProperty	Identifies the RefreshCommandParameter dependency property.
RefreshCommandProperty	Identifies the RefreshCommand dependency property.
RejectChangesCommandProperty	Identifies the RejectChangesCommand dependency property.
RejectRowCommandProperty	Identifies the RejectRowCommand dependency property.
ResourceOverrideProperty	Identifies the ResourceOverride dependency property.
RowBackgroundProperty	Identifies the RowBackground dependency property.
RowDetailsTemplateProperty	Identifies the RowDetailsTemplate dependency property.
RowDetailsTemplateSelectorProperty	Identifies the RowDetailsTemplateSelector dependency property.
RowDetailsVisibilityModeProperty	Identifies the RowDetailsVisibilityMode dependency property.
RowGroupFooterCellStyleProperty	Identifies the RowGroupFooterCellStyle dependency property.
RowGroupFooterCellStyleSelectorProperty	Identifies the RowGroupFooterCellStyleSelector dependency property.
RowGroupFooterStyleProperty	Identifies the RowGroupFooterStyle dependency property.
RowGroupFooterStyleSelectorProperty	Identifies the RowGroupFooterStyleSelector dependency property.
RowGroupHeaderStyleProperty	Identifies the RowGroupHeaderStyle dependency property.
RowGroupHeaderStyleSelectorProperty	Identifies the RowGroupHeaderStyleSelector dependency property.
RowGroupHeaderTemplateSelectorProperty	Identifies the RowGroupHeaderTemplateSelector dependency property.
RowHeaderStyleProperty	Identifies the RowHeaderStyle dependency property.
RowHeaderVisibilityProperty	Identifies the RowHeaderVisibility dependency property.
RowHeaderWidthProperty	Identifies the RowHeaderWidth dependency property.
RowHeightProperty	Identifies the RowHeight dependency property.
RowStyleProperty	Identifies the RowStyle dependency property.
RowStyleSelectorProperty	Identifies the RowStyleSelector dependency property.
RowTemplateProperty	Identifies the RowTemplate dependency property.
RowTemplateSelectorProperty	Identifies the RowTemplateSelector dependency property.
SaveChangesCommandProperty	Identifies the SaveChangesCommand dependency property.
ScrollBarStyleProperty	Identifies the ScrollBarStyle dependency property.
ScrollCornerBackgroundProperty	Identifies the ScrollCornerBackground dependency property.
ScrollIndicatorStyleProperty	Identifies the ScrollIndicatorStyle dependency property.
ScrollIndicatorTemplateProperty	Identifies the ScrollIndicatorTemplate dependency property.
SelectedIndexProperty	Identifies the SelectedIndex dependency property.
SelectedItemProperty	Identifies the SelectedItem dependency property.
SelectedItemsProperty	Identifies the SelectedItems dependency property.
SelectionModeProperty	Identifies the SelectionMode dependency property.
SelectionUnitProperty	Identifies the SelectionUnit dependency property.
SortDescriptorsProperty	Identifies the SortDescriptors dependency property.
StatusBarCommandTemplateProperty	Identifies the StatusBarCommandTemplate dependency property.
StatusBarStyleProperty	Identifies the StatusBarStyle dependency property.
StatusBarVisibilityProperty	Identifies the StatusBarVisibility dependency property.
UpdateCellCommandProperty	Identifies the UpdateCellCommand dependency property.
UpdateRowCommandProperty	Identifies the UpdateRowCommand dependency property.
ValidateRowCommandProperty	Identifies the ValidateRowCommand dependency property.
ValidationResultsProperty	Identifies the ValidationResults dependency property.
VerticalGridLinesBrushProperty	Identifies the VerticalGridLinesBrush dependency property.
VerticalScrollBarVisibilityProperty	Identifies the VerticalScrollBarVisibility dependency property.
VerticalScrollModeProperty	Identifies the VerticalScrollMode dependency property.

Public Methods

AttachEventHandlers()	Attach built-in event handlers to control templates. Call this method if necessary.
BeginEdit()	Causes the gridview to enter editing mode for the current cell and current row, unless the gridview is already in editing mode.
BeginEdit(RoutedEventArgs)	Causes the gridview to enter editing mode for the current cell and current row in the specified keyboard and mouse state.
CancelEdit()	Causes the gridview to cancel the current edit, restore the original value, and exit editing mode.
CancelEdit(EditingUnit)	Causes the gridview to cancel the current edit, restore the original value, and exit editing mode.
CollapseRowGroup(CollectionViewGroup, bool)	Collapses gridview row groups.
CommitEdit()	Causes the gridview to commit the current edit to the data source and exit editing mode.
CommitEdit(EditingUnit, bool)	Causes the gridview to commit the current edit to the data source, and optionally exit editing mode.
DetachedEventHandlers()	Detach built-in event handlers from control templates. Call this method if necessary.
Dispose()	Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
ExpandRowGroup(CollectionViewGroup, bool)	Expands gridview row groups.
Export(Stream, UXGridViewExportOptions)	Export data to the specified stream.
InitializeTemplates()	Initializes control templates.
OnApplyTemplate()	Builds the visual tree for the UXGridView when a new template is applied.
ScrollIntoView(object, UXGridViewColumn)	Scrolls the UXGridView vertically to display the row for the specified data item and scrolls the UXGridView horizontally to display the specified column.

Protected Methods

ArrangeOverride(Size)	Provides the behavior for the Arrange pass of Silverlight layout.
MeasureOverride(Size)	Provides the behavior for the Measure pass of Silverlight layout.
OnAutoGeneratingColumn(UXGridViewAutoGeneratingColumnEventArgs)	Raises the AutoGeneratingColumn event.
OnBeginningEdit(UXGridViewBeginningEditEventArgs)	Raises the BeginningEdit event.
OnCellEditEnded(UXGridViewCellEditEndedEventArgs)	Raises the CellEditEnded event.
OnCellEditEnding(UXGridViewCellEditEndingEventArgs)	Raises the CellEditEnding event.
OnColumnDisplayIndexChanged(UXGridViewColumnEventArgs)	Raises the ColumnDisplayIndexChanged event.
OnCopyingRowClipboardContent(UXGridViewRowClipboardEventArgs)	Raises the CopyingRowClipboardContent event.
OnCurrentCellChanged(ISRoutedEventArgs)	Raises the CurrentCellChanged event.
OnGotFocus(RoutedEventArgs)	Called before the GotFocus event occurs.
OnLoadingRow(UXGridViewRowEventArgs)	Raises the LoadingRow event.
OnLoadingRowDetails(UXGridViewRowDetailsEventArgs)	Raises the LoadingRowDetails event.
OnLoadingRowGroup(UXGridViewRowGroupHeaderEventArgs)	Raises the LoadingRowGroup event.
OnLostFocus(RoutedEventArgs)	Called before the LostFocus event occurs.
OnMouseWheel(MouseWheelEventArgs)	Called before the MouseWheel event occurs.
OnPreparingCellForEdit(UXGridViewPreparingCellForEditEventArgs)	Raises the PreparingCellForEdit event.
OnRowEditEnded(UXGridViewRowEditEndedEventArgs)	Raises the RowEditEnded event.
OnRowEditEnding(UXGridViewRowEditEndingEventArgs)	Raises the RowEditEnding event.
OnSelectionChanged(UXGridViewSelectionChangedEventArgs)	Raises the SelectionChanged event.
OnUnloadingRow(UXGridViewRowEventArgs)	Raises the UnloadingRow event.
OnUnloadingRowDetails(UXGridViewRowDetailsEventArgs)	Raises the UnloadingRowDetails event.
OnUnloadingRowGroup(UXGridViewRowGroupHeaderEventArgs)	Raises the UnloadingRowGroup event.

Events

AutoGeneratingColumn	Occurs one time for each public, non-static property in the bound data type when the ItemsSource property is changed and the AutoGenerateColumns property is true.
BeginningEdit	Occurs before a cell or row enters editing mode.
CellEditEnded	Occurs when a cell edit has been committed or canceled.
CellEditEnding	Occurs when a cell edit is ending.
ColumnDisplayIndexChanged	Occurs when the DisplayIndex property of a column changes.
ColumnReordered	Occurs when a UXGridView column has moved to a new position in the display order.
ColumnReordering	Occurs before a UXGridView column moves to a new position in the display order.
CopyingRowClipboardContent	Occurs when the row is prepared for a clipboard copy operation.
CurrentCellChanged	Occurs when a different cell becomes the current cell.
Exported	Occurs when data is succesfully exported.
Exporting	Occurs when data is being exported.
PreparingCellForEdit	Occurs when a cell in a column enters editing mode.
RowDetailsVisibilityChanged	Occurs when the RowDetailsVisibilityMode property value changes.
RowEditEnded	Occurs when a row edit has been committed or canceled.
RowEditEnding	Occurs when a row edit is ending.
SelectionChanged	Occurs when the SelectedItem or SelectedItems property value changes.

...

public ICommand ExportCommand { get; set; }

Gets or sets command that will be invoked when exporting data.

Remarks

By default, the exporting processes only the data available in the client. Therefore if you enable server paging, you might not be able to export the complete data correctly. To address this challenge, you can implement the ExportCommand in the ViewModel and provide the desired data to the UXGridView property.

Anchor

	P:Intersoft.Client.UI.Data.UXGridView.ExportCssStyleSelector
	P:Intersoft.Client.UI.Data.UXGridView.ExportCssStyleSelector

...

public IEnumerable ExportItems { get; set; }

Gets or sets the items to be exported.

Remarks

By default, the exporting processes only the data available in the client. Therefore if you enable server paging, you might not be able to export the complete data correctly. To address this challenge, you can implement the UXGridView in the ViewModel and provide the desired data to the ExportItems property.

...

public CompositeFilterDescriptorCollection FilterDescriptors { get; set; }

Gets or sets the descriptor object that encapsulates the filtering related information.

Remarks

Server data operation means that the data operation, such as sorting, filtering and paging; are processed in the server side. In this mode, UXGridView does not handle the data operation by its own. It will simply provide the query information allowing you to process it further to a data service. To use this mode, you set the UXDataPager property to Server. When this mode is selected, UXGridView will not attempt to perform the data operation on the given data source. Instead, it will store and distribute the query information on several properties such as FilterDescriptors, UXGridView and UXGridView property. When one of these properties change, the QueryChanged event of the associated QueryDescriptor will be raised. This allows you to streamline the query processing in a centralized function, which is one of the strong benefits of QueryDescriptor. For more information about QueryDescriptor, see QueryDescriptor Overview. To learn how to perform server-side sorting, filtering and paging using UXGridView, see How-to: Implement Server-side Sorting, Filtering and Paging using UXGridView.

...

public bool HasChanges { get; set; }

Gets or sets a value that indicates whether there are data changes or not.

Remarks

If you prefer to automatically update the records after each CUD operation, you can perform the server operation in the UXGridView, UXGridView and UXGridView respectively, and perhaps followed with the UXGridView to refresh the data. However, if you prefer a batch update, you can notify the UXGridView by setting the HasChanges property to true, and later call the SaveChanges method to save all changes in one server call.

...

public ScrollMode HorizontalScrollMode { get; set; }

Gets or sets a value that determine the horizontal scroll mode.

Remarks

When you need to increase the scrolling performance even further, especially due to larger view port, you can set the HorizontalScrollMode and UXGridView properties to ScrollMode. In this mode, the row virtualization will be suspended during scrolling, and resumed when the scrolling completes. When you set the scroll mode to ScrollMode, you will see a visual indicator as you scroll through the vertical scroll bar. You can use the UXGridView or UXGridView to customize the appearance and template of the scrolling visual indicator.

...

public LostFocusAction LostFocusAction { get; set; }

Gets or sets a value that determine the lost focus action when user lost focus during row editing.

Remarks

When you lost focus from an edited row, by default UXGridView will commit the current edit operation you can change this behavior by changing the LostFocusAction property and UXGridView property to CancelEdit. This setting will force UXGridView to cancel the current edit operation when the focus is lost from the edited row. UXGridView property determines the action for new row object, while UXGridView determines the action for existing rows.

...

public LostFocusAction NewRowLostFocusAction { get; set; }

Gets or sets a value that determine the lost focus action when user lost focus during new row editing.

Remarks

When you lost focus from an edited row, by default UXGridView will commit the current edit operation you can change this behavior by changing the UXGridView property and NewRowLostFocusAction property to CancelEdit. This setting will force UXGridView to cancel the current edit operation when the focus is lost from the edited row. NewRowLostFocusAction property determines the action for new row object, while UXGridView determines the action for existing rows.

...

public PageDescriptor PageDescriptor { get; set; }

Gets or sets the descriptor object that encapsulates the paging related information.

Remarks

Server data operation means that the data operation, such as sorting, filtering and paging; are processed in the server side. In this mode, UXGridView does not handle the data operation by its own. It will simply provide the query information allowing you to process it further to a data service. To use this mode, you set the UXDataPager property to Server. When this mode is selected, UXGridView will not attempt to perform the data operation on the given data source. Instead, it will store and distribute the query information on several properties such as UXGridView, UXGridView and PageDescriptor property. When one of these properties change, the QueryChanged event of the associated QueryDescriptor will be raised. This allows you to streamline the query processing in a centralized function, which is one of the strong benefits of QueryDescriptor. For more information about QueryDescriptor, see QueryDescriptor Overview. To learn how to perform server-side sorting, filtering and paging using UXGridView, see How-to: Implement Server-side Sorting, Filtering and Paging using UXGridView.

...

public PagerDisplayMode PagerDisplayMode { get; set; }

Gets or sets a value that indicates how the UXDataPager user interface is displayed.

Remarks

You can customize the appearance of the UXDataPager by setting the PagerDisplayMode property. If you use a PagerDisplayMode that displays numeric buttons, you can change the number of buttons displayed by setting the UXGridView property.

Anchor

	P:Intersoft.Client.UI.Data.UXGridView.PagerNumericButtonCount
	P:Intersoft.Client.UI.Data.UXGridView.PagerNumericButtonCount

public int PagerNumericButtonCount { get; set; }

Gets or sets a value that indicates the number of page buttons shown on the UXDataPager user interface.

Remarks

You can customize the appearance of the UXDataPager by setting the UXGridView property. If you use a UXGridView that displays numeric buttons, you can change the number of buttons displayed by setting the PagerNumericButtonCount property.

...

public QueryOperation QueryOperation { get; set; }

Gets or sets a value that determines whether the filtering operation should be performed in client-side or server-side.

Remarks

It is often useful to view and interact with information in a data grid control such as UXGridView in different ways by grouping, sorting, filtering or paging the data. To handle this data operation, UXGridView provides two approaches that you can choose from by setting the QueryOperation property.

Client Data Operation

Client data operation means that the data operation, such as sorting, filtering and paging; are executed in the client side against the data source provided to the UXGridView. To use this operation, you set the QueryOperation property to Client. You typically use a collection that implements IPagedCollectionView as the data source or encapsulate the collection to a PagedCollectionView class. To learn how to perform client-side sorting, filtering and paging using UXGridView, see How-to: Implement Client-side Sorting, Filtering and Paging using UXGridView.

Server Data Operation

Server data operation means that the data operation, such as sorting, filtering and paging; are processed in the server side. In this mode, UXGridView does not handle the data operation by its own. It will simply provide the query information allowing you to process it further to a data service. To use this mode, you set the QueryOperation property to Server. When this mode is selected, UXGridView will not attempt to perform the data operation on the given data source. Instead, it will store and distribute the query information on several properties such as UXGridView, UXGridView and UXGridView property. When one of these properties change, the QueryChanged event of the associated QueryDescriptor will be raised. This allows you to streamline the query processing in a centralized function, which is one of the strong benefits of QueryDescriptor. For more information about QueryDescriptor, see QueryDescriptor Overview. To learn how to perform server-side sorting, filtering and paging using UXGridView, see How-to: Implement Server-side Sorting, Filtering and Paging using UXGridView.

...

public Binding ScrollIndicatorBinding { get; set; }

Gets or sets the binding that associates the scroll indicator with property in the data source.

Remarks

When you need to increase the scrolling performance even further, especially due to larger view port, you can set the UXGridView and UXGridView properties to ScrollMode. In this mode, the row virtualization will be suspended during scrolling, and resumed when the scrolling completes. When you set the scroll mode to ScrollMode, you will see a visual indicator as you scroll through the vertical scroll bar. You can use the ScrollIndicatorBinding or ScrollIndicatorTemplate to customize the appearance and template of the scrolling visual indicator.

...

public SortDescriptionCollection SortDescriptions { get; }

Gets or sets the sort descriptions object that encapsulates the sorting related information.

Remarks

To implement a predefined sorting, you specify the SortDescriptions or UXGridView property in XAML depending on the value of the UXDataPager property. The SortDescriptions is used when the control is configured with client data operation, while the UXGridView is used for server data operation.

...

public SortDescriptorCollection SortDescriptors { get; set; }

Gets or sets the descriptor object that encapsulates the sorting related information.

Remarks

Server data operation means that the data operation, such as sorting, filtering and paging; are processed in the server side. In this mode, UXGridView does not handle the data operation by its own. It will simply provide the query information allowing you to process it further to a data service. To use this mode, you set the UXDataPager property to Server. When this mode is selected, UXGridView will not attempt to perform the data operation on the given data source. Instead, it will store and distribute the query information on several properties such as UXGridView, SortDescriptors and UXGridView property. When one of these properties change, the QueryChanged event of the associated QueryDescriptor will be raised. This allows you to streamline the query processing in a centralized function, which is one of the strong benefits of QueryDescriptor. For more information about QueryDescriptor, see QueryDescriptor Overview. To learn how to perform server-side sorting, filtering and paging using UXGridView, see How-to: Implement Server-side Sorting, Filtering and Paging using UXGridView.

...

public ScrollMode VerticalScrollMode { get; set; }

Gets or sets a value that indicates the vertical scroll mode.

Remarks

When you need to increase the scrolling performance even further, especially due to larger view port, you can set the UXGridView and VerticalScrollMode properties to ScrollMode. In this mode, the row virtualization will be suspended during scrolling, and resumed when the scrolling completes. When you set the scroll mode to ScrollMode, you will see a visual indicator as you scroll through the vertical scroll bar. You can use the UXGridView or UXGridView to customize the appearance and template of the scrolling visual indicator.

...

Versions Compared

Old Version 23

New Version Current

Key

Remarks

Example

Working with AutoGenerateColumns Property and Columns Property

Working with CanUserAddRows Property, CanUserDeleteRows Property and CanUserEditRows Property

Working with CanUserExport Property

Working with CanUserGroupColumns Property

Working with CanUserPage Property

Working with CanUserSortColumns Property

Working with CellEditingTemplateSelector Property

Working with ColumnFooterVisibility Property

Working with DeleteRowCommand Property, InsertRowCommand Property, PrepareNewRowCommand Property, RejectChangesCommand Property, RejectRowCommand Property, SaveChangesCommand Property, UpdateCellCommand Property, UpdateRowCommand Property and ValidateRowCommand Property

Working with EditEnterKeyAction Property, EditKeyGesture Property and EnterKeyAction Property

Working with EditMouseGesture Property

Working with EmptyRowsVisibility Property and NewRowPosition Property

Working with ExpandedItem Property

Working with ExportCommand Property and ExportItems Property

Working with FrozenColumnCount Property

Working with GroupByBoxVisibility Property

Working with GroupDescriptors Property

Working with GroupFootersVisibility Property

Working with IsReadOnlyBinding Property

Working with ScrollIndicatorBinding Property

Working with SelectedItem Property, SelectedItems Property, SelectionMode Property and SelectionUnit Property

Working with SortDescriptions Property

Public Constructors

Public Properties

Protected Properties

Fields

Public Methods

Protected Methods

Events

Client Data Operation

Server Data Operation

Page History

Versions Compared

Old Version 23

New Version Current

Key

Remarks

Example

Working with AutoGenerateColumns Property and Columns Property

Working with CanUserAddRows Property, CanUserDeleteRows Property and CanUserEditRows Property

Working with CanUserExport Property

Working with CanUserGroupColumns Property

Working with CanUserPage Property

Working with CanUserSortColumns Property

Working with CellEditingTemplateSelector Property

Working with ColumnFooterVisibility Property

Working with DeleteRowCommand Property, InsertRowCommand Property, PrepareNewRowCommand Property, RejectChangesCommand Property, RejectRowCommand Property, SaveChangesCommand Property, UpdateCellCommand Property, UpdateRowCommand Property and ValidateRowCommand Property

Working with EditEnterKeyAction Property, EditKeyGesture Property and EnterKeyAction Property

Working with EditMouseGesture Property

Working with EmptyRowsVisibility Property and NewRowPosition Property

Working with ExpandedItem Property

Working with ExportCommand Property and ExportItems Property

Working with FrozenColumnCount Property

Working with GroupByBoxVisibility Property

Working with GroupDescriptors Property

Working with GroupFootersVisibility Property

Working with IsReadOnlyBinding Property

Working with ScrollIndicatorBinding Property

Working with SelectedItem Property, SelectedItems Property, SelectionMode Property and SelectionUnit Property

Working with SortDescriptions Property

Public Constructors

Public Properties

Protected Properties

Fields

Public Methods

Protected Methods

Events

Client Data Operation

Server Data Operation