PreferredSize Property

DataGridViewCell.PreferredSize Property

 

Gets the size, in pixels, of a rectangular area into which the cell can fit.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

[BrowsableAttribute(false)]
public Size PreferredSize { get; }

Property Value

Type: System.Drawing.Size

A Size containing the height and width, in pixels.

Exception Condition
InvalidOperationException

ColumnIndex is less than 0, indicating that the cell is a row header cell.

ArgumentOutOfRangeException

The row containing the cell is a shared row.

-or-

The cell is a column header cell.

The PreferredSize property returns the natural size of the cell computed by the cell's owning row and column. PreferredSize returns a Size with a width and height of -1 if the cell is not contained in a table.

If the cell is in a DataGridViewColumn that has its Resizable property set to false, -1 is returned for the width.

This method relies on the GetFormattedValue method.

.NET Framework
Available since 2.0
Return to top
Show:
© 2016 Microsoft