TdxGalleryControl Class
A gallery control.
Declaration
TdxGalleryControl = class(
TdxCustomGalleryControl,
IcxCustomCanvasSupport
)Remarks
A gallery control is designed to display a set of items arranged into groups and columns. Individual gallery items can display text and/or image. Users can navigate and select gallery items.
UI Automation/Accessibility Support
The gallery control is mapped to a node in the UI Automation tree when the global UI Automation flag (dxUIAutomationEnabled) is enabled.
UI Automation Settings
Use Automation.Name and Automation.Description properties to specify the gallery name and add optional information that are then used to clarify UI element purpose for users who rely on third-party assistive tools (such as Microsoft Narrator).
Refer to the TdxAutomationElementSettings class description for detailed information on all available options.
Main API Members
The list below outlines key members of the TdxGalleryControl class.
Appearance Settings
- BorderStyle
- Specifies if the gallery control displays a border.
- Font
- Provides access to font settings.
- OptionsView
- Provides access to content appearance settings.
User Interaction Options
- Automation
Provides access to UI Automation and accessibility-related settings.
Tip
Use Automation.Name and Automation.Description, and other API members to specify information visible to third-party assistive tools as UIA node properties.
- Controller
- Provides access to drag-and-drop operation controller.
- OnItemClick
- Allows you to execute custom code in response to clicks on gallery items.
- OptionsBehavior
- Provides access to general user interaction settings.
Content-Related APIs
- Gallery
- Allows you to create and manage gallery groups and items.
- Images
- Specifies a source image list for gallery items.
- MakeItemVisible
- Scrolls gallery content to display the target gallery item.
General-Purpose API Members
- AutoSizeMode
- Allows you to switch between available gallery size calculation modes.
- BeginUpdate | EndUpdate
- Allow you to avoid excessive redraw operations during batch content and setting changes.
- Visible
- Specifies if the gallery control is visible.
- Width | Height
- Specify gallery control dimensions.
Related Compiled Demo
To see the TdxGalleryControl component in action, run the Data Editors and Controls demo in the VCL Demo Center installed with compiled DevExpress VCL demos. Click the Gallery Control item in the sidebar to run the corresponding demo.
Compiled DevExpress demos ship with source code installed in the Public Documents folder (%PUBLIC%) for all users (default). You can find all project and source code files for the Data Editors and Controls demo in the following folder:
%PUBLIC%\Documents\DevExpress VCL Demos\MegaDemos\Product Demos\ExpressEditors\
Tip
Project and source code files for all compiled DevExpress VCL Demos are maintained in a public repository hosted on GitHub:
Other Gallery Components
- TdxColorGallery
- An unbound color gallery component.
- TdxDBColorGallery
- A data-aware color gallery control.
- TdxRibbonBackstageViewGalleryControl
- A Ribbon Backstage View gallery.