EditTriggers Property (DataGridControl)

Gets or sets a value indicating what triggers will cause cells to enter edit mode.

Syntax

Visual Basic
C#

'Declaration
 
Public Property EditTriggers As EditTriggers

'Usage
 
Dim instance As DataGridControl
Dim value As EditTriggers
 
instance.EditTriggers = value
 
value = instance.EditTriggers

public EditTriggers EditTriggers {get; set;}

Property Value

An EditTriggers value indicating what triggers will cause cells to enter edit mode. By default, EditTriggers.BeginEditCommand, ClickOnCurrentCell, and ActivationGesture.

Member	Description
None	No special triggers will cause cells to enter edit mode.
BeginEditCommand	Cells will enter edit mode when the Edit Command (default F2) is sent to the containing DataRow.
ClickOnCurrentCell	The current cell will enter edit mode when it is clicked.
SingleClick	Cells will enter edit mode when it is clicked.
CellIsCurrent	A cell will enter edit mode when it becomes current.
ActivationGesture	Cells will enter edit mode when the user performs the appropriate activation gesture for the current cell's editor.
RowIsCurrent	All cells in a row will enter edit mode when the row becomes current.

Remarks

The conditions under which cell editors are displayed are determined by the value of the CellEditorDisplayConditions Property, which can be defined for the entire grid or per row. The EditTriggers and CellEditorDisplayConditions properties work independently of each other. For example, if the EditTriggers property is set to None and the CellEditorDisplayConditions property is set to CellIsCurrent, when a cell becomes current, its editor will be displayed and the content of the cell can be edited when focus is given to the cell editor.

A cell editor can be displayed without it being in edit mode.

Example

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

The following example demonstrates how to enter edit mode only when a cell becomes current by setting the EditTriggers property to CellIsCurrent.

XAML

<Grid xmlns:xcdg="http://schemas.xceed.com/wpf/xaml/datagrid">
  <Grid.Resources>
    <xcdg:DataGridCollectionViewSource x:Key="cvs_orders"
                                    Source="{Binding Source={x:Static Application.Current},
                                     Path=Orders}"/>
  </Grid.Resources>

  <xcdg:DataGridControl x:Name="OrdersGrid"
                        ItemsSource="{Binding Source={StaticResource cvs_orders}}"
                        EditTriggers="CellIsCurrent"/>      
</Grid>

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

Reference

DataGridControl Class
DataGridControl Members