TcxCustomImage Class

The base class for unbound and data-aware image editors.

Declaration

TcxCustomImage = class(
    TcxCustomEdit,
    IdxScrollingControl,
    IdxZoomClient,
    IcxTrackBar
)

Remarks

An image editor is designed to store and display an image. Unbound and data-aware image editors allow users to invoke a context menu to manage images.

VCL Editors Library: An Image Editor Example

Image editors can use different TGraphic class descendants as image containers. You can use Properties.GraphicClass and Properties.GraphicClassName properties to switch between image container types.

Supported Image Formats

Device-independent bitmap (BMP or DIB)
Graphics Interchange Format (GIF) with support for animation
Joint Photographic Experts Group (JPG, JPEG, etc.)
Portable Network Graphics (PNG)
Tagged Image File Formats (TIFF)
Scalable Vector Graphics (SVG)
Windows Metafiles (EMF and WMF)
Icons (ICO)

Main API Members

The list below outlines key members of the TcxCustomImage class that allow you to load and save images as well as configure image editor settings.

Customize editor settings (Properties).
Assign a repository item as an external source of image editor settings (RepositoryItem).
Identify active image editor settings (ActiveProperties).
Specify if the image editor uses its parent color to fill the background area when no image is displayed (ParentColor).
Configure GIF animation settings (AnimationOptions).
Switch between supported clipboard image formats (ClipboardFormat).
Perform clipboard operations (CopyToClipboard, CutToClipboard, and PasteFromClipboard).
Invoke Open and Save As dialogs for the image editor (LoadFromFile and SaveToFile).
Access the image container, configure its settings, and manage the stored image (Picture).
Zoom the displayed image in or out and customize zoom-related settings (ZoomingOptions).
Disable or enable the image editor (Enabled).
Specify if the editor is transparent in GDI render mode (Transparent).
Configure look & feel and base editor appearance settings (Style).
Define individual appearance settings for different editor states (StyleDisabled, StyleFocused, and StyleHot).
Resize editor dimensions (Width and Height).
Access individual styles applied to the image editor (Styles).