Infragistics logo
메뉴
.NET and JavaScript UI Controls
Version

DefaultColWidth Property

Returns or sets a value representing the default column width.
Syntax
'Declaration
 
Public Property DefaultColWidth As Integer
public int DefaultColWidth {get; set;}
Remarks

You can use this property to specify the width that columns will start with when the band or the grid controlled by the specified override is first displayed. Setting this property to 0 will cause the control to use the largest font size specified for the column to determine the column's width. Pictures are not taken into account by the control when calculating the default column width, so large pictures in cells may be clipped when they are displayed.

Setting DefaultColWidth to a value of -1 will cause it to use the value from the next highest object in the override hierarchy.

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

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
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;
}
Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also