TipStyleRowConnector プロパティ

マウスが行コネクタのライン上で停止した際にツールチップが表示されるかどうかを設定します。

シンタックス

Visual Basic

'宣言
 
Public Property TipStyleRowConnector As TipStyle

C#

public TipStyle TipStyleRowConnector {get; set;}

解説

このプロパティは、指定されたオーバーライドによって制御されるバンドまたはグリッドの行を接続する線でポップアップ ヒントを表示できるかどうかを決定します。階層式レコードセットを使用している場合、バンドの親レコードがコントロールの上端より上または下端より下にあって見えないことがよくあります。行コネクタ ヒントは、コントロールをスクロールしなくても現在表示されているデータの親レコードがわかる便利な手段です。

マウスを接続線の上で一定時間静止させると、行コネクタ ヒントが現れて、その接続線に関連付けられているレコードのデータが表示されます。行コネクタ ヒントには、接続線が位置するバンドの ScrollTipField プロパティで指定された、レコード内の 1 つのフィールドの名前と値が表示されます。

マウスを接続線の上に置くと、マウス ポインターが特殊な接続線カーソルに変わります。この接続線カーソルは、ポップアップ ヒントにデータが表示されるレコードの方向を示します。通常このカーソルは上向きの二重矢印で、線に接続されている前のレコードのデータがポップアップヒントに表示されます。ただしキーボードの [Ctrl] キーを押すと、マウス ポインターは下向きの二重矢印に変わり、線に接続されている次のレコードのデータがポップアップ ヒントに表示されます。

使用例

Visual Basic

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#

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";

}