Legacy Documentclose button

Important: The information in this document is obsolete and should not be used for new development.

Previous Book Contents Book Index Next

Inside Macintosh: More Macintosh Toolbox /
Chapter 1 - Resource Manager / Resource Manager Reference
Resources in the System File


Standard Icons

System software uses icons to represent documents, applications, folders, disks, and other elements of the Macintosh interface. Many of these standard icons are stored in the System file. You can design your own icons for your application and its documents. If you do not provide your own icons, the Finder displays a default icon. Your application can retrieve any of the icons in the System file by using the GetResource function. You should refer to these icons by their constant names and not by their resource IDs. For a description of the GetResource function, see page 1-68.

Most icons are available in at least two sizes: large (32 by 32 pixels) and small (16 by 16 pixels). They are also available in three bit depths: 8-bit, 4-bit, and black-and-white. An icon family consists of the large and small icons for an object, each with a mask, and each available in the three different color depths. See the chapter "Finder Interface" in Inside Macintosh: Macintosh Toolbox Essentials for information about how to create your own icons.

Many of the icons in the System file are also available in a small size (16 by 16 pixels), represented by the 'SICN' resource. These icons are used in Standard File Package dialog boxes. The Finder also uses icons in the System file to display in its windows the contents of disks or folders by name, date, size, or kind. The Views menu in System 7 allows the user to display large or small icons for a given window.

The icons listed in Table 1-4 represent default icons for documents (including special classes of documents such as stationery), applications, and desk accessories. The icons show the 'icl8' resource from the icons' icon family. You can include customized versions of the icons in Table 1-4 with your documents and applications. There are icon families and 'SICN' resources for all of these icons unless otherwise noted.
Table 1-4 Document and application icons
Constant name and iconResource IDDescription
genericDocumentIconResource



-4000The default document icon. The Finder displays this icon if your application does not provide its own icon for documents.
genericApplicationIconResource



-3996The default application icon. The Finder displays this icon for any application that does not provide its own icon.
genericDeskAccessoryIconResource

 

-3991The default desk accessory icon. In System 7 and later versions, desk accessories are represented on the desktop as applications are, each with its own icon. The Finder displays this icon for any desk accessory that does not provide its own icon.
genericEditionFileIconResource



-3989The default edition file icon. (See Inside Macintosh: Interapplication Communication for information about editions.)
genericStationeryIconResource

 

-3985The default stationery file icon. (See Inside Macintosh: Macintosh Toolbox Essentials for information about stationery.)
genericPreferencesIconResource



-3971The default preferences file icon. Preference files appear in the Preferences folder, which is located inside the System Folder. There is no 'SICN' resource for this icon.
genericQueryDocumentIconResource

-16506The default query document icon. (See Inside Macintosh: Interapplication Communication for information about query documents.) There is no 'SICN' resource for this icon.
genericExtensionIconResource

-16415The default extension icon. The Finder displays this icon for any extension that does not have its own icon. Extension files appear in the Extensions folder, which is located inside the System Folder. There is no 'SICN' resource for this icon.

The icons listed in Table 1-5 represent the different types of folders found on the desktop. The icons shown are the 'icl8' resource for the icons' icon families. There are icon families and 'SICN' resources for all of these icons unless otherwise noted.
Table 1-5 Folder icons
Constant name and iconResource IDDescription
genericFolderIconResource



-3999The default folder icon.
privateFolderIconResource


-3994The icon for a folder to which the user does not have access. It is dimmed and has a distinctly marked border. The Finder displays an alert box when a user without privileges attempts to open this folder.
ownedFolderIconResource



-3980The icon for a folder that is owned by a particular user, usually on a shared volume such as a file server. There is no 'SICN' resource for this icon.
dropFolderIconResource


-3979The icon for a folder in which any user may store documents, applications, and so on, but from which only a specified group of users can retrieve the contents. There is no 'SICN' resource for this icon.
sharedFolderIconResource



-3978The icon for a folder that the owner has made available for file sharing. There is no 'SICN' resource for this icon.
mountedFolderIconResource



-3977The icon for a folder that a guest has mounted on a remote volume. This icon appears only for the guest. There is no 'SICN' resource for this icon.

The icons listed in Table 1-6 represent the different types of folders found in the System Folder. The icons shown are the 'icl8' resource for the icons' icon families. You should not alter the appearance of these icons. There are only icon families for these icons.
System Folder icons
Constant name and iconResource IDDescription
systemFolderIconResource



-3983The System Folder icon. This folder contains the System file and other system-related folders.
appleMenuFolderIconResource



-3982The Apple Menu Items folder icon. This folder contains items found in the Apple menu.
startupFolderIconResource



-3981The Startup Items folder icon. This folder contains documents, aliases, applications, and other objects that open when the computer starts up.
controlPanelFolderIconResource


-3976The Control Panels folder icon. This folder contains control panels.

printMonitorFolderIconResource



-3975The PrintMonitor Documents folder icon. This folder contains documents that are in the queue to be printed.
preferencesFolderIconResource



-3974The Preferences folder icon. This folder contains preferences files for the Finder and other software that needs to remember user preferences.
extensionsFolderIconResource



-3973The Extensions folder icon. This folder contains system extensions.
fontsFolderIconResource



-3968The Fonts folder icon. This folder contains fonts (both bitmapped and outline).

The icons listed in Table 1-7 appear on the desktop. The icons shown are the 'icl8' resource for the icons' icon families. There are icon families and 'SICN' resources for these icons unless otherwise noted.
Table 1-7 Desktop icons
Constant name and iconResource IDDescription
floppyIconResource



-3998The default icon for any disk, 3.5-inch or otherwise, whose driver doesn't supply its own icon.
trashIconResource



-3993The default empty Trash icon.
fullTrashIconResource



-3984The default full Trash icon, with bulging midsection. There is no 'SICN' resource for this icon.

The icons listed in Table 1-8 are used only by the Standard File Package and are available only as an 'SICN' resource. The pop-up menu in the standard file dialog boxes indicates where the list of files shown in the dialog box is located (whether on the desktop, at the top level of a volume, or inside a series of folders on a volume).
Table 1-8 Standard File Package icons (Continued)
Constant name and iconResource IDDescription
openFolderIconResource


-3997The open folder icon, which appears in a pop-up menu only. The standard file dialog boxes display this icon to indicate which folder is currently open.
genericHardDiskIconResource

 

-3995The hard disk icon, which appears in a pop-up menu only. The same icon is used to represent internal and external disks. A different icon may appear on the desktop, because the manufacturer of the hard disk can design a special icon for a particular volume.
 
desktopIconResource

 

-3992The desktop icon, which appears in a pop-up menu only. The standard file dialog boxes display this icon to indicate which files and folders are available on the desktop.
genericFileServerIconResource

 

-3972The file server volume icon. This represents any servers open on the desktop. A different icon may appear on the desktop, because the manufacturer can design a special icon for a particular server.
genericSuitcaseIconResource

 

-3970The suitcase icon. This represents any suitcase, such as font suitcases or desk accessory suitcases. There are different icons for these suitcases in larger sizes, depending on the contents.


Previous Book Contents Book Index Next

© Apple Computer, Inc.
6 JUL 1996