DataGridViewColumn::GetPreferredWidth Method (DataGridViewAutoSizeColumnMode, Boolean)
Calculates the ideal width of the column based on the specified criteria.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
public: virtual int GetPreferredWidth( DataGridViewAutoSizeColumnMode autoSizeColumnMode, bool fixedHeight )
Parameters
- autoSizeColumnMode
-
Type:
System.Windows.Forms::DataGridViewAutoSizeColumnMode
A DataGridViewAutoSizeColumnMode value that specifies an automatic sizing mode.
- fixedHeight
-
Type:
System::Boolean
true to calculate the width of the column based on the current row heights; false to calculate the width with the expectation that the row heights will be adjusted.
| Exception | Condition |
|---|---|
| ArgumentException | |
| InvalidEnumArgumentException | autoSizeColumnMode is not a valid DataGridViewAutoSizeColumnMode value. |
This property is used by the content-based automatic sizing feature of the DataGridView control to determine the ideal width of a column.
A fixedHeight parameter value of false calculates the column width based on calculated row heights that will achieve ideal cell height-to-width ratios. For cell contents to wrap onto multiple lines, the cell style in effect for the cell must have a WrapMode property value of True.
For more information about automatic sizing, see Sizing Options in the Windows Forms DataGridView Control.
Available since 2.0