DevExpress中文说明--TdxGalleryControl Object（画廊式组件）

TdxGalleryControl Object

Concepts   Hierarchy   Properties   Methods   Events

一个画廊式控件

Unit dxGalleryControl

Syntax

TdxGalleryControl = class(TdxCustomGalleryControl)

Description

这是一个画廊式的控件，您可以用来呈现一些图片，像一个画廊一样分类；您也可以作为一个菜单来用。

如图所示：

TdxGalleryControl Properties

TdxGalleryControl  

In TdxGalleryControl    

AutoSizeMode      是否启用自动大小模式

BorderStyle    四周边框的风格

Derived from TdxCustomGalleryControl      

ColumnCount      列数

ContentOffset      内容的位移值

ContentOffsetGroups    组的位移值  

ContentOffsetItems      内容项的位移值　

Gallery      画廊：双击可进行可视行编辑

Images      关联的图片列表

ItemCheckMode      是否启用单选框

ItemImageSize      项的图片大小

ItemShowHint      项是否显示提示

ItemShowImageFrame      项是否显示图片边框

ItemTextPosition       项的文本位置

OptionsBehavior   行为选项  

OptionsView         视图查看选项

TdxGalleryControl.AutoSizeMode

TdxGalleryControl

是否用画廊的自动大小模式

Syntax

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

Description

该属性有以下选项：

Value	Description
asAutoHeight	指定是否自动调整画廊的高度以完全垂直显示其内容。如果画廊的OptionsView.ColumnCount属性设置为0，则画廊的高度将根据画廊控件的设置宽度自动调整。
asAutoSize	是否自动调整大小以显示其全部内容。
asAutoWidth	画廊的宽度是否自动调整以完全水平显示其内容。
asNone	画廊的大小不会自动调整，也不会按指定的宽度和高度。将显示一个垂直滚动条，内容比较多的时候。

下图演示了此属性对控件外观的影响。

AutoSizeMode = asNone	AutoSizeMode = asAutoWidth

该属性的默认值为 asNone.

TdxCustomGalleryControl.Gallery

TdxCustomGalleryControl

一个可视行编辑，用了编辑那些组和项显示在画廊里面

Syntax

property Gallery: TdxGalleryControlStructure;

Description

在设计时，属性提供一个直观的设计器窗口。您可以使用以下方法调用此设计器窗口:

• 双击在窗体上的TdxGalleryControl组件;

• 在TdxGalleryControl组件的右击快捷菜单中选择Edit…;

• 在对象属性编辑器中，单击Gallery属性旁边的省略号按钮。

下图显示了加入示例组和项目的设计器窗口。

您可以在设计器窗口中选择多个项目和/或组，同时按住Ctrl或Shift键。此外，您还可以在按住Ctrl键的同时通过拖放复制选定的项/组。

TdxGalleryControlOptionsBehavior Properties

TdxGalleryControlOptionsBehavior   Legend

In TdxGalleryControlOptionsBehavior    

ItemCheckMode      项的单选框的模式

ItemMultiSelectKind     项是否允许多选

ItemShowHint     项是否允许显示提示信息

TdxGalleryControlOptionsView Properties

TdxGalleryControlOptionsView   Legend

In TdxGalleryControlOptionsView      

ColumnAutoWidth    列是否自动宽度  

ColumnCount       列数

ContentOffset      内容的位移

ContentOffsetGroups      内容的组位移

ContentOffsetItems      内容的项位移

Item

 

TdxGalleryControlOptionsView.ColumnCount

指定列的数目

property ColumnCount: Integer;

Description

下图演示不同列数的效果

ColumnCount = 4	ColumnCount = 6

TdxGalleryControlOptionsView.ContentOffset

TdxGalleryControlOptionsView

指定画廊的间隙

Syntax

property ContentOffset: TcxMargin;

Description

此属性设置控件边界和内容之间的距离。

下图显示了设置ContentOffset时控件的外观如何变化，其中 ContentOffset.Top （顶部）设置为20。

Defaul ContentOffset	ContentOffset.Top = 20

所有的默认间隙（ContentOffset.All）属性值为 1.

TdxGalleryControlOptionsView.ContentOffsetGroups

TdxGalleryControlOptionsView

组内部的间隙值

Syntax

property ContentOffsetGroups: TcxMargin;

Description

此属性为组的内部间隙。

下图显示了设置ContentOffsetGroups时控件的外观是如何变化的，我们设置了ContentOffsetGroups.Bottom 为10。

Default ContentOffsetGroups	ContentOffsetGroups.Bottom = 10

所有的组间隙的默认值为 0.

TdxGalleryControlOptionsView.ContentOffsetItems

TdxGalleryControlOptionsView

项与项之间的间隙；

property ContentOffsetItems: TcxMargin;

Description

此属性为项之间的间隙。

下图显示了设置ContentOffsetItems时控件的外观如何变化，我们设置ContentOffsetItems.Left （项的左间隙）为30。

Default ContentOffsetItems	ContentOffsetItems.Left = 30

项的间隙值默认都是　6.

TdxGalleryControl Events（事件）

TdxGalleryControl   Legend

Derived from TdxCustomGalleryControl      

OnItemClick  点击项的事件