AxHost | marshal by reference, disposable |
System.Windows.Forms (system.windows.forms.dll) | abstract class |
This Control class wraps ActiveX controls that
have been imported into the managed environment (either by use of the
Aximp.exe tool or, more commonly, by adding them
to the designer by customizing the toolbox). It extends the base
services to provide methods to get the underlying OCX control
(GetOcx()) and show property pages
(ShowPropertyPages()), if they are present
(HasPropertyPages()).
Note that several of the events you would normally expect from a
Control are not supported (e.g., color and font
property changes), and attempting to bind to them will cause a
NotSupportedException. The Liskov substitution
principle states that you should be able to use any instance of a
derived class in place of an instance of the base class. Throwing
that exception means that this class violates that principle.
Therefore, you have to take care if you are using
Control objects polymorphically in your
application (e.g., in your own custom host), in case someone drops an
ActiveX control into the equation.
public abstract class AxHost : Control :
System.ComponentModel.ISupportInitialize, System.ComponentModel.ICustomTypeDescriptor {
// Protected Constructors
protected AxHost(string clsid);
protected AxHost(string clsid, int flags);
// Public Instance Properties
public override Color BackColor{set; get; } // overrides Control
public override Image BackgroundImage{set; get; } // overrides Control
public ContainerControl ContainingControl{set; get; }
public override ContextMenu ContextMenu{set; get; } // overrides Control
public override Cursor Cursor{set; get; } // overrides Control
public bool EditMode{get; }
public virtual bool Enabled{set; get; } // overrides Control
public override Font Font{set; get; } // overrides Control
public override Color ForeColor{set; get; } // overrides Control
public bool HasAboutBox{get; }
public State OcxState{set; get; }
public virtual bool RightToLeft{set; get; }
public override ISite Site{set; } // overrides Control
public override string Text{set; get; } // overrides Control
// Protected Instance Properties
protected override CreateParams CreateParams{get; } // overrides Control
protected override Size DefaultSize{get; } // overrides Control
// Protected Static Methods
protected static Color GetColorFromOleColor(uint color);
protected static Font GetFontFromIFont(object font);
protected static Font GetFontFromIFontDisp(object font);
protected static object GetIFontDispFromFont(System.Drawing.Font font);
protected static object GetIFontFromFont(System.Drawing.Font font);
protected static object GetIPictureDispFromPicture(System.Drawing.Image image);
protected static object GetIPictureFromCursor(Cursor cursor);
protected static object GetIPictureFromPicture(System.Drawing.Image image);
protected static double GetOADateFromTime(DateTime time);
protected static uint GetOleColorFromColor(System.Drawing.Color color);
protected static Image GetPictureFromIPicture(object picture);
protected static Image GetPictureFromIPictureDisp(object picture);
protected static DateTime GetTimeFromOADate(double date);
// Public Instance Methods
public void BeginInit(); // implements System.ComponentModel.ISupportInitialize
public void DoVerb(int verb);
public void EndInit(); // implements System.ComponentModel.ISupportInitialize
public object GetOcx();
public bool HasPropertyPages();
public void InvokeEditMode();
public void MakeDirty();
public override bool PreProcessMessage(ref Message msg); // overrides Control
public void ShowAboutBox();
public void ShowPropertyPages();
public void ShowPropertyPages(Control control);
// Protected Instance Methods
protected virtual void AttachInterfaces();
protected override void CreateHandle(); // overrides Control
protected virtual void CreateSink();
protected override void DestroyHandle(); // overrides Control
protected virtual void DetachSink();
protected override void Dispose(bool disposing); // overrides Control
protected override bool IsInputChar(char charCode); // overrides Control
protected override void OnBackColorChanged(EventArgs e); // overrides Control
protected override void OnFontChanged(EventArgs e); // overrides Control
protected override void OnForeColorChanged(EventArgs e); // overrides Control
protected override void OnHandleCreated(EventArgs e); // overrides Control
protected virtual void OnInPlaceActive();
protected override void OnLostFocus(EventArgs e); // overrides Control
protected override bool ProcessMnemonic(char charCode); // overrides Control
protected bool PropsValid();
protected void RaiseOnMouseDown(short button, short shift, int x, int y);
protected void RaiseOnMouseDown(short button, short shift, float x, float y);
protected void RaiseOnMouseDown(object o1, object o2, object o3, object o4);
protected void RaiseOnMouseMove(short button, short shift, int x, int y);
protected void RaiseOnMouseMove(short button, short shift, float x, float y);
protected void RaiseOnMouseMove(object o1, object o2, object o3, object o4);
protected void RaiseOnMouseUp(short button, short shift, int x, int y);
protected void RaiseOnMouseUp(short button, short shift, float x, float y);
protected void RaiseOnMouseUp(object o1, object o2, object o3, object o4);
protected void SetAboutBoxDelegate(AboutBoxDelegate d);
protected override void SetBoundsCore(int x, int y, int width, int height, BoundsSpecified specified); // overrides Control
protected override void SetVisibleCore(bool value); // overrides Control
protected override void WndProc(ref Message m); // overrides Control
// Events
public event EventHandler BackColorChanged; // overrides Control
public event EventHandler BackgroundImageChanged; // overrides Control
public event EventHandler BindingContextChanged; // overrides Control
public event UICuesEventHandler ChangeUICues; // overrides Control
public event EventHandler Click; // overrides Control
public event EventHandler ContextMenuChanged; // overrides Control
public event EventHandler CursorChanged; // overrides Control
public event EventHandler DoubleClick; // overrides Control
public event DragEventHandler DragDrop; // overrides Control
public event DragEventHandler DragEnter; // overrides Control
public event EventHandler DragLeave; // overrides Control
public event DragEventHandler DragOver; // overrides Control
public event EventHandler EnabledChanged; // overrides Control
public event EventHandler FontChanged; // overrides Control
public event EventHandler ForeColorChanged; // overrides Control
public event GiveFeedbackEventHandler GiveFeedback; // overrides Control
public event HelpEventHandler HelpRequested; // overrides Control
public event EventHandler ImeModeChanged; // overrides Control
public event KeyEventHandler KeyDown; // overrides Control
public event KeyPressEventHandler KeyPress; // overrides Control
public event KeyEventHandler KeyUp; // overrides Control
public event LayoutEventHandler Layout; // overrides Control
public event MouseEventHandler MouseDown; // overrides Control
public event EventHandler MouseEnter; // overrides Control
public event EventHandler MouseHover; // overrides Control
public event EventHandler MouseLeave; // overrides Control
public event MouseEventHandler MouseMove; // overrides Control
public event MouseEventHandler MouseUp; // overrides Control
public event MouseEventHandler MouseWheel; // overrides Control
public event PaintEventHandler Paint; // overrides Control
public event QueryAccessibilityHelpEventHandler QueryAccessibilityHelp; // overrides Control
public event QueryContinueDragEventHandler QueryContinueDrag; // overrides Control
public event EventHandler RightToLeftChanged; // overrides Control
public event EventHandler StyleChanged; // overrides Control
public event EventHandler TabIndexChanged; // overrides Control
public event EventHandler TabStopChanged; // overrides Control
public event EventHandler TextChanged; // overrides Control
}
Hierarchy
System.Object
System.MarshalByRefObject
System.ComponentModel.Component(System.ComponentModel.IComponen,
System.IDisposable)
Control(IOleContro, IOleObject,
IOleInPlaceObject,
IOleInPlaceActiveObject,
IOleWindow, IViewObject,
IViewObject2, IPersist,
IPersistStreamInit,
IPersistPropertyBag,
IPersistStorage,
IQuickActivate,
System.ComponentModel.ISynchronizeInvoke,
IWin32Window)
AxHost(System.ComponentModel.ISupportInitializ,
System.ComponentModel.ICustomTypeDescriptor)
|