Skip to content

TGroupCursorResource

Group cursor resource type

Declaration

Source position: groupcursorresource.pp line 36

type

  TGroupCursorResource = class(TGroupResource)
  protected
    procedure ReadResourceItemHeader;
    procedure WriteHeader;
    procedure CreateSubItem;
    procedure UpdateItemOwner;
    procedure ClearItemList;
    procedure DeleteSubItems;
    function GetSubStream : TStream;
    function GetType : TResourceDesc;
    function GetName : TResourceDesc;
    function ChangeDescTypeAllowed : Boolean;
    function ChangeDescValueAllowed : Boolean;
  public
    constructor Create;
    constructor Create(aType: TResourceDesc; aName: TResourceDesc);
  end;

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.

Methods

Member Visibility Description
ChangeDescTypeAllowed protected
ChangeDescValueAllowed protected
ClearItemList protected
Create public Creates a new group cursor resource
CreateSubItem protected
DeleteSubItems protected
GetName protected
GetSubStream protected
GetType protected
ReadResourceItemHeader protected
UpdateItemOwner protected
WriteHeader protected
See all Methods

See also

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