CEGUI控件(多列列表).docx

CEGUI:MultiColumnList Class ReferenceMultiColumnList多列列表框，有点像DataGridView控件，可以用来显示多列数据。它同样继承于Window类，运用范围挺广的。公有成员函数：1）boolisUserSortControlEnabled (void) const返回user是否可以对列排序2）boolisUserColumnSizingEnabled (void) const返回user是否可以改变依列分割段排列大小3）boolisUserColumnDraggingEnabled (void) const返回user是否可以修改列的顺序4）uintgetColumnCount (void) constgetRowCount (void) const获得列/行的数目5）uintgetSortColumn (void) const返回当前排序列的0根基索引6）uintgetColumnWithID (uint col_id) const通过指定ID返回列中0根基列的索引7）uintgetColumnWithHeaderText (const String &text) const返回列中与指定text匹配的0根基索引8）ListboxItem *findColumnItemWithText (const String &text, uint col_idx, const ListboxItem *start_item) const返回含有text字符串的列索引9）ListboxItem * findRowItemWithText (const String &text, uint row_idx, const ListboxItem *start_item) const返回还有text字符串的行索引10）ListboxItem* findListItemWithText (const String &text, const ListboxItem *start_item) const返回有text字符串的ListboxItem指针11）ListboxItem*getFirstSelectedItem (void) constgetNextSelected (const ListboxItem *start_item) const返回依附在listbox中第一个被选择的ListboxItem指针（起始item下一个）12）uintgetSelectedCount (void) const返回依附在list box中选中ListboxItem的数目13) uintgetColumnID (uint col_idx) const getRowID (uint row_idx) const返回所需行/列的ID14）voidresetList (void)清除list中所有的item15）voidaddColumn (const String &text, uint col_id, const UDim &width)添加一列到listbox中16）voidinsertColumn (const String &text, uint col_id, const UDim &width, uint position)插入一新行道list中17) voidremoveColumn (uint col_idx)removeColumnWithID (uint col_id)删除一列（这回引起任何ListboxItem使用自动释放选项。不是很明白）18）voidmoveColumn (uint col_idx, uint position)moveColumnWithID (uint col_id, uint position)移动索引为col_idx的列到position位置19）uintaddRow (uint row_id=0)addRow (ListboxItem *item, uint col_id, uint row_id=0)添加一新行20）uintinsertRow (uint row_idx, uint row_id=0)insertRow (ListboxItem *item, uint col_id, uint row_idx, uint row_id=0)插入一新行（与插入一列类似）row_id指新行的ID，21）voidremoveRow (uint row_idx)删除row_idx的行22）voidsetItem (ListboxItem *item, uint col_id, uint row_idx)为行为row_idx列为col_id的column设置ListboxItem23）voidsetSortColumn (uint col_idx)setSortColumnByID (uint col_id)设置列为将被使用的排序key24）voidclearAllSelections (void)清除所有当前被选中的依附在ListboxItem的选中状态25）voidhandleUpdatedItemData (void)告知listbox有ListboxItem发生内部修改，需重新同步状态、刷新显示26）voidsetUserSortControlEnabled (bool setting)setUserColumnSizingEnabled (bool setting)setUserColumnDraggingEnabled (bool setting)设置一些属性27）voidsetRowID (uint row_idx, uint row_id)为所给的row设置ID28）MultiColumnList (const String &type, const String &name)构造函数静态公有属性（绑定一些事件）：static const String1）EventSelectionChanged当在listbox中的当前选项发上改变时触发事件2）EventListContentsChangedlistbox中的内容发生改变时触发事件3）EventSortColumnChanged当排序列发生改变时触发事件4）EventSortDirectionChanged排序方向发生改变是触发事件5）EventListColumnMoved当列顺序改变时触发事件保护类型：typedef std:vectorListItemGrid保护成员函数：主要是一些虚函数，起功能与上面提到的一些公有成员函数类似（就不详细介绍了）virtual void1） onSelectionChanged (WindowEventArgs &e)2） onListContentsChanged (WindowEventArgs &e)3） onSortColumnChanged (WindowEventArgs &e)4） onListColumnMoved (WindowEventArgs &e)5） onMouseButtonDown (MouseEventArgs &e)onMouseWheel (MouseEventArgs &e)响应鼠标事件6）boolhandleHeaderScroll (const EventArgs &e)头滚动条处理函数handleHeaderSegMove (const EventArgs &e)处理头分割线移动函数handleColumnSizeChange (const EventArgs &e)列size改变处理函数handleHorzScrollbar (const EventArgs &e)水平滚动条处理函数handleVertScrollbar (const EventArgs &e)竖直滚动条处理函数handleSortColumnChange (const EventArgs &e)列排序改变处理函数handleSortDirectionChange (const EventArgs &e)排序方向改变处理函数handleHeaderSegDblClic