BootstrapNanUI for Winform 使用示例【第一集】——山寨个代码编辑器

NanUI for
Winform从前日写博客发布到现行拿到了和多朋友的眷顾,首先感谢大家的珍爱和襄助!请看后日自我的博文《NanUI
for
Winform发表,让Winform界面设计有着无限可能
》。

有对象问到我是不是考虑开源NanUI,我想应对是肯定的。可是近年来来看NanUI内部还有一对题目并从未获取缓解,由此暂时不会绽放源代码。待那多少个题材顺利解决未来我会第一时间把NanUI的源码放到GitHub,请稍等片刻。

那么,从前些天起我会陆续放出部分NanUI使用的有些小示例和源代码供感兴趣的意中人参考把玩。任何有关NanUI的题目欢迎我们进群(群号:241088256)或留言与自身交流。

下面,起先前日的言传身教

NanUI for Winform 使用示例【第一集】

山寨个代码编辑器

Bootstrap 1

二〇一八年微软破天荒的发布了个吊炸天的开源代码编辑器VS Code,观察VS
Code的目录结构可知,其实它也是按照CEF来展开付出的,使用的是名为electron的框架。那么,下面我将用NanUI山寨一个简单的Code编辑器实现对代码文件的新建、打开和保存操作,取名为NanUI代码编辑器。

NanUI代码编辑器使用的主旨技术有:

  • Bootstrap
  • CodeMirror
  • NanUI for Winform(我通晓,那句话是废话)
  • 从离其余资源程序集加载资源

Bootstrap做响应式的页面吊炸天,虽然大家明天要拓展的小示例用不到响应式布局,不过引用进来就当CSS
Clear用呢。此外一个CodeMirror作为网页端最精锐的代码编辑器,这一次经过NanUI,我们的Winform也将分享它拉动的强有力效用。下面,我将分步讲解如何来山寨这一个代码编辑器。

在VS中新建Windows
Application项目(后边称为主项目),然后在类型->属性->调试中关闭“启动VS承载进程”选项,因为通过实践,开启该选取后无法加载嵌入的网页资源。同时,开启“启用本机代码调试选项”,因为ChromiumFX使用了PInvoke的点子调用,会有许多莫名其妙的非托管错误,例如,我事先就遭遇个假若开动项目就报错的题材,开启了本机代码调试后发现是QQ拼音输入法钩子的题目,点个忽略继续就足以健康调试了。设置好后引用NanUI的库NetDimenison.NanUI.dll

Bootstrap 2

 

再新建一个类库项目(后边称为资源类型),在里面建立文件夹www,文件夹名字没有要求,随意就好,但要强调一点,html文件不可以在类库项目的根目录下,必须树立个文件夹来放置网页文档。将bootstrap和codemirror的html、css和js文件等拷贝进www目录,当然你也足以平昔从nuget上下载它们,只是需要把nuget得到的公文都拖到www里面,形成下边的公文结构。

Bootstrap 3

剔除掉用不着的文件,从类型中消除或直接删除都行,剩下的急需用的花色都在性质窗口中把变化操作改成“嵌入的资源”。然后新建个静态类,名字随便取,里面新建个法子来显露资源类型的Assembly。

namespace NanUI.Demo.CodeEditor.Resources
{
    public static class SchemeHelper
    {
        public static System.Reflection.Assembly GetSchemeAssembley()
        {
            return System.Reflection.Assembly.GetExecutingAssembly();
        }
    }
}

新建这些类的功用是方便主项目登记资源类型里面的程序集,假如用这种艺术来注册资源文件需要在主项目中引用资源类型。其它一个办法,可以一向在主项目中间接拔取Assembly.LoadFile加载资源类型,如果项目需要平日更新的话用这一个主意可以完成时时更新资源文件而不用重新安装整个软件,具体的用法会在将来的言传身教中介绍,在此就不多说了。

诸如此类,资源类型就弄好了。接下来的干活都将在主项目上进展了。在主项目的main函数里伊始化NanUI。

namespace NanUI.Demo.CodeEditor
{
    using NetDimension.NanUI;

    static class Program
    {
        /// <summary>
        /// 应用程序的主入口点。
        /// </summary>
        [STAThread]
        static void Main()
        {
            Application.EnableVisualStyles();
            Application.SetCompatibleTextRenderingDefault(false);
            UIStartupManager.UseSharedFramework = true;
            if (UIStartupManager.InitializeChromium())
            {
                //初始化成功,加载程序集内嵌的资源到运行时中
                UIStartupManager.RegisterEmbeddedScheme(Resources.SchemeHelper.GetSchemeAssembley());



                //启动主窗体
                Application.Run(new EditorForm());
            }


        }
    }
}

里头,Resources.SchemeHelper.GetSchemeAssembley()方法就是从资源类型里面把Assembly加载过来。之后新建编辑器的主窗体EditorForm。EditorForm除了简单的安装外,需另外添加多少个法子来决定文件的新建、打开、保存等操作。

namespace NanUI.Demo.CodeEditor
{
    using NetDimension.NanUI;

    public partial class EditorForm : HtmlUIForm
    {

        internal bool isClean = true;
        internal bool isNew = true;

        internal string currentFilePath = string.Empty;


        public EditorForm()
            : base("embedded://www/main.html")
        {
            InitializeComponent();

            UI.GlobalObject.Add("hostEditor", new JsCodeEditorObject(this));
        }

        void SetEditorMode()
        {
            if (!string.IsNullOrEmpty(currentFilePath))
            {
                var fileInfo = new System.IO.FileInfo(currentFilePath);

                var ext = fileInfo.Extension;

                if (ext.IndexOf('.') == 0)
                {
                    ext = ext.Substring(1);
                    UI.ExecuteJavascript($"CodeEditor.changeCodeScheme('{ext}');");
                }
            }
        }

        //设置编辑器标题逻辑
        void SetEditorTitle()
        {
            if (isNew || string.IsNullOrEmpty(currentFilePath))
            {
                UI.ExecuteJavascript($"CodeEditor.setTitle('新建');");
            }
            else
            {
                var fileInfo = new System.IO.FileInfo(currentFilePath);
                UI.ExecuteJavascript($"CodeEditor.setTitle('{fileInfo.Name}');");
            }
        }
        //保存文件逻辑
        internal bool SaveFile()
        {
            var result = false;
            UI.EvaluateJavascript(@"CodeEditor.getContent()", (value, ex) =>
            {
                if (ex == null)
                {
                    var content = value.IsString ? value.StringValue : null;

                    if (content != null)
                    {

                        if (isNew)
                        {
                            var saveFileDialog = new SaveFileDialog()
                            {
                                AddExtension = true,
                                Filter = "支持的文件|*.txt;*.js;*.cs;*.html;*.htm;*.css;*.h;*.cpp;*.php;*.xml;*.vb",
                                OverwritePrompt = true
                            };
                            if (saveFileDialog.ShowDialog(this) == DialogResult.OK)
                            {
                                currentFilePath = saveFileDialog.FileName;
                                result = true;

                            }
                        }

                        if (result)
                        {
                            System.IO.File.WriteAllText(currentFilePath, content, Encoding.UTF8);
                            isClean = true;
                            SetEditorMode();
                            SetEditorTitle();
                        }



                    }
                }
            });

            return result;
        }
        //新建文件逻辑
        internal void NewFile()
        {
            var continueFlag = true;

            if (!isClean)
            {
                var ret = MessageBox.Show(this, "文件已经更改,是否保存下先?", "提示", MessageBoxButtons.YesNoCancel, MessageBoxIcon.Question);

                if (ret == DialogResult.Yes)
                {
                    if (!SaveFile())
                    {
                        continueFlag = false;
                    }
                }
                else if (ret == DialogResult.Cancel)
                {
                    return;
                }
            }

            if (!continueFlag)
            {
                return;
            }

            isNew = true;
            isClean = true;


            UI.ExecuteJavascript(@"CodeEditor.setNew()");
            SetEditorTitle();



        }
        //打开文件逻辑
        internal string OpenFile()
        {
            var continueFlag = true;

            if (!isClean)
            {
                var ret = MessageBox.Show(this, "文件已经更改,是否保存下先?", "提示", MessageBoxButtons.YesNoCancel, MessageBoxIcon.Question);

                if (ret == DialogResult.Yes)
                {
                    if (!SaveFile())
                    {
                        continueFlag = false;
                    }
                }
                else if (ret == DialogResult.Cancel)
                {
                    return null;
                }
            }

            if (!continueFlag)
            {
                return null;
            }

            var content = string.Empty;

            var openDialog = new OpenFileDialog()
            {
                AddExtension = true,
                Filter = "支持的文件|*.txt;*.js;*.cs;*.html;*.htm;*.css;*.h;*.cpp;*.php;*.xml;*.vb"
            };

            if (openDialog.ShowDialog() == DialogResult.OK)
            {
                currentFilePath = openDialog.FileName;

                var fileInfo = new System.IO.FileInfo(currentFilePath);

                content = System.IO.File.ReadAllText(fileInfo.FullName);

                isNew = false;

                SetEditorMode();
                SetEditorTitle();
            }
            else
            {
                content = null;
            }

            return content;
        }
    }
}

 

下边重点来了,以下内容将涉及C#操作网页内JS代码以及JS调用C#的方法等等,大旨就是中间对象JsCodeEditorObject。该对象继承自ChromiumFX的JSObject对象,对JS有了解的朋友不会对JS的Object对象感到陌生,这里的JSObject对象和JS的Object对象实际很一般,也是包含了数码和措施的一个集结。如下所示,在内部注册了六个Function,这个Function都是可以被网页端js调用的。

namespace NanUI.Demo.CodeEditor
{
    using Chromium.Remote;
    using NetDimension.NanUI;

    class JsCodeEditorObject : JSObject
    {

        EditorForm parentForm;

        internal JsCodeEditorObject(EditorForm parentForm)
        {
            this.parentForm = parentForm;

            AddFunction("newFile").Execute += JsCodeEditorObject_ExecuteNew;

            AddFunction("openFile").Execute += JsCodeEditorObject_ExecuteOpen;

            AddFunction("saveFile").Execute += JsCodeEditorObject_ExecuteSave;

            AddFunction("setClean").Execute += JsCodeEditorObject_ExecuteSetClean;
        }





        private void JsCodeEditorObject_ExecuteSetClean(object sender, Chromium.Remote.Event.CfrV8HandlerExecuteEventArgs e)
        {
            if (e.Arguments.Length > 0)
            {

                parentForm.isClean = e.Arguments.First(p => p.IsBool).BoolValue;
            }
        }

        private void JsCodeEditorObject_ExecuteSave(object sender, Chromium.Remote.Event.CfrV8HandlerExecuteEventArgs e)
        {
            var result  = parentForm.SaveFile();

            e.SetReturnValue(CfrV8Value.CreateBool(result));

        }

        private void JsCodeEditorObject_ExecuteOpen(object sender, Chromium.Remote.Event.CfrV8HandlerExecuteEventArgs e)
        {
            var result = parentForm.OpenFile();

            if (result != null)
            {
                e.SetReturnValue(CfrV8Value.CreateString(result));

            }
            else
            {
                e.SetReturnValue(CfrV8Value.CreateNull());
            }
        }

        private void JsCodeEditorObject_ExecuteNew(object sender, Chromium.Remote.Event.CfrV8HandlerExecuteEventArgs e)
        {
            parentForm.NewFile();
        }
    }
}

如下面代码中所显示的,这一个类注册了newFile, openFile,
saveFile和setClean多少个点子供网页端js调用。再折回去地点EditorForm的代码,有这样一行:

UI.GlobalObject.Add("hostEditor", new JsCodeEditorObject(this));

那行代码的左右就是将大家的中游对象JsCodeEditorObject实例化后传到浏览器的JS环境中,并且取了个新名字叫做“hostEditor”,这样,我们就可知在网页环境中用js执行下边的多少个点子了。

  • hostEditor.newFile
  • hostEditor.openFile
  • hostEditor.saveFile
  • hostEditor.setClean

当网页端js调用位置这么些措施的时候其实会举行到EditorForm中相应的操作逻辑,如此就兑现了js与c#环境的相互。C#与js环境相互与之相比较要简明得多,例如EdiorForm中的SetEditorTitle方法中,通过UI.ExecuteJavascript方法就足以实施web环境中的js代码或形式。

UI.ExecuteJavascript($"CodeEditor.setTitle('新建');");

如上这行代码,调用了js的法门CodeEditor.setTitle来设置编辑器的题目。那么,假若需要举办js代码并再次来到相应代码,就得利用UI.伊娃(Eva)luateJavascript方法。该格局第一个参数为js代码,第二个参数为实践js代码后的回调,它是一个有五个参数的action对象,第一个参数为回调的再次来到值,第二个参数是exception对象,要是js代码有问题,那么第二个对象exception就带有了错误音信,正确履行时,excepiton对象回来null。

UI.EvaluateJavascript(@"CodeEditor.getContent()", (value, ex) =>
{
    if (ex == null)
    {
        var content = value.IsString ? value.StringValue : null; //value对象是CfrV8Value对象,内置了各种数据转换的方法。

        //其他逻辑
    }
});

 

有了地点的代码要点,大家应该已经清楚C#和JS之间的相互情势和JS于C#里面的相互的艺术了。简单来讲,C#与NanUI的js交互,无再次回到值的用UI.ExecuteJavascript方法,有再次来到值的用UI.伊娃(Eva)luateJavascript。除了这六个点子外,可以用UI.AddFunction方法来直接在js环境中注册C#的法门,方法大家自行钻研在此不再演讲。假诺js需要与C#以内的互相,通过编制继承JSObject的中档对象注册形式或数量对象,即可实现。

这就是说,NanUI的演示第一集就这样讲完了,假诺不精晓请留言给自家或进群(群号:241088256)交换,感谢大家关心。

 


NanUI for .NET Winform系列目录


经过了这多少个多星期的调整与修复,NanUI for .NET
Winform的稳定版已经公布。应广泛群友的渴求,现已将NanUI的满贯代码开源。

GitHub: https://github.com/NetDimension/NanUI

Release: https://github.com/NetDimension/NanUI/releases


 

 假若您欣赏NanUI项目,你可以参预到NanUI的付出中来,当然你也能够更直接了当的支撑自己的劳作,使用支付宝或微信扫描下面二维码请我喝一杯热腾腾的咖啡。

Bootstrap 4

支付宝转账

Bootstrap 5

微信转发


 

其余,打个广告,承接NanUI界面设计与接口开发(收费)。

案例展现

某聊天应用

Bootstrap 6

某商店里面办公室系统

Bootstrap 7

Bootstrap 8

相关文章