DataGrid.PreferredColumnWidth Property

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Gets or sets the default width of the grid columns in pixels.

public:
 property int PreferredColumnWidth { int get(); void set(int value); };

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridPreferredColumnWidthTypeConverter))]
public int PreferredColumnWidth { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridPreferredColumnWidthTypeConverter))>]
member this.PreferredColumnWidth : int with get, set

Public Property PreferredColumnWidth As Integer

Property Value

Int32

The default width (in pixels) of columns in the grid.

Attributes

TypeConverterAttribute

Exceptions

ArgumentException

The property value is less than 0.

Examples

The following code example sets the default column widths to a value passed to the method.

Private Sub SetDefaultColWidth(defColWidth As Integer)
    DataGrid1.PreferredColumnWidth = defColWidth
 End Sub

Remarks

Set this property before resetting the DataSource and DataMember properties (either separately, or through the SetDataBinding method), or the property will have no effect.

The property cannot be set to a value less than 0.

See also

• GetPreferredSize(Graphics, Object)
• PreferredRowHeight