GridSwipeItem.Tap Event
Occurs when a user taps the swipe item.
Namespace: DevExpress.Maui.DataGrid
Assembly: DevExpress.Maui.DataGrid.dll
NuGet Package: DevExpress.Maui.DataGrid
#Declaration
public event EventHandler<SwipeItemTapEventArgs> Tap
#Event Data
The Tap event's data class is SwipeItemTapEventArgs. The following properties provide information specific to this event:
Property | Description |
---|---|
Item | Gets the underlying data object of the tapped item. |
Row |
Returns the handle of the row to which the tapped swipe item belongs. |
#Remarks
Handle the Tap event or use the Command property to specify an action to be performed on a swipe item tap.
#Example
This example shows how to extend the grid’s UI with additional elements (buttons) that appear when a user swipes a data row (from left to right or from right to left) and perform custom actions on tap.
Define two swipe actions for rows of the grid bound to the collection of orders:
- Display information on a customer - When a user swipes a data row from left to right, the Customer button appears on the left side of the row.
- Remove an order - When a user swipes a data row from right to left, the Delete button appears on the right side of the row.
Follow the steps below to implement this functionality:
- Add a GridSwipeItem object to the DataGridView.StartSwipeItems or DataGridView.EndSwipeItems collection.
- Use this object’s Caption, BackgroundColor and Image properties to customize each button appearance.
If you need to apply the same appearance settings to all swipe buttons of the grid, assign a SwipeItemAppearance object with the specified properties to DataGridView.SwipeItemAppearance. In the current example, all buttons have the identical width (SwipeItemAppearance.Width). - Handle the
SwipeItem.Tap
event to assign a custom action to a button.
Note
The grid performs the first action from its Start
<dxg:DataGridView x:Name="grid" ItemsSource="{Binding Orders}">
<!-- ... -->
<dxg:DataGridView.StartSwipeItems>
<dxg:GridSwipeItem Caption="Customer" BackgroundColor="#797bff" Image="person.png"
Tap="Swipe_ShowCustomerInfo" />
</dxg:DataGridView.StartSwipeItems>
<dxg:DataGridView.EndSwipeItems>
<dxg:GridSwipeItem Caption="Delete" BackgroundColor="#ff3b30" Image="delete.png"
Tap="Swipe_Delete"/>
</dxg:DataGridView.EndSwipeItems>
<dxg:DataGridView.SwipeItemAppearance>
<dxg:SwipeItemAppearance Width="100"/>
</dxg:DataGridView.SwipeItemAppearance>
</dxg:DataGridView>