Devaxpress Chinese description -- tdxgallerycontrol object (gallery component)

TdxGalleryControl Object

Concepts   Hierarchy   Properties   Methods   Events

A gallery control

Unit dxGalleryControl

Syntax

TdxGalleryControl = class(TdxCustomGalleryControl)

Description

This is a gallery style control , You can use it to present some pictures , Sort like a gallery ; You can also use it as a menu .

As shown in the figure ：

TdxGalleryControl Properties

TdxGalleryControl  

In TdxGalleryControl    

AutoSizeMode       Whether to enable auto size mode

BorderStyle     The style of the surrounding border

Derived from TdxCustomGalleryControl      

ColumnCount       Number of columns

ContentOffset       Displacement value of content

ContentOffsetGroups     The displacement value of the group  

ContentOffsetItems       Displacement value of content item 　

Gallery       Gallery ： Double click to edit the visual line

Images       List of associated pictures

ItemCheckMode       Whether to enable the radio box

ItemImageSize       The picture size of the item

ItemShowHint       Whether the item displays a prompt

ItemShowImageFrame       Whether the item displays a picture border

ItemTextPosition       The text position of the item

OptionsBehavior   Behavior options  

OptionsView         View view options

TdxGalleryControl.AutoSizeMode

TdxGalleryControl

Whether to use the automatic size mode of the gallery

Syntax

type  TdxAutoSizeMode = (asNone, asAutoWidth, asAutoHeight, asAutoSize);property AutoSizeMode: TdxAutoSizeMode;

Description

This attribute has the following options ：

Value	Description
asAutoHeight	Specifies whether to automatically adjust the height of the gallery to display its contents completely vertically . If the gallery OptionsView.ColumnCount Property is set to 0, The height of the gallery will be automatically adjusted according to the width of the gallery control .
asAutoSize	Whether to automatically resize to display its entire contents .
asAutoWidth	Whether the width of the gallery is automatically adjusted to display its contents completely horizontally .
asNone	The size of the gallery does not automatically adjust , It will not be in accordance with the specified width and height . A vertical scroll bar will be displayed , When there's a lot of content .

The following figure illustrates the effect of this property on the appearance of the control .

AutoSizeMode = asNone	AutoSizeMode = asAutoWidth

The default value for this property is  asNone.

TdxCustomGalleryControl.Gallery

TdxCustomGalleryControl

A visual line editor , Used to edit those groups and items displayed in the gallery

Syntax

property Gallery: TdxGalleryControlStructure;

Description

In design , Property provides an intuitive designer window . You can call this designer window using the following methods :

• Double click... On the form TdxGalleryControl Components ;

• stay TdxGalleryControl Select... From the right-click shortcut menu of the component Edit…;

• In the object attribute editor , single click Gallery The ellipsis button next to the property .

The following figure shows the designer window for joining sample groups and projects .

You can select multiple windows in the designer / Or group , Press and hold at the same time Ctrl or Shift key . Besides , You can also press and hold Ctrl Key and drag and drop to copy the selected item / Group .

TdxGalleryControlOptionsBehavior Properties

TdxGalleryControlOptionsBehavior   Legend

In TdxGalleryControlOptionsBehavior    

ItemCheckMode       The mode of the item's radio box

ItemMultiSelectKind     Whether multiple selections are allowed

ItemShowHint     Whether the item allows prompt information to be displayed

TdxGalleryControlOptionsView Properties

TdxGalleryControlOptionsView   Legend

In TdxGalleryControlOptionsView      

ColumnAutoWidth     Whether the column width is automatically  

ColumnCount       Number of columns

ContentOffset       Displacement of content

ContentOffsetGroups       Group displacement of content

ContentOffsetItems       Item displacement of content

Item

 

TdxGalleryControlOptionsView.ColumnCount

Specify the number of columns

property ColumnCount: Integer;

Description

The following figure shows the effect of different column numbers

ColumnCount = 4	ColumnCount = 6

TdxGalleryControlOptionsView.ContentOffset

TdxGalleryControlOptionsView

Specify the gap of the gallery

Syntax

property ContentOffset: TcxMargin;

Description

This property sets the distance between the control boundary and the content .

The following figure shows the settings ContentOffset How the appearance of the control changes , among  ContentOffset.Top （ Top ） Set to 20.

Defaul ContentOffset	ContentOffset.Top = 20

All default gaps （ContentOffset.All） The property value is  1.

TdxGalleryControlOptionsView.ContentOffsetGroups

TdxGalleryControlOptionsView

Gap value inside the group

Syntax

property ContentOffsetGroups: TcxMargin;

Description

This attribute is the internal gap of the group .

The following figure shows the settings ContentOffsetGroups How the appearance of the control changes , We set it up ContentOffsetGroups.Bottom  by 10.

Default ContentOffsetGroups	ContentOffsetGroups.Bottom = 10

The default value for all group gaps is  0.

TdxGalleryControlOptionsView.ContentOffsetItems

TdxGalleryControlOptionsView

The gap between items ;

property ContentOffsetItems: TcxMargin;

Description

This property is the gap between items .

The following figure shows the settings ContentOffsetItems How the appearance of the control changes , We set up ContentOffsetItems.Left （ Left gap of item ） by 30.

Default ContentOffsetItems	ContentOffsetItems.Left = 30

By default, the gap values of items are 　6.

TdxGalleryControl Events（ event ）

TdxGalleryControl   Legend

Derived from TdxCustomGalleryControl      

OnItemClick   Click on the event