DataGridColumnStyle::GetPreferredHeight Method (Graphics^, Object^)

 

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)

public protected:
virtual int GetPreferredHeight(
	Graphics^ g,
	Object^ value
) abstract

Parameters

g
Type: System.Drawing::Graphics^

A Graphics object.

value
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 ref class MyGridColumn: public DataGridTextBoxColumn
{
public:
   int GetPrefHeight( Graphics^ g, String^ thisString )
   {
      return this->GetPreferredHeight( g, thisString );
   }

};

public ref class Form1: public Form
{
protected:
   DataGrid^ dataGrid1;

private:
   void GetHeight()
   {
      MyGridColumn^ myGridColumn;

      // Get a DataGridColumnStyle of a DataGrid control.
      myGridColumn = dynamic_cast<MyGridColumn^>(dataGrid1->TableStyles[ 0 ]->GridColumnStyles[ "CompanyName" ]);

      // Create a Graphics object.
      Graphics^ g = this->CreateGraphics();
      Console::WriteLine( myGridColumn->GetPrefHeight( g, "A string" ) );
   }

};

.NET Framework
Available since 1.1
Return to top
Show: