Xceed DataGrid for WPF v7.3 Documentation
SurfaceConfiguration Class
Members  Example 


Xceed.Wpf.DataGrid Assembly > Xceed.Wpf.DataGrid.Views.Surfaces Namespace : SurfaceConfiguration Class
Represents configurations that can be applied to any surface exposed by a multi-surface view and supports various regions in which data can be displayed.
Syntax
'Declaration
 
<TypeDescriptionProviderAttribute(MS.Internal.ComponentModel.DependencyObjectProvider)>
<NameScopePropertyAttribute("NameScope", System.Windows.NameScope)>
Public MustInherit Class SurfaceConfiguration 
   Inherits System.Windows.DependencyObject
 
'Usage
 
Dim instance As SurfaceConfiguration
Example

All examples in this topic assume that the grid is bound to the Employees table of the Northwind database, unless stated otherwise.

The following example demonstrates how to provide an image and title surface configuration that will be applied to the center surface and a title surface configuration that will be applied to the left and right side cards.The following example demonstrates how to define default and explicit region configurations.
<Grid xmlns:xcdg="http://schemas.xceed.com/wpf/xaml/datagrid">
  <Grid.Resources>
     <xcdg:DataGridCollectionViewSource x:Key="cvs_employees"
                              Source="{Binding Source={x:Static Application.Current}, Path=EmployeesTable}"/>
 
  </Grid.Resources>
 
  <xcdg:DataGridControl x:Name="EmployeesGrid"
                        ItemsSource="{Binding Source={StaticResource cvs_employees}}">
     <xcdg:DataGridControl.Columns>
        <xcdg:Column FieldName="LastName"
                     IsMainColumn="True"/>
     </xcdg:DataGridControl.Columns>
    <xcdg:DataGridControl.View>
       <xcdg:CardflowView3D>
          <xcdg:CardflowView3D.Theme>
             <xcdg:ElementalBlackTheme>
                <xcdg:ElementalBlackTheme.SurfaceConfigurations>
                   <!-- Because an attempt is made to automatically detect an image in the data
                        item, there is no need to specify the name of the field that contains
                        the image in the surface configuration's ImageRegionConfiguration.
                       
                        If a data item contains more than one image you can set the FieldNames
                        property of the ImageRegionConfiguration to the name of the field that
                        contains the desired image. -->
                   <xcdg:ImageAndTitleSurfaceConfiguration xcdg:CardflowView3D.Surfaces="Center"/>
                  
                   <!-- By default, the value of the main column will be displayed in the title regions. -->
                   <xcdg:TitleSurfaceConfiguration xcdg:CardflowView3D.Surfaces="Left, Right"/>
                </xcdg:ElementalBlackTheme.SurfaceConfigurations>
             </xcdg:ElementalBlackTheme>
          </xcdg:CardflowView3D.Theme>
       </xcdg:CardflowView3D>
    </xcdg:DataGridControl.View>
  </xcdg:DataGridControl>
</Grid>
Inheritance Hierarchy

System.Object
   System.Windows.Threading.DispatcherObject
      System.Windows.DependencyObject
         Xceed.Wpf.DataGrid.Views.Surfaces.SurfaceConfiguration
            Xceed.Wpf.DataGrid.Views.Surfaces.CompleteSurfaceConfiguration
            Xceed.Wpf.DataGrid.Views.Surfaces.DataSurfaceConfiguration
            Xceed.Wpf.DataGrid.Views.Surfaces.ImageAndDataSurfaceConfiguration
            Xceed.Wpf.DataGrid.Views.Surfaces.ImageAndTitleSurfaceConfiguration
            Xceed.Wpf.DataGrid.Views.Surfaces.ImageSurfaceConfiguration
            Xceed.Wpf.DataGrid.Views.Surfaces.TitleAndDataSurfaceConfiguration
            Xceed.Wpf.DataGrid.Views.Surfaces.TitleSurfaceConfiguration

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

SurfaceConfiguration Members
Xceed.Wpf.DataGrid.Views.Surfaces Namespace