03.页面管理器

切换你的页面

根据文档1的步骤，你可以创建多个应用页面，并由ECore统一管理，你可以使用ECore.ActivePage属性 或ECore.NewTransform方法进行切换页面。

Ecore.PageCount

类型：Long（只读属性）
获取当前注册到页面管理器的页面总数。

Ecore.PageName

类型：String（只读属性）
参数：

• Index
  类型：Integer
  说明：页面序号

说明：取得指定页面的名称。

Ecore.PageController

类型：GPage（只读属性）
参数：

• Index
  类型：Integer
  说明：页面序号

说明：取得指定页面的页面绘制控制器。

ECore.ActivePage 解说

赋值后应用页面将立即切换到指定页面。
示例：ECore.ActivePage = "TestPage"

ECore.NewTransform 参数解说

该方法既可以用作切换页面，也可以作为过渡效果使用。

参数名	类型	说明
[optional] kind	TranslationKind	将要显示的过渡效果
[optional] during	Long	过渡效果持续的时长(ms)
[optional] newPage	String	将要切换到的页面的名称，此参数被省略时则不进行页面切换。

TranslationKind 枚举

名称	值	说明
transFadeIn	0	淡入
transFadeOut	1	淡出
transToRight	2	向右飞出
transToLeft	3	向左飞出
transToUp	4	向上飞出
transToDown	5	向下飞出
transToRightFade	6	向右飞出+淡出
transToLeftFade	7	向左飞出+淡出
transToUpFade	8	向上飞出+淡出
transToDownFade	9	向下飞出+淡出
transHighLight	10	闪光
transFallDark	11	变暗
transDarkTo	12	画面变暗并平移淡出
transDarkReturn	13	画面变暗并平移淡出（反向）

分层窗口

Layered方法将使应用窗口变为分层窗口（使用前请确认你的窗口没有标题栏）。

ECore.Layered 参数说明

参数名	类型	说明
[optional] WithAero	Boolean	是否开启Win7 Aero/Win10 亚克力效果，默认为False。

ECore.IsLayered

类型：Boolean
说明：当前工程是否使用了分层窗口。

花哨模式

使你的应用看起来有些魔幻。

原理：将旧的画面按一定透明度重新粘贴在当前画面上

Ecore.FancyMode

类型：Boolean
说明：决定花哨模式是否开启。

Ecore.FancyDeepth

类型：Single
说明：花哨模式的效果深度，该数值越大，应用看起来越花哨。

冻结模式

当应用内没有过渡动画或鼠标导致的元素鼠标状态刷新时，应用将停止绘制活动，降低耗能。适用于将Emerald用于软件开发的开发者。

已知缺陷：

• 有时候需要你手动调用方法更新画面，否则应用看起来像是假死。
• 应用画面需要随时大面积变化的，冻结模式没有什么作用，反而会增大你的开发难度。

Ecore.FreezeMode

类型：Boolean
说明：决定冻结模式是否开启。

Ecore.FreezeDelay

类型：Long
说明：每次需要刷新画面时，允许给出多少时间刷新画面。（单位：毫秒）

Ecore.FreezeReset

该方法不需要任何参数。
通过调用此方法手动重置冻结状态，刷新画面。

其他

Ecore中的其他文档中未说明的方法供Emerald内部使用，不推荐使用。