wxWidgets之wxGrid控件

1. 介绍

    wxGrid控件时wxWidgets界面库中内置的网格控件。通常用来显示表格数据。该控件拥有强大的功能,开发者可根据自己的需求对其进行定制。

2. 常用API     
     构造函数:
        wxGrid ()
        wxGrid (wxWindow *parent, wxWindowID id, const wxPoint &pos=wxDefaultPosition, const wxSize &size=wxDefaultSize, long style=wxWANTS_CHARS, const wxString &name=wxGridNameStr)       
             
     创建表格的API:
        // 创建一个空的表格
        bool Create (wxWindow *parent, wxWindowID id, const wxPoint &pos=wxDefaultPosition, const wxSize &size=wxDefaultSize, long style=wxWANTS_CHARS, const wxString &name=wxGridNameStr)
        // 创建一个指定行,制定列的表格
        bool CreateGrid (int numRows, int numCols, wxGridSelectionModes selmode=wxGridSelectCells)
        
     关于大小的API:                 
        // 获取列标签的高度
        int GetColLabelSize () const
        // 获取指定列的宽度
        int GetColSize (int col) const
        // 获取默认的列标签宽度
        int GetDefaultColLabelSize () const
        // 获取默认的列宽
        int GetDefaultColSize () const
        // 获取默认的行标签宽度
        int GetDefaultRowLabelSize () const
        // 获取默认的行高度
        int GetDefaultRowSize () const
        // 获取行标签的宽度
        int GetRowLabelSize () const
        // 获取指定行的高度
        int GetRowSize (int row) const
        // 设置指定列的宽度
        void SetColSize (int col, int width)
        // 设置列标签的高度
        void SetColLabelSize (int height)
        // 设置默认的列宽度
        void SetDefaultColSize (int width, bool resizeExistingCols=false)
        // 设置默认的行高度
        void SetDefaultRowSize (int height, bool resizeExistingRows=false)
        // 设置行标签的宽度
        void SetRowLabelSize (int width)
        // 设置指定行的高度
        void SetRowSize (int row, int height)
        // 获取列的大小信息
        wxGridSizesInfo GetColSizes () const
        // 获取行的大小信息
        wxGridSizesInfo GetRowSizes () const
        // 设置列的大小信息
        void SetColSizes (const wxGridSizesInfo &sizeInfo)
        // 设置行的大小信息
        void SetRowSizes (const wxGridSizesInfo &sizeInfo)
        // 设置指定单元格的大小
        void SetCellSize (int row, int col, int num_rows, int num_cols)
        // 获取指定单元格的大小
        CellSpan GetCellSize (int row, int col, int *num_rows, int *num_cols) const
        // 获取单元格的大小
        wxSize     GetCellSize (const wxGridCellCoords &coords)
        // 判断制定列大小是否可变
        bool CanDragColSize (int col) const
        // 判断表格大小是否可变
        bool CanDragGridSize () const
        // 判断制定行大小是否可变
        bool CanDragRowSize (int row) const
        // 使指定列大小不能改变
        void DisableColResize (int col)
        // 使指定行大小不能改变
        void DisableRowResize (int row)
        // 使列大小不能改变
        void DisableDragColSize ()
        // 使表格大小不能改变
        void DisableDragGridSize ()
        // 使行大小不能改变
        void DisableDragRowSize ()
        void EnableDragColSize (bool enable=true)
        // 设置表格大小是否可变
        void EnableDragGridSize (bool enable=true)
        // 设置行大小是否可变
        void EnableDragRowSize (bool enable=true)
        // 获取列数
        int GetNumberCols () const
        // 获取行数
        int GetNumberRows () const
        
     关于边框的API:
        // 获取指定列的画笔
        virtual wxPen GetColGridLinePen (int col)
        // 获取默认的表格边框的画笔
        virtual wxPen GetDefaultGridLinePen ()
        // 获取表格边框的颜色
        wxColour GetGridLineColour () const
        // 获取行边框的画笔
        virtual wxPen GetRowGridLinePen (int row)
        // 表格是否有边框
        bool GridLinesEnabled () const
        // 设置表格边框的颜色
        void SetGridLineColour (const wxColour &colour)
        
    关于表头的API:    
        // 获取指定列标签(表头)的对其方式
        void GetColLabelAlignment (int *horiz, int *vert) const     
        // 获取指定列标签(表头)的文件的方向
        int GetColLabelTextOrientation () const
        // 获取制定列标签的内容
        wxString GetColLabelValue (int col) const     
        // 获取标签(表头)的背景颜色
        wxColour GetLabelBackgroundColour () const     
        // 获取标签的字体
        wxFont GetLabelFont () const     
        // 获取标签的文字颜色
        wxColour GetLabelTextColour () const     
        // 获取行标签的对齐方式
        void GetRowLabelAlignment (int *horiz, int *vert) const
        // 获取行标签的内容
        wxString GetRowLabelValue (int row) const
        // 隐藏标签
        void HideColLabels ()     
        // 隐藏行标签
        void HideRowLabels ()     
        // 设置列标签的对齐方式
        void SetColLabelAlignment (int horiz, int vert)
        // 设置列标签的文字方向
        void SetColLabelTextOrientation (int textOrientation)
        // 设置列标签的内容
        void SetColLabelValue (int col, const wxString &value)
        // 设置标签的背景颜色
        void SetLabelBackgroundColour (const wxColour &colour)
        // 设置标签的字体
        void SetLabelFont (const wxFont &font)
        // 设置标签的文字颜色
        void SetLabelTextColour (const wxColour &colour)
        // 设置行标签的对齐方式
        void SetRowLabelAlignment (int horiz, int vert)
        // 设置行标签的内容
        void SetRowLabelValue (int row, const wxString &value)
        
    关于表结构的API:
        // 追加列
        bool AppendCols (int numCols=1, bool updateLabels=true)
        // 追加行
        bool AppendRows (int numRows=1, bool updateLabels=true)
        // 删除指定列
        bool DeleteCols (int pos=0, int numCols=1, bool updateLabels=true)     
        // 删除指定行
        bool DeleteRows (int pos=0, int numRows=1, bool updateLabels=true)
        // 插入新列
        bool InsertCols (int pos=0, int numCols=1, bool updateLabels=true)
        // 插入新行
        bool InsertRows (int pos=0, int numRows=1, bool updateLabels=true)
        
    关于选中的API:
        // 清楚选中状态
        void ClearSelection ()
        // 获取选中的单元格
        wxGridCellCoordsArray GetSelectedCells () const
        // 获取选中的列
        wxArrayInt GetSelectedCols () const
        // 获取选中的行
        wxArrayInt     GetSelectedRows () const
        // 获取选中区域的背景颜色
        wxColour GetSelectionBackground () const
        // 获取选中区域的前景色
        wxColour GetSelectionForeground () const
        // 获取选中模式
        wxGridSelectionModes GetSelectionMode () const
        // 判断制定单元格是否被选中
        bool IsInSelection (int row, int col) const
        // 判断是否有选中的单元格
        bool IsSelection () const
        // 选择整个表格
        void SelectAll ()
        // 选择指定的区域
        void SelectBlock (int topRow, int leftCol, int bottomRow, int rightCol, bool addToSelected=false)
        // 选择指定的区域
        void SelectBlock (const wxGridCellCoords &topLeft, const wxGridCellCoords &bottomRight, bool addToSelected=false)
        // 选择制定的列
        void SelectCol (int col, bool addToSelected=false)
        // 选择指定的行
        void SelectRow (int row, bool addToSelected=false)
        // 设置选中后的背景颜色
        void SetSelectionBackground (const wxColour &c)
        // 设置选中后的前景色
        void SetSelectionForeground (const wxColour &c)
        // 设置选中模式
        void SetSelectionMode (wxGridSelectionModes selmode)
        
    关于格式的API:
        // 获取制定单元格的对其方式
        void GetCellAlignment (int row, int col, int *horiz, int *vert) const
        // 获取制定单元格的背景颜色
        wxColour GetCellBackgroundColour (int row, int col) const
        // 获取制定单元格的字体
        wxFont GetCellFont (int row, int col) const
        // 获取制定单元格的文字颜色
        wxColour GetCellTextColour (int row, int col) const
        // 获取指定单元格默认的对齐方式
        void GetDefaultCellAlignment (int *horiz, int *vert) const     
        // 获取单元格默认的背景色
        wxColour GetDefaultCellBackgroundColour () const     
        // 获取单元格默认的字体
        wxFont GetDefaultCellFont () const
        // 获取单元格默认的字体颜色
        wxColour GetDefaultCellTextColour () const
        // 设置指定单元格的对齐方式
        void SetCellAlignment (int row, int col, int horiz, int vert)
        // 设置指定单元格的对齐方式
        void SetCellAlignment (int align, int row, int col)
        // 设置单元格的背景颜色
        void SetCellBackgroundColour (int row, int col, const wxColour &colour)
        // 设置单元格的字体
        void SetCellFont (int row, int col, const wxFont &font)
        // 设置单元格的字体颜色
        void SetCellTextColour (int row, int col, const wxColour &colour)
        // 设置单元格的字体颜色
        void SetCellTextColour (const wxColour &val, int row, int col)
        // 设置单元格字体颜色
        void SetCellTextColour (const wxColour &colour)
        // 设置单元格默认的对齐方式
        void SetDefaultCellAlignment (int horiz, int vert)
        // 设置单元格默认的背景颜色
        void SetDefaultCellBackgroundColour (const wxColour &colour)
        // 设置单元格默认的字体
        void SetDefaultCellFont (const wxFont &font)
        // 设置单元格默认的字体颜色
        void SetDefaultCellTextColour (const wxColour &colour)
        // 使单元格处于只读状态
        void DisableCellEditControl ()
        // 设置单元格的编辑状态(可编辑或不可编辑)
        void EnableCellEditControl (bool enable=true)
        // 设置表格的编辑状态(可编辑或步可编辑)
        void EnableEditing (bool edit)
        // 获取指定单元格的值
        wxString GetCellValue (int row, int col) const
        // 获取制定单元格的值
        wxString GetCellValue (const wxGridCellCoords &coords) const
        // 当前单元格是否为只读
        bool IsCurrentCellReadOnly () const
        // 表格是否为可编辑的
        bool IsEditable () const
        // 指定单元格是否为只读
        bool IsReadOnly (int row, int col) const
        // 设置指定单元格的值
        void SetCellValue (int row, int col, const wxString &s)
        // 设置制定单元格的值
        void SetCellValue (const wxGridCellCoords &coords, const wxString &s)
        // 设置制定单元格的值
        void SetCellValue (const wxString &val, int row, int col)
        // 设置制定单元格的只读属性
        void SetReadOnly (int row, int col, bool isReadOnly=true)
        // 单元格大小自适应
        void AutoSize ()
        // 指定列标签大小自适应
        void AutoSizeColLabelSize (int col)
        // 指定列大小自适应
        void AutoSizeColumn (int col, bool setAsMin=true)
        // 设置列的大小自适应属性
        void AutoSizeColumns (bool setAsMin=true)
        // 指定行大小自适应
        void AutoSizeRow (int row, bool setAsMin=true)
        // 指定行标签大小自适应
        void AutoSizeRowLabelSize (int col)
        // 设置行的大小自适应属性
        void AutoSizeRows (bool setAsMin=true)
        // 判断指定列是否是显示的
        bool IsColShown (int col) const         
        // 判断制定行是否是显示状态
        bool IsRowShown (int row) const        
        // 设置制定列的最小宽度
        void SetColMinimalWidth (int col, int width)        
        // 隐藏制定列
        void HideCol (int col)
        // 显示指定列
        void ShowCol (int col)        
        // 设置行的最小高度
        void SetRowMinimalHeight (int row, int height)        
        // 隐藏指定行  
        void HideRow (int col)
        // 显示指定行
        void ShowRow (int col)        
        // 判断单元格大小是否可变
        bool CanDragCell () const        
        // 设置单元格大小是否可变
        void EnableDragCell (bool enable=true)    
        
    关于属性的API:
        // 刷新属性
        void RefreshAttr (int row, int col)
        // 设置指定列的属性
        void SetColAttr (int col, wxGridCellAttr *attr)
        // 设置表格外边距
        void SetMargins (int extraWidth, int extraHeight)
        // 设置指定行属性
        void SetRowAttr (int row, wxGridCellAttr *attr)
        // 获取单元格属性
        wxGridCellAttr * GetOrCreateCellAttr (int row, int col) const
        // 获取列数
        int GetNumberCols () const
        // 获取行数
        int GetNumberRows () const
        
    关于排序的API:
        // 判断排序规则是否为ASCII码
        bool IsSortOrderAscending () const
        // 设置排序列
        void SetSortingColumn (int col, bool ascending=true)     
        // 设置列的排序规则
        void SetColumnsOrder (const wxArrayInt &order)
        
        // 获取列的最小宽度
        int GetColMinimalWidth (int col) const
        // 获取行的最小高度
        int GetRowMinimalHeight (int col) const

    选中模式:
        wxGridSelectCells
        wxGridSelectRows
        wxGridSelectColumns
        wxGridSelectRowsOrColumns

    对齐方式:
        wxALIGN_LEFT     
        wxALIGN_TOP     
        wxALIGN_RIGHT     
        wxALIGN_BOTTOM     
        wxALIGN_CENTER_VERTICAL     
        wxALIGN_CENTRE_VERTICAL     
        wxALIGN_CENTER     
        wxALIGN_CENTRE   
详解的API介绍见: http://docs.wxwidgets.org/trunk/classwx_grid.html

3. 示例代码
    在此我们实现一个4*5的表格,其核心代码如下所示:   
void CreateTable(wxWindow* parent)
{
        char* attr[] = {"姓名", "年龄", "性别", "身高", "体重"};
        wxGrid *grid = new wxGrid(parent, wxID_ANY, wxPoint(0, 0), wxSize(580, 310));
        // 创建一个8×5的表格
        grid->CreateGrid(8, 5);
        // 设置默认的行高度
        grid->SetDefaultRowSize(35);
        // 设置默认的列宽度
        grid->SetDefaultColSize(100);
        // 设置表头的背景色
        grid->SetLabelBackgroundColour(0x228B22);
        // 设置表头的颜色
        grid->SetLabelTextColour(0xFFFFFF);
        // 设置单元格中数据的对其方式
        grid->SetDefaultCellAlignment(wxALIGN_CENTER, wxALIGN_CENTRE);
        // 设置表头
        for (int i = 0; i < 5; i++)
        {
            grid->SetColLabelValue(i, wxString::FromUTF8(attr[i]));
        }
        // 使表格完全显示
        parent->Fit();
}     

你可能感兴趣的:(wxwidgets,wxGrid)