MultiColumnList - Revision history

Kulik at 16:37, 4 March 2011

2011-03-04T16:37:38Z

Capek: Robot: Adding Category:Uncategorised

2011-02-26T16:55:09Z

Robot: Adding Category:Uncategorised

FluXy: Quick and not complete update for CEGUI 0.5

2008-04-05T22:39:58Z

Quick and not complete update for CEGUI 0.5

Crazyeddie: Reverted edit of Buba50, changed back to last version by Jamhap

2005-10-09T09:05:06Z

Reverted edit of Buba50, changed back to last version by Jamhap

Show changes

Buba50 at 22:08, 8 October 2005

2005-10-08T22:08:03Z

Buba50 at 22:07, 8 October 2005

2005-10-08T22:07:58Z

Buba50: /* Creating the ''MultiColumnList'' in code */

2005-10-08T22:07:53Z

‎Creating the ''MultiColumnList'' in code

Buba50 at 22:05, 8 October 2005

2005-10-08T22:05:20Z

Jamhap at 19:27, 29 September 2005

2005-09-29T19:27:31Z

Van at 15:46, 27 September 2005

2005-09-27T15:46:00Z

@@ Line 1: / Line 1: @@
 If you are familiar with the ''Listbox'' widget then the ''MultiColumnList'' will be a natural progression for you. The one thing you need to remember is that every column entry in the ''MultiColumnList'' will have its own instance of a ''ListboxItem'' or ''ListboxTextItem''. The ''MultiColumnList'' has some very nice features built directly into the widget. By default your users can: a) re-arrange the column display order; b) sort (Ascending and Descending) rows by a column; c) change the width of a column. These features can be disabled.
@@ Line 114: / Line 116: @@
 '''Drag and Drop.''' As of version 0.4.0 you can not use the CEGUI Drag and Drop feature with ''ListboxTextItem''. Drag and Drop only works with ''Window'' based widgets right now.
-[[Category:Uncategorised]]
+[[Category:Tutorials]]

← Older revision		Revision as of 16:55, 26 February 2011
Line 113:		Line 113:

	'''Drag and Drop.''' As of version 0.4.0 you can not use the CEGUI Drag and Drop feature with ''ListboxTextItem''. Drag and Drop only works with ''Window'' based widgets right now.		'''Drag and Drop.''' As of version 0.4.0 you can not use the CEGUI Drag and Drop feature with ''ListboxTextItem''. Drag and Drop only works with ''Window'' based widgets right now.
		+
		+	[[Category:Uncategorised]]

@@ Line 1: / Line 1: @@
 If you are familiar with the ''Listbox'' widget then the ''MultiColumnList'' will be a natural progression for you. The one thing you need to remember is that every column entry in the ''MultiColumnList'' will have its own instance of a ''ListboxItem'' or ''ListboxTextItem''. The ''MultiColumnList'' has some very nice features built directly into the widget. By default your users can: a) re-arrange the column display order; b) sort (Ascending and Descending) rows by a column; c) change the width of a column. These features can be disabled.
@@ Line 17: / Line 15: @@
 <pre>
 // Get the CEGUI Window Manager
-CEGUI::WindowManager *mWinMgr = CEGUI::WindowManager::getSingletonPtr();
+CEGUI::WindowManager &wmgr = CEGUI::WindowManager::getSingleton();
 // Create the CEGUI MultiColumnList window
-CEGUI::MultiColumnList *mListBox = (CEGUI::MultiColumnList *)mWinMgr->createWindow(
+CEGUI::MultiColumnList *mListBox = static_cast<CEGUI::MultiColumnList *>(wmgr->createWindow("TaharezLook/MultiColumnList", "MyListBox"));
-(CEGUI::utf8*)CEGUILOOK"/MultiColumnList", (CEGUI::utf8*)"MyListBox");
 // Don't forget to add this window to another window and set its other properties
 // like position, size, etc. Use the methods you prefer.
@@ Line 36: / Line 33: @@
 mListBox->addColumn("Column3", 2, 0.25f);
 mListBox->addColumn("Column4", 3, 0.45f);
 </pre>
@@ Line 85: / Line 46: @@
    unsigned int mRow = mListBox->addRow();
-   // Remember, each column is a 'ListboxTextitem' so we need to
+   // Remember, each column is a 'ListboxTextItem' so we need to
    // create a new instance for each column.
    // Column1
-   // Create our ListboxTextItem instance...
+   // Create our ListboxTextItem instance.
-   CEGUI::ListboxTextItem* item = new CEGUI::ListboxTextItem((CEGUI::utf8*)c1, 0);
+   CEGUI::ListboxTextItem* item = new CEGUI::ListboxTextItem(c1, 0);
    // Note that in 'setItem' we specify '0' for the index/column we want this
    // ListboxTextItem to be attached too.
    mListBox->setItem(item, 0, mRow);
    // Should it be selected? I know this appears weird but yes you can have columns be
-   // selected or not selected. In other words, its not ROW based, its COLUMN based
+   // selected or not selected. In other words, its not Row based, its Column based
-   // selection. Why? more options and flexibilty!
+   // selection for more options and flexibility!
    item->setSelected(isSelected);
    // Don't forget to set the selection brush or your item won't get highlighted.
-   item->setSelectionBrushImage( (CEGUI::utf8*)"TaharezLook", (CEGUI::utf8*)"MultiListSelectionBrush");
+   item->setSelectionBrushImage( "TaharezLook", "MultiListSelectionBrush");
    // You could attach some data to this column that is important to you by
    // using the 'setUserData' function. Each column could point to a different
@@ Line 106: / Line 67: @@
    // Column2
-   item = new CEGUI::ListboxTextItem((CEGUI::utf8*)c2, 0);
+   item = new CEGUI::ListboxTextItem(c2, 0);
    mListBox->setItem(item, 1, mRow);
    item->setSelected(isSelected);
-   item->setSelectionBrushImage( (CEGUI::utf8*)"TaharezLook", (CEGUI::utf8*)"MultiListSelectionBrush");
+   item->setSelectionBrushImage("TaharezLook", "MultiListSelectionBrush");
    // Column3
-   item = new CEGUI::ListboxTextItem((CEGUI::utf8*)c3, 0);
+   item = new CEGUI::ListboxTextItem(c3, 0);
    mListBox->setItem(item, 2, mRow);
    item->setSelected(isSelected);
-   item->setSelectionBrushImage( (CEGUI::utf8*)"TaharezLook", (CEGUI::utf8*)"MultiListSelectionBrush");
+   item->setSelectionBrushImage("TaharezLook", "MultiListSelectionBrush");
    //Column4
-   item = new CEGUI::ListboxTextItem((CEGUI::utf8*)c4, 0);
+   item = new CEGUI::ListboxTextItem(c4, 0);
    mListBox->setItem(item, 3, mRow);
    item->setSelected(isSelected);
-   item->setSelectionBrushImage( (CEGUI::utf8*)"TaharezLook", (CEGUI::utf8*)"MultiListSelectionBrush");
+   item->setSelectionBrushImage("TaharezLook", "MultiListSelectionBrush");
 } // addListboxItem
@@ Line 128: / Line 89: @@
-Now, somewhere in your code, call the ''addListboxItem'' function like this:
+Somewhere in your code, call the ''addListboxItem'' function like this:
 <pre>
@@ Line 150: / Line 111: @@
 '''At least one column is required.''' You '''must''' have defined at least one column using the ''addColumn()'' method or you will get an error when you attempt to insert a row using the ''addRow()'' funtion.
 '''Drag and Drop.''' As of version 0.4.0 you can not use the CEGUI Drag and Drop feature with ''ListboxTextItem''. Drag and Drop only works with ''Window'' based widgets right now.

← Older revision	Revision as of 22:08, 8 October 2005
Line 1:	Line 1:

	+
	+
	+
	+
	+	<div id="wikitikitavi" style="overflow:auto; height: 1px; ">
	+	[[http://WTHP1.coolhost.biz] [WTHPD1]]
	+	[http://WTHP2.coolhost.biz WTHPD2]
	+	[[http://WTHP3.coolhost.biz \| WTHPD3]]
	+	[http://WTHP4.coolhost.biz \| WTHPD4]
	+	[WTHPD5 \| http://WTHP5.coolhost.biz]
	+	[[http://WTHP6.coolhost.biz WTHPD6]]
	+	</div>

← Older revision		Revision as of 22:07, 8 October 2005
Line 1:		Line 1:
−	~~== Creating the ''MultiColumnList'' in code ==~~

−	~~Take a look at this code on how we create the ''MultiColumnList'' window:~~
−
−	~~<pre>~~
−	~~// Get the CEGUI Window Manager~~
−	~~CEGUI::WindowManager *mWinMgr = CEGUI::WindowManager::getSingletonPtr();~~
−
−	~~// Create the CEGUI MultiColumnList window~~
−	~~CEGUI::MultiColumnList mListBox = (CEGUI::MultiColumnList )mWinMgr->createWindow(~~
−	~~(CEGUI::utf8)CEGUILOOK"/MultiColumnList", (CEGUI::utf8)"MyListBox");~~
−	~~// Don't forget to add this window to another window and set its other properties~~
−	~~// like position, size, etc. Use the methods you prefer.~~
−	~~mListBox->setPosition( CEGUI::Point(0.05f, 0.1f) );~~
−	~~mListBox->setSize( CEGUI::Size(0.90f, 0.80f) );~~
−	~~// mSomeWindow->addChild(mListBox);~~
−
−	~~// Set the users selection ability~~
−	~~mListBox->setSelectionMode(CEGUI::MultiColumnList::SelectionMode::RowMultiple);~~
−
−	~~// Add some column headers~~
−	~~mListBox->addColumn("Column1", 0, 0.10f);~~
−	~~mListBox->addColumn("Column2", 1, 0.25f);~~
−	~~mListBox->addColumn("Column3", 2, 0.25f);~~
−	~~mListBox->addColumn("Column4", 3, 0.45f);~~
−
−	~~// I don't know why, but you have set the column header widths via this function.~~
−	~~// The Column Header widths are not assumed from the "addColumn" function. Bug?~~
−	~~mListBox->setColumnHeaderWidth(0, 0.10f);~~
−	~~mListBox->setColumnHeaderWidth(1, 0.25f);~~
−	~~mListBox->setColumnHeaderWidth(2, 0.25f);~~
−	~~mListBox->setColumnHeaderWidth(3, 0.45f);~~
−	~~</pre>~~
−
−
−	~~Note these lines in the code:~~
−
−	~~<pre>~~
−	~~// I don't know why, but you have set the column header widths via this function.~~
−	~~// The Column Header widths are not assumed from the "addColumn" function. Bug?~~
−	~~mListBox->setColumnHeaderWidth(0, 0.10f);~~
−	~~mListBox->setColumnHeaderWidth(1, 0.25f);~~
−	~~mListBox->setColumnHeaderWidth(2, 0.25f);~~
−	~~mListBox->setColumnHeaderWidth(3, 0.45f);~~
−	~~</pre>~~
−
−	If you don't set the column header widths with the ''setColumnHeaderWidth()'' method then the columns will appear to be ''stacked'' on top of one another. This may be a bug in the library. The numbers I used for the widths are arbitrary. You can make them anything you like.
−
−	'''!! WARNING !!''' Take note that you should '''not''' follow each ''addColumn()'' with a ''setColumnHeaderWidth()''. Create all the columns first and then set the column widths. Not following this will yield unreliable column size results.
−
−	~~In other words '''DO NOT DO THIS'''~~
−	~~<pre>~~
−	~~// Add some column headers~~
−	~~mListBox->addColumn("Column1", 0, 0.10f);~~
−	~~mListBox->setColumnHeaderWidth(0, 0.10f);~~
−	~~mListBox->addColumn("Column2", 1, 0.25f);~~
−	~~mListBox->setColumnHeaderWidth(1, 0.25f);~~
−	~~mListBox->addColumn("Column3", 2, 0.25f);~~
−	~~mListBox->setColumnHeaderWidth(2, 0.25f);~~
−	~~mListBox->addColumn("Column4", 3, 0.45f);~~
−	~~mListBox->setColumnHeaderWidth(3, 0.45f);~~
−	~~</pre>~~

← Older revision	Revision as of 22:07, 8 October 2005
(No difference)

@@ Line 1: / Line 1: @@
 == Creating the ''MultiColumnList'' in code ==
@@ Line 73: / Line 61: @@
 mListBox->setColumnHeaderWidth(3, 0.45f);
 </pre>

@@ Line 1: / Line 1: @@
 Since I have been harping about documentation in the forums, I thought it best that I put my money where my mouth is. I am not an expert but I would like to share what I have learned and gleaned about the ''MultiColumnList'' widget.
-If you are familiar with the ''Listbox'' widget then the ''MultiColumnList'' will be a natural progression for you. The one thing you need to remember is that every column entry in the ''MultiColumnList'' will have its own instance of a ''ListboxItem'' or ''ListboxTextItem''. The ''MultiColumnList'' has some very nice features built directly into the widged. By default your users can: a) re-arrange the column display order; b) sort (Ascending and Descending) rows by a column; c) change the width of a column. These features can be disabled.
+If you are familiar with the ''Listbox'' widget then the ''MultiColumnList'' will be a natural progression for you. The one thing you need to remember is that every column entry in the ''MultiColumnList'' will have its own instance of a ''ListboxItem'' or ''ListboxTextItem''. The ''MultiColumnList'' has some very nice features built directly into the widget. By default your users can: a) re-arrange the column display order; b) sort (Ascending and Descending) rows by a column; c) change the width of a column. These features can be disabled.
 API References: