RowSizingArea プロパティ

グリッドのインターフェイス内で、行のサイズ変更に使用できる部分を設定します。

シンタックス

Visual Basic

'宣言
 
Public Property RowSizingArea As RowSizingArea

C#

public RowSizingArea RowSizingArea {get; set;}

解説

行のサイズ変更が有効な場合 (RowSizing プロパティによって設定します) 、ユーザーはマウスを使用して行のサイズを変更できます。サイズ変更の際は常に、行の下端をクリックしてドラッグします。RowSizingArea プロパティは、行のサイズ変更時に行のどの部分がマウス ポインターに反応するかを指定します。レコード セレクターのみ、データ領域の境界線のみ、または行のサイズ変更で両方をアクティブ、のいずれかを選択できます。マウス ポインタを行のアクティブな領域の上に置くと、カーソルがサイズ変更カーソルに変わります。

このプロパティの値を設定する場合、アプリケーションが実行中は常にレコード セレクターが表示可能であるかどうか、または表示からスクロールアウトできるか、そして行のサイズ変更を行うためにユーザーの能力にどのような効果があるかを検討したい場合があります。また、データ領域の行境界線が行のサイズ変更でアクティブであるかとグリッドでの他のマウス操作の妨げとなり、ユーザーの邪魔になるかどうかを決定する必要があります。

使用例

Visual Basic

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

  Private Sub Button79_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button79.Click

      ' Set the RowSizing on the layout's override to Free so the rows in the UltraGrid
      ' can be resized independently. By default, row heights are syncronized so when one
      ' row is resized, all the rows in that band will be rezied to that height.
      Me.UltraGrid1.DisplayLayout.Override.RowSizing = RowSizing.Free

      ' Set DefaultRowHeight off the layout's override to 20 so all the rows in the UltraGrid
      ' are sized to 20.
      Me.UltraGrid1.DisplayLayout.Override.DefaultRowHeight = 20

      ' RowSizingArea indicates which part of a row can be used to resize the row. By default,
      ' the user can resize rows using the row-selectors. You can set it to EntireRow to allow
      ' resizing using the entire row and not just the row-selector.
      Me.UltraGrid1.DisplayLayout.Override.RowSizingArea = RowSizingArea.EntireRow

      ' You can override that grid-wide setting for a particular band by setting it on the
      ' override of that band. Set the RowSizing to Fixed to prevent the user from reszing
      ' rows.
      Me.UltraGrid1.DisplayLayout.Bands(1).Override.RowSizing = RowSizing.Fixed
      Me.UltraGrid1.DisplayLayout.Bands(1).Override.DefaultRowHeight = 40

      ' With the RowSizing modes of AutoFree and AutoFixed, the UltraGrid resizes the rows
      ' based on its contents. By default, the UltraGrid will resize the row without any 
      ' limit. You can use the RowSizingAutoMaxLines property to limit the row-autosizing
      ' to a certain number of lines.
      Me.UltraGrid1.DisplayLayout.Bands(2).Override.RowSizing = RowSizing.AutoFree
      Me.UltraGrid1.DisplayLayout.Bands(2).Override.RowSizingAutoMaxLines = 5

  End Sub

C#

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

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

	// Set the RowSizing on the layout's override to Free so the rows in the UltraGrid
	// can be resized independently. By default, row heights are syncronized so when one
	// row is resized, all the rows in that band will be rezied to that height.
	this.ultraGrid1.DisplayLayout.Override.RowSizing = RowSizing.Free;

	// Set DefaultRowHeight off the layout's override to 20 so all the rows in the UltraGrid
	// are sized to 20.
	this.ultraGrid1.DisplayLayout.Override.DefaultRowHeight = 20;

	// RowSizingArea indicates which part of a row can be used to resize the row. By default,
	// the user can resize rows using the row-selectors. You can set it to EntireRow to allow
	// resizing using the entire row and not just the row-selector.
	this.ultraGrid1.DisplayLayout.Override.RowSizingArea = RowSizingArea.EntireRow;

	// You can override that grid-wide setting for a particular band by setting it on the
	// override of that band. Set the RowSizing to Fixed to prevent the user from reszing
	// rows.
	this.ultraGrid1.DisplayLayout.Bands[1].Override.RowSizing = RowSizing.Fixed;
	this.ultraGrid1.DisplayLayout.Bands[1].Override.DefaultRowHeight = 40;

	// With the RowSizing modes of AutoFree and AutoFixed, the UltraGrid resizes the rows
	// based on its contents. By default, the UltraGrid will resize the row without any 
	// limit. You can use the RowSizingAutoMaxLines property to limit the row-autosizing
	// to a certain number of lines.
	this.ultraGrid1.DisplayLayout.Bands[2].Override.RowSizing = RowSizing.AutoFree;
	this.ultraGrid1.DisplayLayout.Bands[2].Override.RowSizingAutoMaxLines = 5;

}