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

# TGroupIconResource

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

Group icon resource type

## Declaration

Source position: groupiconresource.pp line 29

`type TGroupIconResource = 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 icon resource
`end;`

## Inheritance

`TGroupIconResource` |  | Group icon 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_ICON.

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

There is although a big difference between .ico files and icon resources: an .ico file contains an icon, 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_ICON resource only contains information about the single images, which are contained each in a different resource of type RT_ICON. 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_ICON resource, which provides information about them.

TGroupIconResource provides a way to handle an icon as if it was a .ico file, via ItemData property. Single icon 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_ICON. Attempts to do so result in a EResourceDescChangeNotAllowedException.

## See also

TGroupResource.ItemData |  | Resource data as an ICO/CUR stream
TGroupCursorResource |  | Group cursor resource type

Documentation generated on: May 14 2021