System.Windows.Forms
1.0.5000.0
2.0.0.0
System.Windows.Forms.ScrollableControl
System.Windows.Forms.IContainerControl
A represents a control that can function as a container for other controls and provides focus management. Controls that inherit from this class can track the active control they contain, even when the focus moves somewhere within a different container.
objects provide a logical boundary for contained controls. The container control can capture the TAB key press and move focus to the next control in the collection.
The container control does not receive focus; the focus is always set to the first child control in the collection of contained controls.
You do not typically inherit directly from the class. , , and classes inherit from .
Provides focus-management functionality for controls that can function as a container for other controls.
Constructor
To be added.
Initializes a new instance of the class.
1.0.5000.0
2.0.0.0
Property
System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)
System.ComponentModel.Browsable(false)
System.Windows.Forms.Control
To be added.
The property activates or retrieves the active control on the container control.
In order to receive a valid value from this property, the object that calls it must either contain or be contained in the control it is calling. If one form tries to call another form's properties, it will receive an undefined value. In this case, you need to define your own communication mechanism between the forms to pass this data.
Gets or sets the active control on the container control.
1.0.5000.0
2.0.0.0
Method
System.Void
To be added.
To be added.
To be added.
1.0.5000.0
2.0.0.0
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Advanced)
Property
System.Drawing.SizeF
To be added.
The property represents the DPI or font setting of the screen that the control was scaled to or designed for. Specifically, at design time this property will be set by the Windows Forms designer to the value your monitor is currently using. Then, when the form loads at run time, if the property is different from the , the method will be called to perform scaling of the control and all of its children. Afterwards, will be updated to reflect the new scaling size.
For more information about automatic scaling, see Automatic Scaling in Windows Forms.
Gets or sets the dimensions that the control was designed to.
2.0.0.0
System.ComponentModel.Localizable(true)
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Advanced)
System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)
System.ComponentModel.Browsable(false)
Property
System.Drawing.SizeF
To be added.
The property represents the scaling factor between the and properties. This value is calculated when it is required. For example, if is (192, 144) and is (96, 96) then the is (2.0, 1.5).
For more information about automatic scaling, see Automatic Scaling in Windows Forms.
Gets the scaling factor between the current and design-time automatic scaling dimensions.
2.0.0.0
Property
System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Advanced)
System.ComponentModel.Browsable(false)
System.Windows.Forms.AutoScaleMode
To be added.
The property specifies the current automatic scaling mode of this control. Scaling by is useful if you want to have a control or form stretch or shrink according to the size of the fonts in the operating system, and should be used when the absolute size of the control or form does not matter. Scaling by is useful when you want to size a control or form relative to the screen. For example, you may want to use dots per inch (DPI) scaling on a control displaying a chart or other graphic so that it always occupies a certain percentage of the screen.
For more information about automatic scaling, see Automatic Scaling in Windows Forms.
Gets or sets the automatic scaling mode of the control.
2.0.0.0
Property
2.0.0.0
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
System.ComponentModel.AmbientValue(System.Windows.Forms.AutoValidate.Inherit)
System.ComponentModel.Browsable(false)
System.Windows.Forms.AutoValidate
To be added.
The default value for will differ for each control. For more details on implicit validation, see User Input Validation in Windows Forms (Windows Forms).
Setting this property to a new value will raise the event.
Gets or sets a value that indicates whether controls in this container will be automatically validated when the focus changes.
Event
2.0.0.0
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
System.ComponentModel.Browsable(false)
System.EventHandler
For more information about handling events, see Consuming Events.
Occurs when the property changes.
Property
System.ComponentModel.Browsable(false)
System.Windows.Forms.BindingContext
To be added.
To be added.
To be added.
1.0.5000.0
2.0.0.0
Property
2.0.0.0
System.Boolean
To be added.
In the dnprdnlong and later, IME functionality is handled by the framework and native IME support for individual controls is disabled.
A user control that derives from the class can enable native IME support by overriding this property to return true. However, the application is then responsible for making sure that there are no conflicts between the native IME and the Windows Forms IME. This scenario is not supported.
Gets a value indicating whether the property can be set to an active value, to enable IME support.
Property
System.Windows.Forms.CreateParams
To be added.
To be added.
Gets the required creation parameters when the control handle is created.
1.0.5000.0
2.0.0.0
Property
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Advanced)
System.ComponentModel.Browsable(false)
System.Drawing.SizeF
To be added.
The property represents the reference dimensions on the current screen. In contrast, the property represents the design-time reference dimensions of the design environment for the current control, while the property is the ratio of the two.
The interpretation of the dimension value depends on the property in the following ways:
-
If the mode is , this property represents the resolution of the screen, in dots per inch.
-
If the mode is , this property represents the average font character size in pixels.
If the property is set to , is set equal to .
For more information about automatic scaling, see Automatic Scaling in Windows Forms.
Gets the current run-time dimensions of the screen.
2.0.0.0
Method
System.Void
To be added.
To be added.
To be added.
1.0.5000.0
2.0.0.0
Method
2.0.0.0
System.Void
Raising an event invokes the event handler through a delegate. For more information, see Raising an Event.
The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.
Raises the event.
An that contains the event data.
Method
System.Void
To be added.
To be added.
1.0.5000.0
2.0.0.0
Method
System.Void
Changing the font used by a will cause the layout to be recalculated and reapplied to the contained controls if the property has a value of .
Raising an event invokes the event handler through a delegate. For more information, see Raising an Event.
The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.
Raises the event.
An that contains the event data.
2.0.0.0
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Advanced)
Method
2.0.0.0
System.Void
To be added.
Raises the event.
A that contains the event data.
Method
System.Void
To be added.
To be added.
To be added.
2.0.0.0
Property
System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)
System.ComponentModel.Browsable(false)
System.Windows.Forms.Form
To be added.
To be added.
Gets the form that the container control is assigned to.
1.0.5000.0
2.0.0.0
Method
2.0.0.0
System.Void
An explicit call to the method is typically only required after programmatic changes to the layout during run time. is implicitly called from the method.
is recursive; each child control, if it is a container, will have its version of this method called when the container's version executes.
For more information about automatic scaling, see Automatic Scaling in Windows Forms.
Performs scaling of the container control and its children.
Method
2.0.0.0
System.Boolean
To be added.
To be added.
To be added.
To be added.
To be added.
Method
System.Boolean
To be added.
To be added.
To be added.
To be added.
1.0.5000.0
2.0.0.0
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Advanced)
Method
System.Boolean
To be added.
To be added.
To be added.
To be added.
1.0.5000.0
2.0.0.0
Method
System.Boolean
To be added.
To be added.
To be added.
To be added.
1.0.5000.0
2.0.0.0
Method
System.Boolean
A control with its property set to false cannot be selected, so the next available control will be selected.
Selects the next available control and makes it the active control.
true if a control is selected; otherwise, false.
true to cycle forward through the controls in the ; otherwise, false.
1.0.5000.0
2.0.0.0
Method
System.Void
To be added.
To be added.
To be added.
To be added.
1.0.5000.0
2.0.0.0
Method
1.0.5000.0
2.0.0.0
System.Boolean
The parameter must be a child of the container control.
Activates the specified control.
true if the control is successfully activated; otherwise, false.
The to activate.
Method
System.Void
The class does not provide an implementation for the method. Classes that inherit this method must implement to update the default button.
When overridden by a derived class, updates which button is the default button.
1.0.5000.0
2.0.0.0
Method
System.Boolean
The method validates the last child control that is not validated and its ancestors up through, but not including, the current container control. This overloaded version always performs validation, regardless of the value of the property of the control's parent. Therefore use it to unconditionally force validation.
Verifies the value of the control losing focus by causing the and events to occur, in that order.
true if validation is successful; otherwise, false. If called from the or event handlers, this method will always return false.
1.0.5000.0
2.0.0.0
Method
2.0.0.0
System.Boolean
The method validates the last child control that is not validated and its ancestors up through, but not including, the current container control. This overloaded version performs validation based on the following conditions:
-
If the parameter is true, validation always occurs for child controls that are not validated.
-
If the parameter is false, validation occurs only if the property of the control's parent is enabled.
Verifies the value of the control that is losing focus; conditionally dependent on whether automatic validation is turned on.
true if validation is successful; otherwise, false. If called from the or event handlers, this method will always return false.
If true, the value of the property is used to determine if validation should be performed; if false, validation is unconditionally performed.
Method
2.0.0.0
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
System.ComponentModel.Browsable(false)
System.Boolean
will descend a control's hierarchy and examine each control to see if it supports validation. If the control can be selected by the user and its property is true, will cause the event to occur. If any of the controls cancel the event, this method will return false; otherwise, it will return true.
If a control is bound to a data source, and the event occurs, it will cause the control to push its current data back to the data source.
Calling is equivalent to calling with a of .
Causes all of the child controls within a control that support validation to validate their data.
true if all of the children validated successfully; otherwise, false. If called from the or event handlers, this method will always return false.
Method
2.0.0.0
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
System.ComponentModel.Browsable(false)
System.Boolean
will examine all the children of the current control, causing the event to occur on a control if it meets the criteria spelled out by .
You may use several parameters at once by combining them with a bitwise OR operator. Combining parameters with a bitwise OR operator will result in a logical AND operation. For example, calling ValidateChildren(ValidationConstraints.ImmediateChildren | ValidationConstraints.Enabled) will only raise the event on controls that are both immediate children of the container AND are enabled.
Regardless of which parameters you specify for this method, a control must have its property set to true in order for its event to occur. You should also set the property of the control or of the control's container to false if you want validation to happen only when you call , and not when the user shifts focus from the control.
If a control is bound to a data source, and the event occurs, it will cause the control to push its current data back to the data source.
You cannot achieve the opposite effect of a parameter by applying a bitwise negation operator. For example, if you supply the negative value of the field to , it will not validate all children that are not visible on the container. Supplying any negative parameter to will have no effect on the container or its children.
Causes all of the child controls within a control that support validation to validate their data.
true if all of the children validated successfully; otherwise, false. If called from the or event handlers, this method will always return false.
Places restrictions on which controls have their event raised.
Method
System.Void
To be added.
To be added.
To be added.
1.0.5000.0
2.0.0.0
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Advanced)
System.Runtime.InteropServices.ComVisible(true)
System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)