DataGridColumnStyle.GetPreferredHeight Method (Graphics, Object)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

When overridden in a derived class, gets the height used for automatically resizing columns.

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

protected internal abstract int GetPreferredHeight(
	Graphics g,
	object value


Type: System.Drawing.Graphics

A Graphics object.

Type: System.Object

An object value for which you want to know the screen height and width.

Return Value

Type: System.Int32

The height used for auto resizing a cell.

The GetPreferredSize will usually be invoked from a mouse down event to resize a column's height for a long string.

The following code example uses the GetPreferredHeight method to return the height of a cell.

public class Form1: Form
 protected DataGrid dataGrid1;

private void GetHeight(){
    MyGridColumn myGridColumn;
    // Get a DataGridColumnStyle of a DataGrid control.
    myGridColumn = (MyGridColumn) dataGrid1.TableStyles[0].
    // Create a Graphics object.
    Graphics g = this.CreateGraphics();
    Console.WriteLine(myGridColumn.GetPrefHeight(g, "A string"));

public class MyGridColumn:DataGridTextBoxColumn{
   public int GetPrefHeight(Graphics g, string thisString){
      return this.GetPreferredHeight(g,thisString);

.NET Framework
Available since 1.1
Return to top