TipStyleScroll プロパティ

スクロールバーのスクロールボックスがドラッグされたときに、スクロールバー上にツールチップが表示されるかどうかを設定します。

シンタックス

Visual Basic

'宣言
 
Public Property TipStyleScroll As TipStyle

C#

public TipStyle TipStyleScroll {get; set;}

解説

このプロパティは、指定されたオーバーライドによって制御されるバンドまたはグリッドのスクロールバーでポップアップツール ヒントが表示されるかどうかを決定します。デフォルトでは、スクロールボックスをドラッグしてレコードセットをスクロールするとき、マウスボタンを離してスクロールボックスの位置を変更するまでグリッドのデータはスクロールされません。スクロールヒントを表示するように TipStyleScroll を設定した場合は、スクロール ボックスの上にポップアップ ヒントが現れて、スクロールバーを離したときにグリッドの一番上に表示されるレコードが表示されます。ポップアップ ヒントに表示するデータ レコードのフィールドを指定するには、ScrollTipField プロパティを使用します。

注: このプロパティを有効にするためには、UltraGridLayout.ScrollStyle を Deferred に設定する必要があります。

使用例

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

}