ScrollCellIntoView メソッド (RowScrollRegion)

指定されたセルを表示領域にスクロールします。

シンタックス

Visual Basic

'宣言
 
Public Sub ScrollCellIntoView( _
   ByVal cell As UltraGridCell, _
   ByVal colScrollRegion As ColScrollRegion _
) 

C#

public void ScrollCellIntoView( 
   UltraGridCell cell,
   ColScrollRegion colScrollRegion
)

パラメータ

cell

表示するためのセル。

colScrollRegion

列スクロール領域。

解説

このメソッドを起動して、列または行のスクロール領域でセルが表示可能であることを保証します。

このメソッドが colscrollregion に対して起動され、列がすでに領域の表示可能な場所にあれば、このメソッドはスクロールを実行しません。

このメソッドを起動する結果として colscrollregion がスクロールされると、列スクロール領域の Position プロパティの値が変更され、BeforeColRegionScroll イベントが生成されます。このメソッドを起動する結果として colscrollregion がスクロールされると、BeforeRowRegionScroll イベントが生成されます。

Scroll、ScrollColumnIntoView、ScrollGroupIntoView および ScrollRowIntoView メソッドは、スクロール領域の表示可能な領域にオブジェクトをスクロールするために起動できます。

使用例

Visual Basic

Imports Infragistics.Shared
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinGrid

  Private Sub Button136_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button136.Click

      Dim cell As UltraGridCell = Me.UltraGrid1.Rows(20).Cells(2)

      ' Set the back color of the cell so we can identify it on the screen.
      cell.Appearance.BackColor = Color.LightSkyBlue

      ' Get the row-scroll-region and the column-scroll-region to scroll the cell into view.
      Dim rsr As RowScrollRegion = Me.UltraGrid1.ActiveRowScrollRegion
      Dim csr As ColScrollRegion = Me.UltraGrid1.ActiveColScrollRegion

      ' Scroll the cell into view in the scroll region formed by the intersection of
      ' rsr RowScrollRegion and csr ColScrollRegion.
      rsr.ScrollCellIntoView(cell, csr)

      ' ScrollCellIntoView also does the same thing. You need to call just one of these
      ' to scroll a cell into view. Only difference is that ColScrollRegion.ScrollCellIntoView
      ' takes a leftAlign parameter that indicates whether to scroll the cell all the way to 
      ' the left.
      csr.ScrollCellIntoView(cell, rsr, False)

  End Sub

C#

using Infragistics.Shared;
using Infragistics.Win;
using Infragistics.Win.UltraWinGrid;
using System.Diagnostics;

private void button136_Click(object sender, System.EventArgs e)
{	
		
	UltraGridCell cell = this.ultraGrid1.Rows[20].Cells[2];

	// Set the back color of the cell so we can identify it on the screen.
	cell.Appearance.BackColor = Color.LightSkyBlue;

	// Get the row-scroll-region and the column-scroll-region to scroll the cell into view.
	RowScrollRegion rsr = this.ultraGrid1.ActiveRowScrollRegion;
	ColScrollRegion csr = this.ultraGrid1.ActiveColScrollRegion;

	// Scroll the cell into view in the scroll region formed by the intersection of
	// rsr RowScrollRegion and csr ColScrollRegion.
	rsr.ScrollCellIntoView( cell, csr );

	// ScrollCellIntoView also does the same thing. You need to call just one of these
	// to scroll a cell into view. Only difference is that ColScrollRegion.ScrollCellIntoView
	// takes a leftAlign parameter that indicates whether to scroll the cell all the way to 
	// the left.
	csr.ScrollCellIntoView( cell, rsr, false );

}