DataGridViewCell::MeasureTextWidth Method (Graphics^, String^, Font^, Int32, TextFormatFlags)

 

Gets the width, in pixels, of the specified text given the specified characteristics.

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

public:
static int MeasureTextWidth(
	Graphics^ graphics,
	String^ text,
	Font^ font,
	int maxHeight,
	TextFormatFlags flags
)

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.

maxHeight
Type: System::Int32

The maximum height of the text.

flags
Type: System.Windows.Forms::TextFormatFlags

A bitwise combination of TextFormatFlags values to apply to the text.

Return Value

Type: System::Int32

The width, in pixels, of the text.

Exception Condition
ArgumentNullException

graphics is null.

-or-

font is null.

ArgumentOutOfRangeException

maxHeight is less than 1.

InvalidEnumArgumentException

flags is not a valid bitwise combination of TextFormatFlags values.

.NET Framework
Available since 2.0
Return to top
Show: