TGroupCursorResource class

In unit groupcursorresource

Group cursor resource type

Declaration

pascal

TGroupCursorResource = class(TGroupResource)

Inheritance

TGroupCursorResource
TGroupResource
TAbstractResource

Description

This class represents a resource of type RT_GROUP_CURSOR.

Resources of this type are strictly related to .cur files: typically a resource compiler creates resources of this type when it is instructed to insert a cursor from a .cur file.

There is although a big difference between .cur files and cursor resources: a .cur file contains a cursor, which is made of several different images (for different sizes and color depth), but while a file of this type is self-contained, when it comes to resources data is scattered over several different resources: an RT_GROUP_CURSOR resource only contains information about the single images, which are contained each in a different resource of type RT_CURSOR. The single resources are pretty unuseful alone, since they only consist of raw image data: they must be accessed in the contest of the RT_GROUP_CURSOR resource, which provides information about them.

TGroupCursorResource provides a way to handle a cursor as if it was a .cur file, via ItemData property. Single cursor resources are automatically created or destroyed as needed.

This class doesn't allow its type to be changed to anything else than RT_GROUP_CURSOR. Attempts to do so result in a EResourceDescChangeNotAllowedException.

Methods

`ReadResourceItemHeader`	protected
`WriteHeader`	protected
`CreateSubItem`	protected
`UpdateItemOwner`	protected
`ClearItemList`	protected
`DeleteSubItems`	protected
`GetSubStream`	protected
`GetType`	protected	Returns the type of the resource
`GetName`	protected	Returns the name of the resource
`ChangeDescTypeAllowed`	protected	Reports whether changing the type of resource type or name is allowed
`ChangeDescValueAllowed`	protected	Reports whether changing the value of resource type or name is allowed
`Create`	public	Creates a new group cursor resource

Inherited

From TGroupResource (13)

CheckBuildItemStream CompareContents CreateSubItems Destroy FindSubResources GetItemData GetSubStreamCount ItemData NotifyResourcesLoaded SetCustomItemDataStream SetOwnerList UpdateRawData WriteResHeader

From TAbstractResource (18)

_Type CacheData Characteristics CodePage DataOffset DataSize DataVersion HeaderSize LangID MemoryFlags Name Owner OwnerList RawData SetChildOwner SetCustomRawDataStream SetDescOwner Version

An experiment, built from development snapshots. Not the official Free Pascal or Lazarus documentation.