DataGridViewCell::MeasureTextHeight Method (Graphics^, String^, Font^, Int32, TextFormatFlags, Boolean%)
.NET Framework (current version)
Gets the height, in pixels, of the specified text, given the specified characteristics. Also indicates whether the required width is greater than the specified maximum width.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
public: static int MeasureTextHeight( Graphics^ graphics, String^ text, Font^ font, int maxWidth, TextFormatFlags flags, [OutAttribute] bool% widthTruncated )
Parameters
- graphics
-
Type:
System.Drawing::Graphics^
The Graphics used to render the text.
- text
-
Type:
System::String^
The text to measure.
- font
-
Type:
System.Drawing::Font^
The Font applied to the text.
- maxWidth
-
Type:
System::Int32
The maximum width of the text.
- flags
-
Type:
System.Windows.Forms::TextFormatFlags
A bitwise combination of TextFormatFlags values to apply to the text.
- widthTruncated
-
Type:
System::Boolean%
Set to true if the required width of the text is greater than maxWidth.
| Exception | Condition |
|---|---|
| ArgumentNullException | graphics is null. -or- font is null. |
| ArgumentOutOfRangeException | maxWidth is less than 1. |
| InvalidEnumArgumentException | flags is not a valid bitwise combination of TextFormatFlags values. |
If multiple lines are required and the specified formatting allows it, the height returned is the combined height of all lines.
.NET Framework
Available since 2.0
Available since 2.0
Show: