Difference between revisions of "Requesters"

From MorphOS Library

(More about context menus.)
(No need to use hardcoded HTML for things which can be done with Wiki templates.)
Line 19: Line 19:
 
This requester has several gadgets and a list of files and directories. The user may also type in a path and filename in the provided text field. Usually, however, most users will simply scan through a list, dragging the scroll bar as necessary (scroll arrows are provided as well) to locate a given file. There are several extra gadgets used with this requester.
 
This requester has several gadgets and a list of files and directories. The user may also type in a path and filename in the provided text field. Usually, however, most users will simply scan through a list, dragging the scroll bar as necessary (scroll arrows are provided as well) to locate a given file. There are several extra gadgets used with this requester.
  
<ul>
+
* '''"/" (Parent)''': This gadget indicates the current directory's parent directory. If the list currently displays the root of a given device, using this gadget will act the same as the Volumes gadget.
<li>'''"/" (Parent)''': This gadget indicates the current directory's parent directory. If the list currently displays the root of a given device, using this gadget will act the same as the Volumes gadget.</li>
+
* '''"<" (Back)''': During the process of browsing through directories, the back gadget can be used to re-list the last directory viewed in the file requester.
<li>'''"<" (Back)''': During the process of browsing through directories, the back gadget can be used to re-list the last directory viewed in the file requester.</li>
+
* '''">" (Forward)''': Similar to the back gadget, the forward gadget browses through directories in the file requester history.
<li>'''">" (Forward)''': Similar to the back gadget, the forward gadget browses through directories in the file requester history.</li>
+
* '''":" (Volumes)''': When used, the volume gadget will display a list of devices available to MorphOS. This includes USB devices, [[assigns]], and hard drive partitions. When clicking on a device or a drawer, it's contents are then displayed. Information about the files and directories are also displayed within the lister.
<li>'''":" (Volumes)''': When used, the volume gadget will display a list of devices available to MorphOS. This includes USB devices, [[assigns]], and hard drive partitions. When clicking on a device or a drawer, it's contents are then displayed. Information about the files and directories are also displayed within the lister.</li>
+
* '''Ok''': Will load or save the selected file. This result can also be achieved by pressing the Enter key. Double-clicking on the file-name will open a file, but is inactive for saving. The '''Ok''' button may be labeled Ok, Save, Load, or something else based upon a given application.
<li>'''Ok''': Will load or save the selected file. This result can also be achieved by pressing the Enter key. Double-clicking on the file-name will open a file, but is inactive for saving. The '''Ok''' button may be labeled Ok, Save, Load, or something else based upon a given application.</li>
+
* '''Cancel''': Terminates the action and removes the requester from the screen.
<li>'''Cancel''': Terminates the action and removes the requester from the screen.</li>
+
* '''File Pattern or''' '''Pattern''': An optional text input gadget, usually labeled '''Pattern''', allows the use of MorphOS Shell [[pattern matching]] to filter the list of files. The text in this gadget is often called a pattern statement.
<li>'''File Pattern or''' '''Pattern''': An optional text input gadget, usually labeled '''Pattern''', allows the use of MorphOS Shell [[pattern matching]] to filter the list of files. The text in this gadget is often called a pattern statement.</li>
+
* '''All''': This gadget is only present in file requesters allowing for selection of multiple files. Pressing it selects all files in the current directory. Multiselection can be done by dragging mouse with LMB pressed, or by clicking LMB with Shift key pressed. Note that multiselection is controlled by application displaying the requester.
<li>'''All''': This gadget is only present in file requesters allowing for selection of multiple files. Pressing it selects all files in the current directory. Multiselection can be done by dragging mouse with LMB pressed, or by clicking LMB with Shift key pressed. Note that multiselection is controlled by application displaying the requester.</li>
+
* '''None''': This gadget is only present in file requesters allowing for selection of multiple files. Pressing it deselects all files in the current directory.
<li>'''None''': This gadget is only present in file requesters allowing for selection of multiple files. Pressing it deselects all files in the current directory.</li> 
 
</ul>
 
  
 
A file may also be chosen by dragging it's icon from Ambient window or desktop into the file requester window. When this method is used, the contents of the containing directory of the file chosen will also be displayed in the file requester.
 
A file may also be chosen by dragging it's icon from Ambient window or desktop into the file requester window. When this method is used, the contents of the containing directory of the file chosen will also be displayed in the file requester.
Line 37: Line 35:
 
[[File:File_requester_context_menu.png|right]]Right clicking on a file within a file-requester will bring provide the following options:
 
[[File:File_requester_context_menu.png|right]]Right clicking on a file within a file-requester will bring provide the following options:
  
<ul>
+
* '''Rename''': Changes the filename of the selected file in the file requester. A requester appears to confirm the renaming of the file.
<li>'''Rename''': Changes the filename of the selected file in the file requester. A requester appears to confirm the renaming of the file.</li>
+
* '''Delete''': Permanently deletes a file. An action requester requires confirmation of file deletion.
<li>'''Delete''': Permanently deletes a file. An action requester requires confirmation of file deletion.</li>
+
* '''Multiselect''': Appears only if file multiselection is enabled for the requester, allows for selecting multiple files.
<li>'''Multiselect''': Appears only if file multiselection is enabled for the requester, allows for selecting multiple files.</li>
+
* '''New Drawer''': Creates a new directory within the current directory.
<li>'''New Drawer''': Creates a new directory within the current directory.</li>
+
* '''View''': Displays the content of a file based on user set preferences through Ambient's file-types.
<li>'''View''': Displays the content of a file based on user set preferences through Ambient's file-types.</li>
+
* '''Ambient''': Utilizes [[Multiview]] to display a file asynchronously to the application opening the file requester.
<li>'''Ambient''': Utilizes [[Multiview]] to display a file asynchronously to the application opening the file requester.</li>
+
* '''Parent''': Same as clicking the Parent gadget.
<li>'''Parent''': Same as clicking the Parent gadget.</li>
+
* '''Volumes''': Same as clicking the Volumes gadget.
<li>'''Volumes''': Same as clicking the Volumes gadget.</li>
+
* '''Directory History''': Opens a sub-menu with a list of directories previously browsed through via the file requester.
<li>'''Directory History''': Opens a sub-menu with a list of directories previously browsed through via the file requester.</li>
 
</ul>
 
  
 
=== Arranging columns in file and volume lists ===
 
=== Arranging columns in file and volume lists ===
  
 
[[File:List_header_context_menu.png|right]]Columns in the file list and the volume list may be rearranged by dragging (while holding LMB pressed) column headers around. There is also a list header context menu, available via pressing RMB over columns headers. This menu allows for adding and removing columns. Following columns are available:
 
[[File:List_header_context_menu.png|right]]Columns in the file list and the volume list may be rearranged by dragging (while holding LMB pressed) column headers around. There is also a list header context menu, available via pressing RMB over columns headers. This menu allows for adding and removing columns. Following columns are available:
<ul>
+
* '''"Icon"''': Displays thumbnails of files icons.
<li>'''"Icon"''': Displays thumbnails of files icons.</li>
+
* '''Name''': Displays file names (complete with extensions unlike in Windows).
<li>'''Name''': Displays file names (complete with extensions unlike in Windows).</li>
+
* '''Date & Time''': Displays the date and time of the last file modification, combined.
<li>'''Date & Time''': Displays the date and time of the last file modification, combined.</li>
+
* '''Size''': Displays file size. Empty for directories and other non-file objects.
<li>'''Size''': Displays file size. Empty for directories and other non-file objects.</li>
+
* '''Used''': Only makes sense in the volume list, displays amount of used space on device.
<li>'''Used''': Only makes sense in the volume list, displays amount of used space on device.</li>
+
* '''Date''': Displays date (but not time) of the last file modification.
<li>'''Date''': Displays date (but not time) of the last file modification.</li>
+
* '''Time''': Displays time (but not date) of the last file modification.
<li>'''Time''': Displays time (but not date) of the last file modification.</li>
+
* '''Flags''': Displays file flags (access rights).
<li>'''Flags''': Displays file flags (access rights).</li>
+
* '''Type''': Displays object type.
<li>'''Type''': Displays object type.</li>
+
* '''Comment''': Displays comment added to a file or directory.
<li>'''Comment''': Displays comment added to a file or directory.</li>
 
</ul>
 
  
 
== Font Requesters ==
 
== Font Requesters ==

Revision as of 11:06, 2 December 2009

A window that appears on-screen prompting a user response is called a requester. These windows usually contain text explaining what the request is for and what the user must do to continue an operation.

Action Requesters

Action requester.png
A specific type of requester that asks the user about proceeding with an action in process. These windows have buttons labeled usually with two or more of the following: Ok, Continue, Retry, Cancel, or Fail, but may contain more specific buttons, depending on action to be taken. Underlined letters on the requester buttons indicate keyboard shortcuts that can be used instead of using the mouse. The example on the right shows a system shutdown requester, which is an action one.

Message Requesters

Message requester.png
These requesters alert the user about something that has occurred in a program or within the system itself, and require only an acknowledgment by clicking on a button.

Text Requesters

Text requester.png
The user is required to provide information through the keyboard into a box within the window.

File Requesters

File requester.png
Used specifically to identify a file, usually for opening or saving a document, this requester usually contains a list of files and drawers.

This requester has several gadgets and a list of files and directories. The user may also type in a path and filename in the provided text field. Usually, however, most users will simply scan through a list, dragging the scroll bar as necessary (scroll arrows are provided as well) to locate a given file. There are several extra gadgets used with this requester.

  • "/" (Parent): This gadget indicates the current directory's parent directory. If the list currently displays the root of a given device, using this gadget will act the same as the Volumes gadget.
  • "<" (Back): During the process of browsing through directories, the back gadget can be used to re-list the last directory viewed in the file requester.
  • ">" (Forward): Similar to the back gadget, the forward gadget browses through directories in the file requester history.
  • ":" (Volumes): When used, the volume gadget will display a list of devices available to MorphOS. This includes USB devices, assigns, and hard drive partitions. When clicking on a device or a drawer, it's contents are then displayed. Information about the files and directories are also displayed within the lister.
  • Ok: Will load or save the selected file. This result can also be achieved by pressing the Enter key. Double-clicking on the file-name will open a file, but is inactive for saving. The Ok button may be labeled Ok, Save, Load, or something else based upon a given application.
  • Cancel: Terminates the action and removes the requester from the screen.
  • File Pattern or Pattern: An optional text input gadget, usually labeled Pattern, allows the use of MorphOS Shell pattern matching to filter the list of files. The text in this gadget is often called a pattern statement.
  • All: This gadget is only present in file requesters allowing for selection of multiple files. Pressing it selects all files in the current directory. Multiselection can be done by dragging mouse with LMB pressed, or by clicking LMB with Shift key pressed. Note that multiselection is controlled by application displaying the requester.
  • None: This gadget is only present in file requesters allowing for selection of multiple files. Pressing it deselects all files in the current directory.

A file may also be chosen by dragging it's icon from Ambient window or desktop into the file requester window. When this method is used, the contents of the containing directory of the file chosen will also be displayed in the file requester.

MorphOS File Requester Context Menu

File requester context menu.png
Right clicking on a file within a file-requester will bring provide the following options:
  • Rename: Changes the filename of the selected file in the file requester. A requester appears to confirm the renaming of the file.
  • Delete: Permanently deletes a file. An action requester requires confirmation of file deletion.
  • Multiselect: Appears only if file multiselection is enabled for the requester, allows for selecting multiple files.
  • New Drawer: Creates a new directory within the current directory.
  • View: Displays the content of a file based on user set preferences through Ambient's file-types.
  • Ambient: Utilizes Multiview to display a file asynchronously to the application opening the file requester.
  • Parent: Same as clicking the Parent gadget.
  • Volumes: Same as clicking the Volumes gadget.
  • Directory History: Opens a sub-menu with a list of directories previously browsed through via the file requester.

Arranging columns in file and volume lists

List header context menu.png
Columns in the file list and the volume list may be rearranged by dragging (while holding LMB pressed) column headers around. There is also a list header context menu, available via pressing RMB over columns headers. This menu allows for adding and removing columns. Following columns are available:
  • "Icon": Displays thumbnails of files icons.
  • Name: Displays file names (complete with extensions unlike in Windows).
  • Date & Time: Displays the date and time of the last file modification, combined.
  • Size: Displays file size. Empty for directories and other non-file objects.
  • Used: Only makes sense in the volume list, displays amount of used space on device.
  • Date: Displays date (but not time) of the last file modification.
  • Time: Displays time (but not date) of the last file modification.
  • Flags: Displays file flags (access rights).
  • Type: Displays object type.
  • Comment: Displays comment added to a file or directory.

Font Requesters

Displays a list of fonts available to the system, and is used to change fonts in applications or documents within an application. A preview of the font is given, as well as options for bold, underline, and italic.

Screen Mode Requesters

Similar to the Screen Mode Preferences Editor found in MUI Preferences.