Skip to content

Overview (FMX)

Jump to bottom
Carlo Barazzetta edited this page Mar 25, 2020 · 13 revisions

Overview of the FMX components

TIconFontsImageListFMX component

TIconFontsImageListFMX is an FMX component for Delphi derived from TCustomImageList component, that auto-build icons using a collection of TIconFontsSourceItem (derived from TCustomSourceItem) that uses a special TIconFontMultiResBitmap (derived from TMultiResBitmap) to build bitmaps using Icon Fonts.

https://github.com/EtheaDev/IconFontsImageList/blob/master/Packages/IconFontsImageListComponentIcon.png

The Component is available at "Ethea" page, after installing the run-time and design-time Packages located in \Packages\DXXX\IconFontsImageListFMX.dpk and \Packages\DXXX\dclIconFontsImageListFMX.dpk

Into component TIconFontsImageListFMX you can define:

  • AutoSizeBitmaps (true/false) to obtain "dynamic" Bitmaps scaled for the requested components. If AutoSizeBitmaps is false it's possibile to build "static" Bitmaps with different Scale factors, as a normal ImageList that uses bitmap files.

At TIconFontsSourceItem level you can define, for each source item of the ImageList:

  • FontName
  • FontColor
  • Opacity
  • FontIconDec: Character value in decimal (stored into dfm)
  • Character: Character value (not stored)
  • FontIconHex: Character value in hexadecimal (not stored)
  • IconName (optional)

Implicit Methods:

Image Editor

Actually there isn't a specific component editor: to define the IconFontImageList properties you must use the Object Inspector and the Structure Editor to Add TIconFontsSourceItem items, TIconFontMultiResBitmap and TIconFontBitmapItem items. Don't use MultiResBitmap editor to create your bitmaps, because your icons are not loaded from files but generated by font.

TIconFontImageFMX component

TIconFontImageFMX is an FMX component for Delphi derived from TImage component, that auto-build icon using a collection a TIconFontFixedMultiResBitmap (derived from TFixedMultiResBitmap) to build bitmaps for different scale using Icon Fonts.

https://github.com/EtheaDev/IconFontsImageList/blob/master/Packages/IconFontImageComponentIcon.png

At TIconFontImageFMX component level you don't have to set nothing.

At TIconFontFixedBitmapItem level you can define, for each Scale factor:

  • FontName
  • FontColor
  • Opacity
  • FontIconDec: Character value in decimal (stored into dfm)
  • Character: Character value (not stored)
  • FontIconHex: Character value in hexadecimal (not stored)
  • Size
  • IconName (optional)

If you resize the image the MultiResBitmap rebuild the bitmap to show a perfect icon at any resolution.

You need more than one bitmap only if you want to have different aspect icon for different Device scale-factor: if you need only to resize your icon you must define only one MultiResBitmapItem with 16x16 bitmap size: at run-time the icon is built at the correct resolution needed by the Image at any scale factor.

Implicit Methods:

Image Editor

Actually there isn't a specific component editor: to define the IconFontImage properties: you must use the object inspector and the Structure Editor to define the TIconFontFixedMultiResBitmap and the TIconFontFixedBitmapItem items. Don't use MultiResBitmap editor to create your bitmap, because your icons are not loaded from files but generated by font.

See how it work with the Demo for TIconFontImageFMX

Clone this wiki locally