转 cxgrid属性说明
TCXGRID控件:
属性:
ActiveLevel: 当前层
BorderStyle: 窗口风格
Color: 颜色
FocusedView: 当前View;
Font: 字体
LevelTabs: 类似PageControls头设置
CaptionAlgnment:标题对齐方式
Images:图标
Style:风格
Levels:
RootLevelOptions:层选项
DetailTabsPosition: 类似PageControls头显示位置;
TabsForEmptyDetails: 如果数据为空是否显示Tabs
TcxGridLevel组件:
属性：
Active: 读写激活该层;
Controls: 读写指向TCXGrid;
CanBeVisible: 读取是否能设置可见;
Count: 读取子层个数;
Displaycaption: 读取层标题；
IsMaster: 读取是否cxgrid的最上层;
Items: 读取层组，例: Items[0]访问第一个层;
Level: 读取层级数;
VisibleCount: 读取可见层个数
VisibleIndex: 读取可见索引个数
VisibleItems: 读取可见层组，例：VisibleItems[0]访问第一个可见层
Caption: 读写层标题；
GridView: 指定或读取该层的Grid显示;
ImageIndex: 读写图标索引
Options: TcxGridLevelOptions选项
DetailFrameColor: 读或写明细表格颜色
DetailFramWidth: 读或写明细表格
DetailTabsPosition: 读或写Tab位置,类似PageControlsTabs
Styles: 样式
Tab: 读或设置tab样式
tabsBackground: 读或设置tab背景样式
Visible: 读或设置是否可见
方法：
Add: 增加一个Level;
Levels[i].Add:增加一个子Level;
TcxGridDBBandedTableView组件:
属性：
BackGroundBitmaps:背景图片选项
Background:背景图
Bandbackground:带背景图
Bankheader:带头背景
Content:细节区背景
filterBox:过滤区背景
footer:注脚背景
group: 组背景
header:列头背景
preview:预览区背景
Bands:带列表
DataController: 数据控制
DataSource:数据源
DetailKeyFieldNames:主从表时设置细表键字段名
KeyFieldNames: 主从表时设置关键字段名
MasterKeyFieldNames:主从表时设置主表键字段名
Summary:合计组
FooterSummaryItems:注脚定义
FooterSummaryItems:组脚定义
FilterBox:过滤框
CustomizeDialog:是否自定义过滤条件
Position:过滤框显示位置
Visible:显示过滤框
NavigatorButtons:导航条设置
Append:增加按钮设置
Enabled:是否禁用该按钮
Visible:是否显示该按钮
ImageIndex:图标ID
Cancel:取消按钮设置,具体设置同Append;
ConfirmDelete:删除时是否确认提示
Delete: 具体设置同Append;
Edit: 具体设置同Append;
First: 具体设置同Append;
Insert: 具体设置同Append;
Last: 具体设置同Append;
Next: 具体设置同Append;
Filter: 具体设置同Append;
GotoBookmark: 具体设置同Append;
NextPage: 具体设置同Append;
Post: 具体设置同Append;
Prior: 具体设置同Append;
PriorPage: 具体设置同Append;
Refresh: 具体设置同Append;
SaveBookmark: 具体设置同Append;
OptionsBehavior:行为选项
AlwaysShowEditor:是否总是显示编辑条
BandHeaderHints:带头是否显示提示
CellHints:单元格是否显示提示
ColumnHeaderHints:列头是否显示提示
CopyCaptionsToClipboard:是否允许复制标题到剪贴板
CopyPreviewToClipboard:是否允许复制预览内容到剪贴板
ExpandMasterRowOnDblClik:是否允许双击行显示明细
FocusFirstCellOnNewRecord:新增记录时是否焦点指向第一列单元格
GoToNextCellOnEnter:按回车是否自动跳到下一单元格
NavigatorHints:是否显示导航条提示
OptionsCustomize:自定义选项
BandHiding:是否显示带
BandMoving:是否允许拖动带
ColumnFiltering:是否允许列过滤
ColumnGrouping:是否允许列分组
ColumnHiding:列头是否隐藏
ColumnHorzSizing:是否允许调整列宽度
ColumnMoving:是否允许列拖动
ColumnSorting:是否允许列排序
ColumnVertSizing:是否允许调整列高度
DataRowSizing:是否允许调整数据行高度
GroupBySorting:是否允许组排序
GroupRowSizing:是否允许调整组行高度
OptionData: 允许数据操作
Appending: 是否允许增加
CancelOnExit: 退出时是否自动取消修改
Deleting: 是否允许删除
DeletingConfirmation: 删除是否提示
Editing :是否允许编辑
Inserting: 是否允许插入
OptionsSelection: 单元格操作
CellMultiSelect:是否允许选择多单元格
CellSelect: 进入单元格是否选择
InvertSelect: 是否允许转换选择
MultiSelect: 是否允许多行选择
HideFocusRectOnExit: 移开是否隐藏焦点
UnselectFocusedRecordOnExit:移开是否允许取消焦点
OptionsView:表格选项
BandCaptionsInColumnAlternateCaption:是否允许在列里修改带标题
BandHeaderHeight: 带头高度
BandHeaderLineCount: 带头显示行数
BandHeaders: 是否显示带头
CellAutoHeight:单元格是否自动高度
CellTextMaxLineCount: 单元格文本最大行数
ColumnAutoWidth: 列是否自动宽度
DataRowHeight: 数据行高度
Footer:是否允许显示注脚
FooterAutoHeight: 注脚是否自动适应高度
FooterMultiSummaries:是否允许多注脚
GridLineColor:表格行线颜色
GridLines:显示表格行线类型
GroupByBox:是否允许拖动列到分组区进行分组
GroupFooters:显示组脚类型
Header:是否显示列头
HeaderAutoHeight:列头是否自动适应高度
HeaderHeight: 列头高度
IndicatorWidth:是否显示左边指示条
IndicatorWidth: 指示条宽度
Navigator: 是否显示导航条
NavigatorOffSet: 导航条偏移位置
ShowColumnFilterButtons: 是否显示列过滤按钮
ShowEditButtons: 是否显示编辑按钮
Preview:预览选项
AutoHeight:是否自动适应高度
Column:要预览的列，只能选一列
LeftIndent: 左缩进点数
MaxLineCount:最大显示行数
RightIndent:右缩进点数
Visible: 预览是否可见
PopupMenu:弹出菜单
Styles:样式或风格组
BackGround:背景风格
Content:明细风格
Footer:注脚风格
Group:组风格
GroupSummary:组合计区风格
Header:头风格
Indicator:指示区风格
Preview:预览区风格
Selection:选择区风格
StyleSheet:风格组，选中后自动设置各区风格
方法或函数：
CreateColumn:
参数：无；
功能：新建一列;
返回：返回列类型结果;
GetColumnByFieldName：
参数：字段名串；
功能：取得指定字段列;
返回：返回列类型结果;
例：MyTV.GetColumnByFieldName('First').Visible := False;
CleaarItems:
参数：无；
功能：清除全部显示列;
返回：无
CreateItem:
参数：无；
功能：建一显示列;
返回：列类型值
StoreToIniFile:导出布局到Ini文件
StoreToRegistry:导出布局到注册表
StoreToStream:导出布局到流体
RestoreFromIniFile: 从Ini文件恢复布局
RestoreFromRegistry:从注册表恢复布局
RestoreFromStream:从流体恢复布局
FindItemByID:根据ID号查找列
FindItemByName:根据列名查找列
FindItemByTag:根据Tag查找列
IndexofItem:返回列的序号
CreateViewInfo:建表格
TCXGRID用法指南
假设已设定以下变量
MycxGrid: TcxGrid;
MycxGridLevel: TcxGridLevel;
MyTV: TcxGridDBTableView;
MyDataSource: TDataSource;
方法：
一、 建层和层视图
MycxGrid := TcxGrid.Create(self);
MycxGridLevel := MycxGrid.Levels.Add; //建层
MyTV:= TcxGridDBTableView(MycxGrid.createview(TcxGridDBTableView));//建视图
MycxGridLevel.Control := MycxGrid;//指定关系
MycxGridLevel.GridView := MyTV;//指定视图
TcxGridDataController(GetDetailDataController(FocusedRecordIndex, 0)).GridView;//得到下层视图
二、设定表格位置和大小
MycxGrid.ParentWindow := self.Handle;
MycxGrid.Top := 0;
MycxGrid.Height := 200;
MycxGrid.Width := 400;
MyTV.Preview.visible := true;
三、 设定数据源及分配全部字段
MyTV.DataController.DataSource := MyDataSource;
MyTV.DataController.DeleteAllItems; //清除全部字段
MyTV.DataController.CreateAllItems; //建全部显示字段
四、 动态增加显示列及列访问
var
iIndex: integer;
vCol: TcxGridDBColumn;
vImgCom: TcxImageComboBoxItem;
i,j: integer;
for i:= 0 to Mydatasource.dataset.FieldCount -1 do
begin
vCol := MyTV.CreateColumn;
vCol.DataBinding.FieldName:=Mydatasource.dataset.Fields[i].FieldName;
if (i = 1) then
begin
vCol.PropertiesClassName := 'TcxImageComboBoxProperties'; ////分区分大小写
vCol.DataBinding.ValueType := 'String';
for j := 0 to 5 do
begin
vImgCom:=TcxImageComboBoxProperties(vCol.Properties).Items.Add;
vImgCom.Description := IntToStr(j);
vImgCom.Value := IntToStr(j);
end;
end;
end;
showmessage(MyTV.Columns[0].Caption);//列标题访问
showmessage(MyTV.Columns[0].DataBinding.FieldName);//列字段名访问
MyTV.Columns[0].SortIndex := 0;
MyTV.Columns[0].SortOrder := soAscending; //列升序排序
MyTV.Columns[0].SortIndex := -1;
MyTV.Columns[0].SortOrder := soNone; //取消列排序
MyTV.DataController.Search.Locate(MyTV.GetColumnByFieldName(FieldName).Index, 查找值);// 列值搜索
MyTV.DataController.FocusedRowIndex := MyTV.DataController.FocusedRowIndex - 1;//记录回翻,即Prior;
DBView.DataController.FocusedRowIndex := DBView.DataController.FocusedRowIndex + 1; //记录后翻,即Next;
Aa:=MyTV.datacontroller.values[1,1] ;// 访问第二行第二列的值
MyTV.Columns[0].DataBinding.ValueTypeClass := TcxStringValueType;//设置列字段类型,
其他如整型[TcxIntegerValueType],浮点型[TcxFloatValueType];
//设置列风格:
MyFirstColumnStyle := TcxStyle.Create(Self);
MyFirstColumnStyle.Color := clAqua;
MyFirstColumnStyle.TextColor := clBlue;
MyTV.Columns[1].Styles.Content := MyFirstColumnStyle;
//设置列下拉框选择列表及类型
var
A:TDataSource:
B:TcxlookupcomboboxProperties;
begin
A:=TDataSource.create(self);
B:=tcxlookupcomboboxproperties.create(self);
A.Dataset:=Dic_ry_xb;//此处指定数据源。
B.listdource:=A;//此处指明字段的listsource属性。
B.keyfieldnames:='a'; //此处指明字段的关键字段
B.listfieldnames:='b'; //此处指明字段的返回值。
B.listcolumns.items[0].caption:='x’; //此处默认是会建立一个字段，但是显示的表头是name，所以此处让它显示为自己想要的中午显示。
MYTVc1_sex_code.Properties:=B; //此处指明是那个字段。
end;
五、 设置列外观
MyTV.OptionsView.ColumnAutoWidth := true //列自动宽度
MyTV.OptionsView.CellAutoHeight := true //单元自动高度
MyTV.OptionsView.Footer := true //表格合计行显示
MyTV.OptionsView.Header := true // 表格头显示
MyTV.OptionsView.Indicator := true //显示指示条
MyTV.OptionsView.GroupByBox:=true //显示分组框
MyTV.Preview := True //显示预览区
六、 设置表格样式
var MyStyleSheet:TcxGridTableViewStyleSheet;
MyStyle :TcxStyle;
begin
MyStyleSheet := TcxGridTableViewStyleSheet.Create();
MyStyle := TcxStyle.Create(self);
MyStyle.Color := clBlack;
MyStyle.TextColor := clWrite;
MyTV.Styles.Background := MyStyle; //设置背景样式
MyStyleSheet.AddStyles(MyStyle);//分配样式
cxStyleRepository.CreateStyleSheet(MyStyleSheet);
MyTV.Styles.StyleSheet := cxStyleRepository; //分配样式
End;
七、 设置Preview列
前提条件是设置footer=true;
MyTV.Preview.column := MyTVField1;//设置预览列
MyTV.Preview.MaxLineCount := 4;//设置预览列最大显示行数
MyTV.Preview.LeftIndent :=150; //显示左缩进
MyTV.Preview.RightIndent :=150;//显示右缩进
八、 Footer设置
Var ASummary: TcxDataSummary;
MyFooterItems :TcxDataFooterSummaryItems;
Acolumn :TcxGridDBColumn;
ASummary := MyTV.DataController.Summary; //提取Footer;
MyFooterItems := ASummary.FooterSummaryItems; //提取FooterItems;
//增加FooterItems
With TcxGridDBTaleSummaryItem(MyFooterItems.add) do
Begin
try
Try
Beginupdate;
Column := TcxGridDBColumn(MyTV.VisibleColumns[0]; //Footer显示列位置
AColumn := TcxGridDBColumn(MyTV.VisibleColumns[0];
If assigned(AColumn) then
FieldName := AColumn.dataBinding.FieldName; //Footer计算字段
Kind := TcxSummaryKind(skSum);
//skNone=无.skSum=合计;skMax=取最大值,
//skCount=//记录数,skAverage=平均数
Finally
Endupdate;
End;
Except
Showmessage(‘error’);
MyFooterItems.Items[MyFooterItems.Count-1].Free;//报错释放刚加入的
End;
End;
//删除FooterItems
MyFooterItems := TcxGridDBTableSummaryItem(MyFooterItems[0]);
If MyFooterItems.FieldByName<>’’ then
For i:= 0 to MyTV.VisibleColumnCount -1 do
Begin
AColumn := TcxGridDBColumn(MyTV.VisibleColumns[i]);
If AColumn.DataBinding.FieldName = MyFooterItems.FieldName then
Break;
End;
If Assigned(MyFooterItems.Column) then
MyFooterItems.Items[0].Free;
九、 建Band
Var MyBand : TcxGridBand;
MyBandViewInfo: TcxGridbandViewInfo;
MyBand := MyTV.Bands.Add;
MyBand.Caption : =’新建带’;
MyBandViewInfo:= MyTV.ViewInfo.HeaderViewInfo.BandsViewInfo[MyBand.visibleIndex];
MyTV.Controller.LeftPos := MyBandViewInfo.Bounds.right;
十、 主从表明细嵌套关联设置
MyTV.DetailKeyFieldNames := mastered; //主表关键列
MyTV.KeyFieldNames := ID; //子表对应关键列
MasterKeyFieldNames := ID;//子表自己的关键列
子表ADOQUERY的indexFieldNames := mastered;
十一、组设置
MyTV.DataController.Groups.FullExpand;//组展开
MyTV.DataController.Groups.Collapse;//组收缩
十二、记录操作
MyTV.Datacontroller.Append;//增加记录
MyTV.Datacontroller.Insert;//插入记录
MyTV.Datacontroller.Values[0.1]:=’a’;//单元格赋值
MyTV.Datacontroller.Cancel;//取消修改
MyTV.Datacontroller.Post;//提交保存
MyTV.Datacontroller.DeleteFocused;//删除当前记录
MyTV.Controller.Controller.FocusedRow.IsFirst ;//是否第一行
MyTV.Controller.Controller.FocusedRow.IsLast ;//是否最后行
MyTV.DataController.Options.FocusTopRowAfterSorting :=True;//排序后指向第一行
MyTV.ViewInfo.VisibleRecordCount ;可见行数
