Infragistics(R) NetAdvantage(R) Windows Forms
TipStyleRowConnector Property
See Also  Example E-mail your feedback on this topic.
Infragistics.Win.UltraWinGrid Namespace > UltraGridOverride Class : TipStyleRowConnector Property

Returns or sets a value that determines whether a tip will be displayed when the mouse pauses over a row connector line.

Syntax

Visual Basic (Declaration) 
Public Property TipStyleRowConnector As TipStyle
C# 
public TipStyle TipStyleRowConnector {get; set;}

Example

Following code sets TipStyleScroll and TipStyleRowConnector on the layout's override and band 0 override.

Visual BasicCopy Code
Imports Infragistics.Shared
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinGrid

  Private Sub Button59_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button59.Click

      ' Set the TipStyleRowConnector to Hide to disable the row connector tooltips. Row
      ' connectors are the lines that connect sibling rows and child rows to parent
      ' rows. By default, the UltraGrid displays a tooltip when the mouse is hovered
      ' over the row connector connecting a row to its sibling that's not in view. The
      ' text in the tooltip indentifies the sibling row. You can disable this tooltip by
      ' setting the TipStyleRowConnector to Hide.
      Me.UltraGrid1.DisplayLayout.Override.TipStyleRowConnector = TipStyle.Hide

      ' Likewise, use the TipStyleScroll to disable the scroll tooltips which they are
      ' shown by default. Scroll tooltips are displayed when the vertical thumb is
      ' dragged. They identify the row that current scroll thumb position represents.
      ' NOTE: If the UltraGridLayout.ScrollStyle is set to Immediate, which it isn't by
      ' default, then this will be ignored and by the scroll tooltips will be disabled.
      Me.UltraGrid1.DisplayLayout.Override.TipStyleScroll = TipStyle.Hide

      ' You can override that grid-wide setting for a particular band by setting it on 
      ' the override of that band. Enable cell tooltips on band 2.
      Me.UltraGrid1.DisplayLayout.Bands(0).Override.TipStyleRowConnector = TipStyle.Show
      Me.UltraGrid1.DisplayLayout.Bands(0).Override.TipStyleScroll = TipStyle.Show

      ' ScrollTipField is what controls the text that gets displayed in the scroll and
      ' row connector tooltips.
      Me.UltraGrid1.DisplayLayout.Bands(0).ScrollTipField = "CustomerID"

  End Sub
C#Copy Code
using Infragistics.Shared;
using Infragistics.Win;
using Infragistics.Win.UltraWinGrid;
using System.Diagnostics;

private void button59_Click(object sender, System.EventArgs e)
{

	// Set the TipStyleRowConnector to Hide to disable the row connector tooltips. Row
	// connectors are the lines that connect sibling rows and child rows to parent
	// rows. By default, the UltraGrid displays a tooltip when the mouse is hovered
	// over the row connector connecting a row to its sibling that's not in view. The
	// text in the tooltip indentifies the sibling row. You can disable this tooltip by
	// setting the TipStyleRowConnector to Hide.
	this.ultraGrid1.DisplayLayout.Override.TipStyleRowConnector = TipStyle.Hide;

	// Likewise, use the TipStyleScroll to disable the scroll tooltips which they are
	// shown by default. Scroll tooltips are displayed when the vertical thumb is
	// dragged. They identify the row that current scroll thumb position represents.
	// NOTE: If the UltraGridLayout.ScrollStyle is set to Immediate, which it isn't by
	// default, then this will be ignored and by the scroll tooltips will be disabled.
	this.ultraGrid1.DisplayLayout.Override.TipStyleScroll = TipStyle.Hide;

	// You can override that grid-wide setting for a particular band by setting it on 
	// the override of that band. Enable cell tooltips on band 2.
	this.ultraGrid1.DisplayLayout.Bands[0].Override.TipStyleRowConnector = TipStyle.Show;
	this.ultraGrid1.DisplayLayout.Bands[0].Override.TipStyleScroll = TipStyle.Show;

	// ScrollTipField is what controls the text that gets displayed in the scroll and
	// row connector tooltips.
	this.ultraGrid1.DisplayLayout.Bands[0].ScrollTipField = "CustomerID";

}

Remarks

This property determines whether the lines connecting the rows of the band or the grid controlled by the specified override will be capable of displaying pop-up tips. When using hierarchical recordsets, often the parent record of a band will be out of view, above the top or below the bottom of the control. Row connector tips are a convenient way to discover which record is the parent of the data currently being displayed without having to scroll the control.

Row connector tips display data from a record that is attached to the connector line when the mouse has come to rest over the line for a period of time. The tip displays the name and value of one field in the record, as determined by the ScrollTipField property of the band in which the line is located.

When the mouse pointer passes over a connector line, it changes to a special connector line cursor that indicates the direction of the record whose data is being displayed in the pop-up tip. Normally, this cursor is an upward-pointing double arrow and the pop-up tip displays data from the previous record connected to line. But if the CTRL key on the keyboard is depressed, the mouse pointer changes to a downward-pointing double arrow and the pop-up tip displays data from the following record connected to line.

See Also