Powerbuilder – Treeview like Tooltips for Datawindows

Posted on Wednesday, May 18th, 2011 at 8:20 pm in

The treeview control has a very neat piece of functionality built in called Tooltips. When this property is checked your application will automatically display all the text on a treeview item if it is cut off by the edge of the control when the mouse pointer goes over that row. If the row text is not cut off, no tip, if it is, a tip displays. The following is an implementation of this type of functionality for datawindows. Although it is geared more towards grid type datawindows it could be used on others as well. This code is done in PB11.5, which has a tooltip property on datawindow columns, but the basic ideas can be adapted to earlier versions without this.

The code is available here within an Archive File which also includes exports of the objects. Basically you will need to define the ‘mousemove’ event on your datawindow control (mapped to pbm_dwnmousemove) along with an string instance variable that tracks which row/column combination the mouse pointer is over. The instance variable is very important since it prevents the code from constantly being executed when the user keeps the pointer on the same row/column. Within the mouse move the position and width of the datawindow object column being pointed to is compared to the width of the datawindow control and the position of the horizontal scrollbar. Left and Right positioning of the column is also taken into consideration. If the text in the pointed at column is not completely within the control, it it placed into the Tooltip Text of the column. All columns have Tooltips enabled so once the Tip text has a value, the tip appears.

The code to derive the text and determine its length is encapsulated in an non visual object and uses a variety of API calls.

The sample application datawindow has columns of all Edit types as well as a couple of computed columns. One periodic issue is with dropdown datawindows and listboxed which have ‘Display all columns’ on. Another is with the ‘Always show arrow’ option which sometimes keeps the tooltip coming on even though all the text is visible.

Sample Screenshots:

This shows the bubblehelp for a Checkbox column. If the column has three states the text will show either ‘On’, ‘Off’, or ‘Other’.


This shows the right side of the datawindow control with no bubblehelp.


This shows the bubblehelp on a computed column.

At the bottom of the sample application are text boxes which display various position and size information which was useful in creating the checking logic. Since this is a grid datawindow you can re-order the columns as you wish. Also note the datawindow conrol can be resized which makes testing easier.

Code from mousemove event

// listview tooltips functionality for datawindow
//
// check to see if datawindow column text is cut off by either the size of the datawindow
// control or the position of the horizontal scrollbar
// if the text is cut off, put the text into the tooltip for the datawindow column so it
// will display.
Long    ll_hScrollPos, ll_width
Long    ll_colX, ll_colW, ll_colXW, ll_textwidth
datawindow ldw
string ls_mod, ls_value, ls_err, ls_checkname, ls_oldcolname, ls_alignment
s_dwbubble lstr_bubble

ldw = THIS
IF  row > 0 AND dwo.name <> 'datawindow' THEN
	ls_checkname = (dwo.Name  + '/' + string(row))
	// only do this if mouse moved to new row/column since last time
	IF(is_curcol <> ls_checkname) THEN
		IF Len(is_curcol) > 0 THEN // blank out previous tip
			ls_oldcolname = Left(is_curcol, Pos(is_curcol,'/') - 1)
			ls_mod = ls_oldcolname + '.Tooltip.Tip = ""'
			ls_err = this.modify(ls_mod)
		END IF
		ll_width = w_dwbubblehelp.dw_1.width
		ll_hScrollPos = Long( THIS.Describe("DataWindow.HorizontalScrollPosition") )
		ls_mod = dwo.name + '.x'
		ll_colX = Long( THIS.Describe(ls_mod) )
		ls_mod = dwo.name + '.width'
		ll_colW = Long( this.Describe(ls_mod) )
		ll_colXW = ll_colX + ll_colW
		IF ll_colXW < ll_hScrollPos THEN
			 // "Not visible"
		ELSE
			 IF ( ll_colX < ll_hScrollPos ) AND ( ll_colXW > ll_hScrollPos ) THEN
				 // Partially Visible Left 
				 // get the text value and its length
				lstr_bubble = idw.uf_get_width_of_data(row, dwo.name, ldw, iw_parent)
				ll_textwidth = lstr_bubble.i_width
				ls_value = lstr_bubble.s_value
				ls_mod = dwo.name + '.Alignment'
				ls_alignment = this.describe(ls_mod)
				IF ls_alignment = '1' THEN // right alighment
					IF ll_textwidth > ll_colw THEN // text wider than column
						ls_mod = dwo.name + '.Tooltip.Tip = "' + ls_value + '"'
						ls_err = this.modify(ls_mod)
					ELSEIF ll_colXW - ll_textwidth <  ll_hScrollPos THEN 
						 // text cut off by datawindow control or scrollbar
						ls_mod = dwo.name + '.Tooltip.Tip = "' + ls_value + '"'
						ls_err = this.modify(ls_mod)
					ELSE
						ls_mod = dwo.name + '.Tooltip.Tip = ""'
						ls_err = this.modify(ls_mod)
					END IF
				ELSE // other alignments
					IF ll_textwidth > ll_colw THEN
						ls_mod = dwo.name + '.Tooltip.Tip = "' + ls_value + '"'
						ls_err = this.modify(ls_mod)
					ELSEIF ll_textwidth > (ll_colXW - (ll_width + ll_hScrollPos)) THEN
						ls_mod = dwo.name + '.Tooltip.Tip = "' + ls_value + '"'
						ls_err = this.modify(ls_mod)
					ELSE
						ls_mod = dwo.name + '.Tooltip.Tip = ""'
						ls_err = this.modify(ls_mod)
					END IF
				END IF
				  
			ELSEIF (ll_colXW >  ll_hScrollPos) AND (ll_colXW > (ll_width + ll_hScrollPos) ) THEN 
				// Partially Visible Right 
				// get the text value and its length
				lstr_bubble = idw.uf_get_width_of_data(row, dwo.name, ldw, iw_parent)
				ll_textwidth = lstr_bubble.i_width
				ls_value = lstr_bubble.s_value
				ls_mod = dwo.name + '.Alignment'
				ls_alignment = this.describe(ls_mod)
				IF ls_alignment = '0' THEN // left alighment
					IF ll_textwidth > ll_colw THEN // text wider than column
						ls_mod = dwo.name + '.Tooltip.Tip = "' + ls_value + '"'
						ls_err = this.modify(ls_mod)
					ELSEIF ll_width + ll_hScrollPos - ll_colX < ll_textwidth + Round((ll_textwidth / 10), 0) THEN  
						// text cut off by datawindow control or scrollbar
						ls_mod = dwo.name + '.Tooltip.Tip = "' + ls_value + '"'
						ls_err = this.modify(ls_mod)
					ELSE
						ls_mod = dwo.name + '.Tooltip.Tip = ""'
						ls_err = this.modify(ls_mod)
					END IF
				ELSE
					IF ll_textwidth > ll_colw THEN // text wider than column width
						ls_mod = dwo.name + '.Tooltip.Tip = "' + ls_value + '"'
						ls_err = this.modify(ls_mod)
					ELSEIF ll_textwidth > (ll_colW - (ll_width + ll_hScrollPos)) THEN 
						// text cut off by datawindow control or scrollbar
						ls_mod = dwo.name + '.Tooltip.Tip = "' + ls_value + '"'
						ls_err = this.modify(ls_mod)
					ELSE
						ls_mod = dwo.name + '.Tooltip.Tip = ""'
						ls_err = this.modify(ls_mod)
					END IF
				END IF
			 ELSE
				// "Visible"			
				// this could be modifed for grid columns resized smaller than text value
				ls_mod = dwo.name + '.Tooltip.Tip = ""'
				ls_err = this.modify(ls_mod)
			 END IF
		END IF
	END IF	
	is_curcol = dwo.Name + '/' + string(row)
END IF

Thanks to Adam Simmonds for his assistance on this.

You might also be interested in

1 Comment

Add your comment

  1. jwayt@iobar.com - October 21, 2012 at 7:20 am

    Also consider tool tips for invisible items than could not fit on the screen. Tool tips for customer account number over their name, or expanding a code to preserve space, like A/I with a tool tip for Active/Inactive. A user_id that tips the users’ name. Tooltips can reveal formulas on computed fields. DW buttons can get tips, ‘Click this button to …’

Leave a Reply

Top