[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