The XtraGrid control lets users change data directly within the grid cells. To modify cell values, you need to perform certain actions with the cells in-place editor. This topic describes how you can activate the editor and apply the changes made.
To perform these actions, TestComplete should have access to the internal methods and properties of the XtraGrid control. That is, the .NET Open Applications plug-in must be installed and enabled.
Activating In-place Editors
Depending on the cells column settings, you can activate the in-place editor for the focused cell in the following ways:
- By clicking the focused cell.
- By pressing the F2 key.
- By typing into the focused cell. At that, the cells value is replaced by the value typed.
- Using the
ShowEditor method of the grids view in which the cell resides.
- Finally, if the cell columns
ShowEditorMode property has any value except Click, the cells editor is automatically activated when the cell is clicked. In this case, no special actions are needed to put the cell into the edit mode.
ActivateInplaceEditor routine demonstrates how to implement some of the described approaches. Its Grid parameter specifies the tested XtraGrid control. If you decide to activate the edit mode by clicking the cell, you will need to include the helper
ClickCell routine from the Selecting Cells in Developer Express XtraGrid article into your code.
Closing In-Place Editors
After you have inputted the new cell value, you need to close the editor and save the changes made. You can do this in two ways:
- By simulating the Enter key press.
- By using the grid views internal
The code snippet below contains the
CloseCellEditor routine that can be used to finish editing the grid cell value. The Grid parameter of this routine specifies the grid control under which the action is performed.
You may also need to cancel the editing and discard any changes made to the cell value. For this purpose, you can either send the
Esc key press to the grid control, or use the grid views internal
HideEditor method. The
CancelEditing routine in the example below demonstrates how to do this:
Below is an example of how to use introduced routines in test scripts. This example works with the GridTutorials sample application that is shipped with the Developer Express XtraGrid Suite. The
Main routine selects some grid cells, makes the grid editable, modifies cell values and then either applies or cancels the changes. The
ClickCell routine is used to simulate clicks on grid cells. You can find more information on it in Selecting Cells in Developer Express XtraGrid.