AmigaOS Manual: Workbench Fundamentals - Revision history

Janne Peräaho: /* Font Requesters */

2021-01-31T15:01:45Z

Font Requesters

← Older revision		Revision as of 15:01, 31 January 2021
Line 453:		Line 453:
	Font requesters list the available fonts on the system. Figure 3-7 illustrates the font requester window.		Font requesters list the available fonts on the system. Figure 3-7 illustrates the font requester window.

	[[File:WorkbenchFig3-7.png\|frame\|~~center~~\|Font Requester]]		[[File:WorkbenchFig3-7.png\|frame\|none\|Font Requester]]

	Fonts are sets of characters of the same design. Using font requesters, applications allow you to choose the font style and point size. Some applications might also allow you to select font attributes (plain, bold, italicized, or underlined) and colors for the text and/or background. The display box above the OK and Cancel gadgets shows an example of text in the selected font. Use the requester's sizing gadget to widen the requester to show more characters.		Fonts are sets of characters of the same design. Using font requesters, applications allow you to choose the font style and point size. Some applications might also allow you to select font attributes (plain, bold, italicized, or underlined) and colors for the text and/or background. The display box above the OK and Cancel gadgets shows an example of text in the selected font. Use the requester's sizing gadget to widen the requester to show more characters.

Janne Peräaho: /* File Requesters */

2021-01-31T15:01:35Z

File Requesters

← Older revision		Revision as of 15:01, 31 January 2021
Line 413:		Line 413:
	File requesters allow you to select or enter the name of a file that you want to open or save. Figure 3-6 illustrates a file requester window.		File requesters allow you to select or enter the name of a file that you want to open or save. Figure 3-6 illustrates a file requester window.

	[[File:WorkbenchFig3-6.png\|frame\|~~center~~\|File Requester]]		[[File:WorkbenchFig3-6.png\|frame\|none\|File Requester]]

	A file requester contains a scrolling list of files and drawers, plus several other gadgets for locating your file. Read through the list by dragging the scroll bar up or down or selecting the scroll arrows. If your file is in a different drawer or on another disk, the gadgets in the requester allow you to look for that file.		A file requester contains a scrolling list of files and drawers, plus several other gadgets for locating your file. Read through the list by dragging the scroll bar up or down or selecting the scroll arrows. If your file is in a different drawer or on another disk, the gadgets in the requester allow you to look for that file.

Janne Peräaho: /* Text Requester */

2021-01-31T15:01:27Z

Text Requester

← Older revision		Revision as of 15:01, 31 January 2021
Line 407:		Line 407:
	Text requesters ask you to enter text into a text gadget, as illustrated in Figure 3-5. The text gadget is automatically selected and text is entered at the cursor position (the small highlighted box inside the text gadget).		Text requesters ask you to enter text into a text gadget, as illustrated in Figure 3-5. The text gadget is automatically selected and text is entered at the cursor position (the small highlighted box inside the text gadget).

	[[File:WorkbenchFig3-5.png\|frame\|~~center~~\|Text Requester]]		[[File:WorkbenchFig3-5.png\|frame\|none\|Text Requester]]

	== File Requesters ==		== File Requesters ==

Janne Peräaho: /* Action Requesters */

2021-01-31T15:01:18Z

Action Requesters

← Older revision		Revision as of 15:01, 31 January 2021
Line 395:		Line 395:
	Action requesters require you to proceed with or cancel an operation by clicking on the appropriate action gadget: OK, Continue, Retry, or Cancel. Figure 3-4 illustrates an action requester window.		Action requesters require you to proceed with or cancel an operation by clicking on the appropriate action gadget: OK, Continue, Retry, or Cancel. Figure 3-4 illustrates an action requester window.

	[[File:WorkbenchFig3-4.png\|frame\|~~center~~\|Action Requester]]		[[File:WorkbenchFig3-4.png\|frame\|none\|Action Requester]]

	Keyboard shortcut: To proceed (OK, Continue, or Retry), press left Amiga+V. To Cancel, press left Amiga+B.		Keyboard shortcut: To proceed (OK, Continue, or Retry), press left Amiga+V. To Cancel, press left Amiga+B.

Janne Peräaho: /* Windows */

2021-01-31T15:00:54Z

Windows

← Older revision		Revision as of 15:00, 31 January 2021
Line 53:		Line 53:
	Windows are areas on a screen that display and accept information. When you first boot the Amiga, the Workbench window is displayed on the Workbench screen. When you double-click on the Workbench disk icon the Workbench disk window opens on the Workbench window, as illustrated in Figure 3-2. Many of the Workbench icons create windows when opened.		Windows are areas on a screen that display and accept information. When you first boot the Amiga, the Workbench window is displayed on the Workbench screen. When you double-click on the Workbench disk icon the Workbench disk window opens on the Workbench window, as illustrated in Figure 3-2. Many of the Workbench icons create windows when opened.

	[[File:WorkbenchFig3-2.png\|~~center~~\|frame\|Workbench Disk Window Open on Workbench Window]]		[[File:WorkbenchFig3-2.png\|none\|frame\|Workbench Disk Window Open on Workbench Window]]

	== Working with Windows ==		== Working with Windows ==

Janne Peräaho: /* Screens */

2021-01-31T15:00:45Z

Screens

← Older revision		Revision as of 15:00, 31 January 2021
Line 13:		Line 13:
	A screen is always at least the full width of the monitor display. All windows open within a screen. The Workbench screen, shown in Figure 3-1, is the first thing displayed when you turn on your Amiga or following reboot.		A screen is always at least the full width of the monitor display. All windows open within a screen. The Workbench screen, shown in Figure 3-1, is the first thing displayed when you turn on your Amiga or following reboot.

	[[File:WorkbenchFig3-1.png\|~~center~~\|frame\|Workbench Screen]]		[[File:WorkbenchFig3-1.png\|none\|frame\|Workbench Screen]]

	== Using Screens ==		== Using Screens ==

Steven Solie: /* Requesters */

2014-02-03T18:12:37Z

Requesters

← Older revision		Revision as of 18:12, 3 February 2014
Line 390:		Line 390:

	Requesters are prompts that appear in small windows. You must respond to a requester to continue. A requester always contains text explaining what you must do to satisfy the request. Menu items that generate requesters are followed by an ellipses (...).		Requesters are prompts that appear in small windows. You must respond to a requester to continue. A requester always contains text explaining what you must do to satisfy the request. Menu items that generate requesters are followed by an ellipses (...).

			== Action Requesters ==

			Action requesters require you to proceed with or cancel an operation by clicking on the appropriate action gadget: OK, Continue, Retry, or Cancel. Figure 3-4 illustrates an action requester window.

			[[File:WorkbenchFig3-4.png\|frame\|center\|Action Requester]]

			Keyboard shortcut: To proceed (OK, Continue, or Retry), press left Amiga+V. To Cancel, press left Amiga+B.

			== Message Requesters ==

			Message requesters inform you about something that occurred in the system or a program. They require an acknowledgement by clicking on a gadget.

			== Text Requester ==

			Text requesters ask you to enter text into a text gadget, as illustrated in Figure 3-5. The text gadget is automatically selected and text is entered at the cursor position (the small highlighted box inside the text gadget).

			[[File:WorkbenchFig3-5.png\|frame\|center\|Text Requester]]

			== File Requesters ==

			File requesters allow you to select or enter the name of a file that you want to open or save. Figure 3-6 illustrates a file requester window.

			[[File:WorkbenchFig3-6.png\|frame\|center\|File Requester]]

			A file requester contains a scrolling list of files and drawers, plus several other gadgets for locating your file. Read through the list by dragging the scroll bar up or down or selecting the scroll arrows. If your file is in a different drawer or on another disk, the gadgets in the requester allow you to look for that file.

			The gadgets are used as follows:
			{\| class="wikitable"
			\| Volumes \|\| Displays a list of available floppy disks, hard disk partitions, and assigned directories. List the available files and drawers on a disk by clicking on the name. Click on the drawer names to list their contents. In addition to volume, drawer, and file names, the scrolling list displays the file size in bytes, file and drawer timestamps, and volume use statistics. Use the sizing gadget to make the file requester wider for viewing this information.
			\|-
			\| Parent \|\| Lists the current drawer's parent. Selecting Parent when the current drawer is the root of a particular volume is the same as selecting the Volumes gadget.
			\|-
			\| OK \|\| Loads/saves the selected file. Same as pressing Return. In a Load or Open requester, the shortcut is to double-click on the file name. In a Save requester, distinguished by the reversed colors on its scrolling list, you cannot save by double-clicking. This gadget can be labeled OK, Load, or Save.
			\|-
			\| Cancel \|\| Cancels the requester.
			\|-
			\| Pattern \|\| An optional text gadget labeled Pattern, when present, allows use of AmigaDOS pattern matching to control the list of files. Users familiar with AmigaDOS pattern matching can enter their own pattern statements.
			\|}

			The standard Amiga file requester has a Control menu with the following items:
			{\| class="wikitable"
			\| Last Name/Next Name \|\| Moves up and down through the listed names. (The up and down arrow keys or the right Amiga key shortcuts in the menu can also move you through the list.) The current name appears in the File text gadget; a highlighted bar appears in the list if the current name is a file name.
			\|-
			\| Restore \|\| Recalls the scrolling list and text gadget contents that were displayed when the requester opened.
			\|-
			\| Parent \|\| Has the same function as the Parent gadget.
			\|-
			\| Volumes \|\| Has the same function as the Volumes gadget.
			\|-
			\| OK \|\| Has the same function as the OK gadget.
			\|-
			\| Cancel \|\| Has the same function as the Cancel gadget.
			\|-
			\| Delete \|\| Deletes files from the file requester. Select the file name or type the name into the File text gadget and choose Delete. A requester appears, requiring confirmation. Select OK to delete or Cancel to return to the file requester without deleting.
			\|}

			Because the file requester window is an AppWindow, you can also choose a file by dragging its icon into the window. The contents of the drawer containing the icon are listed with the file's path loaded into the Drawer and File gadgets.

			== Font Requesters ==

			Font requesters list the available fonts on the system. Figure 3-7 illustrates the font requester window.

			[[File:WorkbenchFig3-7.png\|frame\|center\|Font Requester]]

			Fonts are sets of characters of the same design. Using font requesters, applications allow you to choose the font style and point size. Some applications might also allow you to select font attributes (plain, bold, italicized, or underlined) and colors for the text and/or background. The display box above the OK and Cancel gadgets shows an example of text in the selected font. Use the requester's sizing gadget to widen the requester to show more characters.

			When you select a font name, the display box shows that font in the currently selected font size, scaling the font as necessary. Depending on whether the font is an outline font or a bitmap font, there can be a delay in displaying the font. Some bitmap fonts sizes may appear distorted.

			For more information about fonts, see Chapter 8.

			== ScreenMode Requesters ==

			ScreenMode requesters work similarly to the ScreenMode Preferences editor. Detailed ScreenMode information appears in Chapter 5.

Steven Solie: /* Icons */

2014-02-03T18:05:50Z

Icons

← Older revision		Revision as of 18:05, 3 February 2014
Line 276:		Line 276:
	\| [[File:WorkbenchIcon8.png\|center]] \|\| The Trashcan represents a special drawer used to store unwanted items until you remove them from the disk. A Trashcan is found in the Work partition.		\| [[File:WorkbenchIcon8.png\|center]] \|\| The Trashcan represents a special drawer used to store unwanted items until you remove them from the disk. A Trashcan is found in the Work partition.
	\|}		\|}

			== Working with Icons ==

			This section describes the mouse operations that can be done with icons, including selecting, dragging, and copying.

			=== Selecting an Icon ===

			To work with an icon you must first select it. Once an icon is selected, you can make a copy of it, change its name, or delete it.

			All icons are surrounded by a box. When an icon is not selected, the box appears raised above the screen or window surface. When you select an icon, the box appears to sink into the screen or window surface. Icons also change color or shape when selected. For example, drawer icons change from a closed drawer to an open drawer when selected.

			To select an icon:

			# Point to the icon, making sure the pointer tip is within the icon's box.
			# Click the selection button. The icon changes to show that it is selected.

			If you click the selection button while the pointer is elsewhere on the screen or window, the icon is deselected and returns to its original appearance.

			=== Selecting Multiple Icons ===

			You can select several icons at one time. When multiple icons are selected, you can treat them as a single, entity, deleting, moving, or copying the entire group in one operation.

			The two methods for selecting multiple icons using the mouse are drag selection and extended selection.

			Drag selection uses the mouse to draw a box around all of the icons that you wish to select, as follows:

			# Move the pointer just outside of the outermost icon to be included in the box. That points is one corner of the box. Make sure it is not on an icon or gadget.
			# Hold down the selection button and move the mouse to place the opposite corner of the box. A dotted outline of the box is shown as you move the pointer.
			# When the box encloses all the icons to be selected, release the mouse button. All of these icons are now selected.

			The extended selection method is for selecting icons that are not in a group that can be enclosed in a box, as follows:

			# Select the first icon.
			# Hold down Shift.
			# While holding down Shift, select each of the other icons.
			# Release Shift. All of the chosen icons remain selected until you select a different icon or click within a Workbench window while not holding down Shift.

			=== Dragging an Icon ===

			You can move icons within a window or to another window by dragging them.

			To drag an icon:

			# Point to the icon.
			# Hold down the selection button and move the mouse. An image of the selected icon moves with the pointer.
			# Release the selection button when the icon is in position.

			If you selected several icons, you can drag all of them at once. Hold down Shift, point to one of the icons, hold down the selection button, and move the mouse. All the selected icons move as you move the mouse.

			=== Copy by Dragging ===

			Copy a drawer, project, or tool to another disk by dragging the icon over the other disk's icon or into the other disk's window. The original icon stays on the original disk and a copy is created in the destination disk's window.

			You cannot make a copy of an icon on the same disk with this method. To copy something onto the same disk, select its icon, and then use the Copy menu item.

			You can copy several icons at once using drag selection or extended selection. When the icons to be copied are selected:

			# Hold down Shift.
			# Point to one of the selected icons and then drag it over the other disk's icon or into the other disk's window. As you drag one icon, the rest follow.
			# Release the selection button to copy the icons.

			{{Note\|When drag-copying several icons, be sure the tip of the pointer is over the icon or window to which you are copying when you release the selection button.}}

			== Icon Tool Types ==

			Tool Types specify parameters used by a program. Tool Types are usually in the form of KEYWORD = argument. Case differences do not matter when entering the information. Do not use any spaces around the equals sign in a Tool Type entry.

			Any changes you make to a program's Tool Types take effect the next time you run the program. Tool Types are found in an icon's Information window.

			To use Tool Types:

			# Select the appropriate icon.
			# Choose Information from the Icons menu.

			When the window appears, you can add, delete, or change Tool Types in the Tool Types field.

			For convenience, Workbench programs usually have all their possible Tool Types already entered. The Tool Types that are optional or do not set default values are disabled or commented. Commented Tool Types are enclosed in parentheses and are ignored when the icon is opened.

			All icon program provide the DONOTWAIT Tool Type. Normally the Workbench waits for one program to finish before it opens the next. The DONOTWAIT option overrides this delay, which can cause unwanted requesters after booting. DONOTWAIT does not take an argument.

			=== Uncommenting ===

			Uncomment or make available Tool Types by removing the parentheses. Where there are angle-bracketed parameters in the Tool Type, the parameter and brackets must be replaced with an appropriate value or option.

			=== Changing a Tool Type ===

			# Select the appropriate icon and choose Information from the Icons menu.
			# Select the Tool Type that you want to change from the list. It is copied to the text gadget below.
			# Edit the text in the text gadget and press Return.
			# Select the Save gadget. Be sure to make all your changes before selecting Save because it closes the Information window.

			=== Adding a Tool Type ===

			# Select the appropriate icon and choose Information from the Icons menu.
			# Select the New gadget.
			# Type in the new Tool Type and press Return.<br/>Repeat Steps 2 and 3 for each additional Tool Type you want to add.
			# Select the Save gadget to save the new information. If you do not wish to save your changes, select Cancel or the window's close gadget.

			=== Deleting a Tool Type ===

			# Select the appropriate icon and choose Information from the Icons menu.
			# Select the Tool Type to be deleted.
			# Select the DEL gadget.<br/>Repeat Steps 2 and 3 for each Tool Type you wish to delete.
			# Select the Save gadget to save the change. If you do not wish to save your changes, select Cancel or the window's close gadget.

			{{Note\|Commenting out Tool Types that you do not currently need rather than deleting them makes recalling them easier the next time you need them.}}

			== AppIcons ==

			An AppIcons is an icon that is created by an application program. The function of these icons is determined by the application. For specific information on how a particular AppIcon works, read the documentation that came with the application that uses it.

			= Requesters =

			Requesters are prompts that appear in small windows. You must respond to a requester to continue. A requester always contains text explaining what you must do to satisfy the request. Menu items that generate requesters are followed by an ellipses (...).

Steven Solie: /* Icons */

2014-02-03T17:54:07Z

Icons

← Older revision		Revision as of 17:54, 3 February 2014
Line 262:		Line 262:
	\| [[File:WorkbenchIcon1.png\|center]] \|\| A disk icon represents any disk that is available or accessible by the Workbench. Disk icons appear only in the Workbench window.		\| [[File:WorkbenchIcon1.png\|center]] \|\| A disk icon represents any disk that is available or accessible by the Workbench. Disk icons appear only in the Workbench window.
	\|-		\|-
	\| \|\| A drawer icon represents a directory, which is a subdivision of the disk storage area.		\| [[File:WorkbenchIcon2.png\|center]] \|\| A drawer icon represents a directory, which is a subdivision of the disk storage area.
	\|-		\|-
	\| \|\| A tool icon represents a specific program, such as the Clock utility. When a tool icon opens, the program is started.		\| [[File:WorkbenchIcon3.png\|center]] \|\| A tool icon represents a specific program, such as the Clock utility. When a tool icon opens, the program is started.
	\|-		\|-
	\| \|\| A project icon represents a file created or used by a tool, such as the Prefs Preset icons.		\| [[File:WorkbenchIcon4.png\|center]] \|\| A project icon represents a file created or used by a tool, such as the Prefs Preset icons.
	\|-		\|-
	\| \|\| A project pseudo-icon represents a project file that does not have an icon.		\| [[File:WorkbenchIcon5.png\|center]] \|\| A project pseudo-icon represents a project file that does not have an icon.
	\|-		\|-
	\| \|\| A drawer pseudo-icon represents a directory that does not have an icon.		\| [[File:WorkbenchIcon6.png\|center]] \|\| A drawer pseudo-icon represents a directory that does not have an icon.
	\|-		\|-
	\| \|\| A tool pseudo-icon represents a tool file that does not have an icon.		\| [[File:WorkbenchIcon7.png\|center]] \|\| A tool pseudo-icon represents a tool file that does not have an icon.
	\|-		\|-
	\| \|\| The Trashcan represents a special drawer used to store unwanted items until you remove them from the disk. A Trashcan is found in the Work partition.		\| [[File:WorkbenchIcon8.png\|center]] \|\| The Trashcan represents a special drawer used to store unwanted items until you remove them from the disk. A Trashcan is found in the Work partition.
	\|}		\|}

Steven Solie: /* Icons */

2014-02-03T17:52:26Z

Icons

← Older revision		Revision as of 17:52, 3 February 2014
Line 255:		Line 255:
	= Icons =		= Icons =

			Icons are movable graphic representations of disks, drawers, files, and programs that you manipulate with the mouse.
	To Be Continued....

			The Workbench uses the following types of icons:

			{\| class="wikitable"
			\| [[File:WorkbenchIcon1.png\|center]] \|\| A disk icon represents any disk that is available or accessible by the Workbench. Disk icons appear only in the Workbench window.
			\|-
			\| \|\| A drawer icon represents a directory, which is a subdivision of the disk storage area.
			\|-
			\| \|\| A tool icon represents a specific program, such as the Clock utility. When a tool icon opens, the program is started.
			\|-
			\| \|\| A project icon represents a file created or used by a tool, such as the Prefs Preset icons.
			\|-
			\| \|\| A project pseudo-icon represents a project file that does not have an icon.
			\|-
			\| \|\| A drawer pseudo-icon represents a directory that does not have an icon.
			\|-
			\| \|\| A tool pseudo-icon represents a tool file that does not have an icon.
			\|-
			\| \|\| The Trashcan represents a special drawer used to store unwanted items until you remove them from the disk. A Trashcan is found in the Work partition.
			\|}