= IN_EVENT_WRITE_DATA =
Standard form behavior is that if the form is exited by escape or left arrow any changes are lost. This also is the case if an "EXIT" button is provided on the form. The exit button will call an event that will return nonzero to cause the form to exit. It is often useful to prompt the user in this instance whether to keep any changes. The IN_EVENT_WRITE_DATA macro when used in a form done event will write the changed data.

{{{
IN_EVENT_WRITE_DATA
}}}

== Parameters == 

 * None

== Return Value ==

This function does not return any value

== Remarks ==

IN_EVENT_WRITE_DATA is a macro to the call to form !WriteData within a form event. The preprocessor will replace this with a call to the !WriteData function of the form.
{{{
#define IN_EVENT_WRITE_DATA pForm->WriteData()
}}}


== Examples ==

The FORM_INIT must have !EventInputDone specified for the done event parameter. such as
{{{
  FORM_INIT(EditTruck, EventEditTruckShow, NULL, NULL, EventInputDone, nFormFlgNone);
}}}

{{{
EVENT(InputDone) 
{
   if(nData == FORM_DONE_ESCAPE || nData == FORM_DONE_LEFT_ARROW)
   {
      if (pForm->IsChanged() == true)
      {
         if(WaitPrompt(LANG(STR_SAVE_CHANGES), LANG(STR_YES), LANG(STR_NO)) == true)
         {
            IN_EVENT_WRITE_DATA;
         }
      }
   }
   return 1;
}
}}}

== See Also ==

 * [wiki:WriteData WriteData]
 * [wiki:IN_EVENT_SHOW_FORM IN_EVENT_SHOW_FORM]
 * [wiki:FORM_INIT FORM_INIT]
 * [wiki:FORM_SHOW FORM_SHOW]
 * [wiki:FORM_RUN FORM_RUN]