Xceed Logo
Shop
Xceed Toolkit Plus for WPF v5.0 Documentation
Xceed.Wpf.DataGrid Assembly / Xceed.Wpf.DataGrid.Views Namespace / TableView Class
Members


In This Topic
    TableView Class
    In This Topic
    Represents a table-view layout in which rows are laid out horizontally in a traditional grid-like style.
    Syntax
    'Declaration
 
<StyleTypedPropertyAttribute(Property="FocusVisualStyle", StyleTargetType=System.Windows.Controls.Control)>
<XmlLangPropertyAttribute("Language")>
<UsableDuringInitializationAttribute(True)>
<RuntimeNamePropertyAttribute("Name")>
<TypeDescriptionProviderAttribute(MS.Internal.ComponentModel.DependencyObjectProvider)>
<NameScopePropertyAttribute("NameScope", System.Windows.NameScope)>
Public Class TableView 
   Inherits UIViewBase
    'Usage
 
Dim instance As TableView
    [StyleTypedProperty(Property="FocusVisualStyle", StyleTargetType=System.Windows.Controls.Control)]
[XmlLangProperty("Language")]
[UsableDuringInitialization(true)]
[RuntimeNameProperty("Name")]
[TypeDescriptionProvider(MS.Internal.ComponentModel.DependencyObjectProvider)]
[NameScopeProperty("NameScope", System.Windows.NameScope)]
public class TableView : UIViewBase
    Remarks

    The View property of the DataGridControl class determines which view is applied to a grid. If the View property is left to its default value, null (Nothing in Visual Basic), or explicitly set to null, the default table-view layout will be used with the system color palette. The Theme property of the View class can be set to change the color palette applied to a grid's elements. If left to its default value, null, the system color palette will be used. In either case, if the system-color theme is not recognized (e.g., a third-party color palette is being used), the Aero normal-color theme will be used.

    Views and themes can be set through attribute syntax or property element syntax. To change the default view and/or theme using attribute syntax, the name of the view to use (e.g., CardView) must be provided, optionally followed by the name of the theme class (e.g., NormalColorTheme), or the name of the class without the "Theme" portion. If the theme is omitted, the default Aero normal-color theme will be used.

    Fixed Columns vs. Templates  

    In order to support fixed columns when creating a new row template for a table-view layout, the following criteria must be met:

    1. The PART_CellsHost template part must be a FixedCellPanel.
    2. The FixedCellCount property of the FixedCellPanel must be bound to the table view's FixedColumnCount property using a TwoWay ViewBinding.

    The fixed-cell-panel properties listed below are also usually bound when provided a new row template for a table-view layout:

    1. SplitterStyle (TemplateBinding xcdg:TableView.FixedColumnSplitterStyle)
    2. SplitterWidth (xcdg:ViewBinding FixedColumnSplitterWidth)
    3. ShowSplitter (xcdg:ViewBinding ShowFixedColumnSplitter)
    4. FixedColumnDropMarkPen (xcdg:ViewBinding FixedColumnDropMarkPen)

    If a new template is provided for a DataGridControl and fixed columns are to be supported, it is essential that a TableViewScrollViewer be used. This scroll viewer is responsible for preserving the TranslateTransforms that fix and scroll elements, as well as executing the PageLeft and PageRight actions according to the reduced viewport.  It is also recommended that an AdornerDecorator be located above the TableViewScrollViewer of the templated DataGridControl to support drag and dropping of the fixed-column splitter correctly.

    Inheritance Hierarchy

    System.Object
       System.Windows.Threading.DispatcherObject
          System.Windows.DependencyObject
             System.Windows.ContentElement
                System.Windows.FrameworkContentElement
                   Xceed.Wpf.DataGrid.Views.ViewBase
                      Xceed.Wpf.DataGrid.Views.UIViewBase
                         Xceed.Wpf.DataGrid.Views.TableView
                            Xceed.Wpf.DataGrid.Views.TableflowView

    Requirements

    Target Platforms: Windows 11, Windows 10, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

    See Also

    Reference

    TableView Members
    Xceed.Wpf.DataGrid.Views Namespace

    DataGrid Fundamentals

    Views and Themes
    Table Views Overview

    Send Feedback