FileDialog documentation should be enhanced

The FileDialog class setFile() method contains the next statement.

"Sets the selected file for this file dialog window to be the
 specified file. This file becomes the default file if it is set before
 the file dialog window is first shown."

It is unclear how the selected file should look like. We should explicitly write that the selected file could be visually represented basing on the native file dialog implementation.