Read in a Workbench disk object from disk.
Source position: icon.pas line 359
function GetDiskObjectNew( |
const name: pCHAR |
):pDiskObject; |
const name: RawByteString |
):pDiskObject; |
name |
|
Name of the object or nil if you just want a DiskObject structure allocated for you (useful when calling AddAppIcon() in workbench.library). |
The Workbench disk object in question
name |
|
Name of the object or nil if you just want a DiskObject structure allocated for you (useful when calling AddAppIcon() in workbench.library). |
This routine reads in a Workbench disk object in from disk. The name parameter will have ".info" postpended to it, and the icon file of that name will be read. If the call fails, it will return zero. The reason for the failure may be obtained via IoErr().
Using this routine protects you from any future changes to the way icons are stored within the system.
A TFreeList structure is allocated just after the DiskObject structure; FreeDiskObject() makes use of this to get rid of the memory that was allocated.
This call is functionally identical to GetDiskObject() with one exception. If its call to GetDiskObject() fails, this function calls GetDefDiskObject(). This is useful when there is no .info file for the icon you are trying to get a disk object for. Applications that use workbench application windows must use this call if they want to handle the user dropping an icon (that doesn't have a '.info' file) on their window.
|
Return extra information from the system |
|
|
Delete a Workbench disk object from disk. |
|
|
Free all memory in a Workbench disk object. |
|
|
Read in a Workbench disk object from disk. |
|
|
Retrieve an icon |
|
|
Create an empty icon |
|
|
Write out a DiskObject to disk. |
|
|
Store an icon |
|
|