设置 屏幕 (Screen) 节点

Kanzi 应用程序中的屏幕 (Screen) 节点描述显示 Kanzi 应用程序所用的目标设备屏幕的指标和内容。您可以：

• 设置应用程序的 屏幕 (Screen) 尺寸，以便固定其尺寸或动态调整其尺寸。请参阅设置屏幕 (Screen) 节点的大小。
• 设置屏幕 (Screen) 节点之外的区域的颜色。请参阅设置屏幕 (Screen) 节点之外的区域的颜色。
• 使您的应用程序填充整个设备屏幕。请参阅使应用程序填充整个设备屏幕。

设置屏幕 (Screen) 节点的大小

要设置屏幕 (Screen) 节点的大小，在工程 (Project) 中选择屏幕 (Screen) 节点并在属性 (Properties) 中设置：

• 对于固定尺寸窗口，进行以下设置：
  • 将屏幕分辨率 (Screen Resolution) 设为特定分辨率
    
  • 将指标类型 (Metrics Type) 设为绝对 (Absolute)，并定义绝对宽度 (Width) 和高度 (Height)
    
• 对于可调整尺寸的窗口，将指标类型 (Metrics Type) 设为相对 (Relative)，并定义相对宽度 (Width) 和高度 (Height)。
  

设置屏幕 (Screen) 节点之外的区域的颜色

当设备屏幕的分辨率大于具有大小固定的屏幕 (Screen) 节点的应用程序的分辨率时，可以使用屏幕清除颜色 (Screen Clear Color) 属性设置屏幕 (Screen) 点之外的区域的颜色。

当您使用屏幕清除颜色 (Screen Clear Color) 属性时并且场景图中有 2D 视口 (Viewport 2D) 节点时，您可以使用不执行颜色清除的渲染通道对其进行渲染。屏幕 (Screen) 已执行颜色清除。

当 Kanzi 应用程序不使用复制交换行为时设置 屏幕清除颜色 (Screen Clear Color)，并且：

• 目标硬件使用基于磁贴的架构。

或

• 目标硬件不使用基于磁贴的架构，但不使用不透明渲染（例如背景图像）填充重要屏幕区域。

要设置屏幕 (Screen) 节点之外的区域的颜色：

1. 在工程 (Project) 中选择屏幕 (Screen) 节点。
   
2. 在属性 (Properties) 中将屏幕清除颜色 (Screen Clear Color) 属性设置为用于屏幕 (Screen) 节点以外的区域的颜色。
   当您设置屏幕清除颜色 (Screen Clear Color) 属性时，Kanzi 会使用您之前设置的颜色清除 屏幕 (Screen) 节点以外的屏幕，然后再渲染任何其他区域。
   

使应用程序填充整个设备屏幕

要使 Kanzi 应用程序填充整个设备屏幕，在工程 (Project) 中选择屏幕 (Screen) 节点，并在属性 (Properties) 中设置：

• 屏幕分辨率 (Screen Resolution) 属性为自定义 (Custom)
• 指标类型 (Metrics Type) 为相对 (Relative)
• 将宽度 (Width) 和高度 (Height) 设为 1

当您需要在应用程序的根节点中重写上述设置时，例如RootPage：

1. 在工程 (Project) 中选择根节点。
2. 在属性 (Properties) 中添加这些属性：
   • 布局宽度 (Layout Width)
   • 布局高度 (Layout Height)
   • 纵横比 (Aspect Ratio)

在 API 中使用 屏幕 (Screen) 节点

有关详细信息，请参阅 API reference中的 Screen 类。

屏幕 (Screen)属性类型和消息

要查看 屏幕 (Screen) 节点可用属性类型和消息的完整列表，请参阅Screen。

另请参阅

教程：让应用程序拥有动态布局

打开导航