TableView.IsDetailButtonVisibleBinding Property

Gets or sets the binding that determines which rows display detail expand buttons.

Namespace: DevExpress.Xpf.Grid

Assembly: DevExpress.Xpf.Grid.v20.2.dll

NuGet Packages: DevExpress.WindowsDesktop.Wpf.Grid.Core, DevExpress.Wpf.Grid.Core

Declaration

C#

[DefaultValue(null)]
public BindingBase IsDetailButtonVisibleBinding { get; set; }

VB.NET

<DefaultValue(Nothing)>
Public Property IsDetailButtonVisibleBinding As BindingBase

Property Value

Type	Default	Description
BindingBase	*null*	A BindingBase object specifying which rows display detail expand buttons.

Remarks

Use this property if you want to selectively display detail expand buttons. By default, the DataContext for this binding is the master row, so you can make the necessary binding adjustments and/or specify a value converter and return whether a given row should display its button.

If a row’s detail expand button is hidden, end-users won’t be able to expand it via keyboard shortcuts too.

Example

This sample shows how to use the TableView.IsDetailButtonVisibleBinding property to selectively hide detail expand buttons. The specified Binding transmits row field values to a value converter. The value converter then specifies if the row containing that value should display the detail expand button.

View Example

MainWindow.xaml.vb

Imports Microsoft.VisualBasic
Imports System
Imports System.Collections.Generic
Imports System.Linq
Imports System.Text
Imports System.Windows
Imports System.Windows.Controls
Imports System.Windows.Data
Imports System.Windows.Documents
Imports System.Windows.Input
Imports System.Windows.Media
Imports System.Windows.Media.Imaging
Imports System.Windows.Navigation
Imports System.Windows.Shapes
Imports System.Globalization

Namespace WpfApplication26
    Partial Public Class MainWindow
        Inherits Window
        Public Sub New()
            InitializeComponent()
            grid1.ItemsSource = New DataSource().Categories

        End Sub
    End Class

    <ValueConversion(GetType(Object), GetType(Boolean))> _
    Public Class MyConverter
        Implements IValueConverter
        Public Function Convert(ByVal value As Object, ByVal targetType As Type, ByVal parameter As Object, ByVal culture As CultureInfo) As Object Implements IValueConverter.Convert
            ' Obtaining the value to be converted 
            Dim categoryValue As String = CStr(value)

            ' Specifying values for which to show expand buttons
            Dim categories() As String = { "First", "Third" }
            If categories.Contains(categoryValue) Then
                Return True
            End If

            ' Disable expand button if the value isn't in the list
            Return False
        End Function
        Public Function ConvertBack(ByVal value As Object, ByVal targetType As Type, ByVal parameter As Object, ByVal culture As CultureInfo) As Object Implements IValueConverter.ConvertBack
            Return Nothing
        End Function
    End Class
End Namespace

MainWindow.xaml

<Window xmlns:dxg="http://schemas.devexpress.com/winfx/2008/xaml/grid"  x:Class="WpfApplication26.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:local="clr-namespace:WpfApplication26"
        Title="MainWindow" Height="350" Width="525">
    <Window.Resources>
        <local:MyConverter x:Key="myConverter" />
    </Window.Resources>
    <Grid>
        <dxg:GridControl x:Name="grid1" AutoPopulateColumns="True">
            <dxg:GridControl.DetailDescriptor>
                <dxg:DataControlDetailDescriptor ItemsSourcePath="Products">
                    <dxg:DataControlDetailDescriptor.DataControl>
                        <dxg:GridControl AutoPopulateColumns="True">
                            <dxg:GridControl.View>
                                <dxg:TableView AutoWidth="True" ShowGroupPanel="False" />
                            </dxg:GridControl.View>
                        </dxg:GridControl>
                    </dxg:DataControlDetailDescriptor.DataControl>
                </dxg:DataControlDetailDescriptor>
            </dxg:GridControl.DetailDescriptor>
            <dxg:GridControl.View>
                <dxg:TableView IsDetailButtonVisibleBinding="{Binding Row.Name, Converter={StaticResource myConverter}}" AutoWidth="True" ShowGroupPanel="False"/>
            </dxg:GridControl.View>
        </dxg:GridControl>
    </Grid>
</Window>

MainWindow.xaml.cs

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Data;
using System.Windows.Documents;
using System.Windows.Input;
using System.Windows.Media;
using System.Windows.Media.Imaging;
using System.Windows.Navigation;
using System.Windows.Shapes;
using System.Globalization;

namespace WpfApplication26
{
    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();
            grid1.ItemsSource = new DataSource().Categories;

        }
    }

    [ValueConversion(typeof(object), typeof(bool))]
    public class MyConverter : IValueConverter
    {
        public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
        {
            // Obtaining the value to be converted 
            string categoryValue = (string)value;

            // Specifying values for which to show expand buttons
            string[] categories = new string[] { "First", "Third" };
            if (categories.Contains(categoryValue))
                return true;

            // Disable expand button if the value isn't in the list
            return false;
        }
        public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
        {
            return null;
        }
    }
}

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the IsDetailButtonVisibleBinding property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

XAML

how-to-create-a-custom-wizard-using-navigationframe-t192371/CS/NavigationFrameWizard/MainWindow.xaml#L29

<dxg:GridControl.View>
    <dxg:TableView IsDetailButtonVisibleBinding="{Binding Row.Orders, Converter={local:HasOrdersConverter}}"/>
</dxg:GridControl.View>