a1200   NEWS   APPS   DOCS   ABOUT
a1200
----
a1200
----
Autodocs
 Libraries:
 icon.library
  AddFreeList
  BumpRevision
  ChangeToSelectedIconColor
  DeleteDiskObject
  DrawIconStateA
  DupDiskObjectA
  FindToolType
  FreeDiskObject
  FreeFreeList
  GetDefDiskObject
  GetDiskObject
  GetDiskObjectNew
  GetIconRectangleA
  GetIconTagList
  IconControlA
  LayoutIconA
  MatchToolValue
  NewDiskObject
  PutDefDiskObject
  PutDiskObject
  PutIconTagList
Include
GuruMeditation
Docs » Autodocs » icon.library » GetDiskObjectNew

NAME

	GetDiskObjectNew - read in a Workbench disk object from disk.    (V36)

SYNOPSIS

	diskobj = GetDiskObjectNew(name)
D0 A0
struct DiskObject *GetDiskObjectNew(STRPTR);

FUNCTION

	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 FreeList 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. The V2.0 icon editor program is an example of a Workbench
application window that uses this call.

INPUTS

	name -- name of the object (STRPTR) or NULL if you just want a
DiskObject structure allocated for you (useful when
calling AddAppIcon() in workbench.library).

RESULT

	diskobj -- the Workbench disk object in question

SEE ALSO

dos.library/IoErr(), icon.library/FreeDiskObject(), icon.library/GetDiskObject(), icon.library/PutDiskObject(), icon.library/DeleteDiskObject(), icon.library/GetIconTagList(), icon.library/PutIconTagList(), workbench.library/AddAppIconA()

Comments

Name:
E-mail: Use this if you want a message if you get a response, will not be shown.
Comment:
Select correct short for:

Red Sector Inc.

AOA
RSI
SNT
KEF

Comments:

$VER: d0.se 1.14 Copyright © 2011-2024 Tobias Geijersson support at d0 dot se