UserControl Class
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Provides an empty control that can be used to create other controls.
public ref class UserControl : System::Windows::Forms::ContainerControlpublic class UserControl : System.Windows.Forms.ContainerControl[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)]
[System.Runtime.InteropServices.ComVisible(true)]
public class UserControl : System.Windows.Forms.ContainerControltype UserControl = class
inherit ContainerControl[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type UserControl = class
inherit ContainerControlPublic Class UserControl
Inherits ContainerControl- Inheritance
- Derived
- Attributes
Examples
The following code example creates a UserControl that can be reused in multiple applications to get user information. This example adds several Label controls, TextBox controls and an ErrorProvider to the UserControl to gather the user's information. Additionally, the user's email address is validated in the Validating event of the TextBox and the ErrorProvider object is used to give the user feedback if the data fails validation. The code is intended to be compiled into a DLL for reference in other applications.
#using <System.dll>
#using <System.Drawing.dll>
#using <System.Windows.Forms.dll>
using namespace System;
using namespace System::Windows::Forms;
using namespace System::Drawing;
using namespace System::ComponentModel;
namespace UserControls
{
public ref class MyCustomerInfoUserControl: public System::Windows::Forms::UserControl
{
private:
// Create the controls.
System::Windows::Forms::ErrorProvider^ errorProvider1;
System::Windows::Forms::TextBox^ textName;
System::Windows::Forms::TextBox^ textAddress;
System::Windows::Forms::TextBox^ textCity;
System::Windows::Forms::TextBox^ textStateProvince;
System::Windows::Forms::TextBox^ textPostal;
System::Windows::Forms::TextBox^ textCountryRegion;
System::Windows::Forms::TextBox^ textEmail;
System::Windows::Forms::Label ^ labelName;
System::Windows::Forms::Label ^ labelAddress;
System::Windows::Forms::Label ^ labelCityStateProvincePostal;
System::Windows::Forms::Label ^ labelCountryRegion;
System::Windows::Forms::Label ^ labelEmail;
System::ComponentModel::IContainer^ components;
public:
// Define the constructor.
MyCustomerInfoUserControl()
{
InitializeComponent();
}
// Initialize the control elements.
void InitializeComponent()
{
// Initialize the controls.
components = gcnew System::ComponentModel::Container;
errorProvider1 = gcnew System::Windows::Forms::ErrorProvider;
textName = gcnew System::Windows::Forms::TextBox;
textAddress = gcnew System::Windows::Forms::TextBox;
textCity = gcnew System::Windows::Forms::TextBox;
textStateProvince = gcnew System::Windows::Forms::TextBox;
textPostal = gcnew System::Windows::Forms::TextBox;
textCountryRegion = gcnew System::Windows::Forms::TextBox;
textEmail = gcnew System::Windows::Forms::TextBox;
labelName = gcnew System::Windows::Forms::Label;
labelAddress = gcnew System::Windows::Forms::Label;
labelCityStateProvincePostal = gcnew System::Windows::Forms::Label;
labelCountryRegion = gcnew System::Windows::Forms::Label;
labelEmail = gcnew System::Windows::Forms::Label;
// Set the tab order, text alignment, size, and location of the controls.
textName->Location = System::Drawing::Point( 120, 8 );
textName->Size = System::Drawing::Size( 232, 20 );
textName->TabIndex = 0;
textAddress->Location = System::Drawing::Point( 120, 32 );
textAddress->Size = System::Drawing::Size( 232, 20 );
textAddress->TabIndex = 1;
textCity->Location = System::Drawing::Point( 120, 56 );
textCity->Size = System::Drawing::Size( 96, 20 );
textCity->TabIndex = 2;
textStateProvince->Location = System::Drawing::Point( 216, 56 );
textStateProvince->Size = System::Drawing::Size( 56, 20 );
textStateProvince->TabIndex = 3;
textPostal->Location = System::Drawing::Point( 272, 56 );
textPostal->Size = System::Drawing::Size( 80, 20 );
textPostal->TabIndex = 4;
textCountryRegion->Location = System::Drawing::Point( 120, 80 );
textCountryRegion->Size = System::Drawing::Size( 232, 20 );
textCountryRegion->TabIndex = 5;
textEmail->Location = System::Drawing::Point( 120, 104 );
textEmail->Size = System::Drawing::Size( 232, 20 );
textEmail->TabIndex = 6;
labelName->Location = System::Drawing::Point( 8, 8 );
labelName->Size = System::Drawing::Size( 112, 23 );
labelName->Text = "Name:";
labelName->TextAlign = System::Drawing::ContentAlignment::MiddleRight;
labelAddress->Location = System::Drawing::Point( 8, 32 );
labelAddress->Size = System::Drawing::Size( 112, 23 );
labelAddress->Text = "Address:";
labelAddress->TextAlign = System::Drawing::ContentAlignment::MiddleRight;
labelCityStateProvincePostal->Location = System::Drawing::Point( 8, 56 );
labelCityStateProvincePostal->Size = System::Drawing::Size( 112, 23 );
labelCityStateProvincePostal->Text = "City, St/Prov. Postal:";
labelCityStateProvincePostal->TextAlign = System::Drawing::ContentAlignment::MiddleRight;
labelCountryRegion->Location = System::Drawing::Point( 8, 80 );
labelCountryRegion->Size = System::Drawing::Size( 112, 23 );
labelCountryRegion->Text = "Country/Region:";
labelCountryRegion->TextAlign = System::Drawing::ContentAlignment::MiddleRight;
labelEmail->Location = System::Drawing::Point( 8, 104 );
labelEmail->Size = System::Drawing::Size( 112, 23 );
labelEmail->Text = "email:";
labelEmail->TextAlign = System::Drawing::ContentAlignment::MiddleRight;
// Add the Validating and Validated handlers for textEmail.
textEmail->Validating += gcnew System::ComponentModel::CancelEventHandler( this, &MyCustomerInfoUserControl::textEmail_Validating );
textEmail->Validated += gcnew System::EventHandler( this, &MyCustomerInfoUserControl::textEmail_Validated );
// Add the controls to the user control.
array<System::Windows::Forms::Control^>^temp0 = {labelName,labelAddress,labelCityStateProvincePostal,labelCountryRegion,labelEmail,textName,textAddress,textCity,textStateProvince,textPostal,textCountryRegion,textEmail};
Controls->AddRange( temp0 );
// Size the user control.
Size = System::Drawing::Size( 375, 150 );
}
private:
void MyValidatingCode()
{
// Confirm there is text in the control.
if ( textEmail->Text->Length == 0 )
{
throw gcnew Exception( "Email address is a required field." );
}
// Confirm that there is a "." and an "@" in the email address.
else
// Confirm that there is a "." and an "@" in the email address.
if ( textEmail->Text->IndexOf( "." ) == -1 || textEmail->Text->IndexOf( "@" ) == -1 )
{
throw gcnew Exception( "Email address must be valid email address format.\nFor example: 'someone@example.com'" );
}
}
// Validate the data input by the user into textEmail.
void textEmail_Validating( Object^ /*sender*/, System::ComponentModel::CancelEventArgs^ e )
{
try
{
MyValidatingCode();
}
catch ( Exception^ ex )
{
// Cancel the event and select the text to be corrected by the user.
e->Cancel = true;
textEmail->Select(0,textEmail->Text->Length);
// Set the ErrorProvider error with the text to display.
this->errorProvider1->SetError( textEmail, ex->Message );
}
}
void textEmail_Validated( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
//If all conditions have been met, clear the error provider of errors.
errorProvider1->SetError( textEmail, "" );
}
};
}
// End Class
// End Namespace
using System;
using System.Windows.Forms;
using System.Drawing;
using System.ComponentModel;
namespace UserControls
{
public class MyCustomerInfoUserControl : System.Windows.Forms.UserControl
{
// Create the controls.
private System.Windows.Forms.ErrorProvider errorProvider1;
private System.Windows.Forms.TextBox textName;
private System.Windows.Forms.TextBox textAddress;
private System.Windows.Forms.TextBox textCity;
private System.Windows.Forms.TextBox textStateProvince;
private System.Windows.Forms.TextBox textPostal;
private System.Windows.Forms.TextBox textCountryRegion;
private System.Windows.Forms.TextBox textEmail;
private System.Windows.Forms.Label labelName;
private System.Windows.Forms.Label labelAddress;
private System.Windows.Forms.Label labelCityStateProvincePostal;
private System.Windows.Forms.Label labelCountryRegion;
private System.Windows.Forms.Label labelEmail;
private System.ComponentModel.IContainer components;
// Define the constructor.
public MyCustomerInfoUserControl()
{
InitializeComponent();
}
// Initialize the control elements.
public void InitializeComponent()
{
// Initialize the controls.
components = new System.ComponentModel.Container();
errorProvider1 = new System.Windows.Forms.ErrorProvider();
textName = new System.Windows.Forms.TextBox();
textAddress = new System.Windows.Forms.TextBox();
textCity = new System.Windows.Forms.TextBox();
textStateProvince = new System.Windows.Forms.TextBox();
textPostal = new System.Windows.Forms.TextBox();
textCountryRegion = new System.Windows.Forms.TextBox();
textEmail = new System.Windows.Forms.TextBox();
labelName = new System.Windows.Forms.Label();
labelAddress = new System.Windows.Forms.Label();
labelCityStateProvincePostal = new System.Windows.Forms.Label();
labelCountryRegion = new System.Windows.Forms.Label();
labelEmail = new System.Windows.Forms.Label();
// Set the tab order, text alignment, size, and location of the controls.
textName.Location = new System.Drawing.Point(120, 8);
textName.Size = new System.Drawing.Size(232, 20);
textName.TabIndex = 0;
textAddress.Location = new System.Drawing.Point(120, 32);
textAddress.Size = new System.Drawing.Size(232, 20);
textAddress.TabIndex = 1;
textCity.Location = new System.Drawing.Point(120, 56);
textCity.Size = new System.Drawing.Size(96, 20);
textCity.TabIndex = 2;
textStateProvince.Location = new System.Drawing.Point(216, 56);
textStateProvince.Size = new System.Drawing.Size(56, 20);
textStateProvince.TabIndex = 3;
textPostal.Location = new System.Drawing.Point(272, 56);
textPostal.Size = new System.Drawing.Size(80, 20);
textPostal.TabIndex = 4;
textCountryRegion.Location = new System.Drawing.Point(120, 80);
textCountryRegion.Size = new System.Drawing.Size(232, 20);
textCountryRegion.TabIndex = 5;
textEmail.Location = new System.Drawing.Point(120, 104);
textEmail.Size = new System.Drawing.Size(232, 20);
textEmail.TabIndex = 6;
labelName.Location = new System.Drawing.Point(8, 8);
labelName.Size = new System.Drawing.Size(112, 23);
labelName.Text = "Name:";
labelName.TextAlign = System.Drawing.ContentAlignment.MiddleRight;
labelAddress.Location = new System.Drawing.Point(8, 32);
labelAddress.Size = new System.Drawing.Size(112, 23);
labelAddress.Text = "Address:";
labelAddress.TextAlign = System.Drawing.ContentAlignment.MiddleRight;
labelCityStateProvincePostal.Location = new System.Drawing.Point(8, 56);
labelCityStateProvincePostal.Size = new System.Drawing.Size(112, 23);
labelCityStateProvincePostal.Text = "City, St/Prov. Postal:";
labelCityStateProvincePostal.TextAlign = System.Drawing.ContentAlignment.MiddleRight;
labelCountryRegion.Location = new System.Drawing.Point(8, 80);
labelCountryRegion.Size = new System.Drawing.Size(112, 23);
labelCountryRegion.Text = "Country/Region:";
labelCountryRegion.TextAlign = System.Drawing.ContentAlignment.MiddleRight;
labelEmail.Location = new System.Drawing.Point(8, 104);
labelEmail.Size = new System.Drawing.Size(112, 23);
labelEmail.Text = "email:";
labelEmail.TextAlign = System.Drawing.ContentAlignment.MiddleRight;
// Add the Validating and Validated handlers for textEmail.
textEmail.Validating += new System.ComponentModel.CancelEventHandler(textEmail_Validating);
textEmail.Validated += new System.EventHandler(textEmail_Validated);
// Add the controls to the user control.
Controls.AddRange(new System.Windows.Forms.Control[]
{
labelName,
labelAddress,
labelCityStateProvincePostal,
labelCountryRegion,
labelEmail,
textName,
textAddress,
textCity,
textStateProvince,
textPostal,
textCountryRegion,
textEmail
});
// Size the user control.
Size = new System.Drawing.Size(375, 150);
}
private void MyValidatingCode()
{
// Confirm there is text in the control.
if (textEmail.Text.Length == 0)
{
throw new Exception("Email address is a required field.");
}
// Confirm that there is a "." and an "@" in the email address.
else if(textEmail.Text.IndexOf(".") == -1 || textEmail.Text.IndexOf("@") == -1)
{
throw new Exception("Email address must be valid email address format." +
"\nFor example: 'someone@example.com'");
}
}
// Validate the data input by the user into textEmail.
private void textEmail_Validating(object sender, System.ComponentModel.CancelEventArgs e)
{
try
{
MyValidatingCode();
}
catch(Exception ex)
{
// Cancel the event and select the text to be corrected by the user.
e.Cancel = true;
textEmail.Select(0, textEmail.Text.Length);
// Set the ErrorProvider error with the text to display.
this.errorProvider1.SetError(textEmail,ex.Message);
}
}
private void textEmail_Validated(Object sender, System.EventArgs e)
{
//If all conditions have been met, clear the error provider of errors.
errorProvider1.SetError(textEmail, "");
}
} // End Class
} // End Namespace
Imports System.Windows.Forms
Imports System.Drawing
Imports System.ComponentModel
Namespace UserControls
Public Class MyCustomerInfoUserControl
Inherits System.Windows.Forms.UserControl
' Create the controls.
Private errorProvider1 As System.Windows.Forms.ErrorProvider
Private textName As System.Windows.Forms.TextBox
Private textAddress As System.Windows.Forms.TextBox
Private textCity As System.Windows.Forms.TextBox
Private textStateProvince As System.Windows.Forms.TextBox
Private textPostal As System.Windows.Forms.TextBox
Private textCountryRegion As System.Windows.Forms.TextBox
Private WithEvents textEmail As System.Windows.Forms.TextBox
Private labelName As System.Windows.Forms.Label
Private labelAddress As System.Windows.Forms.Label
Private labelCityStateProvincePostal As System.Windows.Forms.Label
Private labelCountryRegion As System.Windows.Forms.Label
Private labelEmail As System.Windows.Forms.Label
Private components As System.ComponentModel.IContainer
' Define the constructor.
Public Sub New()
InitializeComponent()
End Sub
' Initialize the control elements.
Public Sub InitializeComponent()
' Initialize the controls.
components = New System.ComponentModel.Container()
errorProvider1 = New System.Windows.Forms.ErrorProvider()
textName = New System.Windows.Forms.TextBox()
textAddress = New System.Windows.Forms.TextBox()
textCity = New System.Windows.Forms.TextBox()
textStateProvince = New System.Windows.Forms.TextBox()
textPostal = New System.Windows.Forms.TextBox()
textCountryRegion = New System.Windows.Forms.TextBox()
textEmail = New System.Windows.Forms.TextBox()
labelName = New System.Windows.Forms.Label()
labelAddress = New System.Windows.Forms.Label()
labelCityStateProvincePostal = New System.Windows.Forms.Label()
labelCountryRegion = New System.Windows.Forms.Label()
labelEmail = New System.Windows.Forms.Label()
' Set the tab order, text alignment, size, and location of the controls.
textName.Location = New System.Drawing.Point(120, 8)
textName.Size = New System.Drawing.Size(232, 20)
textName.TabIndex = 0
textAddress.Location = New System.Drawing.Point(120, 32)
textAddress.Size = New System.Drawing.Size(232, 20)
textAddress.TabIndex = 1
textCity.Location = New System.Drawing.Point(120, 56)
textCity.Size = New System.Drawing.Size(96, 20)
textCity.TabIndex = 2
textStateProvince.Location = New System.Drawing.Point(216, 56)
textStateProvince.Size = New System.Drawing.Size(56, 20)
textStateProvince.TabIndex = 3
textPostal.Location = New System.Drawing.Point(272, 56)
textPostal.Size = New System.Drawing.Size(80, 20)
textPostal.TabIndex = 4
textCountryRegion.Location = New System.Drawing.Point(120, 80)
textCountryRegion.Size = New System.Drawing.Size(232, 20)
textCountryRegion.TabIndex = 5
textEmail.Location = New System.Drawing.Point(120, 104)
textEmail.Size = New System.Drawing.Size(232, 20)
textEmail.TabIndex = 6
labelName.Location = New System.Drawing.Point(8, 8)
labelName.Size = New System.Drawing.Size(112, 23)
labelName.Text = "Name:"
labelName.TextAlign = System.Drawing.ContentAlignment.MiddleRight
labelAddress.Location = New System.Drawing.Point(8, 32)
labelAddress.Size = New System.Drawing.Size(112, 23)
labelAddress.Text = "Address:"
labelAddress.TextAlign = System.Drawing.ContentAlignment.MiddleRight
labelCityStateProvincePostal.Location = New System.Drawing.Point(8, 56)
labelCityStateProvincePostal.Size = New System.Drawing.Size(112, 23)
labelCityStateProvincePostal.Text = "City, St/Prov. Postal:"
labelCityStateProvincePostal.TextAlign = System.Drawing.ContentAlignment.MiddleRight
labelCountryRegion.Location = New System.Drawing.Point(8, 80)
labelCountryRegion.Size = New System.Drawing.Size(112, 23)
labelCountryRegion.Text = "Country/Region:"
labelCountryRegion.TextAlign = System.Drawing.ContentAlignment.MiddleRight
labelEmail.Location = New System.Drawing.Point(8, 104)
labelEmail.Size = New System.Drawing.Size(112, 23)
labelEmail.Text = "email:"
labelEmail.TextAlign = System.Drawing.ContentAlignment.MiddleRight
' Add the controls to the user control.
Controls.AddRange(New System.Windows.Forms.Control() {labelName, _
labelAddress, labelCityStateProvincePostal, labelCountryRegion, _
labelEmail, textName, textAddress, textCity, textStateProvince, _
textPostal, textCountryRegion, textEmail})
' Size the user control.
Size = New System.Drawing.Size(375, 150)
End Sub
Private Sub MyValidatingCode()
' Confirm there is text in the control.
If textEmail.Text.Length = 0 Then
Throw New Exception("Email address is a required field")
Else
' Confirm that there is a "." and an "@" in the email address.
If textEmail.Text.IndexOf(".") = - 1 Or textEmail.Text.IndexOf("@") = - 1 Then
Throw New Exception("Email address must be valid email address format." + _
Microsoft.VisualBasic.ControlChars.Cr + "For example 'someone@example.com'")
End If
End If
End Sub
' Validate the data input by the user into textEmail.
Private Sub textEmail_Validating(sender As Object, _
e As System.ComponentModel.CancelEventArgs) Handles textEmail.Validating
Try
MyValidatingCode()
Catch ex As Exception
' Cancel the event and select the text to be corrected by the user.
e.Cancel = True
textEmail.Select(0, textEmail.Text.Length)
' Set the ErrorProvider error with the text to display.
Me.errorProvider1.SetError(textEmail, ex.Message)
End Try
End Sub
Private Sub textEmail_Validated(sender As Object, _
e As System.EventArgs) Handles textEmail.Validated
' If all conditions have been met, clear the error provider of errors.
errorProvider1.SetError(textEmail, "")
End Sub
End Class
End Namespace
Remarks
By extending ContainerControl, UserControl inherits all the standard positioning and mnemonic-handling code that is necessary in a user control.
The UserControl gives you the ability to create controls that can be used in multiple places within an application or organization. You can include all the code needed for validation of common data you ask the user to input; some examples of this are email addresses (see Example section), telephone numbers, and postal codes. Another efficient use of the user control is to simply preload a ComboBox or ListBox with static items you commonly use in almost every application; some examples of this are countries/regions, cities, states, and office locations. For more information about authoring custom controls, see Developing Custom Windows Forms Controls with the .NET Framework.
Note
You might consider creating a namespace that contains several classes of user controls and compiling it into one DLL. This DLL can be referenced and distributed with the application or all applications within an organization. This gives you the ability to reference the user control in many applications and save time laying out and coding the contained elements of the user control. A user control also gives you consistency within or across applications; for example, all address information input blocks will all have the same appearance and behavior. Consistency gives your application a more polished and professional appearance.
You can host Windows Forms UserControl-derived classes inside of a form, on another UserControl, inside of Internet Explorer on a web page, or inside a WebBrowser control hosted on a form.
Note
When hosting a UserControl inside of the WebBrowser control, you cannot turn off Visual Styles using the META tag value MSThemeCompatible. For more information about Visual Styles, see Rendering Controls with Visual Styles.
Constructors
| UserControl() |
Initializes a new instance of the UserControl class. |
Fields
| ScrollStateAutoScrolling |
Determines the value of the AutoScroll property. (Inherited from ScrollableControl) |
| ScrollStateFullDrag |
Determines whether the user has enabled full window drag. (Inherited from ScrollableControl) |
| ScrollStateHScrollVisible |
Determines whether the value of the HScroll property is set to |
| ScrollStateUserHasScrolled |
Determines whether the user had scrolled through the ScrollableControl control. (Inherited from ScrollableControl) |
| ScrollStateVScrollVisible |
Determines whether the value of the VScroll property is set to |
Properties
| AccessibilityObject |
Gets the AccessibleObject assigned to the control. (Inherited from Control) |
| AccessibleDefaultActionDescription |
Gets or sets the default action description of the control for use by accessibility client applications. (Inherited from Control) |
| AccessibleDescription |
Gets or sets the description of the control used by accessibility client applications. (Inherited from Control) |
| AccessibleName |
Gets or sets the name of the control used by accessibility client applications. (Inherited from Control) |
| AccessibleRole |
Gets or sets the accessible role of the control. (Inherited from Control) |
| ActiveControl |
Gets or sets the active control on the container control. (Inherited from ContainerControl) |
| AllowDrop |
Gets or sets a value indicating whether the control can accept data that the user drags onto it. (Inherited from Control) |
| Anchor |
Gets or sets the edges of the container to which a control is bound and determines how a control is resized with its parent. (Inherited from Control) |
| AutoScaleDimensions |
Gets or sets the dimensions that the control was designed to. (Inherited from ContainerControl) |
| AutoScaleFactor |
Gets the scaling factor between the current and design-time automatic scaling dimensions. (Inherited from ContainerControl) |
| AutoScaleMode |
Gets or sets the automatic scaling mode of the control. (Inherited from ContainerControl) |
| AutoScroll |
Gets or sets a value indicating whether the container enables the user to scroll to any controls placed outside of its visible boundaries. (Inherited from ScrollableControl) |
| AutoScrollMargin |
Gets or sets the size of the auto-scroll margin. (Inherited from ScrollableControl) |
| AutoScrollMinSize |
Gets or sets the minimum size of the auto-scroll. (Inherited from ScrollableControl) |
| AutoScrollOffset |
Gets or sets where this control is scrolled to in ScrollControlIntoView(Control). (Inherited from Control) |
| AutoScrollPosition |
Gets or sets the location of the auto-scroll position. (Inherited from ScrollableControl) |
| AutoSize |
This property is not relevant for this class. |
| AutoSize |
This property is not relevant for this class. (Inherited from Control) |
| AutoSizeMode |
Gets or sets how the control will resize itself. |
| AutoValidate |
Gets or sets how the control performs validation when the user changes focus to another control. |
| AutoValidate |
Gets or sets a value that indicates whether controls in this container will be automatically validated when the focus changes. (Inherited from ContainerControl) |
| BackColor |
Gets or sets the background color for the control. (Inherited from Control) |
| BackgroundImage |
Gets or sets the background image displayed in the control. (Inherited from Control) |
| BackgroundImageLayout |
Gets or sets the background image layout as defined in the ImageLayout enumeration. (Inherited from Control) |
| BindingContext |
Gets or sets the BindingContext for the control. (Inherited from ContainerControl) |
| BorderStyle |
Gets or sets the border style of the user control. |
| Bottom |
Gets the distance, in pixels, between the bottom edge of the control and the top edge of its container's client area. (Inherited from Control) |
| Bounds |
Gets or sets the size and location of the control including its nonclient elements, in pixels, relative to the parent control. (Inherited from Control) |
| CanEnableIme |
Gets a value indicating whether the ImeMode property can be set to an active value, to enable IME support. (Inherited from ContainerControl) |
| CanFocus |
Gets a value indicating whether the control can receive focus. (Inherited from Control) |
| CanRaiseEvents |
Determines if events can be raised on the control. (Inherited from Control) |
| CanSelect |
Gets a value indicating whether the control can be selected. (Inherited from Control) |
| Capture |
Gets or sets a value indicating whether the control has captured the mouse. (Inherited from Control) |
| CausesValidation |
Gets or sets a value indicating whether the control causes validation to be performed on any controls that require validation when it receives focus. (Inherited from Control) |
| ClientRectangle |
Gets the rectangle that represents the client area of the control. (Inherited from Control) |
| ClientSize |
Gets or sets the height and width of the client area of the control. (Inherited from Control) |
| CompanyName |
Gets the name of the company or creator of the application containing the control. (Inherited from Control) |
| Container |
Gets the IContainer that contains the Component. (Inherited from Component) |
| ContainsFocus |
Gets a value indicating whether the control, or one of its child controls, currently has the input focus. (Inherited from Control) |
| ContextMenu |
Gets or sets the shortcut menu associated with the control. (Inherited from Control) |
| ContextMenuStrip |
Gets or sets the ContextMenuStrip associated with this control. (Inherited from Control) |
| Controls |
Gets the collection of controls contained within the control. (Inherited from Control) |
| Created |
Gets a value indicating whether the control has been created. (Inherited from Control) |
| CreateParams |
Gets the required creation parameters when the control handle is created. |
| CreateParams |
Gets the required creation parameters when the control handle is created. (Inherited from ContainerControl) |
| CurrentAutoScaleDimensions |
Gets the current run-time dimensions of the screen. (Inherited from ContainerControl) |
| Cursor |
Gets or sets the cursor that is displayed when the mouse pointer is over the control. (Inherited from Control) |
| DataBindings |
Gets the data bindings for the control. (Inherited from Control) |
| DataContext |
Gets or sets the data context for the purpose of data binding. This is an ambient property. (Inherited from Control) |
| DefaultCursor |
Gets or sets the default cursor for the control. (Inherited from Control) |
| DefaultImeMode |
Gets the default Input Method Editor (IME) mode supported by the control. (Inherited from Control) |
| DefaultMargin |
Gets the space, in pixels, that is specified by default between controls. (Inherited from Control) |
| DefaultMaximumSize |
Gets the length and height, in pixels, that is specified as the default maximum size of a control. (Inherited from Control) |
| DefaultMinimumSize |
Gets the length and height, in pixels, that is specified as the default minimum size of a control. (Inherited from Control) |
| DefaultPadding |
Gets the default internal spacing, in pixels, of the contents of a control. (Inherited from Control) |
| DefaultSize |
Gets the default size of the control. |
| DesignMode |
Gets a value that indicates whether the Component is currently in design mode. (Inherited from Component) |
| DeviceDpi |
Gets the DPI value for the display device where the control is currently being displayed. (Inherited from Control) |
| DisplayRectangle |
Gets the rectangle that represents the virtual display area of the control. (Inherited from ScrollableControl) |
| Disposing |
Gets a value indicating whether the base Control class is in the process of disposing. (Inherited from Control) |
| Dock |
Gets or sets which control borders are docked to its parent control and determines how a control is resized with its parent. (Inherited from Control) |
| DockPadding |
Gets the dock padding settings for all edges of the control. (Inherited from ScrollableControl) |
| DoubleBuffered |
Gets or sets a value indicating whether this control should redraw its surface using a secondary buffer to reduce or prevent flicker. (Inherited from Control) |
| Enabled |
Gets or sets a value indicating whether the control can respond to user interaction. (Inherited from Control) |
| Events |
Gets the list of event handlers that are attached to this Component. (Inherited from Component) |
| Focused |
Gets a value indicating whether the control has input focus. (Inherited from Control) |
| Font |
Gets or sets the font of the text displayed by the control. (Inherited from Control) |
| FontHeight |
Gets or sets the height of the font of the control. (Inherited from Control) |
| ForeColor |
Gets or sets the foreground color of the control. (Inherited from Control) |
| Handle |
Gets the window handle that the control is bound to. (Inherited from Control) |
| HasChildren |
Gets a value indicating whether the control contains one or more child controls. (Inherited from Control) |
| Height |
Gets or sets the height of the control. (Inherited from Control) |
| HorizontalScroll |
Gets the characteristics associated with the horizontal scroll bar. (Inherited from ScrollableControl) |
| HScroll |
Gets or sets a value indicating whether the horizontal scroll bar is visible. (Inherited from ScrollableControl) |
| ImeMode |
Gets or sets the Input Method Editor (IME) mode of the control. (Inherited from Control) |
| ImeModeBase |
Gets or sets the IME mode of a control. (Inherited from Control) |
| InvokeRequired |
Gets a value indicating whether the caller must call an invoke method when making method calls to the control because the caller is on a different thread than the one the control was created on. (Inherited from Control) |
| IsAccessible |
Gets or sets a value indicating whether the control is visible to accessibility applications. (Inherited from Control) |
| IsAncestorSiteInDesignMode |
Indicates if one of the Ancestors of this control is sited and that site in DesignMode. This property is read-only. (Inherited from Control) |
| IsDisposed |
Gets a value indicating whether the control has been disposed of. (Inherited from Control) |
| IsHandleCreated |
Gets a value indicating whether the control has a handle associated with it. (Inherited from Control) |
| IsMirrored |
Gets a value indicating whether the control is mirrored. (Inherited from Control) |
| LayoutEngine |
Gets a cached instance of the control's layout engine. (Inherited from Control) |
| Left |
Gets or sets the distance, in pixels, between the left edge of the control and the left edge of its container's client area. (Inherited from Control) |
| Location |
Gets or sets the coordinates of the upper-left corner of the control relative to the upper-left corner of its container. (Inherited from Control) |
| Margin |
Gets or sets the space between controls. (Inherited from Control) |
| MaximumSize |
Gets or sets the size that is the upper limit that GetPreferredSize(Size) can specify. (Inherited from Control) |
| MinimumSize |
Gets or sets the size that is the lower limit that GetPreferredSize(Size) can specify. (Inherited from Control) |
| Name |
Gets or sets the name of the control. (Inherited from Control) |
| Padding |
Gets or sets padding within the control. (Inherited from Control) |
| Parent |
Gets or sets the parent container of the control. (Inherited from Control) |
| ParentForm |
Gets the form that the container control is assigned to. (Inherited from ContainerControl) |
| PreferredSize |
Gets the size of a rectangular area into which the control can fit. (Inherited from Control) |
| ProductName |
Gets the product name of the assembly containing the control. (Inherited from Control) |
| ProductVersion |
Gets the version of the assembly containing the control. (Inherited from Control) |
| RecreatingHandle |
Gets a value indicating whether the control is currently re-creating its handle. (Inherited from Control) |
| Region |
Gets or sets the window region associated with the control. (Inherited from Control) |
| RenderRightToLeft |
Obsolete.
Obsolete.
This property is now obsolete. (Inherited from Control) |
| ResizeRedraw |
Gets or sets a value indicating whether the control redraws itself when resized. (Inherited from Control) |
| Right |
Gets the distance, in pixels, between the right edge of the control and the left edge of its container's client area. (Inherited from Control) |
| RightToLeft |
Gets or sets a value indicating whether control's elements are aligned to support locales using right-to-left fonts. (Inherited from Control) |
| ScaleChildren |
Gets a value that determines the scaling of child controls. (Inherited from Control) |
| ShowFocusCues |
Gets a value indicating whether the control should display focus rectangles. (Inherited from Control) |
| ShowKeyboardCues |
Gets a value indicating whether the user interface is in the appropriate state to show or hide keyboard accelerators. (Inherited from Control) |
| Site |
Gets or sets the site of the control. (Inherited from Control) |
| Size |
Gets or sets the height and width of the control. (Inherited from Control) |
| TabIndex |
Gets or sets the tab order of the control within its container. (Inherited from Control) |
| TabStop |
Gets or sets a value indicating whether the user can give the focus to this control using the TAB key. (Inherited from Control) |
| Tag |
Gets or sets the object that contains data about the control. (Inherited from Control) |
| Text |
Gets or sets the text associated with this control. |
| Top |
Gets or sets the distance, in pixels, between the top edge of the control and the top edge of its container's client area. (Inherited from Control) |
| TopLevelControl |
Gets the parent control that is not parented by another Windows Forms control. Typically, this is the outermost Form that the control is contained in. (Inherited from Control) |
| UseWaitCursor |
Gets or sets a value indicating whether to use the wait cursor for the current control and all child controls. (Inherited from Control) |
| VerticalScroll |
Gets the characteristics associated with the vertical scroll bar. (Inherited from ScrollableControl) |
| Visible |
Gets or sets a value indicating whether the control and all its child controls are displayed. (Inherited from Control) |
| VScroll |
Gets or sets a value indicating whether the vertical scroll bar is visible. (Inherited from ScrollableControl) |
| Width |
Gets or sets the width of the control. (Inherited from Control) |
| WindowTarget |
This property is not relevant for this class. (Inherited from Control) |
Methods
| AccessibilityNotifyClients(AccessibleEvents, Int32, Int32) |
Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control . (Inherited from Control) |
| AccessibilityNotifyClients(AccessibleEvents, Int32) |
Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control. (Inherited from Control) |
| AdjustFormScrollbars(Boolean) |
Adjusts the scroll bars on the container based on the current control positions and the control currently selected. (Inherited from ContainerControl) |
| BeginInvoke(Action) |
Executes the specified delegate asynchronously on the thread that the control's underlying handle was created on. (Inherited from Control) |
| BeginInvoke(Delegate, Object[]) |
Executes the specified delegate asynchronously with the specified arguments, on the thread that the control's underlying handle was created on. (Inherited from Control) |
| BeginInvoke(Delegate) |
Executes the specified delegate asynchronously on the thread that the control's underlying handle was created on. (Inherited from Control) |
| BringToFront() |
Brings the control to the front of the z-order. (Inherited from Control) |
| Contains(Control) |
Retrieves a value indicating whether the specified control is a child of the control. (Inherited from Control) |
| CreateAccessibilityInstance() |
Creates a new accessibility object for the control. (Inherited from Control) |
| CreateControl() |
Forces the creation of the visible control, including the creation of the handle and any visible child controls. (Inherited from Control) |
| CreateControlsInstance() |
Creates a new instance of the control collection for the control. (Inherited from Control) |
| CreateGraphics() |
Creates the Graphics for the control. (Inherited from Control) |
| CreateHandle() |
Creates a handle for the control. (Inherited from Control) |
| CreateObjRef(Type) |
Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from MarshalByRefObject) |
| DefWndProc(Message) |
Sends the specified message to the default window procedure. (Inherited from Control) |
| DestroyHandle() |
Destroys the handle associated with the control. (Inherited from Control) |
| Dispose() |
Releases all resources used by the Component. (Inherited from Component) |
| Dispose(Boolean) |
Releases the unmanaged resources used by the Control and its child controls and optionally releases the managed resources. (Inherited from ContainerControl) |
| DoDragDrop(Object, DragDropEffects, Bitmap, Point, Boolean) |
Begins a drag operation. (Inherited from Control) |
| DoDragDrop(Object, DragDropEffects) |
Begins a drag-and-drop operation. (Inherited from Control) |
| DrawToBitmap(Bitmap, Rectangle) |
Supports rendering to the specified bitmap. (Inherited from Control) |
| EndInvoke(IAsyncResult) |
Retrieves the return value of the asynchronous operation represented by the IAsyncResult passed. (Inherited from Control) |
| Equals(Object) |
Determines whether the specified object is equal to the current object. (Inherited from Object) |
| FindForm() |
Retrieves the form that the control is on. (Inherited from Control) |
| Focus() |
Sets input focus to the control. (Inherited from Control) |
| GetAccessibilityObjectById(Int32) |
Retrieves the specified AccessibleObject. (Inherited from Control) |
| GetAutoSizeMode() |
Retrieves a value indicating how a control will behave when its AutoSize property is enabled. (Inherited from Control) |
| GetChildAtPoint(Point, GetChildAtPointSkip) |
Retrieves the child control that is located at the specified coordinates, specifying whether to ignore child controls of a certain type. (Inherited from Control) |
| GetChildAtPoint(Point) |
Retrieves the child control that is located at the specified coordinates. (Inherited from Control) |
| GetContainerControl() |
Returns the next ContainerControl up the control's chain of parent controls. (Inherited from Control) |
| GetHashCode() |
Serves as the default hash function. (Inherited from Object) |
| GetLifetimeService() |
Obsolete.
Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject) |
| GetNextControl(Control, Boolean) |
Retrieves the next control forward or back in the tab order of child controls. (Inherited from Control) |
| GetPreferredSize(Size) |
Retrieves the size of a rectangular area into which a control can be fitted. (Inherited from Control) |
| GetScaledBounds(Rectangle, SizeF, BoundsSpecified) |
Retrieves the bounds within which the control is scaled. (Inherited from Control) |
| GetScrollState(Int32) |
Determines whether the specified flag has been set. (Inherited from ScrollableControl) |
| GetService(Type) |
Returns an object that represents a service provided by the Component or by its Container. (Inherited from Component) |
| GetStyle(ControlStyles) |
Retrieves the value of the specified control style bit for the control. (Inherited from Control) |
| GetTopLevel() |
Determines if the control is a top-level control. (Inherited from Control) |
| GetType() |
Gets the Type of the current instance. (Inherited from Object) |
| Hide() |
Conceals the control from the user. (Inherited from Control) |
| InitializeLifetimeService() |
Obsolete.
Obtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject) |
| InitLayout() |
Called after the control has been added to another container. (Inherited from Control) |
| Invalidate() |
Invalidates the entire surface of the control and causes the control to be redrawn. (Inherited from Control) |
| Invalidate(Boolean) |
Invalidates a specific region of the control and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control. (Inherited from Control) |
| Invalidate(Rectangle, Boolean) |
Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control. (Inherited from Control) |
| Invalidate(Rectangle) |
Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. (Inherited from Control) |
| Invalidate(Region, Boolean) |
Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control. (Inherited from Control) |
| Invalidate(Region) |
Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. (Inherited from Control) |
| Invoke(Action) |
Executes the specified delegate on the thread that owns the control's underlying window handle. (Inherited from Control) |
| Invoke(Delegate, Object[]) |
Executes the specified delegate, on the thread that owns the control's underlying window handle, with the specified list of arguments. (Inherited from Control) |
| Invoke(Delegate) |
Executes the specified delegate on the thread that owns the control's underlying window handle. (Inherited from Control) |
| Invoke<T>(Func<T>) |
Executes the specified delegate on the thread that owns the control's underlying window handle. (Inherited from Control) |
| InvokeAsync(Action, CancellationToken) |
Invokes the specified synchronous callback asynchronously on the thread that owns the control's handle. (Inherited from Control) |
| InvokeAsync(Func<CancellationToken,ValueTask>, CancellationToken) |
Executes the specified asynchronous callback on the thread that owns the control's handle asynchronously. (Inherited from Control) |
| InvokeAsync<T>(Func<CancellationToken,ValueTask<T>>, CancellationToken) |
Executes the specified asynchronous callback on the thread that owns the control's handle. (Inherited from Control) |
| InvokeAsync<T>(Func<T>, CancellationToken) |
Invokes the specified synchronous callback asynchronously on the thread that owns the control's handle. (Inherited from Control) |
| InvokeGotFocus(Control, EventArgs) |
Raises the GotFocus event for the specified control. (Inherited from Control) |
| InvokeLostFocus(Control, EventArgs) |
Raises the LostFocus event for the specified control. (Inherited from Control) |
| InvokeOnClick(Control, EventArgs) |
Raises the Click event for the specified control. (Inherited from Control) |
| InvokePaint(Control, PaintEventArgs) |
Raises the Paint event for the specified control. (Inherited from Control) |
| InvokePaintBackground(Control, PaintEventArgs) |
Raises the |
| IsInputChar(Char) |
Determines if a character is an input character that the control recognizes. (Inherited from Control) |
| IsInputKey(Keys) |
Determines whether the specified key is a regular input key or a special key that requires preprocessing. (Inherited from Control) |
| LogicalToDeviceUnits(Int32) |
Converts a Logical DPI value to its equivalent DeviceUnit DPI value. (Inherited from Control) |
| LogicalToDeviceUnits(Size) |
Transforms a size from logical to device units by scaling it for the current DPI and rounding down to the nearest integer value for width and height. (Inherited from Control) |
| MemberwiseClone() |
Creates a shallow copy of the current Object. (Inherited from Object) |
| MemberwiseClone(Boolean) |
Creates a shallow copy of the current MarshalByRefObject object. (Inherited from MarshalByRefObject) |
| NotifyInvalidate(Rectangle) |
Raises the Invalidated event with a specified region of the control to invalidate. (Inherited from Control) |
| OnAutoSizeChanged(EventArgs) |
Raises the AutoSizeChanged event. (Inherited from Control) |
| OnAutoValidateChanged(EventArgs) |
Raises the AutoValidateChanged event. (Inherited from ContainerControl) |
| OnBackColorChanged(EventArgs) |
Raises the BackColorChanged event. (Inherited from Control) |
| OnBackgroundImageChanged(EventArgs) |
Raises the BackgroundImageChanged event. (Inherited from Control) |
| OnBackgroundImageLayoutChanged(EventArgs) |
Raises the BackgroundImageLayoutChanged event. (Inherited from Control) |
| OnBindingContextChanged(EventArgs) |
Raises the BindingContextChanged event. (Inherited from Control) |
| OnCausesValidationChanged(EventArgs) |
Raises the CausesValidationChanged event. (Inherited from Control) |
| OnChangeUICues(UICuesEventArgs) |
Raises the ChangeUICues event. (Inherited from Control) |
| OnClick(EventArgs) |
Raises the Click event. (Inherited from Control) |
| OnClientSizeChanged(EventArgs) |
Raises the ClientSizeChanged event. (Inherited from Control) |
| OnContextMenuChanged(EventArgs) |
Raises the ContextMenuChanged event. (Inherited from Control) |
| OnContextMenuStripChanged(EventArgs) |
Raises the ContextMenuStripChanged event. (Inherited from Control) |
| OnControlAdded(ControlEventArgs) |
Raises the ControlAdded event. (Inherited from Control) |
| OnControlRemoved(ControlEventArgs) |
Raises the ControlRemoved event. (Inherited from Control) |
| OnCreateControl() |
Raises the |
| OnCursorChanged(EventArgs) |
Raises the CursorChanged event. (Inherited from Control) |
| OnDataContextChanged(EventArgs) | (Inherited from Control) |
| OnDockChanged(EventArgs) |
Raises the DockChanged event. (Inherited from Control) |
| OnDoubleClick(EventArgs) |
Raises the DoubleClick event. (Inherited from Control) |
| OnDpiChangedAfterParent(EventArgs) |
Raises the DpiChangedAfterParent event. (Inherited from Control) |
| OnDpiChangedBeforeParent(EventArgs) |
Raises the DpiChangedBeforeParent event. (Inherited from Control) |
| OnDragDrop(DragEventArgs) |
Raises the DragDrop event. (Inherited from Control) |
| OnDragEnter(DragEventArgs) |
Raises the DragEnter event. (Inherited from Control) |
| OnDragLeave(EventArgs) |
Raises the DragLeave event. (Inherited from Control) |
| OnDragOver(DragEventArgs) |
Raises the DragOver event. (Inherited from Control) |
| OnEnabledChanged(EventArgs) |
Raises the EnabledChanged event. (Inherited from Control) |
| OnEnter(EventArgs) |
Raises the Enter event. (Inherited from Control) |
| OnFontChanged(EventArgs) |
Raises the FontChanged event. (Inherited from ContainerControl) |
| OnForeColorChanged(EventArgs) |
Raises the ForeColorChanged event. (Inherited from Control) |
| OnGiveFeedback(GiveFeedbackEventArgs) |
Raises the GiveFeedback event. (Inherited from Control) |
| OnGotFocus(EventArgs) |
Raises the GotFocus event. (Inherited from Control) |
| OnHandleCreated(EventArgs) |
Raises the HandleCreated event. (Inherited from Control) |
| OnHandleDestroyed(EventArgs) |
Raises the HandleDestroyed event. (Inherited from Control) |
| OnHelpRequested(HelpEventArgs) |
Raises the HelpRequested event. (Inherited from Control) |
| OnImeModeChanged(EventArgs) |
Raises the ImeModeChanged event. (Inherited from Control) |
| OnInvalidated(InvalidateEventArgs) |
Raises the Invalidated event. (Inherited from Control) |
| OnKeyDown(KeyEventArgs) |
Raises the KeyDown event. (Inherited from Control) |
| OnKeyPress(KeyPressEventArgs) |
Raises the KeyPress event. (Inherited from Control) |
| OnKeyUp(KeyEventArgs) |
Raises the KeyUp event. (Inherited from Control) |
| OnLayout(LayoutEventArgs) |
Raises the Layout event. (Inherited from ContainerControl) |
| OnLeave(EventArgs) |
Raises the Leave event. (Inherited from Control) |
| OnLoad(EventArgs) |
Raises the Load event. |
| OnLocationChanged(EventArgs) |
Raises the LocationChanged event. (Inherited from Control) |
| OnLostFocus(EventArgs) |
Raises the LostFocus event. (Inherited from Control) |
| OnMarginChanged(EventArgs) |
Raises the MarginChanged event. (Inherited from Control) |
| OnMouseCaptureChanged(EventArgs) |
Raises the MouseCaptureChanged event. (Inherited from Control) |
| OnMouseClick(MouseEventArgs) |
Raises the MouseClick event. (Inherited from Control) |
| OnMouseDoubleClick(MouseEventArgs) |
Raises the MouseDoubleClick event. (Inherited from Control) |
| OnMouseDown(MouseEventArgs) |
Raises the MouseDown event. |
| OnMouseEnter(EventArgs) |
Raises the MouseEnter event. (Inherited from Control) |
| OnMouseHover(EventArgs) |
Raises the MouseHover event. (Inherited from Control) |
| OnMouseLeave(EventArgs) |
Raises the MouseLeave event. (Inherited from Control) |
| OnMouseMove(MouseEventArgs) |
Raises the MouseMove event. (Inherited from Control) |
| OnMouseUp(MouseEventArgs) |
Raises the MouseUp event. (Inherited from Control) |
| OnMouseWheel(MouseEventArgs) |
Raises the MouseWheel event. (Inherited from ScrollableControl) |
| OnMove(EventArgs) | (Inherited from ContainerControl) |
| OnNotifyMessage(Message) |
Notifies the control of Windows messages. (Inherited from Control) |
| OnPaddingChanged(EventArgs) |
Raises the PaddingChanged event. (Inherited from ScrollableControl) |
| OnPaint(PaintEventArgs) |
Raises the Paint event. (Inherited from Control) |
| OnPaintBackground(PaintEventArgs) |
Paints the background of the control. (Inherited from ScrollableControl) |
| OnParentBackColorChanged(EventArgs) |
Raises the BackColorChanged event when the BackColor property value of the control's container changes. (Inherited from Control) |
| OnParentBackgroundImageChanged(EventArgs) |
Raises the BackgroundImageChanged event when the BackgroundImage property value of the control's container changes. (Inherited from Control) |
| OnParentBindingContextChanged(EventArgs) |
Raises the BindingContextChanged event when the BindingContext property value of the control's container changes. (Inherited from Control) |
| OnParentChanged(EventArgs) |
Raises the ParentChanged event. (Inherited from ContainerControl) |
| OnParentCursorChanged(EventArgs) |
Raises the CursorChanged event. (Inherited from Control) |
| OnParentDataContextChanged(EventArgs) | (Inherited from Control) |
| OnParentEnabledChanged(EventArgs) |
Raises the EnabledChanged event when the Enabled property value of the control's container changes. (Inherited from Control) |
| OnParentFontChanged(EventArgs) |
Raises the FontChanged event when the Font property value of the control's container changes. (Inherited from Control) |
| OnParentForeColorChanged(EventArgs) |
Raises the ForeColorChanged event when the ForeColor property value of the control's container changes. (Inherited from Control) |
| OnParentRightToLeftChanged(EventArgs) |
Raises the RightToLeftChanged event when the RightToLeft property value of the control's container changes. (Inherited from Control) |
| OnParentVisibleChanged(EventArgs) |
Raises the VisibleChanged event when the Visible property value of the control's container changes. (Inherited from Control) |
| OnPreviewKeyDown(PreviewKeyDownEventArgs) |
Raises the PreviewKeyDown event. (Inherited from Control) |
| OnPrint(PaintEventArgs) |
Raises the Paint event. (Inherited from Control) |
| OnQueryContinueDrag(QueryContinueDragEventArgs) |
Raises the QueryContinueDrag event. (Inherited from Control) |
| OnRegionChanged(EventArgs) |
Raises the RegionChanged event. (Inherited from Control) |
| OnResize(EventArgs) |
Raises the Resize event. |
| OnResize(EventArgs) | (Inherited from ContainerControl) |
| OnRightToLeftChanged(EventArgs) |
Raises the RightToLeftChanged event. (Inherited from ScrollableControl) |
| OnScroll(ScrollEventArgs) |
Raises the Scroll event. (Inherited from ScrollableControl) |
| OnSizeChanged(EventArgs) |
Raises the SizeChanged event. (Inherited from Control) |
| OnStyleChanged(EventArgs) |
Raises the StyleChanged event. (Inherited from Control) |
| OnSystemColorsChanged(EventArgs) |
Raises the SystemColorsChanged event. (Inherited from Control) |
| OnTabIndexChanged(EventArgs) |
Raises the TabIndexChanged event. (Inherited from Control) |
| OnTabStopChanged(EventArgs) |
Raises the TabStopChanged event. (Inherited from Control) |
| OnTextChanged(EventArgs) |
Raises the TextChanged event. (Inherited from Control) |
| OnValidated(EventArgs) |
Raises the Validated event. (Inherited from Control) |
| OnValidating(CancelEventArgs) |
Raises the Validating event. (Inherited from Control) |
| OnVisibleChanged(EventArgs) |
Raises the VisibleChanged event. (Inherited from ScrollableControl) |
| PerformAutoScale() |
Performs scaling of the container control and its children. (Inherited from ContainerControl) |
| PerformLayout() |
Forces the control to apply layout logic to all its child controls. (Inherited from Control) |
| PerformLayout(Control, String) |
Forces the control to apply layout logic to all its child controls. (Inherited from Control) |
| PointToClient(Point) |
Computes the location of the specified screen point into client coordinates. (Inherited from Control) |
| PointToScreen(Point) |
Computes the location of the specified client point into screen coordinates. (Inherited from Control) |
| PreProcessControlMessage(Message) |
Preprocesses keyboard or input messages within the message loop before they are dispatched. (Inherited from Control) |
| PreProcessMessage(Message) |
Preprocesses keyboard or input messages within the message loop before they are dispatched. (Inherited from Control) |
| ProcessCmdKey(Message, Keys) |
Processes a command key. (Inherited from ContainerControl) |
| ProcessDialogChar(Char) |
Processes a dialog character. (Inherited from ContainerControl) |
| ProcessDialogKey(Keys) |
Processes a dialog key. (Inherited from ContainerControl) |
| ProcessKeyEventArgs(Message) |
Processes a key message and generates the appropriate control events. (Inherited from Control) |
| ProcessKeyMessage(Message) |
Processes a keyboard message. (Inherited from Control) |
| ProcessKeyPreview(Message) |
Previews a keyboard message. (Inherited from Control) |
| ProcessMnemonic(Char) |
Processes a mnemonic character. (Inherited from ContainerControl) |
| ProcessTabKey(Boolean) |
Selects the next available control and makes it the active control. (Inherited from ContainerControl) |
| RaiseDragEvent(Object, DragEventArgs) |
Raises the appropriate drag event. (Inherited from Control) |
| RaiseKeyEvent(Object, KeyEventArgs) |
Raises the appropriate key event. (Inherited from Control) |
| RaiseMouseEvent(Object, MouseEventArgs) |
Raises the appropriate mouse event. (Inherited from Control) |
| RaisePaintEvent(Object, PaintEventArgs) |
Raises the appropriate paint event. (Inherited from Control) |
| RecreateHandle() |
Forces the re-creation of the handle for the control. (Inherited from Control) |
| RectangleToClient(Rectangle) |
Computes the size and location of the specified screen rectangle in client coordinates. (Inherited from Control) |
| RectangleToScreen(Rectangle) |
Computes the size and location of the specified client rectangle in screen coordinates. (Inherited from Control) |
| Refresh() |
Forces the control to invalidate its client area and immediately redraw itself and any child controls. (Inherited from Control) |
| RescaleConstantsForDpi(Int32, Int32) | (Inherited from ContainerControl) |
| ResetBackColor() |
Resets the BackColor property to its default value. (Inherited from Control) |
| ResetBindings() |
Causes a control bound to the BindingSource to reread all the items in the list and refresh their displayed values. (Inherited from Control) |
| ResetCursor() |
Resets the Cursor property to its default value. (Inherited from Control) |
| ResetFont() |
Resets the Font property to its default value. (Inherited from Control) |
| ResetForeColor() |
Resets the ForeColor property to its default value. (Inherited from Control) |
| ResetImeMode() |
Resets the ImeMode property to its default value. (Inherited from Control) |
| ResetMouseEventArgs() |
Resets the control to handle the MouseLeave event. (Inherited from Control) |
| ResetRightToLeft() |
Resets the RightToLeft property to its default value. (Inherited from Control) |
| ResetText() |
Resets the Text property to its default value (Empty). (Inherited from Control) |
| ResumeLayout() |
Resumes usual layout logic. (Inherited from Control) |
| ResumeLayout(Boolean) |
Resumes usual layout logic, optionally forcing an immediate layout of pending layout requests. (Inherited from Control) |
| RtlTranslateAlignment(ContentAlignment) |
Converts the specified ContentAlignment to the appropriate ContentAlignment to support right-to-left text. (Inherited from Control) |
| RtlTranslateAlignment(HorizontalAlignment) |
Converts the specified HorizontalAlignment to the appropriate HorizontalAlignment to support right-to-left text. (Inherited from Control) |
| RtlTranslateAlignment(LeftRightAlignment) |
Converts the specified LeftRightAlignment to the appropriate LeftRightAlignment to support right-to-left text. (Inherited from Control) |
| RtlTranslateContent(ContentAlignment) |
Converts the specified ContentAlignment to the appropriate ContentAlignment to support right-to-left text. (Inherited from Control) |
| RtlTranslateHorizontal(HorizontalAlignment) |
Converts the specified HorizontalAlignment to the appropriate HorizontalAlignment to support right-to-left text. (Inherited from Control) |
| RtlTranslateLeftRight(LeftRightAlignment) |
Converts the specified LeftRightAlignment to the appropriate LeftRightAlignment to support right-to-left text. (Inherited from Control) |
| Scale(Single, Single) |
Obsolete.
Obsolete.
Scales the entire control and any child controls. (Inherited from Control) |
| Scale(Single) |
Obsolete.
Obsolete.
Scales the control and any child controls. (Inherited from Control) |
| Scale(SizeF) |
Scales the control and all child controls by the specified scaling factor. (Inherited from Control) |
| ScaleBitmapLogicalToDevice(Bitmap) |
Scales a logical bitmap value to it's equivalent device unit value when a DPI change occurs. (Inherited from Control) |
| ScaleControl(SizeF, BoundsSpecified) |
Scales a control's location, size, padding and margin. (Inherited from ScrollableControl) |
| ScaleCore(Single, Single) |
This method is not relevant for this class. (Inherited from ScrollableControl) |
| ScaleMinMaxSize(Single, Single, Boolean) |
Scales the size of the container's |
| ScrollControlIntoView(Control) |
Scrolls the specified child control into view on an auto-scroll enabled control. (Inherited from ScrollableControl) |
| ScrollToControl(Control) |
Calculates the scroll offset to the specified child control. (Inherited from ScrollableControl) |
| Select() |
Activates the control. (Inherited from Control) |
| Select(Boolean, Boolean) |
Activates a child control. Optionally specifies the direction in the tab order to select the control from. (Inherited from ContainerControl) |
| SelectNextControl(Control, Boolean, Boolean, Boolean, Boolean) |
Activates the next control. (Inherited from Control) |
| SendToBack() |
Sends the control to the back of the z-order. (Inherited from Control) |
| SetAutoScrollMargin(Int32, Int32) |
Sets the size of the auto-scroll margins. (Inherited from ScrollableControl) |
| SetAutoSizeMode(AutoSizeMode) |
Sets a value indicating how a control will behave when its AutoSize property is enabled. (Inherited from Control) |
| SetBounds(Int32, Int32, Int32, Int32, BoundsSpecified) |
Sets the specified bounds of the control to the specified location and size. (Inherited from Control) |
| SetBounds(Int32, Int32, Int32, Int32) |
Sets the bounds of the control to the specified location and size. (Inherited from Control) |
| SetBoundsCore(Int32, Int32, Int32, Int32, BoundsSpecified) |
Performs the work of setting the specified bounds of this control. (Inherited from Control) |
| SetClientSizeCore(Int32, Int32) |
Sets the size of the client area of the control. (Inherited from Control) |
| SetDisplayRectLocation(Int32, Int32) |
Positions the display window to the specified value. (Inherited from ScrollableControl) |
| SetScrollState(Int32, Boolean) |
Sets the specified scroll state flag. (Inherited from ScrollableControl) |
| SetStyle(ControlStyles, Boolean) |
Sets a specified ControlStyles flag to either |
| SetTopLevel(Boolean) |
Sets the control as the top-level control. (Inherited from Control) |
| SetVisibleCore(Boolean) |
Sets the control to the specified visible state. (Inherited from Control) |
| Show() |
Displays the control to the user. (Inherited from Control) |
| SizeFromClientSize(Size) |
Determines the size of the entire control from the height and width of its client area. (Inherited from Control) |
| SuspendLayout() |
Temporarily suspends the layout logic for the control. (Inherited from Control) |
| ToString() |
Returns a String containing the name of the Component, if any. This method should not be overridden. (Inherited from Component) |
| Update() |
Causes the control to redraw the invalidated regions within its client area. (Inherited from Control) |
| UpdateBounds() |
Updates the bounds of the control with the current size and location. (Inherited from Control) |
| UpdateBounds(Int32, Int32, Int32, Int32, Int32, Int32) |
Updates the bounds of the control with the specified size, location, and client size. (Inherited from Control) |
| UpdateBounds(Int32, Int32, Int32, Int32) |
Updates the bounds of the control with the specified size and location. (Inherited from Control) |
| UpdateDefaultButton() |
When overridden by a derived class, updates which button is the default button. (Inherited from ContainerControl) |
| UpdateStyles() |
Forces the assigned styles to be reapplied to the control. (Inherited from Control) |
| UpdateZOrder() |
Updates the control in its parent's z-order. (Inherited from Control) |
| Validate() |
Verifies the value of the control losing focus by causing the Validating and Validated events to occur, in that order. (Inherited from ContainerControl) |
| Validate(Boolean) |
Verifies the value of the control that is losing focus; conditionally dependent on whether automatic validation is turned on. (Inherited from ContainerControl) |
| ValidateChildren() |
Causes all of the child controls within a control that support validation to validate their data. |
| ValidateChildren() |
Causes all of the child controls within a control that support validation to validate their data. (Inherited from ContainerControl) |
| ValidateChildren(ValidationConstraints) |
Causes all of the child controls within a control that support validation to validate their data. |
| ValidateChildren(ValidationConstraints) |
Causes all of the child controls within a control that support validation to validate their data. (Inherited from ContainerControl) |
| WndProc(Message) |
Processes Windows messages. |
Events
| AutoSizeChanged |
Occurs when the AutoSize property changes. |
| AutoSizeChanged |
This event is not relevant for this class. (Inherited from Control) |
| AutoValidateChanged |
Occurs when the AutoValidate property changes. |
| AutoValidateChanged |
Occurs when the AutoValidate property changes. (Inherited from ContainerControl) |
| BackColorChanged |
Occurs when the value of the BackColor property changes. (Inherited from Control) |
| BackgroundImageChanged |
Occurs when the value of the BackgroundImage property changes. (Inherited from Control) |
| BackgroundImageLayoutChanged |
Occurs when the BackgroundImageLayout property changes. (Inherited from Control) |
| BindingContextChanged |
Occurs when the value of the BindingContext property changes. (Inherited from Control) |
| CausesValidationChanged |
Occurs when the value of the CausesValidation property changes. (Inherited from Control) |
| ChangeUICues |
Occurs when the focus or keyboard user interface (UI) cues change. (Inherited from Control) |
| Click |
Occurs when the control is clicked. (Inherited from Control) |
| ClientSizeChanged |
Occurs when the value of the ClientSize property changes. (Inherited from Control) |
| ContextMenuChanged |
Occurs when the value of the ContextMenu property changes. (Inherited from Control) |
| ContextMenuStripChanged |
Occurs when the value of the ContextMenuStrip property changes. (Inherited from Control) |
| ControlAdded |
Occurs when a new control is added to the Control.ControlCollection. (Inherited from Control) |
| ControlRemoved |
Occurs when a control is removed from the Control.ControlCollection. (Inherited from Control) |
| CursorChanged |
Occurs when the value of the Cursor property changes. (Inherited from Control) |
| DataContextChanged |
Occurs when the value of the DataContext property changes. (Inherited from Control) |
| Disposed |
Occurs when the component is disposed by a call to the Dispose() method. (Inherited from Component) |
| DockChanged |
Occurs when the value of the Dock property changes. (Inherited from Control) |
| DoubleClick |
Occurs when the control is double-clicked. (Inherited from Control) |
| DpiChangedAfterParent |
Occurs when the DPI setting for a control is changed programmatically after the DPI of its parent control or form has changed. (Inherited from Control) |
| DpiChangedBeforeParent |
Occurs when the DPI setting for a control is changed programmatically before a DPI change event for its parent control or form has occurred. (Inherited from Control) |
| DragDrop |
Occurs when a drag-and-drop operation is completed. (Inherited from Control) |
| DragEnter |
Occurs when an object is dragged into the control's bounds. (Inherited from Control) |
| DragLeave |
Occurs when an object is dragged out of the control's bounds. (Inherited from Control) |
| DragOver |
Occurs when an object is dragged over the control's bounds. (Inherited from Control) |
| EnabledChanged |
Occurs when the Enabled property value has changed. (Inherited from Control) |
| Enter |
Occurs when the control is entered. (Inherited from Control) |
| FontChanged |
Occurs when the Font property value changes. (Inherited from Control) |
| ForeColorChanged |
Occurs when the ForeColor property value changes. (Inherited from Control) |
| GiveFeedback |
Occurs during a drag operation. (Inherited from Control) |
| GotFocus |
Occurs when the control receives focus. (Inherited from Control) |
| HandleCreated |
Occurs when a handle is created for the control. (Inherited from Control) |
| HandleDestroyed |
Occurs when the control's handle is in the process of being destroyed. (Inherited from Control) |
| HelpRequested |
Occurs when the user requests help for a control. (Inherited from Control) |
| ImeModeChanged |
Occurs when the ImeMode property has changed. (Inherited from Control) |
| Invalidated |
Occurs when a control's display requires redrawing. (Inherited from Control) |
| KeyDown |
Occurs when a key is pressed while the control has focus. (Inherited from Control) |
| KeyPress |
Occurs when a character, space, or backspace key is pressed while the control has focus. (Inherited from Control) |
| KeyUp |
Occurs when a key is released while the control has focus. (Inherited from Control) |
| Layout |
Occurs when a control should reposition its child controls. (Inherited from Control) |
| Leave |
Occurs when the input focus leaves the control. (Inherited from Control) |
| Load |
Occurs before the control becomes visible for the first time. |
| LocationChanged |
Occurs when the Location property value has changed. (Inherited from Control) |
| LostFocus |
Occurs when the control loses focus. (Inherited from Control) |
| MarginChanged |
Occurs when the control's margin changes. (Inherited from Control) |
| MouseCaptureChanged |
Occurs when the control loses mouse capture. (Inherited from Control) |
| MouseClick |
Occurs when the control is clicked by the mouse. (Inherited from Control) |
| MouseDoubleClick |
Occurs when the control is double clicked by the mouse. (Inherited from Control) |
| MouseDown |
Occurs when the mouse pointer is over the control and a mouse button is pressed. (Inherited from Control) |
| MouseEnter |
Occurs when the mouse pointer enters the control. (Inherited from Control) |
| MouseHover |
Occurs when the mouse pointer rests on the control. (Inherited from Control) |
| MouseLeave |
Occurs when the mouse pointer leaves the control. (Inherited from Control) |
| MouseMove |
Occurs when the mouse pointer is moved over the control. (Inherited from Control) |
| MouseUp |
Occurs when the mouse pointer is over the control and a mouse button is released. (Inherited from Control) |
| MouseWheel |
Occurs when the mouse wheel moves while the control has focus. (Inherited from Control) |
| Move |
Occurs when the control is moved. (Inherited from Control) |
| PaddingChanged |
Occurs when the control's padding changes. (Inherited from Control) |
| Paint |
Occurs when the control is redrawn. (Inherited from Control) |
| ParentChanged |
Occurs when the Parent property value changes. (Inherited from Control) |
| PreviewKeyDown |
Occurs before the KeyDown event when a key is pressed while focus is on this control. (Inherited from Control) |
| QueryAccessibilityHelp |
Occurs when AccessibleObject is providing help to accessibility applications. (Inherited from Control) |
| QueryContinueDrag |
Occurs during a drag-and-drop operation and enables the drag source to determine whether the drag-and-drop operation should be canceled. (Inherited from Control) |
| RegionChanged |
Occurs when the value of the Region property changes. (Inherited from Control) |
| Resize |
Occurs when the control is resized. (Inherited from Control) |
| RightToLeftChanged |
Occurs when the RightToLeft property value changes. (Inherited from Control) |
| Scroll |
Occurs when the user or code scrolls through the client area. (Inherited from ScrollableControl) |
| SizeChanged |
Occurs when the Size property value changes. (Inherited from Control) |
| StyleChanged |
Occurs when the control style changes. (Inherited from Control) |
| SystemColorsChanged |
Occurs when the system colors change. (Inherited from Control) |
| TabIndexChanged |
Occurs when the TabIndex property value changes. (Inherited from Control) |
| TabStopChanged |
Occurs when the TabStop property value changes. (Inherited from Control) |
| TextChanged |
Raises the TextChanged event. |
| Validated |
Occurs when the control is finished validating. (Inherited from Control) |
| Validating |
Occurs when the control is validating. (Inherited from Control) |
| VisibleChanged |
Occurs when the Visible property value changes. (Inherited from Control) |
Explicit Interface Implementations
| IContainerControl.ActivateControl(Control) |
Activates the specified control. (Inherited from ContainerControl) |
| IDropTarget.OnDragDrop(DragEventArgs) |
Raises the DragDrop event. (Inherited from Control) |
| IDropTarget.OnDragEnter(DragEventArgs) |
Raises the DragEnter event. (Inherited from Control) |
| IDropTarget.OnDragLeave(EventArgs) |
Raises the DragLeave event. (Inherited from Control) |
| IDropTarget.OnDragOver(DragEventArgs) |
Raises the DragOver event. (Inherited from Control) |
