Ligg.EasyWinApp-102-Ligg.EasyWinForm:Function--ControlBox、Tray、Resize、Menu
阅读原文时间:2023年07月11日阅读:1

首先请在VS里打开下面的文件,我们将对源码分段进行说明:

Function(功能):一个应用的功能界面,一个应用对应多个Function(功能);如某应用可分为管理员界面、用户界面。

*首先我们来看一下继承关系*

public partial class StartForm : FunctionForm

public partial class FunctionForm : FrameForm

StartForm是继承FunctionForm的,FunctionForm是继承FrameForm的。对UI操作大部分在FunctionForm上完成。

LoadForm方法里读取FunctionFormStyle

对于MultipleView从 .\Applications\xxxx(Apllication)\Clients\Form\Functions\yyyy(Function)\ FunctionFormStyle.xml读取FunctionFormStyle至_functionFormStyle。FunctionFormStyle 的各属性如下:

对于SingleView

从 .\Applications\xxxx(Apllication)\Clients\Form\Functions\yyyy(Function)\ Form\Zones\zzzz(Zone)\ Feature.xml读取FunctionFormStyle至_functionFormStyle

InitLayout方法

首先是确定Form的Text, 如果传参里包含了Text,就使用传参的,如果没有,就采用缺省的:就去里根据Function或Zone的Name去从 .\Applications\xxxx(Apllication)\abbrevAnnexes.xml读取。

然后确定ControlBox

然后确定Form的WindowState

然后确定Form的尺寸

然后确定Form的Icon

然后确定Form的Tray,是否把关闭按钮当作最小化按钮

下面的代码是在弹出一个Dialog时,让Dialog出现在中间靠上的位置

请至https://github.com/Liggin2019/Ligg.EasyWinApp/blob/master/demo/demo.rar下载,运行Form-MutiView-ITSmaoa-AdmKt0-CustMenu-AssignedTitle相关执行文件,查看Text由外部传参的配置。

Tray读取和显示(InitTray方法)

首先读取Tray的定义文件和Icon;对Multiple View在对于MultipleView从 .\Applications\xxxx(Apllication)\Clients\Form\Functions\yyyy(Function)\ TrayMenuItems.xml读取;对于SingleView

从 .\Applications\xxxx(Apllication)\Form\Functions\yyyy(Function)\Clients\ Form\Zones\zzzz(Zone)\ TrayMenuItems.xml读取

请至https://github.com/Liggin2019/Ligg.EasyWinApp/blob/master/demo/demo.rar下载,运行Form-MutiView-ITSmaoa-AdmKt1-CustMenu-Tray相关执行文件,查看带Trayform的配置

ResizeRegion方法****

FrameForm顾名思义是Form的框架,它首先横向切了5刀,把Form分为6个Section,如下:

MainMenuSection(Dock: Top)

ToolBarSection(Dock: Top)

ShortcutSection(Dock: Top)

NavigationSection(Dock: Top)

MainSection(Dock: Top)

RunningMessageSection(Dock: Down)

然后在每个Section上从左到右在切几刀,划分为不同的Region(Dock: Left或Right)。如下图:

以下代码初始化每个Section和Region是否显示,及其尺寸

例如:在https://github.com/Liggin2019/Ligg.EasyWinApp/blob/master/demo/demo.rar

_functionFormStyle.ResizeRegionParams=

”MainMenu:0;ToolBarSection:64,600,370;NavigationSection:0;ShortcutSection:0;MainSectionLeftNavDivision:0,0,0;MainSectionRightNavDivision:145,175,145;MainSectionMainDivision:130,0;MainSectionRightDivision:230,34,0;RunningMessageSection:0;RunningStatusSection:26,0;HorResizableDivisionStatus:none”

Menu的读取和显示

menu只在MutilpleView的情况下存在,有2种类型:

缺省(Simple)采用Winform自带的ToolStripMenuItem控件;另一种(Customized)是本框架在揣摩 SAP GUI和SEP客户端后独创一种以用View(视图)实现多窗体(MDI)的效果的菜单形式。

然后根据FunctionFormStyle.xml里的配置,决定采用哪一种菜单。

以下代码是在LoadForm方法里确定采用哪一种菜单类型:

以下代码是从配置文件.\Applications\xxxx(Apllication)\Clients\Form\Functions\yyyy(Function)\ MenuItems.xml读取菜单数据到_layoutElements

菜单配置文件里的元素包含以下类型:

  • ViewMenuItem点击时会触发ViewMenuItemClickHandler,显示当前View,并隐藏前一个View。
  • DisplayAndTransactionItem是会显示和带Action的菜单项,当点击时会触发ControlEventHandler并执行一个Act方法。
  • TransactionOnlyItem不显示,只会被DisplayAndTransactionItem调用。
  • DisplayOnlyItem只显示的菜单项,如分隔条。
  • ViewMenuArea是一个Panel,是上述类型的容器,可以包含ViewMenuItem、DisplayAndTransactionItem、DisplayOnlyItem菜单项。
  • ToolMenuArea是一个Panel,是上述类型的容器,可以包含DisplayAndTransactionItem、DisplayOnlyItem菜单项。

见以下示例:

ViewMenuArea包含的菜单项(Customized Menu)

ToolMenuArea包含的菜单项(Customized Menu)

ViewMenuArea包含的菜单项(Simple Menu)

ToolMenuArea包含的菜单项(Simple Menu)

以下代码确定当前显示的View,分几种情况:一种是RereshUi后重显(如登录后重显),一种是传参,一种是缺省(在配置文件MenuItems.xml里定义)

下面的代码就是分2种类型Render菜单,请大家自行阅读代码

请至https://github.com/Liggin2019/Ligg.EasyWinApp/blob/master/demo/demo.rar

下载,运行Form-MutiView-ITSmaoa-AdmKt1-CustMenu Form-MutiView-ITSmaoa-AdmKt4-SimpMenu相关执行文件,查看2种不同菜单情况下的form的配置

点击ViewMenuItem显示和隐藏View、以及View下各个Zone的排列和传参,请看下一章节文档。

LiggEasyWinApp-103-Ligg.EasyWinFormView

手机扫一扫

移动阅读更方便

阿里云服务器
腾讯云服务器
七牛云服务器

你可能感兴趣的文章