wx:file-selector

   

• (wx:file-selector message default-path default-filename default-extension wildcard flags parent x y) -> string or null
      message : string
      default-path = null : string or null
      default-filename = null : string or null
      default-extension = null : string or null
      wildcard = "*" : string
      flags = 0 : small integer
      parent = null : wx:window object or null
      x = -1 : small integer
      y = -1 : small integer

  Pops up a file selector box (the standard one for the platform). The result is a path selected by the user or null if the user cancels the dialog. The returned pathname may or may not exist.

  If default-path is not null, it is used as the starting directory for the file selector. If default-filename is not null, it is used as the default filename when appropriate. If default-extension is not null, the return path will use the extension if the user does not supply one (Windows).

  The wildcard argument determines what files are displayed in the file selector (X Windows, Windows). In X Windows, this pattern is used as a pattern as in the shell. Under Windows, the wildcard can may be a specification for multiple types of file with a description for each, such as:

   
    "BMP files (*.bmp) | *.bmp | GIF files (*.gif) | *.gif" 
  

  The flags arugument can be any bitwise combination of the following:

  •  wx:const-open -- the user chooses an existing file (Windows, MacOS)
  •  wx:const-save -- the user chooses an new file (Windows, MacOS)
  •  wx:const-overwrite-prompt -- warn the user if an existing file is chosen (Windows, MacOS)
  •  wx:const-hide-readonly -- the user chooses only writeable files (Windows)