What does FormatMode.New actually do?

[HamidBee]

I am reading about this function 'FormatMode.New'. In the MS documentation it reads the following:

"The form is populated with default values and the user can modify the values of the fields. Once complete, the user can add the record to the data source."

Does this mean that the form is populated with random, arbitrary values?. But why would someone want to do this?. Can someone please provide a further explanation with an example?. Thank you. 

[Drrickryp]

@HamidBee 

It means the form is populated with the Default values of the fields in your data source. Most of the time they are blank but not necessarily. There is nothing random about it. The description is of a typical form in new mode For a canvas app.

FYI, FormatMode.New is a property. The function to set that property is NewForm(Form1)

[timl · Accepted solution]

Hi @HamidBee 

>> Does this mean that the form is populated with random, arbitrary values?.

This means that the form is populated with 'default' values. Default values are those that are defined in each form card here:

>>Can someone please provide a further explanation with an example?

Here's a further example.  The syntax below illustrates that if the form mode is new, the aquisition date field defaults to 'Now()' (eg todays date). Otherwise, the form must be in edit or view mode, in which case, the value defaults to ThisItem.AquisitionDate (eg, the existing record value).

Also, note the property name is FormMode.New, rather than FormatMode.New.