TdxSmartGlyph Class

A DPI-aware universal image container that can load an image from a DFM file.

Declaration

TdxSmartGlyph = class(
    TdxSmartImage,
    IdxSourceDPI,
    IdxSourceSize
)

Remarks

The TdxSmartGlyph class implements a DPI-aware image container with support for the following 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 Format (TIFF)
Scalable Vector Graphics (SVG)

All DevExpress controls that display bitmap and vector images as UI icons and pictures use a TdxSmartGlyph class instance as an image container.

Main API Members

The list below outlines key members of the TdxSmartGlyph class that allow you to load and manage images in all supported formats.

Create an image container filled with a solid color (CreateSize).
Create an image container from different sources (CreateFromBitmap, CreateFromHBitmap, CreateFromBits, and CreateFromStream).
Replace the stored image with content of another image container (Assign, AssignFromGraphic, and AssignFromSmartImage).
Check if the content of two image containers is identical (Compare).
Load an image to an existing image container (LoadFromBits, LoadFromFieldValue, LoadFromResource, and LoadFromStream).
Copy image data between the image container and the clipboard (CopyToClipboard, CutToClipboard, and PasteFromClipboard).
Identify stored image dimensions (ClientRect and Size).
Scale the stored image (Resize and Scale).
Convert the stored image to any supported format (ImageCodec).
Identify if the stored image has transparent pixels (IsAlphaUsed).
Suspend and restore the image container to optimize GDI resource usage (Dormant and HandleNeeded).
Save the stored image to a file or stream (SaveToStream, SaveToStreamByCodec, and SaveToFile).
Calculate a CRC32 hash code from stored image data (GetHashCode).
Rasterize the stored vector image (ConvertToBitmap).
Obtain the stored image as a TBitmap container (GetAsBitmap).
Fill the stored image with a solid color (ChangeColor).
Obtain the stored image as an array of pixel color values (GetBitmapBits).
Copy the image container (Clone).
Flip the stored image horizontally or vertically (Flip).
Blend images from two image containers (MakeComposition).
Draw the stored image (CreateCanvas and StretchDraw).
Specify the target monitor DPI for the stored image (SourceDPI).
Specify container pixel dimensions regardless of the stored image size (SourceWidth and SourceHeight).

Direct TdxSmartGlyph Class References

The following list groups public API members that reference a TdxSmartGlyph object by DevExpress product.

ExpressQuantumGrid

TcxCustomGridColumn.HeaderGlyph: Specifies the column header‘s icon.

ExpressEditors

TcxButtonImageOptions.Glyph: Specifies the image(s) to be displayed by a button.
TcxCustomButton.Glyph: Specifies the image displayed within a button.
TcxCustomCheckBoxProperties.Glyph: Provides custom images for check boxes.
TcxCustomCheckComboBoxProperties.Glyph: Provides custom images for check boxes.
TcxCustomCheckGroupProperties.Glyph: Provides custom images for check boxes.
TcxCustomCheckListBox.Glyph: Provides custom images for check boxes.
TcxCustomDropDownEditProperties.ButtonGlyph: Specifies the custom glyph for the drop-down button.
TcxCustomEditButton.Glyph: Specifies the custom glyph for the editor button.
TcxCustomLabelProperties.Glyph: Specifies the image used to draw the label’s caption.
TdxCustomRatingControlProperties.CheckedGlyph: Specifies an image depicting a checked element within the rating control.
TdxCustomRatingControlProperties.Glyph: Specifies an image depicting an unchecked element within the rating control.
TdxCustomRatingControlProperties.HoverGlyph: Specifies an image depicting a hot-tracked element within the rating control.
TdxToggleSwitchStateIndicator.OffGlyph: Specifies the image for the unchecked state (also called the Off state).
TdxToggleSwitchStateIndicator.OnGlyph: Specifies the image for the checked state (also called the On state).
TdxTokenEditToken.Glyph: Specifies the image associated with the token.
TdxBadgeBackground.Glyph: Specifies the image used as the badge UI adorner‘s background.
TdxGuideViewInfo.BorderGlyph: Returns the bitmap mask used to paint the guide UI adorner‘s outlines.
dxBadgeDefaultGlyph: Returns a Smart Glyph containing the default glyph for badge UI adorners.
dxGuideNormalBorderGlyph: Returns a Smart Glyph containing the bitmap mask for the normal guide UI adorner borders.
dxGuideSelectedBorderGlyph: Returns a Smart Glyph containing the bitmap mask for the borders of the selected guide UI adorner.
TdxWheelPickerItem.Glyph: Specifies the image to be displayed by the wheel item.

ExpressBars

TdxBarManager.HelpButtonGlyph: Specifies a bitmap which appears on the Help button in the Customization Form.
TdxBar.Glyph: Specifies the icon that is displayed within a collapsed Ribbon tab group bound to the current toolbar.
TdxBarItem.Glyph: Specifies the glyph that is displayed when this item’s link represents a standard size (16 by 16 pixels) item control.
TdxBarItem.LargeGlyph: Specifies the glyph that is displayed when this item’s link represents a large button, enlarged standard size button, or large size menu item.
TdxBarItemControl.Glyph: Returns the item control’s glyph.
TdxBarItemLink.Glyph: Provides access to the glyph of the item control, which corresponds to the current item link.
TdxBarItemLink.UserGlyph: Specifies a user-defined glyph.
TdxBarLargeButton.HotGlyph: Specifies the glyph that is drawn on the button when the button is selected.
TdxBarLargeButtonControl.HotGlyph: Returns the hot image associated with an item.
TdxOfficeSearchBoxProperties.Glyph: Specifies a glyph for the search box.
TdxRibbonCustomButtonPersistent.Glyph: Specifies the button’s glyph.
TdxRibbonBackstageViewTabSheet.Glyph: Specifies a glyph for a tab.
TdxRibbonGalleryGroupItem.Glyph: Specifies an explanatory image for a gallery item.
TdxRibbonGalleryGroupItem.GlyphInDropDown
TdxRibbonCustomRadialMenu.Glyph: Specifies the icon for the radial menu’s central button.
TdxCustomRibbon.BackgroundImage: Specifies the background image for the Ribbon tab area and the Ribbon Form’s non-client area painted using the Ribbon.

ExpressLibrary

TdxCustomGalleryItem.Glyph: Specifies the glyph displayed.
TdxCustomScreenTipBand.Glyph: Specifies the explanatory image for the ScreenTip section.