Retrieve an icon
Source position: icon.pas line 370
function GetIconTagList( |
const name: pCHAR; |
const tags: pTagItem |
):pDiskObject; |
const name: RawByteString; |
const tags: pTagItem |
):pDiskObject; |
name |
|
Name of the object an icon is to be retrieved for, or nil if a default icon is to be retrieved. |
tags |
|
Retrieval options. (ICONGETA_*) |
Pointer to a struct DiskObject or nil in case of error. You can use IoErr() to retrieve the error code or use the ICONA_ErrorCode tag instead.
name |
|
Name of the object an icon is to be retrieved for, or nil if a default icon is to be retrieved. |
tags |
|
Retrieval options. (ICONGETA_*) |
This function is used to retrieve an icon; the icon can belong to a file/drawer/volume or it can be a default icon.
This function is a superset of GetDefDiskObject(), GetDiskObject() and GetDiskObjectNew().
If a palette-mapped icon is set to allocate its colours from the default screen, such as the Workbench screen, icon.library may resort to remap its colours in the course of Workbench screen close/reopen transitions. This means that you cannot depend upon the icon's image bitmaps to stay the same size, shape or colour. If this is what you need, you should either create your own images from the palette mapped data or make copies of the icon image bitmaps and the associated colour table.
If during Workbench close/open transitions the global remap screen becomes nil, GetIconTagList() may refuse to return a remapped icon and return with an error (ERROR_REQUIRED_ARG_MISSING) instead.
|
Read in a Workbench disk object from disk. |
|
|
Read in a Workbench disk object from disk. |
|
|
Read default wb disk object from disk. |
|
|
Set and get icon and icon.library options |
|
|
Store an icon |