cxgrid属性说明

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 ;可见行数