ActiveX（四） mshtml 命名空间 重要接口简介

　　在上一篇随笔 ActiveX（三）ActiveX 调用 Js 中，我们已经可以获得js中window对象的强类型接口、即 mshtml.IHTMLWindow2 ，通过该接口、我们可以调用js函数。那么我们再试一试其他的方法呢，看看结果是否符合预期：

　　

        private void btnAlert_Click(object sender, EventArgs e)
        {
            if (this.window2 != null)
            {
                this.window2.alert("C#CodeAlert:" + this.txtPwd.Text);
            }
        }

        private void btnLocation_Click(object sender, EventArgs e)
        {
            if (this.window2 != null && this.window2.location != null)
            {
                this.window2.alert(this.window2.location.toString());
            }
        }

　　

　　哈哈，试了一下，没有问题。 但是经过使用发现 location 属性是只读的，并且、如果通过反射强制设置 location 属性，则会抛出异常哦。

　　现在知道了 window ， 那 document 呢？ mshtml 命名空间中有没有提供相应的接口呢？ 经过查找发现、document实现了如下的两个接口：

　　

    [Guid("332C4425-26CB-11D0-B483-00C04FD90119")]
    [TypeLibType()]
    public interface IHTMLDocument2 : IHTMLDocument
    {
        [DispId()]
        IHTMLElement activeElement { get; }
        [DispId()]
        dynamic alinkColor { get; set; }
        [DispId()]
        IHTMLElementCollection all { get; }
        [DispId()]
        IHTMLElementCollection anchors { get; }
        [DispId()]
        IHTMLElementCollection applets { get; }
        [DispId(-)]
        dynamic bgColor { get; set; }
        [DispId()]
        IHTMLElement body { get; }
        [DispId()]
        string charset { get; set; }
        [DispId()]
        string cookie { get; set; }
        [DispId()]
        string defaultCharset { get; set; }
        [DispId()]
        string designMode { get; set; }
        [DispId()]
        string domain { get; set; }
        [DispId()]
        IHTMLElementCollection embeds { get; }
        [DispId()]
        bool expando { get; set; }
        [DispId(-)]
        dynamic fgColor { get; set; }
        [DispId()]
        string fileCreatedDate { get; }
        [DispId()]
        string fileModifiedDate { get; }
        [DispId()]
        string fileSize { get; }
        [DispId()]
        string fileUpdatedDate { get; }
        [DispId()]
        IHTMLElementCollection forms { get; }
        [DispId()]
        FramesCollection frames { get; }
        [DispId()]
        IHTMLElementCollection images { get; }
        [DispId()]
        string lastModified { get; }
        [DispId()]
        dynamic linkColor { get; set; }
        [DispId()]
        IHTMLElementCollection links { get; }
        [DispId()]
        HTMLLocation location { get; }
        [DispId()]
        string mimeType { get; }
        [DispId()]
        string nameProp { get; }
        [DispId(-)]
        dynamic onafterupdate { get; set; }
        [DispId(-)]
        dynamic onbeforeupdate { get; set; }
        [DispId(-)]
        dynamic onclick { get; set; }
        [DispId(-)]
        dynamic ondblclick { get; set; }
        [DispId(-)]
        dynamic ondragstart { get; set; }
        [DispId(-)]
        dynamic onerrorupdate { get; set; }
        [DispId(-)]
        dynamic onhelp { get; set; }
        [DispId(-)]
        dynamic onkeydown { get; set; }
        [DispId(-)]
        dynamic onkeypress { get; set; }
        [DispId(-)]
        dynamic onkeyup { get; set; }
        [DispId(-)]
        dynamic onmousedown { get; set; }
        [DispId(-)]
        dynamic onmousemove { get; set; }
        [DispId(-)]
        dynamic onmouseout { get; set; }
        [DispId(-)]
        dynamic onmouseover { get; set; }
        [DispId(-)]
        dynamic onmouseup { get; set; }
        [DispId(-)]
        dynamic onreadystatechange { get; set; }
        [DispId(-)]
        dynamic onrowenter { get; set; }
        [DispId(-)]
        dynamic onrowexit { get; set; }
        [DispId(-)]
        dynamic onselectstart { get; set; }
        [DispId()]
        IHTMLWindow2 parentWindow { get; }
        [DispId()]
        IHTMLElementCollection plugins { get; }
        [DispId()]
        string protocol { get; }
        [DispId()]
        string readyState { get; }
        [DispId()]
        string referrer { get; }
        [DispId()]
        dynamic Script { get; }
        [DispId()]
        IHTMLElementCollection scripts { get; }
        [DispId()]
        string security { get; }
        [DispId()]
        IHTMLSelectionObject selection { get; }
        [DispId()]
        HTMLStyleSheetsCollection styleSheets { get; }
        [DispId()]
        string title { get; set; }
        [DispId()]
        string url { get; set; }
        [DispId()]
        dynamic vlinkColor { get; set; }

        [DispId()]
        void clear();
        [DispId()]
        void close();
        [DispId()]
        IHTMLElement createElement(string eTag);
        [DispId()]
        IHTMLStyleSheet createStyleSheet(string bstrHref = "", int lIndex = -);
        [DispId()]
        IHTMLElement elementFromPoint(int x, int y);
        [DispId()]
        bool execCommand(string cmdID, bool showUI = false, object value = Type.Missing);
        [DispId()]
        bool execCommandShowHelp(string cmdID);
        [DispId()]
        dynamic open(string url = "text/html", object name = Type.Missing, object features = Type.Missing, object replace = Type.Missing);
        [DispId()]
        bool queryCommandEnabled(string cmdID);
        [DispId()]
        bool queryCommandIndeterm(string cmdID);
        [DispId()]
        bool queryCommandState(string cmdID);
        [DispId()]
        bool queryCommandSupported(string cmdID);
        [DispId()]
        string queryCommandText(string cmdID);
        [DispId()]
        dynamic queryCommandValue(string cmdID);
        [DispId()]
        string toString();
        [DispId()]
        void write(params object[] psarray);
        [DispId()]
        void writeln(params object[] psarray);
    }

IHTMLDocument2

    [Guid("3050F485-98B5-11CF-BB82-00AA00BDCE0B")]
    [TypeLibType()]
    public interface IHTMLDocument3
    {
        [DispId()]
        string baseUrl { get; set; }
        [DispId(-)]
        dynamic childNodes { get; }
        [DispId(-)]
        string dir { get; set; }
        [DispId()]
        IHTMLElement documentElement { get; }
        [DispId()]
        bool enableDownload { get; set; }
        [DispId()]
        bool inheritStyleSheets { get; set; }
        [DispId(-)]
        dynamic onbeforeeditfocus { get; set; }
        [DispId(-)]
        dynamic oncellchange { get; set; }
        [DispId(-)]
        dynamic oncontextmenu { get; set; }
        [DispId(-)]
        dynamic ondataavailable { get; set; }
        [DispId(-)]
        dynamic ondatasetchanged { get; set; }
        [DispId(-)]
        dynamic ondatasetcomplete { get; set; }
        [DispId(-)]
        dynamic onpropertychange { get; set; }
        [DispId(-)]
        dynamic onrowsdelete { get; set; }
        [DispId(-)]
        dynamic onrowsinserted { get; set; }
        [DispId(-)]
        dynamic onstop { get; set; }
        [DispId()]
        IHTMLDocument2 parentDocument { get; }
        [DispId()]
        string uniqueID { get; }

        [DispId(-)]
        bool attachEvent(string @event, object pdisp);
        [DispId()]
        IHTMLDocument2 createDocumentFragment();
        [DispId()]
        IHTMLDOMNode createTextNode(string text);
        [DispId(-)]
        void detachEvent(string @event, object pdisp);
        [DispId()]
        IHTMLElement getElementById(string v);
        [DispId()]
        IHTMLElementCollection getElementsByName(string v);
        [DispId()]
        IHTMLElementCollection getElementsByTagName(string v);
        [DispId()]
        void recalc(bool fForce = false);
        [DispId()]
        void releaseCapture();
    }

IHTMLDocument3

　　在 IHTMLDocument3 中 发现的比较重要的几个方法，是 IHTMLDocument2 中没有的。

        [DispId()]
        IHTMLElement getElementById(string v);
        [DispId()]
        IHTMLElementCollection getElementsByName(string v);
        [DispId()]
        IHTMLElementCollection getElementsByTagName(string v);

　　document 有了，那 element 呢？ element 似乎有点多、一共有四个，常用的有两个、分别为：IHTMLElement、IHTMLElement2。不做过多解释。

　　如果把 element 再具体一些、像 Frame、 Form、input 等等 都有相对应的接口的，由此可以看出 mshtml 命名空间强大之处。　　

　　附一个简单应用demo，通过id获取element，然后得到按钮的显示文本。

        private void btnId_Click(object sender, EventArgs e)
        {
            if (this.document3 != null)
            {
                IHTMLElement ele = this.document3.getElementById("btnId");
                if (ele != null)
                {
                    var attri = ele.getAttribute("value") as object;
                    if (attri != null)
                    {
                        MessageBox.Show(attri.ToString());
                    }
                }
            }
        }

完整的测试项目demo： TestActiveX.zip

(暂完，如有需要后续补充)