Export (0) Print
Expand All

Control Class

Defines the base class for controls, which are components with visual representation.

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Windows.Forms.Control
        More...

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

'Declaration
<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
<ComVisibleAttribute(True)> _
Public Class Control _
	Inherits Component _
	Implements IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent,  _
	IComponent, IDisposable

The Control type exposes the following members.

  NameDescription
Public methodControlInitializes a new instance of the Control class with default settings.
Public methodControl(String)Initializes a new instance of the Control class with specific text.
Public methodControl(Control, String)Initializes a new instance of the Control class as a child control, with specific text.
Public methodControl(String, Int32, Int32, Int32, Int32)Initializes a new instance of the Control class with specific text, size, and location.
Public methodControl(Control, String, Int32, Int32, Int32, Int32)Initializes a new instance of the Control class as a child control, with specific text, size, and location.
Top

  NameDescription
Public propertyAccessibilityObjectGets the AccessibleObject assigned to the control.
Public propertyAccessibleDefaultActionDescriptionGets or sets the default action description of the control for use by accessibility client applications.
Public propertyAccessibleDescriptionGets or sets the description of the control used by accessibility client applications.
Public propertyAccessibleNameGets or sets the name of the control used by accessibility client applications.
Public propertyAccessibleRoleGets or sets the accessible role of the control
Public propertyAllowDropGets or sets a value indicating whether the control can accept data that the user drags onto it.
Public propertyAnchorGets or sets the edges of the container to which a control is bound and determines how a control is resized with its parent.
Public propertyAutoScrollOffsetGets or sets where this control is scrolled to in ScrollControlIntoView.
Public propertyAutoSizeInfrastructure. This property is not relevant for this class.
Public propertyBackColorGets or sets the background color for the control.
Public propertyBackgroundImageGets or sets the background image displayed in the control.
Public propertyBackgroundImageLayoutGets or sets the background image layout as defined in the ImageLayout enumeration.
Public propertyBindingContextGets or sets the BindingContext for the control.
Public propertyBottomGets the distance, in pixels, between the bottom edge of the control and the top edge of its container's client area.
Public propertyBoundsGets or sets the size and location of the control including its nonclient elements, in pixels, relative to the parent control.
Protected propertyCanEnableImeGets a value indicating whether the ImeMode property can be set to an active value, to enable IME support.
Public propertyCanFocusGets a value indicating whether the control can receive focus.
Protected propertyCanRaiseEventsDetermines if events can be raised on the control. (Overrides Component.CanRaiseEvents.)
Public propertyCanSelectGets a value indicating whether the control can be selected.
Public propertyCaptureGets or sets a value indicating whether the control has captured the mouse.
Public propertyCausesValidationGets or sets a value indicating whether the control causes validation to be performed on any controls that require validation when it receives focus.
Public propertyStatic memberCheckForIllegalCrossThreadCallsGets or sets a value indicating whether to catch calls on the wrong thread that access a control's Handle property when an application is being debugged.
Public propertyClientRectangleGets the rectangle that represents the client area of the control.
Public propertyClientSizeGets or sets the height and width of the client area of the control.
Public propertyCompanyNameGets the name of the company or creator of the application containing the control.
Public propertyContainerGets the IContainer that contains the Component. (Inherited from Component.)
Public propertyContainsFocusGets a value indicating whether the control, or one of its child controls, currently has the input focus.
Public propertyContextMenuGets or sets the shortcut menu associated with the control.
Public propertyContextMenuStripGets or sets the ContextMenuStrip associated with this control.
Public propertyControlsGets the collection of controls contained within the control.
Public propertyCreatedGets a value indicating whether the control has been created.
Protected propertyCreateParamsGets the required creation parameters when the control handle is created.
Public propertyCursorGets or sets the cursor that is displayed when the mouse pointer is over the control.
Public propertyDataBindingsGets the data bindings for the control.
Public propertyStatic memberDefaultBackColorGets the default background color of the control.
Protected propertyDefaultCursorGets or sets the default cursor for the control.
Public propertyStatic memberDefaultFontGets the default font of the control.
Public propertyStatic memberDefaultForeColorGets the default foreground color of the control.
Protected propertyDefaultImeModeGets the default Input Method Editor (IME) mode supported by the control.
Protected propertyDefaultMarginGets the space, in pixels, that is specified by default between controls.
Protected propertyDefaultMaximumSizeGets the length and height, in pixels, that is specified as the default maximum size of a control.
Protected propertyDefaultMinimumSizeGets the length and height, in pixels, that is specified as the default minimum size of a control.
Protected propertyDefaultPaddingGets the internal spacing, in pixels, of the contents of a control.
Protected propertyDefaultSizeGets the default size of the control.
Protected propertyDesignModeGets a value that indicates whether the Component is currently in design mode. (Inherited from Component.)
Public propertyDisplayRectangleGets the rectangle that represents the display area of the control.
Public propertyDisposingGets a value indicating whether the base Control class is in the process of disposing.
Public propertyDockGets or sets which control borders are docked to its parent control and determines how a control is resized with its parent.
Protected propertyDoubleBufferedGets or sets a value indicating whether this control should redraw its surface using a secondary buffer to reduce or prevent flicker.
Public propertyEnabledGets or sets a value indicating whether the control can respond to user interaction.
Protected propertyEventsGets the list of event handlers that are attached to this Component. (Inherited from Component.)
Public propertyFocusedGets a value indicating whether the control has input focus.
Public propertyFontGets or sets the font of the text displayed by the control.
Protected propertyFontHeightGets or sets the height of the font of the control.
Public propertyForeColorGets or sets the foreground color of the control.
Public propertyHandleGets the window handle that the control is bound to.
Public propertyHasChildrenGets a value indicating whether the control contains one or more child controls.
Public propertyHeightGets or sets the height of the control.
Public propertyImeModeGets or sets the Input Method Editor (IME) mode of the control.
Protected propertyImeModeBaseGets or sets the IME mode of a control.
Public propertyInvokeRequiredGets 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.
Public propertyIsAccessibleGets or sets a value indicating whether the control is visible to accessibility applications.
Public propertyIsDisposedGets a value indicating whether the control has been disposed of.
Public propertyIsHandleCreatedGets a value indicating whether the control has a handle associated with it.
Public propertyIsMirroredGets a value indicating whether the control is mirrored.
Public propertyLayoutEngineGets a cached instance of the control's layout engine.
Public propertyLeftGets or sets the distance, in pixels, between the left edge of the control and the left edge of its container's client area.
Public propertyLocationGets or sets the coordinates of the upper-left corner of the control relative to the upper-left corner of its container.
Public propertyMarginGets or sets the space between controls.
Public propertyMaximumSizeGets or sets the size that is the upper limit that GetPreferredSize can specify.
Public propertyMinimumSizeGets or sets the size that is the lower limit that GetPreferredSize can specify.
Public propertyStatic memberModifierKeysGets a value indicating which of the modifier keys (SHIFT, CTRL, and ALT) is in a pressed state.
Public propertyStatic memberMouseButtonsGets a value indicating which of the mouse buttons is in a pressed state.
Public propertyStatic memberMousePositionGets the position of the mouse cursor in screen coordinates.
Public propertyNameGets or sets the name of the control.
Public propertyPaddingGets or sets padding within the control.
Public propertyParentGets or sets the parent container of the control.
Public propertyPreferredSizeGets the size of a rectangular area into which the control can fit.
Public propertyProductNameGets the product name of the assembly containing the control.
Public propertyProductVersionGets the version of the assembly containing the control.
Protected propertyStatic memberPropagatingImeModeGets an object that represents a propagating IME mode.
Public propertyRecreatingHandleGets a value indicating whether the control is currently re-creating its handle.
Public propertyRegionGets or sets the window region associated with the control.
Protected propertyRenderRightToLeft Obsolete. This property is now obsolete.
Protected propertyResizeRedrawGets or sets a value indicating whether the control redraws itself when resized.
Public propertyRightGets the distance, in pixels, between the right edge of the control and the left edge of its container's client area.
Public propertyRightToLeftGets or sets a value indicating whether control's elements are aligned to support locales using right-to-left fonts.
Protected propertyScaleChildrenGets a value that determines the scaling of child controls.
Protected propertyShowFocusCuesGets a value indicating whether the control should display focus rectangles.
Protected propertyShowKeyboardCuesGets a value indicating whether the user interface is in the appropriate state to show or hide keyboard accelerators.
Public propertySiteGets or sets the site of the control. (Overrides Component.Site.)
Public propertySizeGets or sets the height and width of the control.
Public propertyTabIndexGets or sets the tab order of the control within its container.
Public propertyTabStopGets or sets a value indicating whether the user can give the focus to this control using the TAB key.
Public propertyTagGets or sets the object that contains data about the control.
Public propertyTextGets or sets the text associated with this control.
Public propertyTopGets or sets the distance, in pixels, between the top edge of the control and the top edge of its container's client area.
Public propertyTopLevelControlGets the parent control that is not parented by another Windows Forms control. Typically, this is the outermost Form that the control is contained in.
Public propertyUseWaitCursorGets or sets a value indicating whether to use the wait cursor for the current control and all child controls.
Public propertyVisibleGets or sets a value indicating whether the control and all its child controls are displayed.
Public propertyWidthGets or sets the width of the control.
Public propertyWindowTargetInfrastructure. This property is not relevant for this class.
Top

  NameDescription
Protected methodAccessibilityNotifyClients(AccessibleEvents, Int32)Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control.
Protected methodAccessibilityNotifyClients(AccessibleEvents, Int32, Int32)Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control .
Public methodBeginInvoke(Delegate)Executes the specified delegate asynchronously on the thread that the control's underlying handle was created on.
Public methodBeginInvoke(Delegate, Object())Executes the specified delegate asynchronously with the specified arguments, on the thread that the control's underlying handle was created on.
Public methodBringToFrontBrings the control to the front of the z-order.
Public methodContainsRetrieves a value indicating whether the specified control is a child of the control.
Protected methodCreateAccessibilityInstanceCreates a new accessibility object for the control.
Public methodCreateControlForces the creation of the visible control, including the creation of the handle and any visible child controls.
Protected methodCreateControlsInstanceCreates a new instance of the control collection for the control.
Public methodCreateGraphicsCreates the Graphics for the control.
Protected methodCreateHandleCreates a handle for the control.
Public methodCreateObjRefCreates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from MarshalByRefObject.)
Protected methodDefWndProcSends the specified message to the default window procedure.
Protected methodDestroyHandleDestroys the handle associated with the control.
Public methodDisposeReleases all resources used by the Component. (Inherited from Component.)
Protected methodDispose(Boolean)Releases the unmanaged resources used by the Control and its child controls and optionally releases the managed resources. (Overrides Component.Dispose(Boolean).)
Public methodDoDragDropBegins a drag-and-drop operation.
Public methodDrawToBitmapSupports rendering to the specified bitmap.
Public methodEndInvokeRetrieves the return value of the asynchronous operation represented by the IAsyncResult passed.
Public methodEquals(Object)Determines whether the specified object is equal to the current object. (Inherited from Object.)
Protected methodFinalizeReleases unmanaged resources and performs other cleanup operations before the Component is reclaimed by garbage collection. (Inherited from Component.)
Public methodFindFormRetrieves the form that the control is on.
Public methodFocusSets input focus to the control.
Public methodStatic memberFromChildHandleRetrieves the control that contains the specified handle.
Public methodStatic memberFromHandleReturns the control that is currently associated with the specified handle.
Protected methodGetAccessibilityObjectByIdRetrieves the specified AccessibleObject.
Protected methodGetAutoSizeModeRetrieves a value indicating how a control will behave when its AutoSize property is enabled.
Public methodGetChildAtPoint(Point)Retrieves the child control that is located at the specified coordinates.
Public methodGetChildAtPoint(Point, GetChildAtPointSkip)Retrieves the child control that is located at the specified coordinates, specifying whether to ignore child controls of a certain type.
Public methodGetContainerControlReturns the next ContainerControl up the control's chain of parent controls.
Public methodGetHashCodeServes as the default hash function. (Inherited from Object.)
Public methodGetLifetimeServiceRetrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
Public methodGetNextControlRetrieves the next control forward or back in the tab order of child controls.
Public methodGetPreferredSizeRetrieves the size of a rectangular area into which a control can be fitted.
Protected methodGetScaledBoundsRetrieves the bounds within which the control is scaled.
Protected methodGetServiceReturns an object that represents a service provided by the Component or by its Container. (Inherited from Component.)
Protected methodGetStyleRetrieves the value of the specified control style bit for the control.
Protected methodGetTopLevelDetermines if the control is a top-level control.
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Public methodHideConceals the control from the user.
Public methodInitializeLifetimeServiceObtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
Protected methodInitLayoutCalled after the control has been added to another container.
Public methodInvalidateInvalidates the entire surface of the control and causes the control to be redrawn.
Public methodInvalidate(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.
Public methodInvalidate(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.
Public methodInvalidate(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.
Public methodInvalidate(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.
Public methodInvalidate(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.
Public methodInvoke(Delegate)Executes the specified delegate on the thread that owns the control's underlying window handle.
Public methodInvoke(Delegate, Object())Executes the specified delegate, on the thread that owns the control's underlying window handle, with the specified list of arguments.
Protected methodInvokeGotFocusRaises the GotFocus event for the specified control.
Protected methodInvokeLostFocusRaises the LostFocus event for the specified control.
Protected methodInvokeOnClickRaises the Click event for the specified control.
Protected methodInvokePaintRaises the Paint event for the specified control.
Protected methodInvokePaintBackgroundRaises the PaintBackground event for the specified control.
Protected methodIsInputCharDetermines if a character is an input character that the control recognizes.
Protected methodIsInputKeyDetermines whether the specified key is a regular input key or a special key that requires preprocessing.
Public methodStatic memberIsKeyLockedDetermines whether the CAPS LOCK, NUM LOCK, or SCROLL LOCK key is in effect.
Public methodStatic memberIsMnemonicDetermines if the specified character is the mnemonic character assigned to the control in the specified string.
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Protected methodMemberwiseClone(Boolean)Creates a shallow copy of the current MarshalByRefObject object. (Inherited from MarshalByRefObject.)
Protected methodNotifyInvalidateInfrastructure. Raises the Invalidated event with a specified region of the control to invalidate.
Protected methodOnAutoSizeChangedRaises the AutoSizeChanged event.
Protected methodOnBackColorChangedRaises the BackColorChanged event.
Protected methodOnBackgroundImageChangedRaises the BackgroundImageChanged event.
Protected methodOnBackgroundImageLayoutChangedRaises the BackgroundImageLayoutChanged event.
Protected methodOnBindingContextChangedRaises the BindingContextChanged event.
Protected methodOnCausesValidationChangedRaises the CausesValidationChanged event.
Protected methodOnChangeUICuesRaises the ChangeUICues event.
Protected methodOnClickRaises the Click event.
Protected methodOnClientSizeChangedRaises the ClientSizeChanged event.
Protected methodOnContextMenuChangedRaises the ContextMenuChanged event.
Protected methodOnContextMenuStripChangedRaises the ContextMenuStripChanged event.
Protected methodOnControlAddedRaises the ControlAdded event.
Protected methodOnControlRemovedRaises the ControlRemoved event.
Protected methodOnCreateControlRaises the CreateControl method.
Protected methodOnCursorChangedRaises the CursorChanged event.
Protected methodOnDockChangedRaises the DockChanged event.
Protected methodOnDoubleClickRaises the DoubleClick event.
Protected methodOnDragDropRaises the DragDrop event.
Protected methodOnDragEnterRaises the DragEnter event.
Protected methodOnDragLeaveRaises the DragLeave event.
Protected methodOnDragOverRaises the DragOver event.
Protected methodOnEnabledChangedRaises the EnabledChanged event.
Protected methodOnEnterRaises the Enter event.
Protected methodOnFontChangedRaises the FontChanged event.
Protected methodOnForeColorChangedRaises the ForeColorChanged event.
Protected methodOnGiveFeedbackRaises the GiveFeedback event.
Protected methodOnGotFocusRaises the GotFocus event.
Protected methodOnHandleCreatedRaises the HandleCreated event.
Protected methodOnHandleDestroyedRaises the HandleDestroyed event.
Protected methodOnHelpRequestedRaises the HelpRequested event.
Protected methodOnImeModeChangedRaises the ImeModeChanged event.
Protected methodOnInvalidatedRaises the Invalidated event.
Protected methodOnKeyDownRaises the KeyDown event.
Protected methodOnKeyPressRaises the KeyPress event.
Protected methodOnKeyUpRaises the KeyUp event.
Protected methodOnLayoutRaises the Layout event.
Protected methodOnLeaveRaises the Leave event.
Protected methodOnLocationChangedRaises the LocationChanged event.
Protected methodOnLostFocusRaises the LostFocus event.
Protected methodOnMarginChangedRaises the MarginChanged event.
Protected methodOnMouseCaptureChangedRaises the MouseCaptureChanged event.
Protected methodOnMouseClickRaises the MouseClick event.
Protected methodOnMouseDoubleClickRaises the MouseDoubleClick event.
Protected methodOnMouseDownRaises the MouseDown event.
Protected methodOnMouseEnterRaises the MouseEnter event.
Protected methodOnMouseHoverRaises the MouseHover event.
Protected methodOnMouseLeaveRaises the MouseLeave event.
Protected methodOnMouseMoveRaises the MouseMove event.
Protected methodOnMouseUpRaises the MouseUp event.
Protected methodOnMouseWheelRaises the MouseWheel event.
Protected methodOnMoveRaises the Move event.
Protected methodOnNotifyMessageNotifies the control of Windows messages.
Protected methodOnPaddingChangedRaises the PaddingChanged event.
Protected methodOnPaintRaises the Paint event.
Protected methodOnPaintBackgroundPaints the background of the control.
Protected methodOnParentBackColorChangedRaises the BackColorChanged event when the BackColor property value of the control's container changes.
Protected methodOnParentBackgroundImageChangedRaises the BackgroundImageChanged event when the BackgroundImage property value of the control's container changes.
Protected methodOnParentBindingContextChangedRaises the BindingContextChanged event when the BindingContext property value of the control's container changes.
Protected methodOnParentChangedRaises the ParentChanged event.
Protected methodOnParentCursorChangedRaises the CursorChanged event.
Protected methodOnParentEnabledChangedRaises the EnabledChanged event when the Enabled property value of the control's container changes.
Protected methodOnParentFontChangedRaises the FontChanged event when the Font property value of the control's container changes.
Protected methodOnParentForeColorChangedRaises the ForeColorChanged event when the ForeColor property value of the control's container changes.
Protected methodOnParentRightToLeftChangedRaises the RightToLeftChanged event when the RightToLeft property value of the control's container changes.
Protected methodOnParentVisibleChangedRaises the VisibleChanged event when the Visible property value of the control's container changes.
Protected methodOnPreviewKeyDownRaises the PreviewKeyDown event.
Protected methodOnPrintRaises the Paint event.
Protected methodOnQueryContinueDragRaises the QueryContinueDrag event.
Protected methodOnRegionChangedRaises the RegionChanged event.
Protected methodOnResizeRaises the Resize event.
Protected methodOnRightToLeftChangedRaises the RightToLeftChanged event.
Protected methodOnSizeChangedRaises the SizeChanged event.
Protected methodOnStyleChangedRaises the StyleChanged event.
Protected methodOnSystemColorsChangedRaises the SystemColorsChanged event.
Protected methodOnTabIndexChangedRaises the TabIndexChanged event.
Protected methodOnTabStopChangedRaises the TabStopChanged event.
Protected methodOnTextChangedRaises the TextChanged event.
Protected methodOnValidatedRaises the Validated event.
Protected methodOnValidatingRaises the Validating event.
Protected methodOnVisibleChangedRaises the VisibleChanged event.
Public methodPerformLayoutForces the control to apply layout logic to all its child controls.
Public methodPerformLayout(Control, String)Forces the control to apply layout logic to all its child controls.
Public methodPointToClientComputes the location of the specified screen point into client coordinates.
Public methodPointToScreenComputes the location of the specified client point into screen coordinates.
Public methodPreProcessControlMessagePreprocesses keyboard or input messages within the message loop before they are dispatched.
Public methodPreProcessMessagePreprocesses keyboard or input messages within the message loop before they are dispatched.
Protected methodProcessCmdKeyProcesses a command key.
Protected methodProcessDialogCharProcesses a dialog character.
Protected methodProcessDialogKeyProcesses a dialog key.
Protected methodProcessKeyEventArgsProcesses a key message and generates the appropriate control events.
Protected methodProcessKeyMessageProcesses a keyboard message.
Protected methodProcessKeyPreviewPreviews a keyboard message.
Protected methodProcessMnemonicProcesses a mnemonic character.
Protected methodRaiseDragEventInfrastructure. Raises the appropriate drag event.
Protected methodRaiseKeyEventInfrastructure. Raises the appropriate key event.
Protected methodRaiseMouseEventInfrastructure. Raises the appropriate mouse event.
Protected methodRaisePaintEventInfrastructure. Raises the appropriate paint event.
Protected methodRecreateHandleForces the re-creation of the handle for the control.
Public methodRectangleToClientComputes the size and location of the specified screen rectangle in client coordinates.
Public methodRectangleToScreenComputes the size and location of the specified client rectangle in screen coordinates.
Protected methodStatic memberReflectMessageReflects the specified message to the control that is bound to the specified handle.
Public methodRefreshForces the control to invalidate its client area and immediately redraw itself and any child controls.
Public methodResetBackColorResets the BackColor property to its default value.
Public methodResetBindingsCauses a control bound to the BindingSource to reread all the items in the list and refresh their displayed values.
Public methodResetCursorResets the Cursor property to its default value.
Public methodResetFontResets the Font property to its default value.
Public methodResetForeColorResets the ForeColor property to its default value.
Public methodResetImeModeResets the ImeMode property to its default value.
Protected methodResetMouseEventArgsInfrastructure. Resets the control to handle the MouseLeave event.
Public methodResetRightToLeftResets the RightToLeft property to its default value.
Public methodResetTextResets the Text property to its default value.
Public methodResumeLayoutResumes usual layout logic.
Public methodResumeLayout(Boolean)Resumes usual layout logic, optionally forcing an immediate layout of pending layout requests.
Protected methodRtlTranslateAlignment(ContentAlignment)Converts the specified ContentAlignment to the appropriate ContentAlignment to support right-to-left text.
Protected methodRtlTranslateAlignment(HorizontalAlignment)Converts the specified HorizontalAlignment to the appropriate HorizontalAlignment to support right-to-left text.
Protected methodRtlTranslateAlignment(LeftRightAlignment)Converts the specified LeftRightAlignment to the appropriate LeftRightAlignment to support right-to-left text.
Protected methodRtlTranslateContentConverts the specified ContentAlignment to the appropriate ContentAlignment to support right-to-left text.
Protected methodRtlTranslateHorizontalConverts the specified HorizontalAlignment to the appropriate HorizontalAlignment to support right-to-left text.
Protected methodRtlTranslateLeftRightConverts the specified LeftRightAlignment to the appropriate LeftRightAlignment to support right-to-left text.
Public methodScale(Single) Obsolete. Scales the control and any child controls.
Public methodScale(SizeF)Scales the control and all child controls by the specified scaling factor.
Public methodScale(Single, Single) Obsolete. Scales the entire control and any child controls.
Protected methodScaleControlScales a control's location, size, padding and margin.
Protected methodScaleCoreInfrastructure. This method is not relevant for this class.
Public methodSelectActivates the control.
Protected methodSelect(Boolean, Boolean)Activates a child control. Optionally specifies the direction in the tab order to select the control from.
Public methodSelectNextControlActivates the next control.
Public methodSendToBackSends the control to the back of the z-order.
Protected methodSetAutoSizeModeSets a value indicating how a control will behave when its AutoSize property is enabled.
Public methodSetBounds(Int32, Int32, Int32, Int32)Sets the bounds of the control to the specified location and size.
Public methodSetBounds(Int32, Int32, Int32, Int32, BoundsSpecified)Sets the specified bounds of the control to the specified location and size.
Protected methodSetBoundsCorePerforms the work of setting the specified bounds of this control.
Protected methodSetClientSizeCoreSets the size of the client area of the control.
Protected methodSetStyleSets a specified ControlStyles flag to either true or false.
Protected methodSetTopLevelSets the control as the top-level control.
Protected methodSetVisibleCoreSets the control to the specified visible state.
Public methodShowDisplays the control to the user.
Protected methodSizeFromClientSizeDetermines the size of the entire control from the height and width of its client area.
Public methodSuspendLayoutTemporarily suspends the layout logic for the control.
Public methodToStringReturns a String containing the name of the Component, if any. This method should not be overridden. (Inherited from Component.)
Public methodUpdateCauses the control to redraw the invalidated regions within its client area.
Protected methodUpdateBoundsUpdates the bounds of the control with the current size and location.
Protected methodUpdateBounds(Int32, Int32, Int32, Int32)Updates the bounds of the control with the specified size and location.
Protected methodUpdateBounds(Int32, Int32, Int32, Int32, Int32, Int32)Updates the bounds of the control with the specified size, location, and client size.
Protected methodUpdateStylesForces the assigned styles to be reapplied to the control.
Protected methodUpdateZOrderUpdates the control in its parent's z-order.
Protected methodWndProcProcesses Windows messages.
Top

  NameDescription
Public eventAutoSizeChangedInfrastructure. This event is not relevant for this class.
Public eventBackColorChangedOccurs when the value of the BackColor property changes.
Public eventBackgroundImageChangedOccurs when the value of the BackgroundImage property changes.
Public eventBackgroundImageLayoutChangedOccurs when the BackgroundImageLayout property changes.
Public eventBindingContextChangedOccurs when the value of the BindingContext property changes.
Public eventCausesValidationChangedOccurs when the value of the CausesValidation property changes.
Public eventChangeUICuesOccurs when the focus or keyboard user interface (UI) cues change.
Public eventClickOccurs when the control is clicked.
Public eventClientSizeChangedOccurs when the value of the ClientSize property changes.
Public eventContextMenuChangedOccurs when the value of the ContextMenu property changes.
Public eventContextMenuStripChangedOccurs when the value of the ContextMenuStrip property changes.
Public eventControlAddedOccurs when a new control is added to the Control.ControlCollection.
Public eventControlRemovedOccurs when a control is removed from the Control.ControlCollection.
Public eventCursorChangedOccurs when the value of the Cursor property changes.
Public eventDisposedOccurs when the component is disposed by a call to the Dispose method. (Inherited from Component.)
Public eventDockChangedOccurs when the value of the Dock property changes.
Public eventDoubleClickOccurs when the control is double-clicked.
Public eventDragDropOccurs when a drag-and-drop operation is completed.
Public eventDragEnterOccurs when an object is dragged into the control's bounds.
Public eventDragLeaveOccurs when an object is dragged out of the control's bounds.
Public eventDragOverOccurs when an object is dragged over the control's bounds.
Public eventEnabledChangedOccurs when the Enabled property value has changed.
Public eventEnterOccurs when the control is entered.
Public eventFontChangedOccurs when the Font property value changes.
Public eventForeColorChangedOccurs when the ForeColor property value changes.
Public eventGiveFeedbackOccurs during a drag operation.
Public eventGotFocusOccurs when the control receives focus.
Public eventHandleCreatedOccurs when a handle is created for the control.
Public eventHandleDestroyedOccurs when the control's handle is in the process of being destroyed.
Public eventHelpRequestedOccurs when the user requests help for a control.
Public eventImeModeChangedOccurs when the ImeMode property has changed.
Public eventInvalidatedOccurs when a control's display requires redrawing.
Public eventKeyDownOccurs when a key is pressed while the control has focus.
Public eventKeyPressOccurs when a character. space or backspace key is pressed while the control has focus.
Public eventKeyUpOccurs when a key is released while the control has focus.
Public eventLayoutOccurs when a control should reposition its child controls.
Public eventLeaveOccurs when the input focus leaves the control.
Public eventLocationChangedOccurs when the Location property value has changed.
Public eventLostFocusOccurs when the control loses focus.
Public eventMarginChangedOccurs when the control's margin changes.
Public eventMouseCaptureChangedOccurs when the control loses mouse capture.
Public eventMouseClickOccurs when the control is clicked by the mouse.
Public eventMouseDoubleClickOccurs when the control is double clicked by the mouse.
Public eventMouseDownOccurs when the mouse pointer is over the control and a mouse button is pressed.
Public eventMouseEnterOccurs when the mouse pointer enters the control.
Public eventMouseHoverOccurs when the mouse pointer rests on the control.
Public eventMouseLeaveOccurs when the mouse pointer leaves the control.
Public eventMouseMoveOccurs when the mouse pointer is moved over the control.
Public eventMouseUpOccurs when the mouse pointer is over the control and a mouse button is released.
Public eventMouseWheelOccurs when the mouse wheel moves while the control has focus.
Public eventMoveOccurs when the control is moved.
Public eventPaddingChangedOccurs when the control's padding changes.
Public eventPaintOccurs when the control is redrawn.
Public eventParentChangedOccurs when the Parent property value changes.
Public eventPreviewKeyDownOccurs before the KeyDown event when a key is pressed while focus is on this control.
Public eventQueryAccessibilityHelpOccurs when AccessibleObject is providing help to accessibility applications.
Public eventQueryContinueDragOccurs during a drag-and-drop operation and enables the drag source to determine whether the drag-and-drop operation should be canceled.
Public eventRegionChangedOccurs when the value of the Region property changes.
Public eventResizeOccurs when the control is resized.
Public eventRightToLeftChangedOccurs when the RightToLeft property value changes.
Public eventSizeChangedOccurs when the Size property value changes.
Public eventStyleChangedOccurs when the control style changes.
Public eventSystemColorsChangedOccurs when the system colors change.
Public eventTabIndexChangedOccurs when the TabIndex property value changes.
Public eventTabStopChangedOccurs when the TabStop property value changes.
Public eventTextChangedOccurs when the Text property value changes.
Public eventValidatedOccurs when the control is finished validating.
Public eventValidatingOccurs when the control is validating.
Public eventVisibleChangedOccurs when the Visible property value changes.
Top

  NameDescription
Explicit interface implemetationPrivate methodIDropTarget.OnDragDropInfrastructure. Raises the DragDrop event.
Explicit interface implemetationPrivate methodIDropTarget.OnDragEnterInfrastructure. Raises the DragEnter event.
Explicit interface implemetationPrivate methodIDropTarget.OnDragLeaveInfrastructure. Raises the DragLeave event.
Explicit interface implemetationPrivate methodIDropTarget.OnDragOverInfrastructure. Raises the DragOver event.
Top

To create your own control class, inherit from the UserControl, Control classes, or from the other Windows Forms provided controls. For more information about authoring custom controls, see Developing Custom Windows Forms Controls with the .NET Framework.

The Control class implements very basic functionality required by classes that display information to the user. It handles user input through the keyboard and pointing devices. It handles message routing and security. It defines the bounds of a control (its position and size), although it does not implement painting. It provides a window handle (hWnd).

Windows Forms controls use ambient properties so child controls can appear like their surrounding environment. An ambient property is a control property that, if not set, is retrieved from the parent control. If the control does not have a Parent, and the property is not set, the control attempts to determine the value of the ambient property through the Site property. If the control is not sited, if the site does not support ambient properties, or if the property is not set on the AmbientProperties, the control uses its own default values. Typically, an ambient property represents a characteristic of a control, such as BackColor, that is communicated to a child control. For example, a Button will have the same BackColor as its parent Form by default. Ambient properties provided by the Control class include: Cursor, Font, BackColor, ForeColor, and RightToLeft.

NoteNote

To make your Windows Forms application support visual styles, be sure to set the FlatStyle property to System and include a manifest with your executable. A manifest is an XML file that is included either as a resource within your application executable or as a separate file that resides in the same directory as the executable file. For an example of a manifest, see the Example section of the FlatStyle enumeration. For more information about using visual styles, see Visual Styles.

Windows Forms has accessibility support built in, and provides information about your application that enables it to work with accessibility client applications such as screen enlarger and reviewer utilities, voice input utilities, on-screen keyboards, alternative input devices, and keyboard enhancement utilities. Sometimes you will want to provide additional information to accessibility client applications. There are two ways of providing this additional information. You can set the AccessibleName, AccessibleDescription, AccessibleDefaultActionDescription, and AccessibleRole property values, which will be reported to accessibility client applications. This method is typically used to provide limited accessibility information for existing controls. Alternatively, you can write your own class deriving from the AccessibleObject or Control.ControlAccessibleObject classes, providing as much accessibility information as needed.

NoteNote

To maintain better performance, do not set the size of a control in its constructor. The preferred method is to override the DefaultSize property.

NoteNote

Do not add data bindings for a Control in its constructor. Doing so will cause errors in code generation and can cause unwanted behavior.

The majority of the controls in the System.Windows.Forms namespace use the underlying Windows common control as a base to build on. For more information about the Windows common controls, see General Control Reference.

To identify Windows Forms controls from a separate process, use a standard SendMessage call to pass the WM_GETCONTROLNAME message. WM_GETCONTROLNAME is independent of the language and Windows hierarchy. For more information, see the "Recommended Solution for Windows Forms" topic in Automating Windows Forms.

Use the InvokeRequired property to synchronize access to the control from multiple threads. For more information about multithreaded Windows Forms controls, see How to: Make Thread-Safe Calls to Windows Forms Controls

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Only the following members are thread safe: BeginInvoke, EndInvoke, Invoke, InvokeRequired, and CreateGraphics if the handle for the control has already been created. Calling CreateGraphics before the control's handle has been created on a background thread can cause illegal cross thread calls.

Show:
© 2014 Microsoft