event EditClose ()
Occurs when the edit operation ends.

TypeDescription
Use the EditClose event to notify your application that the editor is closed. The EditClose event is fired when the focused cell ends editing. Use the FocusItem property to determine the handle of the item where the edit operation ends. Use the FocusColumnIndex property to determine the index of the column where the edit operation ends. The Editing specifies the window's handle of the built-in editor while the control is running in edit mode. The EditingText property returns the caption being shown on the editor while the control runs in edit mode. Use the EditClose method to closes the current editor, by code.  For instance, the EditClose event is not fired when user hides the drop down portion of the editor. Use the Edit event to prevent editing a cell.

The edit events are fired in the following order:

  1. Edit event. Prevents editing cells, before showing the cell's editor.

  2. EditOpen event. The edit operation started, the cell's editor is shown. The Editing property gives the window's handle of the built-in editor being started.

  3. Change event. The Change event is fired only if the user types ENTER key, or the user selects a new value from a predefined data list.

  4. EditClose event. The cell's editor is hidden and closed.

Syntax for EditClose event, /NET version, on:

private void EditCloseEvent(object sender)
{
}

Private Sub EditCloseEvent(ByVal sender As System.Object) Handles EditCloseEvent
End Sub

Syntax for EditClose event, /COM version, on:

private void EditCloseEvent(object sender, EventArgs e)
{
}

void OnEditClose()
{
}

void __fastcall EditClose(TObject *Sender)
{
}

procedure EditClose(ASender: TObject; );
begin
end;

procedure EditCloseEvent(sender: System.Object; e: System.EventArgs);
begin
end;

begin event EditClose()
end event EditClose

Private Sub EditCloseEvent(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles EditCloseEvent
End Sub

Private Sub EditClose()
End Sub

Private Sub EditClose()
End Sub

LPARAMETERS nop

PROCEDURE OnEditClose(oGrid)
RETURN

Syntax for EditClose event, /COM version (others), on:

<SCRIPT EVENT="EditClose()" LANGUAGE="JScript">
</SCRIPT>

<SCRIPT LANGUAGE="VBScript">
Function EditClose()
End Function
</SCRIPT>

Procedure OnComEditClose 
	Forward Send OnComEditClose 
End_Procedure

METHOD OCX_EditClose() CLASS MainDialog
RETURN NIL

void onEvent_EditClose()
{
}

function EditClose as v ()
end function

function nativeObject_EditClose()
return

The following VB sample displays the window's handle of the built-in editor being closed:

Private Sub Grid1_EditClose()
    Debug.Print "EditClose " & Grid1.Editing
End Sub

The following VB sample displays the caption of the cell where the edit operation ends:

Private Sub Grid1_EditClose()
    With Grid1.Items
        Debug.Print "EditClose on '"; .CellCaption(.FocusItem, Grid1.FocusColumnIndex) & "'."
    End With
End Sub

The following C++ sample displays the handle of the built-in editor being closed:

#include "Items.h"
void OnEditCloseGrid1() 
{
	CItems items = m_grid.GetItems();
	COleVariant vtItem( items.GetFocusItem() ), vtColumn( m_grid.GetFocusColumnIndex() );
	CString strFormat;
	strFormat.Format( "'%s'  %i", V2S( &items.GetCellValue( vtItem, vtColumn ) ), m_grid.GetEditing() );
	OutputDebugString( strFormat );
}

The following VB.NET sample displays the handle of the built-in editor being closed:

Private Sub AxGrid1_EditCloseEvent(ByVal sender As Object, ByVal e As System.EventArgs) Handles AxGrid1.EditCloseEvent
    With AxGrid1
        Debug.Print(.Items.CellValue(.Items.FocusItem, .FocusColumnIndex) & " " & .Editing.ToString())
    End With
End Sub

The following C# sample displays the handle of the built-in editor being closed:

private void axGrid1_EditCloseEvent(object sender, EventArgs e)
{
	object cellValue = axGrid1.Items.get_CellValue(axGrid1.Items.FocusItem, axGrid1.FocusColumnIndex);
	string strOutput = "'" + (cellValue != null ? cellValue.ToString() : "") + "' " + axGrid1.Editing.ToString();
	System.Diagnostics.Debug.WriteLine( strOutput );
}

The following VFP sample displays the handle of the built-in editor being closed:

*** ActiveX Control Event ***

with thisform.Grid1.Items
	.DefaultItem = .FocusItem()
	wait window nowait str(.CellValue( 0, thisform.Grid1.FocusColumnIndex() ))
	wait window nowait str(thisform.Grid1.Editing())
endwith