使用WMFL实现可配置Windows窗体

原创 2004年07月22日 09:41:00
 

使用WMFL实现可配置Windows窗体

 

         作者: Joe Stegman

翻译:秋枫

原文出处:http://windowsforms.net/articles/wfml.aspx

文章原名: Using the Windows Forms XML Parser Sample

代码下载:下载

Introduction

这里介绍的是个带有可以扩展机制的例子,通过添加一个标记模型来实现。我们把里面的解析规则可以概述为“XML 元素映射到.NET Framework 类型 XML 中的属性映射到类型的属性、方法(或者事件)”。这个例子包含一个markup parser通过解析XML文件来动态的产生一个对象的实例树。对于标记的格式包括下面的结构:

1.   XML 命名空间 .NET Framework 命名空间的映射

2.   对象实例化名称

3.   对象验证及引用

4.   属性设置

5.   实例和静态方法

6.   事件委托

7.   组件引用

 

Disclaimer

这个例子中使用的技术不是下一版本Windows Forms的一部分。另外,这里的例子是针对.NET Framework version 1.1的,至于其他版本没有测试过。

Basic Sample

下面的例子显示了一个XML的语法用来声明或定义一个包含了Label的简单窗体。

xml version="1.0" encoding="utf-8" ?>

mapping xmlns="http://www.microsoft.com/2003/WindowsForms"

          namespace="System.Windows.Forms;System.Drawing"?>

<wfml xmlns="http://www.microsoft.com/2003/WindowsForms"

      xmlns:wfml="http://www.microsoft.com/2003/WFML"> 

  <Form wfml:root="true" Text="Basic Sample" Size="300,200">

    <Label Text="Hello World" AutoSize="True" Location="10, 20"/>

    <method.Show/>

  Form>

wfml>

WMFL解析器根据上面的XML文件来动态的生成一个窗体。这里假设上面的XML文件内容包含在“basic.xml”文件中。

MarkupParser parser = new MarkupParser();

object form = parser.Parse("basic.xml");

下面是动态生成的窗体:


Dissecting the Basic Sample

根据Xml文档中的定义,解析器进行了精确的处理,一个根标签,实体声明和一个结束标签。下面是对各部分的描述。

XML Declaration

xml version="1.0" encoding="utf-8" ?>

这行定义了XML针对这个例子的默认命名空间同时定义了元素和属性的前缀。

Instance Declarations

<Form wfml:root="true" Text="Basic Sample" Size="300,200">

    <Label Text="Hello World" AutoSize="True" Location="10,20"/>

    <method.Show/>

  Form>

当处理xml的时候,解析器将通过默认构造函数创建一个窗体的实例,同时设置Text属性为“Basic Sample,Size属性为“300200”。解析器还创建了一个Label实例添加到窗体的Controls集合,同时设置了LabelText属性为“Hello World”,设置他的AutoSize属性为“True”,Location属性为“10,20”。最后,解析器还调用了Show方法来显示窗体的实例。

XML Namespace to .NET Framework Mappings

解析器通过

标签来创建System.Windows.Forms.Form类的一个实例。.NET Framework 1.1版本至少包含两个不同的“Form”类型:一个是在System.Windows.Forms命名空间,另一个是在System.Web.UI.MobileControls。解析器通过Xml文件中的命名空间映射来选择需要创建的实例的命名空间,在这个例子中,元素使用默认的命名空间。而这里默认的为http://www.microsoft.com/2003/WindowsForms:

<wfml xmlns="http://www.microsoft.com/2003/WindowsForms" …

这里的映射就是指示Xml namespaceSystem.Windows.Forms .NET Framework 命名空间:

mapping xmlns="http://www.microsoft.com/2003/WindowsForms"

          namespace="System.Windows.Forms;System.Drawing"?>

解析器通过这个映射来选择Form的类型命名空间为System.Windows.Forms而不是System.Web.UI.MobileControls”.

Collection Heuristics

当解析器遇到元素的子元素时,就会根据上面定义的映射规则来生成相对应的类的实例加入到父控件的一个容器(如果父控件是一个容器,就直接添加)。在默认的情况下,解析器寻找一个“Controls”集合但是也可以把子控件通过“.”符号加载到的不同的集合。

<MenuItem Text="New" >

  <property.MenuItems>

    <MenuItem Text="Window" Shortcut="CtrlN" />

    <MenuItem Text="-" />

    <MenuItem Text="Message" />

    <MenuItem Text="Post" />

    <MenuItem Text="Contact" />

    <MenuItem Text="Internet Call" />

  property.MenuItems>

MenuItem>

在上面的例子中,那些子菜单被明确的加入到父一级的MenuItem的“MenuItems”集合中。对于“property.PropertyName”符号在下面的Markup reference一节中会有更多的详细说明。

 

Markup Reference

这个简单的解析器使用一些的属性,元素和一些其他符号指令来处理转换。那些属性和元素在http://www.microsoft.com/2003/WFML命名空间下,同时使用“wfml”作为前缀。

wfml:ID Attribute

这个ID属性用来唯一表示元素的实例。另外,解析器还提供一个API通过ID来查询一个实例,在下面的例子中,Form元素被给了“form1”。

xml version="1.0" encoding="utf-8" ?>

mapping xmlns="http://www.microsoft.com/2003/WindowsForms"

          namespace="System.Windows.Forms;System.Drawing"?>

<wfml xmlns="http://www.microsoft.com/2003/WindowsForms"

      xmlns:wfml="http://www.microsoft.com/2003/WFML"> 

  <Form wfml:ID="form1" Text="Basic Sample" Size="300,200">

   <Label Text="Hello World" AutoSize="True" Location="10, 20"/>

    <method.Show/>

  Form>

wfml>

解析器能通过“Find”方法来重新获取“form1”实例。

MarkupParser parser = new MarkupParser();

Parser.Parse(“basic.xml”);

Form form1 =(Form)parser.Find(“form1”);

wfml:root Attribute

root属性标识由解析器的“Parser”方法生成的实例。整个Xml只能有一个元素使用root属性。下面的例子中“form1元素包含了“root”属性。

xml version="1.0" encoding="utf-8" ?>

mapping xmlns="http://www.microsoft.com/2003/WindowsForms"

          namespace="System.Windows.Forms;System.Drawing"?>

<wfml xmlns="http://www.microsoft.com/2003/WindowsForms"

      xmlns:wfml="http://www.microsoft.com/2003/WFML"> 

  <Form wfml:ID="form1" wfml:root="true" Text="Basic Sample" Size="300,200">

    <Label Text="Hello World" AutoSize="True" Location="10, 20"/>

    <method.Show/>

  Form>

wfml>

下面是“Parse”方法返回一个“form1”实例:

MarkupParser parser = new Markupparser();

Form form1 = (Form)parser.Parse(“basic.xml”);

wfml:argument Attribute

当实例化类型的时侯,解析器使用类型的默认构造函数。但是有些类型没有默认的构造函数,比如Bitmap

Argument属性专门为没有默认构造函数的类型传递一个参数。下面的例子就是为Bitmap的构造函数传递一个“c:/image.jpg”参数。

<Form wfml:root="true" wfml:ID="form1" Name="Form1" Text="Set Background"> 

  <property.BackgroundImage>

    <Bitmap wfml:argument="C://image.jpg"/>

  property.BackgroundImage>

  <method.Show/>

Form>

注意这里如果是使用带多个参数的构造函数是不可能的。

property Element

解析器的通常规则是xml元素映射到类型而xml属性映射到类型的属性。

<Element Attribute="string value"/>

解析器能通过TypeConverters(System.ComponentModel.TypeConverter)来有效的处理字符串到非字符串属性的转换。举例Form类的BackColor属性是“System.Drawing.Color”类型的,但是可以使用下面的设置:

<Form BackColor="Green"/>

在上面的例子中,BackColor属性是通过一个TypeConverter来把“Green”字符串转换成“System.Drawing.Color”得到的。在一般情况下TypeCoverter模块可以很正常的工作,但是在处理复杂的属性类型时(比如Image)不会提供一个很好的结果。解析器通过使用一个“.”属性符号来处理更多复杂属性的设置,下面使用就是设置窗体的BackgroundImage

<Form wfml:root="true" wfml:ID="form1" Name="Form1" Text="Set Background"> 

  <property.BackgroundImage>

    <Bitmap wfml:argument="C://image.jpg"/>

  property.BackgroundImage>

  <method.Show/>

Form>

在上面的例子中,把Bitmap实例作为窗体的BackgroundImage设置。

method Element

类似于上面的“.”属性符号,解析支持“.”方法符号。当解析器发现一个元素带有“method.methodName”,他将会在父元素实例中调用“methodName”方法。下面就会在“form1”实例中调用“Show”方法。

<Form wfml:root="true" wfml:ID="form1" Name="Form1" Text="Set Background"> 

  <property.BackgroundImage>

    <Bitmap wfml:argument="C://image.jpg"/>

  property.BackgroundImage>

  <method.Show/>

Form>

解析器能调用实例或静态函数,但是不能调用含有多个参数的方法。下面的例子是调用带有一个参数的静态方法:

<Form wfml:root="true" wfml:ID="form1" Name="Form1" Text="Set Background"> 

  <property.BackgroundImage>

    <method.FromFile Static="System.Drawing.Image">

      C://image.jpg

    method.FromFile>

  property.BackgroundImage>

  <method.Show/>

Form>

上面调用静态方法“System.Drawing.Image.FromFile”,参数为“c:/image.jpg”。窗体的的BackgroundImage属性值为静态方法的返回值。

wfml:var Element

解析器对创建引用类型的变量提供了有限的支持。任何属性使用wfml:ID 属性能被解析为引用类型。如下:

<Form wfml:ID="form1" Name="Form1" Text="Simple"/>

<wfml:var Name="form1">

  <method.Show/>

wfml:var>

在上面的例子中,“wfml:var”元素引用“form1”参数也就是窗体,“Show”方法在“form1”的实例中被调用。

Variable Prefix

以“$”开始的属性值被处理为是引用参数。

<wfml:var wfml:ID="image">

 <method.FromFile Static="System.Drawing.Image">C://image.jpgmethod.FromFile>

wfml:var>

<Form BackgroundImage="$image" Name="Form1" Text="Set Background"> 

  <method.Show/>

Form>

Mapping Processing Instruction

通常的使用语法是:

mapping xmlns="XMLNamespace" namespace=".NET Namespaces"?>

.NET Framework命名空间属性可以包含一个或多个用“;”隔开的列表。

mapping xmlns="MyNamespace" namespace="System.Windows.Forms;System.Drawing"?>

在实例化类型的时侯,解析器将会映射Xml元素中指定的“xmlns”到.NET Framework类型。

Assembly Processing Instruction

对于“assembly”的处理指令是通过添加装配件引用。

assembly name="system.data" version="1.0.5000.0" culture="neutral" PublicKeyToken="b77a5c561934e089"?>

Markup Parser Reference

解析器根据Xml文件动态的生成一个实例树,而他的API描述如下:

Parse 方法使用一个字符串参数或者一个TextReader作为参数。该方法返回的一个实例是文档里那个包含了“wfml:root”的属性的元素的ID值,或者就是第一个元素。

AddVariable Method

下面的例子将产生一个窗体同时包装窗体的Load事件:

<Form wfml:root="true" Load="me.FormLoadHandler" Text="Load Sample"/> 

解析器会认出“Load”是一个事件并寻找一个“me”的变量同时把窗体的Load事件用“me’s”的FormLoadHandler委托来包装。

private void button1_Click(object sender, System.EventArgs e)

{

  MarkupParser  parser = new MarkupParser();

  // Add "this"

  parser.AddVariable("me", this);

  // Parse

  object    obj = parser.Parse("sample.xml");

}

 

private void FormLoadHandler(object sender, EventArgs e)

{

  MessageBox.Show("Form Load");

}

Find Method

Find方法被用来从变量上下文中重新获得一个实例(wfml:ID)。举例,下面的例子定义了一个“form1窗体,里面包含了一个“button1按钮:

<Form wfml:root="true" wfml:ID="form1" Text="Find Sample"> 

  <Button wfml:ID="button1"/>

Form>

通过Find方法能够重新得到“button1”的实例:

private void button1_Click(object sender, System.EventArgs e)

{

  MarkupParser  parser = new MarkupParser();

  // Parse (returns form1)

  object    obj = parser.Parse("sample.xml");

  // Get button1 instance

  Button    button1 = parser.Find("button1") as Button;

}

Reset Method

解析器的变量上下文(变量列表)是跨多个解析器实例共享的(静态列表)。

Reset方法就是用来清空这个共享变量列表。

Status Event

解析器的状态事件提供每一行的解析信息。注意这个事件只有在调试场景下才有用。

Windows编程特点

一个完整的Windows应用程序除了WinMain函数外,还包含用于处理用户动作和窗口消息的窗口函数。这不同于一个C++控制台应用程序,可以将整个程序包含在main函数中。当然,他们的区别还远不止这些...
  • shufac
  • shufac
  • 2014年06月24日 23:20
  • 1496

使用C#开发数据库应用系统_初识Windows程序

第1章 初识Windows程序 一.第一个Windows程序 1.创建Windows程序 不需要一行代码,就能够运行出一个窗体,这得益于Visual Studio和.NET Framework的...
  • hacker_A
  • hacker_A
  • 2017年11月06日 22:24
  • 219

Windows隐含窗体的实现及使用

1.Windows消息机制之PostMessage 在Windows环境下,我们无法绕开Windows消息机制的话题。 对于Windows消息机制的使用,我们用得较多的是PostMessage,该...
  • psy361212
  • psy361212
  • 2014年07月20日 16:52
  • 201

C#开发Windows窗体应用程序的步骤

使用C#开发应用程序时,一般包括创建项目、界面设计、设置属性、编写程序代码、保存项目、程序运行等6个步骤。 1.创建项目 在Visual Studio2017开发环境中选择“文件”→“新建”→“项...
  • JAVAbccd
  • JAVAbccd
  • 2017年12月11日 17:59
  • 303

Windows服务调用Quartz.net 实现消息调度

Windows服务调用Quartz.net 实现消息调度 作者:cnblogs.com  来源:cnblogs.com  发布日期:2014-09-17 Quartz.NET是一个开源的作...
  • lenovouser
  • lenovouser
  • 2015年05月27日 16:14
  • 2795

VC++ 2010下的MFC应用程序与Windows窗体应用程序的区别

VC++ 2010下的MFC应用程序与Windows窗体应用程序的区别 (2013-07-02 03:01:47)   分类:IT业界声音·观点 2010下...
  • hutao1101175783
  • hutao1101175783
  • 2014年06月13日 16:00
  • 2711

C#Windows窗体组成基本思路和控件使用

创建C#窗体时会产生一个主窗体(假设为Form1)此窗体被默认为程序的启动窗体, C#Windows程序有一个主程序,此主程序会加载创建的窗体Form1,而Form1窗体 的控件设计例如样式、位置和本...
  • riyuedangkong1
  • riyuedangkong1
  • 2016年09月16日 11:01
  • 883

Windows 窗体入门(VS2010 )

Windows 窗体入门 Visual Studio 2010 其他版本 .NET Framework 4.5 .NET Framework 3.0 .N...
  • ericwuhk
  • ericwuhk
  • 2014年01月07日 17:51
  • 1052

C#编写Windows应用程序的一般过程

利用Visual C#编制Windows应用程序的过程可归结成以下几个步骤:  (1)利用窗体设计器和【Windows窗体】控件组中的控件设计应用程序界面。 (2)设计窗口和控件的属性。 (3)编写事...
  • basycia
  • basycia
  • 2016年01月02日 10:17
  • 1836

Windows窗体与控件

学习下Window的窗体与控件,UI,我的IDE是VS2012,通过学习这些基本控件,如果以后要用到别的控件,就能够较快上手。 Windows窗体窗体是应用程序的基本单元,是非常重要的。它实质上是一块...
  • im_zhq
  • im_zhq
  • 2016年05月11日 11:20
  • 3615
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:使用WMFL实现可配置Windows窗体
举报原因:
原因补充:

(最多只允许输入30个字)