Item Selector

From GEMWiki

The Item Selector is a screen displayed by GEM to choose a file to load or save.

Parts of the screen

• The "Directory" field contains the current path and search pattern to use.
• The "Selection" field indicates the filename to load or save.
• The list on the left shows files and folders (folders marked with a ◆). Double-clicking a file selects it; double-clicking a folder moves to that folder.
• Above the list, the title bar shows what search pattern is in use, and the 'close' symbol (◼, ⧓, or ◂) moves to the next directory up. Moving up from the root directory displays a list of drives - the "?:" button in GEM/5 and FreeGEM is a shortcut to the drive list.

Bugs

GEM 1.1 does not display the drive list. If it is currently showing the root directory of a drive, clicking the close button does nothing. To switch to a different drive, the user would have to edit the path displayed under "Directory".

The path cannot grow longer than the width of the "Directory:" control -- 42 characters in GEM/1 to GEM/3. If it does overflow the control, the search pattern will be cut off.

Programming

The fsel_input call is used to display this screen and await results. On FreeGEM, fsel_exinput can also be used; this allows the title of the screen to be changed from "Item Selector" to something else.