Infragistics(R) NetAdvantage(R) Windows Forms
ColumnSizingArea Property
See Also  Example E-mail your feedback on this topic.
Infragistics.Win.UltraWinGrid Namespace > UltraGridOverride Class : ColumnSizingArea Property

Returns or sets a value that determines which part of the grid's interface may be used to resize columns.

Syntax

Visual Basic (Declaration) 
Public Property ColumnSizingArea As ColumnSizingArea
C# 
public ColumnSizingArea ColumnSizingArea {get; set;}

Example

Following code sets some of the properties available for controlling column sizing.

Visual BasicCopy Code
Imports Infragistics.Shared
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinGrid

  Private Sub Button1_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button1.Click
      ' By default, the widths of the columns in different bands are synchronized.
      ' You can set the AllowColSizing to Free to prevent that so you can have
      ' different widths for columns in different bands.
      Me.ultraGrid1.DisplayLayout.Override.AllowColSizing = AllowColSizing.Free

      ' ColumnSizingArea specifies the area used for resizing the columns.
      Me.ultraGrid1.DisplayLayout.Override.ColumnSizingArea = ColumnSizingArea.EntireColumn

      ' DefaultColWidth indicates the default width that the UltraGrid will assign
      ' to each column in the UltraGrid when none is explicitly specified for that
      ' column.
      Me.ultraGrid1.DisplayLayout.Override.DefaultColWidth = 100

      ' You can override that grid-wide setting for a particular band by setting it
      ' on the override of that band.
      Me.ultraGrid1.DisplayLayout.Bands(0).Override.AllowColSizing = AllowColSizing.None
      Me.ultraGrid1.DisplayLayout.Bands(0).Override.DefaultColWidth = 120

      ' You can also set widths of individual columns.
      Me.ultraGrid1.DisplayLayout.Bands(0).Columns(0).Width = 200

      ' You can also control the column sizing aspect for a particular column.
      ' MinWidth and MaxWidth properties off the UltraGridColumn limit how much the
      ' user can resize the column. Following code won't allow the user to make the
      ' column smaller than 60 pixels and wider than 200 pixels.
      Me.ultraGrid1.DisplayLayout.Bands(0).Columns(0).MinWidth = 60
      Me.ultraGrid1.DisplayLayout.Bands(0).Columns(0).MinWidth = 200
  End Sub
C#Copy Code
using Infragistics.Shared;
using Infragistics.Win;
using Infragistics.Win.UltraWinGrid;
using System.Diagnostics;

private void button1_Click(object sender, System.EventArgs e)
{
	// By default, the widths of the columns in different bands are synchronized.
	// You can set the AllowColSizing to Free to prevent that so you can have
	// different widths for columns in different bands.
	this.ultraGrid1.DisplayLayout.Override.AllowColSizing = AllowColSizing.Free;

	// ColumnSizingArea specifies the area used for resizing the columns.
	this.ultraGrid1.DisplayLayout.Override.ColumnSizingArea = ColumnSizingArea.EntireColumn;

	// DefaultColWidth indicates the default width that the UltraGrid will assign
	// to each column in the UltraGrid when none is explicitly specified for that
	// column.
	this.ultraGrid1.DisplayLayout.Override.DefaultColWidth = 100;

	// You can override that grid-wide setting for a particular band by setting it
	// on the override of that band.
	this.ultraGrid1.DisplayLayout.Bands[0].Override.AllowColSizing = AllowColSizing.None;
	this.ultraGrid1.DisplayLayout.Bands[0].Override.DefaultColWidth = 120;

	// You can also set widths of individual columns.
	this.ultraGrid1.DisplayLayout.Bands[0].Columns[0].Width = 200;

	// You can also control the column sizing aspect for a particular column.
	// MinWidth and MaxWidth properties off the UltraGridColumn limit how much the
	// user can resize the column. Following code won't allow the user to make the
	// column smaller than 60 pixels and wider than 200 pixels.
	this.ultraGrid1.DisplayLayout.Bands[0].Columns[0].MinWidth = 60;
	this.ultraGrid1.DisplayLayout.Bands[0].Columns[0].MinWidth = 200;
}

Remarks

If column resizing is enabled (as determined by the UltraGridOverride.AllowColSizing property) the user can resize columns using the mouse. Resizing is always accomplished by clicking on the right edge of the column and dragging the mouse. The ColumnSizingArea property specifies which part of the column responds to the mouse pointer to initiate resizing of the column. You can choose to have just the column headers, just the borders of the column cells, or both be active for column resizing. When the mouse pointer passes over the active area of the column, the cursor changes to a resizing cursor.

See Also