Export (0) Print
Expand All

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.

ExceptionCondition
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

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft