Tutorial:LuaFormListView - Revision history

Dark Byte: Reverted edits by This content is not available (Talk) to last revision by Jgoemat

2019-03-18T19:08:42Z

Reverted edits by This content is not available (Talk) to last revision by Jgoemat

Show changes

This content is not available: Replaced content with 'Sorry! Content not available.'

2019-03-16T16:07:55Z

Replaced content with '<span style="font-size:25px;color:red">Sorry! Content not available.</span>'

Show changes

Jgoemat at 09:08, 23 July 2018

2018-07-23T09:08:51Z

Jgoemat: /* Using OnCustomDrawItem, OnCustomDrawSubItem */

2018-07-23T07:02:12Z

‎Using OnCustomDrawItem, OnCustomDrawSubItem

Jgoemat: /* Using OnCustomDrawItem, OnCustomDrawSubItem */

2018-07-23T06:50:24Z

‎Using OnCustomDrawItem, OnCustomDrawSubItem

Jgoemat: /* OnCustomDrawSubItem */

2018-07-23T06:48:22Z

‎OnCustomDrawSubItem

Jgoemat at 06:33, 23 July 2018

2018-07-23T06:33:30Z

Jgoemat: /* Using OwnerData */

2018-07-23T04:20:29Z

‎Using OwnerData

Jgoemat at 04:17, 23 July 2018

2018-07-23T04:17:10Z

Jgoemat at 04:09, 23 July 2018

2018-07-23T04:09:56Z

← Older revision		Revision as of 09:08, 23 July 2018
Line 201:		Line 201:

	[[File:TutorialLuaCustomDrawSubItem.png\|\|Style Columns\|border]]		[[File:TutorialLuaCustomDrawSubItem.png\|\|Style Columns\|border]]
		+
		+	== Selecting Items ==
		+
		+	Edit the '''CEListView1''' properties in the designer and uncheck '''HideSelection''' to change it to False.
		+	This maintains the selection, though it looks grayed out when another control is selected.
		+
		+	You should already have '''RowSelect''' set to True from earlier. When this is false, only the first column of the row is selected.
		+	I think that looks wonky, I don't know why you would want this. You can't even select other columns...
		+
		+	Finally, '''MultiSelect' should be false. When this is set, you have to check each individual item (UDF1.CEListView1.Items[x].Selected) to see if it's selected. On my computer that's about 1,000 items per second, so I wouldn't want to do that for more than 50 items or so. When allowing only a single item to be selected you can use UDF1.CEListView1.getItemIndes() to get the index of the selected item (or -1 if none is selected).
		+
		+	=== OnSelectItem ===
		+
		+	There is an '''OnSelectItem''' event that is a little weird. The signature looks like this:
		+
		+	<pre>function CEListView1SelectItem(sender, listitem, selected)
		+	print('SelectItem!', tostring(listitem.Index), tostring(selected))
		+	end</pre>
		+
		+	It is called with listitem.index being the selected index and selected=true, but it is also called with listitem.index=-1 and selected=false to clear the selection. With single-select it is always called twice: once to clear the selection (-1,false), then with the newly selected index and true. With multi-select it works the same way when selecting single rows, but when using CTRL+CLICK to select additional rows you don't get the -1,false to clear the selection. However when you use SHIFT+CLICK to select a range it ''only'' gives you that clear message. Pretty useless...
		+
		+	=== Finding with Multiselect=true ===
		+
		+	Again, the performance is horrible so don't use it with big lists (> 100 items), and if you do you should probably set a limit
		+	in code so it won't access too many items.
		+
		+	<pre>local items = UDF1.CEListView1.Items
		+	local selected = {}
		+	for i=0,math.min(100,#items.count-1) do
		+	if items[i].Selected then table.insert(selected, i) end
		+	end</pre>
		+
		+	=== Finding with single select ===
		+
		+	You can use either of these to get the selected index, which is 0-based and will be -1 if no item is selected:
		+
		+	<pre>UDF1.CEListView1.Selected.Index
		+	UDF1.CEListView1.getItemIndex()</pre>
		+
		+
		+	== Other Events ==
		+
		+	=== DblClick ===
		+
		+	I like using '''DblClick''' for doing something if you have one main thing to do with an item, it preserves the 'single-click to select' ux and is pretty common.
		+
		+	Double-click in it in the Events tab of the object inspector to create a template or edit the value to be an existing function.
		+	You can see what it does with this code:
		+
		+	<pre>function CEListView1DblClick(sender)
		+	print('You double-clicked with selected index '..tostring(sender.getItemIndex()))
		+	end</pre>
		+
		+	=== KeyDown ===
		+
		+	Double-click the space by this event in the Events tab of the object inspector to create a template, or set the value to an
		+	existing function. The 'key' parameter is the key code, you can see a list in '''Defines.lua''' in the directory where
		+	Cheat Engine is installed. This handler will print a message to the lua console only when the 'RETURN' key is pressed.
		+
		+	<pre>function CEListView1KeyDown(sender, key)
		+	if key == VK_RETURN then
		+	print('Hit key "'..tostring(key)..'" with selected index '..tostring(sender.getItemIndex()))
		+	end
		+	return key
		+	end</pre>
		+
		+	You can return other keys, but I'm not sure of the rules. Letters and Numbers seem to move the list to the top and the value you return doesn't matter. Other keys like function keys, cursor keys, return, space, PGUP (VK_PRIOR) and PGDOWN (VK_NEXT) will replace that key with what you return. For instance you could return VK_NEXT if the key is VK_PRIOR and both PGUP and PGDOWN would act like PGDOWN.

@@ Line 146: / Line 146: @@
 I think they can also be used to do other drawing.
-<pre style="background-color: #ff6677; color: white">Warning!
+<pre style="background-color: #ff4655; color: white; white-space: pre-wrap">Warning!
 I have CE become unresponsive sometimes, I think it's best to close the editor when saving changes to these methods.  You can still leave the form open to see changes, just not the editor.  I think it is changing the item array and item count with the custom data most likely.</pre>

@@ Line 148: / Line 148: @@
 <pre style="background-color: #ff6677; color: white">Warning!
-I have CE become unresponsive sometimes, I think it's best to close the editor when saving changes to these methods.  You can still leave the form open to see changes, just not the editor.</pre>
+I have CE become unresponsive sometimes, I think it's best to close the editor when saving changes to these methods.  You can still leave the form open to see changes, just not the editor.  I think it is changing the item array and item count with the custom data most likely.</pre>
 === OnCustomDrawItem ===

← Older revision		Revision as of 06:48, 23 July 2018
Line 175:		Line 175:
	=== OnCustomDrawSubItem ===		=== OnCustomDrawSubItem ===

−	This is called for columns ''other than the first''.	+	This is called for columns ''other than the first''. You should have
		+	'''OnCustomDrawItem''' set as well to handle the first column, and I
		+	think it's best just to have it delegate to this method. The value
		+	are the same except for a new '''SubItem''' parameter that is the
		+	zero-based column index.
		+
		+	<pre>function CEListView1CustomDrawSubItem(Sender, Item, SubItem, State)
		+	if (Item.Index % 2) == 1 then
		+	Sender.Canvas.Brush.Color = 0xffe0e0 -- odd rows blue bg (0-based)
		+	if SubItem == 1 then Sender.Canvas.Font.Color = 0x8f8f8f end -- gray middle column
		+	else
		+	Sender.Canvas.Brush.Color = 0xffffff -- odd rows white bg (0-based)
		+	if SubItem == 2 then
		+	Sender.Canvas.Font.Color = 0xffff40 -- cyan right column
		+	else
		+	Sender.Canvas.Font.Color = 0x2020ff -- red other columns
		+	end
		+	end
		+	return true -- return true for DefaultDraw
		+	end
		+
		+	function CEListView1CustomDrawItem(Sender, Item, State)
		+	return CEListView1CustomDrawSubItem(Sender, Item, 0, State)
		+	end</pre>
		+
		+	[[File:TutorialLuaCustomDrawSubItem.png\|\|Style Columns\|border]]

← Older revision		Revision as of 06:33, 23 July 2018
Line 138:		Line 138:
	# Run your script that creates the functions used by the form events		# Run your script that creates the functions used by the form events
	# Click Table=>Resynchronize forms with lua		# Click Table=>Resynchronize forms with lua
		+
		+	== Using OnCustomDrawItem, OnCustomDrawSubItem ==
		+
		+	If you want to change the style of items you can use the '''OnCustomDrawItem'''
		+	and '''OnCustomDrawSubItem''' events. These can alter the styles as shown
		+	here and CE will draw the text as normal if you return '''true''', but
		+	I think they can also be used to do other drawing.
		+
		+	<pre style="background-color: #ff6677; color: white">Warning!
		+
		+	I have CE become unresponsive sometimes, I think it's best to close the editor when saving changes to these methods. You can still leave the form open to see changes, just not the editor.</pre>
		+
		+	=== OnCustomDrawItem ===
		+
		+	<pre>CustomDrawItem(Sender, Item, State)</pre>
		+
		+	This is called for the first column that displays the '''Caption'''. If you
		+	change a style here it will be set for other columns as well. Sender is
		+	the '''ListView''' control, Item is the '''ListItem''', and I'm not sure
		+	what '''State''' is. Here's a sample that will draw odd rows (0-based)
		+	with a blue background:
		+
		+	<pre>function CEListView1CustomDrawItem(Sender, Item, State)
		+	if (Item.Index % 2) == 1 then
		+	Sender.Canvas.Brush.Color = 0xffe0e0 -- odd rows blue bg (0-based)
		+	else
		+	Sender.Canvas.Brush.Color = 0xffffff -- other rows white bg red fg
		+	Sender.Canvas.Font.Color = 0x4040ff
		+	end
		+	return true --return true for DefaultDraw
		+	end</pre>
		+
		+	[[File:TutorialLuaCustomDrawItem.png\|\|Drawing odd rows blue bg, even red fg\|border]]
		+
		+
		+	=== OnCustomDrawSubItem ===
		+
		+	This is called for columns ''other than the first''.

@@ Line 122: / Line 122: @@
 can also see it when selecting or deselecting rows because it needs to be
 redrawn.
 [[File:TutorialListViewOwnerData.png||ListView Add More Columns|border]]

← Older revision		Revision as of 04:17, 23 July 2018
Line 124:		Line 124:

	[[File:TutorialListViewOwnerData.png\|\|ListView Add More Columns\|border]]		[[File:TutorialListViewOwnerData.png\|\|ListView Add More Columns\|border]]
		+
		+	=== Aside on syncing with lua ===
		+
		+	If you see something you don't expect, it could be that the event handlers are
		+	using old functions. Try these steps:
		+
		+	# Close down the designer and the form
		+	# Run your script that creates the functions used by the form events
		+	# Click Table=>Resynchronize forms with lua

← Older revision		Revision as of 04:09, 23 July 2018
Line 79:		Line 79:

	[[File:TutorialListViewMoreColumnsData.png\|\|ListView Add More Columns\|border]]		[[File:TutorialListViewMoreColumnsData.png\|\|ListView Add More Columns\|border]]
		+
		+	== Using OwnerData ==
		+
		+	What if you have a LOT of items you want to display? There's overhead with creating the items and I couldn't get BeginUpdate/EndUpdate to work. That's where the '''OwnerData''' property comes in! Check the '''OwnerData'''
		+	property of the ListView to make it True. Change the Object Inspector tab from Properties to Events and double-click
		+	on the OnData property to create an event handler. Now I'll change the table script to look like this and run it:
		+
		+	<pre>-- items
		+	list = {}
		+	for i=1,1000000 do
		+	local item = {
		+	message = string.format('Message %d', i),
		+	data = math.sqrt(i)
		+	}
		+	table.insert(list, item)
		+	end
		+
		+	-- need to set the Items.Count property so that it knows how many rows there
		+	-- are in total
		+	UDF1.CEListView1.Items.Count = #list
		+
		+	-- definition created by double-clicking OnData event handler
		+	function CEListView1Data(sender, listitem)
		+	-- use + 1 because listitem.Index is 0-based
		+	local d = list[listitem.Index + 1]
		+	if not d then return end
		+	listitem.Caption = d.message -- first column
		+	-- other columns have sqrt of data property and CURRENT clock
		+	-- when this event was called
		+	local others = {string.format('%0.3f', math.sqrt(d.data)), os.clock()}
		+	listitem.SubItems.text = table.concat(others, '\n')
		+	end</pre>
		+
		+	So we set '''UDF1.CEListView1.Items.Count''' to the number of items the ListView
		+	should display. The OnData event handler will be called for each ''displayed''
		+	row. When the displayed row changes, the method is called again. This way
		+	it is called just for the visible rows in the control.
		+
		+	You can tell it's getting called by scrolling down one row then back up,
		+	the 'Clock' column value will change. If you resize the form (and have
		+	the anchors set so the ListView will resize) then they all change. You
		+	can also see it when selecting or deselecting rows because it needs to be
		+	redrawn.
		+
		+	[[File:TutorialListViewOwnerData.png\|\|ListView Add More Columns\|border]]