TextBoxRenderer::DrawTextBox Method (Graphics^, Rectangle, String^, Font^, Rectangle, TextFormatFlags, TextBoxState)
Draws a text box control in the specified state and bounds, and with the specified text, text bounds, and text formatting.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
public: static void DrawTextBox( Graphics^ g, Rectangle bounds, String^ textBoxText, Font^ font, Rectangle textBounds, TextFormatFlags flags, TextBoxState state )
Parameters
- g
-
Type:
System.Drawing::Graphics^
The Graphics used to draw the text box.
- bounds
-
Type:
System.Drawing::Rectangle
The Rectangle that specifies the bounds of the text box.
- textBoxText
-
Type:
System::String^
The String to draw in the text box.
- font
-
Type:
System.Drawing::Font^
The Font to apply to textBoxText.
- textBounds
-
Type:
System.Drawing::Rectangle
The Rectangle that specifies the bounds of textBoxText.
- flags
-
Type:
System.Windows.Forms::TextFormatFlags
A bitwise combination of the TextFormatFlags values.
- state
-
Type:
System.Windows.Forms.VisualStyles::TextBoxState
One of the TextBoxState values that specifies the visual state of the text box.
| Exception | Condition |
|---|---|
| InvalidOperationException | The operating system does not support visual styles. -or- Visual styles are disabled by the user in the operating system. -or- Visual styles are not applied to the client area of application windows. |
Before calling this method, you should verify that the IsSupported property returns true.
The following code example demonstrates how to use the DrawTextBox(Graphics^, Rectangle, String^, Font^, Rectangle, TextFormatFlags, TextBoxState) method in a custom control's OnPaint method to draw a text box. This code example is part of a larger example provided for the TextBoxRenderer class.
// Use DrawText with the current TextFormatFlags.
protected:
virtual void OnPaint(PaintEventArgs^ e) override
{
__super::OnPaint(e);
if (TextBoxRenderer::IsSupported)
{
TextBoxRenderer::DrawTextBox(e->Graphics, textBorder, this->Text,
this->Font, textRectangle, textFlags, TextBoxState::Normal);
this->Parent->Text = "CustomTextBox Enabled";
}
else
{
this->Parent->Text = "CustomTextBox Disabled";
}
}
Available since 2.0