EditTriggers Property
See Also  Example
Xceed.Wpf.DataGrid Assembly > Xceed.Wpf.DataGrid Namespace > DataGridControl Class : EditTriggers Property

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

Syntax

Visual Basic (Declaration) 
Public Property EditTriggers As EditTriggers
C# 
public EditTriggers EditTriggers {get; set;}

Return 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.

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.
XAMLCopy Code
<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>

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.

Requirements

Supported Frameworks: Microsoft .NET Framework version 3.5

See Also