##language:zh
'''wxEasyWizard  -- wx易向导'''
::-- limodou [<<DateTime(2005-07-23T08:30:16Z)>>]
<<TableOfContents>>

= EasyWizard项目 =
== 概述 ==
EasyWizard的作用就是帮助你使用 wxPython 来方便地生成Wizard界面，那么它附属的一些类你就可以使用了，象EasyDialog之类的。

== 背景 ==
为什么要搞这个东西，原因有几点：

 * 将要用在我的项目中
 * 可以加快GUI的Dialog的开发，特别是我将用它与 Meteor (流星我的另一个项目，是一个模板系统)相结合，最终可以方便地进行模板处理乃至代码框架的生成。
 * 更详细地背景说明请参见我的Blog[[http://blog.donews.com/limodou/archive/2005/07/23/477792.aspx|EasyWizard项目预览]]

== 下载 ==
 * [[attachment:EasyWizard-0.1.tar.gz]] 目录还是测试版，有兴趣可以用一用。

== 更新说明 ==

 * 2005/08/07 增加打开文件，保存文件，目录，时间，日期，多选的输入类型。支持Notebook类型窗口。
 * 2005/08/01 上传新的测试版本，修改EasyCommander.py，增加对obj2ini的支持，增加TemplateScript的测试程序，可以生成S5格式文档。

== 功能介绍 ==
下面我简单地介绍一下EasyWizard的功能，因为现在没有文档，甚至程序注释都很少。

 * 以一个字典的方式生成一个Wizard页面的配置信息
 * 根据这个配置信息可以一次生成多页的Wizard
 * 现在支持的配置项数据类型有：

   * int 整数(IntCtrl或SpinCtrl)
   * string 文本(TextCtrl)
   * lines 多行文本(TextCtrl)
   * float 浮点数(EasyFloat)
   * bool 布尔(CheckBox)
   * choice 选择(ComboBox)
   * static静态文本(StaticText)
   * list列表(ListView)

     list是一个特殊配置项，它还可以支持如上的配置项包括list，因此可以定义多层(我只试过２层)这样可以生成分级型式的数据。这样与 Meteor 中的数据循环就对应的。
   * list控制本身提供增加、删除、修改的功能。
   * 提供一个命令行工具(EasyAdmin.py)，可以对你写出的Wizard直接运行，可以看效果
   * 生成的结果按照分级的情况为一个字典

以后还会增加其它一些输入控制项，如：密码、目录、文件等，反正想到什么就加什么。也许以后还会增加一些其它的更方便的界面生成类，如：列表等。


== 安装说明 ==
EasyWizard使用了最新的 SetupTools工具。如果你没有安装，没有关系。下载完EasyWizard的安装包后，解压到一个目录下，然后直接运行：
{{{python setup.py install}}}
这样，安装程序会自动判断你是否安装了SetupTools，如果没有安装或版本不对，则安装程序会自动下载这个工具。

EasyWizard在安装后会将EasyAdmin.py安装到python的Scripts目录下。这样你就可以在命令行上直接运行EasyAdmin.py了。

== 测试 ==
安装后就可以测试一下。在源码包目录下，进入EasyGui/test目录，然后在命令行下敲入：
{{{EasyAdmin.py testTmp.py}}}
即可。
== 截图 ==
这是测试用的配置信息
{{{#!python
#coding=cp936
page1_elements = [
    ('int', 'numbername', '0', u'数字测试', None),
    ('bool', 'checkname', '0', u'检查框测试', None),
    ('choice', 'choicename', 'Y', u'选择测试', [(u'是', 'Y'), (u'否', 'N')]),
    ('string', 'textname', u'这是一个简单文本', u'简单文本测试', None),
    ('lines', 'multitextname', u'这是一个多行文本', u'多行文本测试', None),
    ('static', 'statictextname', u'这是一个静态文本', u'静态文本测试', None),
    ('float', 'floatname', 12.3, u'浮点数测试', None),
    ]

page2_elements = [
    ('int', 'number', '0', u'数字测试', None),
    ('bool', 'check', '0', u'检查框测试', None),
    ('choice', 'choice', 'Y', u'选择测试', {u'是':'Y', u'否':'N'}),
    ('string', 'text', u'这是一个简单文本', u'简单文本测试', None),
    ('list', 'list', [{'name':'limodou', 'age':31, 'sublist':[]}, 
        {'name':'zoomquiet', 'age':31, 'sublist':[]}], u'这是一个列表测试', {
        'columns':[('name', 60, 'left'), ('age', 40, 'right'), ('sublist', 50, 'center')],
        'elements':[
            ('string', 'name', 'name', u'姓名', None),
            ('int', 'age', 0, u'年龄', None),
            ('list', 'sublist', [], u'这是子列表测试', {
                'columns':[('X', 60, 'left'), ('Y', 40, 'right'), ('Z', 50, 'center')],
                'elements':[
                    ('string', 'x', 'x', u'X', None),
                    ('choice', 'y', 'A', u'Y', ['A', 'B', 'C']),
                    ('bool', 'z', False, u'Z', None),
                ]
            }),
        ]
    }),
    ]
bitmap = 'logo.jpg'
pagesinfo = [
{'title':u'第一页', 'description':u'第一页描述信息', 'elements':page1_elements},
{'title':u'第二页', 'description':u'第二页描述信息', 'elements':page2_elements, 'bitmap':'logo.png'},
]

}}}
截图：


{{attachment:EasyWizard02.jpg}}

(命令行下运行)

{{attachment:EasyWizard03.jpg}}

(第一个页面)

{{attachment:EasyWizard04.jpg}}

(第二个页面，背景图变了)

{{attachment:EasyWizard01.jpg}}

(list项的增加对话框，其中又有一个list)

= 反馈 =
<<Include(/Discuss)>>