AxHost Class (System.Windows.Forms)

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2010/.NET Framework 4

Other versions are also available for the following:

.NET Framework Class Library

AxHost Class

Wraps ActiveX controls and exposes them as fully featured Windows Forms controls.

Inheritance Hierarchy

System..::.Object
  System..::.MarshalByRefObject
    System.ComponentModel..::.Component
      System.Windows.Forms..::.Control
        System.Windows.Forms..::.AxHost

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

Syntax

Visual Basic

<ComVisibleAttribute(True)> _
<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
<PermissionSetAttribute(SecurityAction.LinkDemand, Name := "FullTrust")> _
Public MustInherit Class AxHost _
    Inherits Control _
    Implements ISupportInitialize, ICustomTypeDescriptor

[ComVisibleAttribute(true)]
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]
[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
[PermissionSetAttribute(SecurityAction.LinkDemand, Name = "FullTrust")]
public abstract class AxHost : Control, 
    ISupportInitialize, ICustomTypeDescriptor

Visual C++

[ComVisibleAttribute(true)]
[ClassInterfaceAttribute(ClassInterfaceType::AutoDispatch)]
[PermissionSetAttribute(SecurityAction::InheritanceDemand, Name = L"FullTrust")]
[PermissionSetAttribute(SecurityAction::LinkDemand, Name = L"FullTrust")]
public ref class AxHost abstract : public Control, 
    ISupportInitialize, ICustomTypeDescriptor

[<AbstractClass>]
[<ComVisibleAttribute(true)>]
[<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)>]
[<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")>]
[<PermissionSetAttribute(SecurityAction.LinkDemand, Name = "FullTrust")>]
type AxHost =  
    class
        inherit Control
        interface ISupportInitialize
        interface ICustomTypeDescriptor
    end

The AxHost type exposes the following members.

Constructors

	Name	Description
	AxHost(String)	Initializes a new instance of the AxHost class, wrapping the ActiveX control indicated by the specified CLSID.
	AxHost(String, Int32)	Initializes a new instance of the AxHost class, wrapping the ActiveX control indicated by the specified CLSID, and using the shortcut-menu behavior indicated by the specified flags value.

Top

Properties

	Name	Description
	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.)
	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.)
	AutoScrollOffset	Gets or sets where this control is scrolled to in ScrollControlIntoView. (Inherited from Control.)
	AutoSize	Infrastructure. This property is not relevant for this class. (Inherited from Control.)
	BackColor	Infrastructure. This member is not meaningful for this control. (Overrides Control..::.BackColor.)
	BackgroundImage	Infrastructure. This property is not relevant for this class. (Overrides Control..::.BackgroundImage.)
	BackgroundImageLayout	Infrastructure. This property is not relevant for this class. (Overrides Control..::.BackgroundImageLayout.)
	BindingContext	Gets or sets the BindingContext for the control. (Inherited from 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 Control.)
	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.)
	ContainingControl	Gets or sets the control containing the ActiveX control.
	ContainsFocus	Gets a value indicating whether the control, or one of its child controls, currently has the input focus. (Inherited from Control.)
	ContextMenu	Infrastructure. This property is not relevant for this class. (Overrides Control..::.ContextMenu.)
	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. (Overrides Control..::.CreateParams.)
	Cursor	Infrastructure. This property is not relevant for this class. (Overrides Control..::.Cursor.)
	DataBindings	Gets the data bindings for the control. (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 internal spacing, in pixels, of the contents of a control. (Inherited from Control.)
	DefaultSize	Gets the default size of the control. (Overrides Control..::.DefaultSize.)
	DesignMode	Gets a value that indicates whether the Component is currently in design mode. (Inherited from Component.)
	DisplayRectangle	Gets the rectangle that represents the display area of the control. (Inherited from Control.)
	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.)
	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.)
	EditMode	Returns a value that indicates whether the hosted control is in edit mode.
	Enabled	Infrastructure. This property is not relevant for this class.
	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	Infrastructure. This property is not relevant for this class. (Overrides Control..::.Font.)
	FontHeight	Gets or sets the height of the font of the control. (Inherited from Control.)
	ForeColor	Infrastructure. This property is not relevant for this class. (Overrides Control..::.ForeColor.)
	Handle	Gets the window handle that the control is bound to. (Inherited from Control.)
	HasAboutBox	Gets a value indicating whether the ActiveX control has an About dialog box.
	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.)
	ImeMode	Infrastructure. This property is not relevant for this class.
	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.)
	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 can specify. (Inherited from Control.)
	MinimumSize	Gets or sets the size that is the lower limit that GetPreferredSize can specify. (Inherited from Control.)
	Name	Gets or sets the name of the control. (Inherited from Control.)
	OcxState	Gets or sets the persisted state of the ActiveX 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.)
	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. 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	Infrastructure. This property is not relevant for this class.
	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. (Overrides Control..::.Site.)
	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	Infrastructure. This property is not relevant for this class. (Overrides Control..::.Text.)
	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.)
	Visible	Gets or sets a value indicating whether the control and all its child controls are displayed. (Inherited from Control.)
	Width	Gets or sets the width of the control. (Inherited from Control.)
	WindowTarget	Infrastructure. This property is not relevant for this class. (Inherited from Control.)

Top

Methods

	Name	Description
	AccessibilityNotifyClients(AccessibleEvents, Int32)	Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control. (Inherited from Control.)
	AccessibilityNotifyClients(AccessibleEvents, Int32, Int32)	Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control . (Inherited from Control.)
	AttachInterfaces	When overridden in a derived class, attaches interfaces to the underlying ActiveX control.
	BeginInit	Begins the initialization of the ActiveX control.
	BeginInvoke(Delegate)	Executes the specified delegate asynchronously on the thread that the control's underlying handle was created on. (Inherited from Control.)
	BeginInvoke(Delegate, array<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.)
	BringToFront	Brings the control to the front of the z-order. (Inherited from Control.)
	Contains	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. (Overrides Control..::.CreateHandle()()().)
	CreateInstanceCore	Called by the system to create the ActiveX control.
	CreateObjRef	Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from MarshalByRefObject.)
	CreateSink	Called by the control to prepare it for listening to events.
	DefWndProc	Sends the specified message to the default window procedure. (Inherited from Control.)
	DestroyHandle	Destroys the handle associated with the control. (Overrides Control..::.DestroyHandle()()().)
	DetachSink	Called by the control when it stops listening to events.
	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. (Overrides Control..::.Dispose(Boolean).)
	DoDragDrop	Begins a drag-and-drop operation. (Inherited from Control.)
	DoVerb	Requests that an object perform an action in response to an end-user's action.
	DrawToBitmap	Infrastructure. This method is not supported by this control.
	EndInit	Ends the initialization of an ActiveX control.
	EndInvoke	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.)
	Finalize	Releases unmanaged resources and performs other cleanup operations before the Component is reclaimed by garbage collection. (Inherited from Component.)
	FindForm	Retrieves the form that the control is on. (Inherited from Control.)
	Focus	Sets input focus to the control. (Inherited from Control.)
	GetAccessibilityObjectById	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)	Retrieves the child control that is located at the specified coordinates. (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.)
	GetColorFromOleColor	Returns a Color structure that corresponds to the specified OLE color value.
	GetContainerControl	Returns the next ContainerControl up the control's chain of parent controls. (Inherited from Control.)
	GetFontFromIFont	Returns a Font created from the specified OLE IFont object.
	GetFontFromIFontDisp	Returns a Font created from the specified OLE IFontDisp object.
	GetHashCode	Serves as a hash function for a particular type. (Inherited from Object.)
	GetIFontDispFromFont	Returns an OLE IFontDisp object created from the specified Font object.
	GetIFontFromFont	Returns an OLE IFont object created from the specified Font object.
	GetIPictureDispFromPicture	Returns an OLE IPictureDisp object corresponding to the specified Image.
	GetIPictureFromCursor	Returns an OLE IPicture object corresponding to the specified Cursor.
	GetIPictureFromPicture	Returns an OLE IPicture object corresponding to the specified Image.
	GetLifetimeService	Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
	GetNextControl	Retrieves the next control forward or back in the tab order of child controls. (Inherited from Control.)
	GetOADateFromTime	Returns an OLE Automation date that corresponds to the specified DateTime structure.
	GetOcx	Retrieves a reference to the underlying ActiveX control.
	GetOleColorFromColor	Returns an OLE color value that corresponds to the specified Color structure.
	GetPictureFromIPicture	Returns an Image corresponding to the specified OLE IPicture object.
	GetPictureFromIPictureDisp	Returns an Image corresponding to the specified OLE IPictureDisp object.
	GetPreferredSize	Retrieves the size of a rectangular area into which a control can be fitted. (Inherited from Control.)
	GetScaledBounds	Called by the system to retrieve the current bounds of the ActiveX control. (Overrides Control..::.GetScaledBounds(Rectangle, SizeF, BoundsSpecified).)
	GetService	Returns an object that represents a service provided by the Component or by its Container. (Inherited from Component.)
	GetStyle	Retrieves the value of the specified control style bit for the control. (Inherited from Control.)
	GetTimeFromOADate	Returns a DateTime structure that corresponds to the specified OLE Automation date.
	GetTopLevel	Determines if the control is a top-level control. (Inherited from Control.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	HasPropertyPages	Determines if the ActiveX control has a property page.
	Hide	Conceals the control from the user. (Inherited from Control.)
	InitializeLifetimeService	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)	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)	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(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(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.)
	Invoke(Delegate)	Executes the specified delegate on the thread that owns the control's underlying window handle. (Inherited from Control.)
	Invoke(Delegate, array<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.)
	InvokeEditMode	Attempts to activate the editing mode of the hosted control.
	InvokeGotFocus	Raises the GotFocus event for the specified control. (Inherited from Control.)
	InvokeLostFocus	Raises the LostFocus event for the specified control. (Inherited from Control.)
	InvokeOnClick	Raises the Click event for the specified control. (Inherited from Control.)
	InvokePaint	Raises the Paint event for the specified control. (Inherited from Control.)
	InvokePaintBackground	Raises the PaintBackground event for the specified control. (Inherited from Control.)
	IsInputChar	Determines if a character is an input character that the ActiveX control recognizes. (Overrides Control..::.IsInputChar(Char).)
	IsInputKey	Determines whether the specified key is a regular input key or a special key that requires preprocessing. (Inherited from Control.)
	MakeDirty	Announces to the component change service that the AxHost has changed.
	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	Infrastructure. Raises the Invalidated event with a specified region of the control to invalidate. (Inherited from Control.)
	OnAutoSizeChanged	Raises the AutoSizeChanged event. (Inherited from Control.)
	OnBackColorChanged	Raises the BackColorChanged event. (Overrides Control..::.OnBackColorChanged(EventArgs).)
	OnBackgroundImageChanged	Raises the BackgroundImageChanged event. (Inherited from Control.)
	OnBackgroundImageLayoutChanged	Raises the BackgroundImageLayoutChanged event. (Inherited from Control.)
	OnBindingContextChanged	Raises the BindingContextChanged event. (Inherited from Control.)
	OnCausesValidationChanged	Raises the CausesValidationChanged event. (Inherited from Control.)
	OnChangeUICues	Raises the ChangeUICues event. (Inherited from Control.)
	OnClick	Raises the Click event. (Inherited from Control.)
	OnClientSizeChanged	Raises the ClientSizeChanged event. (Inherited from Control.)
	OnContextMenuChanged	Raises the ContextMenuChanged event. (Inherited from Control.)
	OnContextMenuStripChanged	Raises the ContextMenuStripChanged event. (Inherited from Control.)
	OnControlAdded	Raises the ControlAdded event. (Inherited from Control.)
	OnControlRemoved	Raises the ControlRemoved event. (Inherited from Control.)
	OnCreateControl	Raises the CreateControl method. (Inherited from Control.)
	OnCursorChanged	Raises the CursorChanged event. (Inherited from Control.)
	OnDockChanged	Raises the DockChanged event. (Inherited from Control.)
	OnDoubleClick	Raises the DoubleClick event. (Inherited from Control.)
	OnDragDrop	Raises the DragDrop event. (Inherited from Control.)
	OnDragEnter	Raises the DragEnter event. (Inherited from Control.)
	OnDragLeave	Raises the DragLeave event. (Inherited from Control.)
	OnDragOver	Raises the DragOver event. (Inherited from Control.)
	OnEnabledChanged	Raises the EnabledChanged event. (Inherited from Control.)
	OnEnter	Raises the Enter event. (Inherited from Control.)
	OnFontChanged	Raises the FontChanged event. (Overrides Control..::.OnFontChanged(EventArgs).)
	OnForeColorChanged	Raises the ForeColorChanged event. (Overrides Control..::.OnForeColorChanged(EventArgs).)
	OnGiveFeedback	Raises the GiveFeedback event. (Inherited from Control.)
	OnGotFocus	Raises the GotFocus event. (Inherited from Control.)
	OnHandleCreated	Raises the HandleCreated event. (Overrides Control..::.OnHandleCreated(EventArgs).)
	OnHandleDestroyed	Raises the HandleDestroyed event. (Inherited from Control.)
	OnHelpRequested	Raises the HelpRequested event. (Inherited from Control.)
	OnImeModeChanged	Raises the ImeModeChanged event. (Inherited from Control.)
	OnInPlaceActive	Infrastructure. Called when the control transitions to the in-place active state.
	OnInvalidated	Raises the Invalidated event. (Inherited from Control.)
	OnKeyDown	Raises the KeyDown event. (Inherited from Control.)
	OnKeyPress	Raises the KeyPress event. (Inherited from Control.)
	OnKeyUp	Raises the KeyUp event. (Inherited from Control.)
	OnLayout	Raises the Layout event. (Inherited from Control.)
	OnLeave	Raises the Leave event. (Inherited from Control.)
	OnLocationChanged	Raises the LocationChanged event. (Inherited from Control.)
	OnLostFocus	Raises the LostFocus event. (Overrides Control..::.OnLostFocus(EventArgs).)
	OnMarginChanged	Raises the MarginChanged event. (Inherited from Control.)
	OnMouseCaptureChanged	Raises the MouseCaptureChanged event. (Inherited from Control.)
	OnMouseClick	Raises the MouseClick event. (Inherited from Control.)
	OnMouseDoubleClick	Raises the MouseDoubleClick event. (Inherited from Control.)
	OnMouseDown	Raises the MouseDown event. (Inherited from Control.)
	OnMouseEnter	Raises the MouseEnter event. (Inherited from Control.)
	OnMouseHover	Raises the MouseHover event. (Inherited from Control.)
	OnMouseLeave	Raises the MouseLeave event. (Inherited from Control.)
	OnMouseMove	Raises the MouseMove event. (Inherited from Control.)
	OnMouseUp	Raises the MouseUp event. (Inherited from Control.)
	OnMouseWheel	Raises the MouseWheel event. (Inherited from Control.)
	OnMove	Raises the Move event. (Inherited from Control.)
	OnNotifyMessage	Notifies the control of Windows messages. (Inherited from Control.)
	OnPaddingChanged	Raises the PaddingChanged event. (Inherited from Control.)
	OnPaint	Raises the Paint event. (Inherited from Control.)
	OnPaintBackground	Paints the background of the control. (Inherited from Control.)
	OnParentBackColorChanged	Raises the BackColorChanged event when the BackColor property value of the control's container changes. (Inherited from Control.)
	OnParentBackgroundImageChanged	Raises the BackgroundImageChanged event when the BackgroundImage property value of the control's container changes. (Inherited from Control.)
	OnParentBindingContextChanged	Raises the BindingContextChanged event when the BindingContext property value of the control's container changes. (Inherited from Control.)
	OnParentChanged	Raises the ParentChanged event. (Inherited from Control.)
	OnParentCursorChanged	Raises the CursorChanged event. (Inherited from Control.)
	OnParentEnabledChanged	Raises the EnabledChanged event when the Enabled property value of the control's container changes. (Inherited from Control.)
	OnParentFontChanged	Raises the FontChanged event when the Font property value of the control's container changes. (Inherited from Control.)
	OnParentForeColorChanged	Raises the ForeColorChanged event when the ForeColor property value of the control's container changes. (Inherited from Control.)
	OnParentRightToLeftChanged	Raises the RightToLeftChanged event when the RightToLeft property value of the control's container changes. (Inherited from Control.)
	OnParentVisibleChanged	Raises the VisibleChanged event when the Visible property value of the control's container changes. (Inherited from Control.)
	OnPreviewKeyDown	Raises the PreviewKeyDown event. (Inherited from Control.)
	OnPrint	Raises the Paint event. (Inherited from Control.)
	OnQueryContinueDrag	Raises the QueryContinueDrag event. (Inherited from Control.)
	OnRegionChanged	Raises the RegionChanged event. (Inherited from Control.)
	OnResize	Raises the Resize event. (Inherited from Control.)
	OnRightToLeftChanged	Raises the RightToLeftChanged event. (Inherited from Control.)
	OnSizeChanged	Raises the SizeChanged event. (Inherited from Control.)
	OnStyleChanged	Raises the StyleChanged event. (Inherited from Control.)
	OnSystemColorsChanged	Raises the SystemColorsChanged event. (Inherited from Control.)
	OnTabIndexChanged	Raises the TabIndexChanged event. (Inherited from Control.)
	OnTabStopChanged	Raises the TabStopChanged event. (Inherited from Control.)
	OnTextChanged	Raises the TextChanged event. (Inherited from Control.)
	OnValidated	Raises the Validated event. (Inherited from Control.)
	OnValidating	Raises the Validating event. (Inherited from Control.)
	OnVisibleChanged	Raises the VisibleChanged event. (Inherited from Control.)
	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	Computes the location of the specified screen point into client coordinates. (Inherited from Control.)
	PointToScreen	Computes the location of the specified client point into screen coordinates. (Inherited from Control.)
	PreProcessControlMessage	Preprocesses keyboard or input messages within the message loop before they are dispatched. (Inherited from Control.)
	PreProcessMessage	Preprocesses keyboard or input messages within the message loop before they are dispatched. (Overrides Control..::.PreProcessMessage(Message%).)
	ProcessCmdKey	Processes a command key. (Inherited from Control.)
	ProcessDialogChar	Processes a dialog character. (Inherited from Control.)
	ProcessDialogKey	Processes a dialog key. (Overrides Control..::.ProcessDialogKey(Keys).)
	ProcessKeyEventArgs	Processes a key message and generates the appropriate control events. (Inherited from Control.)
	ProcessKeyMessage	Processes a keyboard message. (Inherited from Control.)
	ProcessKeyPreview	Previews a keyboard message. (Inherited from Control.)
	ProcessMnemonic	Processes a mnemonic character. (Overrides Control..::.ProcessMnemonic(Char).)
	PropsValid	Returns a value that indicates whether the hosted control is in a state in which its properties can be accessed.
	RaiseDragEvent	Infrastructure. Raises the appropriate drag event. (Inherited from Control.)
	RaiseKeyEvent	Infrastructure. Raises the appropriate key event. (Inherited from Control.)
	RaiseMouseEvent	Infrastructure. Raises the appropriate mouse event. (Inherited from Control.)
	RaiseOnMouseDown(Int16, Int16, Int32, Int32)	Infrastructure. Raises the MouseDown event using the specified 32-bit signed integers.
	RaiseOnMouseDown(Int16, Int16, Single, Single)	Infrastructure. Raises the MouseDown event using the specified single-precision floating-point numbers.
	RaiseOnMouseDown(Object, Object, Object, Object)	Infrastructure. Raises the MouseDown event using the specified objects.
	RaiseOnMouseMove(Int16, Int16, Int32, Int32)	Infrastructure. Raises the MouseMove event using the specified 32-bit signed integers.
	RaiseOnMouseMove(Int16, Int16, Single, Single)	Infrastructure. Raises the MouseMove event using the specified single-precision floating-point numbers.
	RaiseOnMouseMove(Object, Object, Object, Object)	Infrastructure. Raises the MouseMove event using the specified objects.
	RaiseOnMouseUp(Int16, Int16, Int32, Int32)	Infrastructure. Raises the MouseUp event using the specified 32-bit signed integers.
	RaiseOnMouseUp(Int16, Int16, Single, Single)	Infrastructure. Raises the MouseUp event using the specified single-precision floating-point numbers.
	RaiseOnMouseUp(Object, Object, Object, Object)	Infrastructure. Raises the MouseUp event using the specified objects.
	RaisePaintEvent	Infrastructure. Raises the appropriate paint event. (Inherited from Control.)
	RecreateHandle	Forces the re-creation of the handle for the control. (Inherited from Control.)
	RectangleToClient	Computes the size and location of the specified screen rectangle in client coordinates. (Inherited from Control.)
	RectangleToScreen	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.)
	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	Infrastructure. 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. (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	Converts the specified ContentAlignment to the appropriate ContentAlignment to support right-to-left text. (Inherited from Control.)
	RtlTranslateHorizontal	Converts the specified HorizontalAlignment to the appropriate HorizontalAlignment to support right-to-left text. (Inherited from Control.)
	RtlTranslateLeftRight	Converts the specified LeftRightAlignment to the appropriate LeftRightAlignment to support right-to-left text. (Inherited from Control.)
	Scale(Single)	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.)
	Scale(Single, Single)	Obsolete. Scales the entire control and any child controls. (Inherited from Control.)
	ScaleControl	Scales a control's location, size, padding and margin. (Inherited from Control.)
	ScaleCore	Infrastructure. This method is not relevant for this class. (Inherited from Control.)
	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 Control.)
	SelectNextControl	Activates the next control. (Inherited from Control.)
	SendToBack	Sends the control to the back of the z-order. (Inherited from Control.)
	SetAboutBoxDelegate	Calls the ShowAboutBox method to display the ActiveX control's About dialog box.
	SetAutoSizeMode	Sets a value indicating how a control will behave when its AutoSize property is enabled. (Inherited from Control.)
	SetBounds(Int32, Int32, Int32, Int32)	Sets the bounds of the control to the specified location and size. (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.)
	SetBoundsCore	Performs the work of setting the specified bounds of this control. (Overrides Control..::.SetBoundsCore(Int32, Int32, Int32, Int32, BoundsSpecified).)
	SetClientSizeCore	Sets the size of the client area of the control. (Inherited from Control.)
	SetStyle	Sets a specified ControlStyles flag to either true or false. (Inherited from Control.)
	SetTopLevel	Sets the control as the top-level control. (Inherited from Control.)
	SetVisibleCore	Sets the control to the specified visible state. (Overrides Control..::.SetVisibleCore(Boolean).)
	Show	Displays the control to the user. (Inherited from Control.)
	ShowAboutBox	Displays the ActiveX control's About dialog box.
	ShowPropertyPages()()()	Displays the property pages associated with the ActiveX control.
	ShowPropertyPages(Control)	Displays the property pages associated with the ActiveX control assigned to the specified parent control.
	SizeFromClientSize	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)	Updates the bounds of the control with the specified 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.)
	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.)
	WndProc	Processes Windows messages. (Overrides Control..::.WndProc(Message%).)

Top

Events

	Name	Description
	AutoSizeChanged	Infrastructure. This event is not relevant for this class. (Inherited from Control.)
	BackColorChanged	Infrastructure. The BackColorChanged event is not supported by the AxHost class.
	BackgroundImageChanged	Infrastructure. The BackgroundImageChanged event is not supported by the AxHost class.
	BackgroundImageLayoutChanged	Infrastructure. This event is not relevant for this class.
	BindingContextChanged	Infrastructure. The BindingContextChanged event is not supported by the AxHost class.
	CausesValidationChanged	Occurs when the value of the CausesValidation property changes. (Inherited from Control.)
	ChangeUICues	Infrastructure. The ChangeUICues event is not supported by the AxHost class.
	Click	Infrastructure. The Click event is not supported by the AxHost class.
	ClientSizeChanged	Occurs when the value of the ClientSize property changes. (Inherited from Control.)
	ContextMenuChanged	Infrastructure. The ContextMenuChanged event is not supported by the AxHost class.
	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	Infrastructure. The CursorChanged event is not supported by the AxHost class.
	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	Infrastructure. The DoubleClick event is not supported by the AxHost class.
	DragDrop	Infrastructure. The DragDrop event is not supported by the AxHost class.
	DragEnter	Infrastructure. The DragEnter event is not supported by the AxHost class.
	DragLeave	Infrastructure. The DragLeave event is not supported by the AxHost class.
	DragOver	Infrastructure. The DragOver event is not supported by the AxHost class.
	EnabledChanged	Infrastructure. The EnabledChanged event is not supported by the AxHost class.
	Enter	Occurs when the control is entered. (Inherited from Control.)
	FontChanged	Infrastructure. The FontChanged event is not supported by the AxHost class.
	ForeColorChanged	Infrastructure. The ForeColorChanged event is not supported by the AxHost class.
	GiveFeedback	Infrastructure. The GiveFeedback event is not supported by the AxHost class.
	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	Infrastructure. The HelpRequested event is not supported by the AxHost class.
	ImeModeChanged	Infrastructure. The ImeModeChanged event is not supported by the AxHost class.
	Invalidated	Occurs when a control's display requires redrawing. (Inherited from Control.)
	KeyDown	Infrastructure. The KeyDown event is not supported by the AxHost class.
	KeyPress	Infrastructure. The KeyPress event is not supported by the AxHost class.
	KeyUp	Infrastructure. The KeyUp event is not supported by the AxHost class.
	Layout	Infrastructure. The Layout event is not supported by the AxHost class.
	Leave	Occurs when the input focus leaves the control. (Inherited from Control.)
	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	Infrastructure. This event is not relevant for this class.
	MouseDoubleClick	Infrastructure. This event is not relevant for this class.
	MouseDown	Infrastructure. The MouseDown event is not supported by the AxHost class.
	MouseEnter	Infrastructure. The MouseEnter event is not supported by the AxHost class.
	MouseHover	Infrastructure. The MouseHover event is not supported by the AxHost class.
	MouseLeave	Infrastructure. The MouseLeave event is not supported by the AxHost class.
	MouseMove	Infrastructure. The MouseMove event is not supported by the AxHost class.
	MouseUp	Infrastructure. The MouseUp event is not supported by the AxHost class.
	MouseWheel	Infrastructure. The MouseWheel event is not supported by the AxHost class.
	Move	Occurs when the control is moved. (Inherited from Control.)
	PaddingChanged	Occurs when the control's padding changes. (Inherited from Control.)
	Paint	Infrastructure. The Paint event is not supported by the AxHost class.
	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	Infrastructure. The QueryAccessibilityHelp event is not supported by the AxHost class.
	QueryContinueDrag	Infrastructure. The QueryContinueDrag event is not supported by the AxHost class.
	RegionChanged	Occurs when the value of the Region property changes. (Inherited from Control.)
	Resize	Occurs when the control is resized. (Inherited from Control.)
	RightToLeftChanged	Infrastructure. The RightToLeftChanged event is not supported by the AxHost class.
	SizeChanged	Occurs when the Size property value changes. (Inherited from Control.)
	StyleChanged	Infrastructure. The StyleChanged event is not supported by the AxHost class.
	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	Infrastructure. The TextChanged event is not supported by the AxHost class.
	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.)

Top

Explicit Interface Implementations

	Name	Description
	ICustomTypeDescriptor..::.GetAttributes	Infrastructure. Returns a collection of type Attribute for the current object.
	ICustomTypeDescriptor..::.GetClassName	Infrastructure. Returns the class name of the current object.
	ICustomTypeDescriptor..::.GetComponentName	Infrastructure. Returns the name of the current object.
	ICustomTypeDescriptor..::.GetConverter	Infrastructure. Returns a type converter for the current object.
	ICustomTypeDescriptor..::.GetDefaultEvent	Infrastructure. Returns the default event for the current object.
	ICustomTypeDescriptor..::.GetDefaultProperty	Infrastructure. Returns the default property for the current object.
	ICustomTypeDescriptor..::.GetEditor	Infrastructure. Returns an editor of the specified type for the current object.
	ICustomTypeDescriptor..::.GetEvents()()()	Infrastructure. Returns the events for the current object.
	ICustomTypeDescriptor..::.GetEvents(array<Attribute>[]()[])	Infrastructure. Returns the events for the current object using the specified attribute array as a filter.
	ICustomTypeDescriptor..::.GetProperties()()()	Infrastructure. Returns the properties for the current object.
	ICustomTypeDescriptor..::.GetProperties(array<Attribute>[]()[])	Infrastructure. Returns the properties for the current object using the specified attribute array as a filter.
	ICustomTypeDescriptor..::.GetPropertyOwner	Infrastructure. Returns the object that owns the specified value.
	IDropTarget..::.OnDragDrop	Infrastructure. Raises the DragDrop event. (Inherited from Control.)
	IDropTarget..::.OnDragEnter	Infrastructure. Raises the DragEnter event. (Inherited from Control.)
	IDropTarget..::.OnDragLeave	Infrastructure. Raises the DragLeave event. (Inherited from Control.)
	IDropTarget..::.OnDragOver	Infrastructure. Raises the DragOver event. (Inherited from Control.)

Top

Remarks

You typically do not use the AxHost class directly. You can use the Aximp.exe (Windows Forms ActiveX Control Importer) to generate the wrappers that extend AxHost.

The ActiveX Control Importer generates a class that is derived from the AxHost class, and compiles it into a library file (DLL) that can be added as a reference to your application. Alternatively, you can use the /source switch with the ActiveX Control Importer and a C# file is generated for your AxHost derived class. You can then make changes to the code and recompile it into a library file.

Note
If the name of a member of the ActiveX control matches a name defined in the .NET Framework, then the ActiveX Control Importer will prefix the member name with "Ctl" when it creates the AxHost derived class. For example, if your ActiveX control has a member named "Layout", it is renamed "CtlLayout" in the AxHost derived class because the Layout event is defined within the .NET Framework.

Most of the common properties of the AxHost class are only valid and used if the underlying ActiveX control exposes those properties. A few examples of the common properties are BackColor, Cursor, Font, and Text.

Note
If you are using Visual Studio as your Windows Forms design environment, you can make an ActiveX control available to your application by adding the ActiveX control to your Toolbox. To accomplish this, right-click the Toolbox, select Customize Toolbox, then browse to the ActiveX control's.ocx file. For more information, see "Adding ActiveX Controls to Windows Forms" in the Visual Studio documentation.

Note

If you are using Visual Studio as your Windows Forms design environment, you can make an ActiveX control available to your application by adding the ActiveX control to your Toolbox. To accomplish this, right-click the Toolbox, select Customize Toolbox, then browse to the ActiveX control's.ocx file. For more information, see "Adding ActiveX Controls to Windows Forms" in the Visual Studio documentation.

Examples

The following code example overrides the constructor, and the SetAboutBoxDelegate and AttachInterfaces methods of an AxHost derived class that wraps the Microsoft Masked Edit ActiveX Control. This code requires that you have created the generated source code by running the AxImp.exe on the MSMask32.ocx file with the /source switch to generate the wrapper class to be edited. This code is only shown in C# syntax because that is the only language output by the AxImp.exe.

public AxMaskEdBox()
    :
  base("c932ba85-4374-101b-a56c-00aa003668dc") // The ActiveX control's class identifier.
{
    // Make the AboutBox method the about box delegate.
    this.SetAboutBoxDelegate(new AboutBoxDelegate(AboutBox));
}

public virtual void AboutBox()
{
    // If the instance of the ActiveX control is null when the AboutBox method 
    // is called, raise an InvalidActiveXStateException exception.
    if ((this.ocx == null))
    {
        throw new System.Windows.Forms.AxHost.InvalidActiveXStateException(
          "AboutBox", System.Windows.Forms.AxHost.ActiveXInvokeKind.MethodInvoke);
    }
    // Show the about box if the ActiveX control has one.
    if (this.HasAboutBox)
    {
        this.ocx.AboutBox();
    }
}

protected override void AttachInterfaces()
{
    try
    {
        // Attach the IMSMask interface to the ActiveX control.
        this.ocx = ((MSMask.IMSMask)(this.GetOcx()));
    }
    catch (System.Exception ex)
    {
        System.Console.WriteLine(ex.Message);
    }
}

Version Information

.NET Framework

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

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Reference

System.Windows.Forms Namespace

Control

UserControl