[Overview][Classes][Index] | Reference for unit 'groupcursorresource' (#fcl-res)

# TGroupCursorResource

[Properties (by Name)] [Methods (by Name)] [Events (by Name)]

Group cursor resource type

## Declaration

Source position: groupcursorresource.pp line 29

`type TGroupCursorResource = class(TGroupResource)`
`protected`
`procedure ReadResourceItemHeader; override;`
`procedure WriteHeader(); override;`
`procedure CreateSubItem; override;`
`procedure UpdateItemOwner(); override;`
`procedure ClearItemList; override;`
`procedure DeleteSubItems; override;`
`function GetSubStream(); override;`
`function GetType; override;`
`function GetName; override;`
`function ChangeDescTypeAllowed(); override;`
`function ChangeDescValueAllowed(); override;`
`public`
`constructor Create();` |  | Creates a new group cursor resource
`end;`

## Inheritance

`TGroupCursorResource` |  | Group cursor resource type
`TGroupResource` |  | Abstract common class for group icon and group cursor classes
`TAbstractResource` |  | Base abstract resource class
`TObject`

## 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.

Remark: | 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.

## See also

TGroupResource.ItemData |  | Resource data as an ICO/CUR stream
TGroupIconResource |  | Group icon resource type