ScrollCellIntoView(UltraGridCell,RowScrollRegion,Boolean) メソッド

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

シンタックス

Visual Basic

'宣言
 
Public Overloads Sub ScrollCellIntoView( _
   ByVal cell As UltraGridCell, _
   ByVal rowScrollRegion As RowScrollRegion, _
   ByVal leftAlign As Boolean _
) 

C#

public void ScrollCellIntoView( 
   UltraGridCell cell,
   RowScrollRegion rowScrollRegion,
   bool leftAlign
)

パラメータ

cell

表示するためのセル。

rowScrollRegion

RowScrollRegion

leftAlign

セルを ColScrollRegion の左に揃えるように指定するには True。

解説

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

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

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

Scroll、ScrollColIntoView、ScrollGroupIntoView、ScrollHeaderIntoView および 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 );

}