窗口

功能描述

窗口实际是一个容器部件。可以包含所有的控件,也可以再次包含一个新的窗口。可以用于以下场景

  • 显示隐藏一个控件组合
  • 当需要完成tab页面的时候可以通过多个窗口实现不同的窗口切换
  • 弹出的对话框
  • 弹出悬浮框

如何使用

  1. 创建一个 窗口 控件,默认的窗口是透明的。根据需求,可以自行添加背景图或者修改背景色; 你也可以将其他控件添加到窗口中。

  2. 在上面的属性表中 有两个属性需要解释下:
    • 是否是模态窗口
      如果是模态,当这个窗口控件显示时,点击该窗口以外的区域,该窗口会自动隐藏。
      如果是非模态, 该窗口控件的显示/隐藏 都必须自行控制。
    • 超时自动隐藏窗口
      如果是模态窗口, 那么该窗口从刚开始显示开始计时,在指定时间后自动隐藏。单位为秒;如果该值为 -1,那么表示不会自动隐藏。
      如果是非模态,那么该参数无任何作用。

代码操作

对于窗口控件,我们一般会涉及到如下几个函数

//显示窗口
void showWnd();
//隐藏窗口
void hideWnd();
判断窗口是否显示
bool isWndShow();

动态设置背景

如果我们将窗口布满整个屏幕,然后设置这个窗口的背景,即可实现修改屏幕背景的效果。

  • 相关的接口

      /**
       * @brief 设置背景图
       * @param pPicPath 图片路径
       */
      void setBackgroundPic(const char *pPicPath);
    
      /**
       * @brief 设置背景颜色
       * @param color -1时,背景设置为透明;其他颜色值为0x RGB,颜色值不支持alpha
       */
      void setBackgroundColor(int color);
    
  • 使用示例

      //把/mnt/extsd/bg.png 这个路径的图片设置为这个窗口控件的背景图
      mWindow1Ptr->setBackgroundPic("/mnt/extsd/bg.png");
    
      //将ID为window1的窗口背景色设置为红色
      mWindow1Ptr->setBackgroundColor(0xff0000);
    
      //将ID为window1的窗口背景色设置为绿色
      mWindow1Ptr->setBackgroundColor(0x00ff00);
    
      //将ID为window1的窗口背景色设置为蓝色
      mWindow1Ptr->setBackgroundColor(0x0000ff);
    

    有许多控件都拥有设置背景色、设置背景图的接口,使用方法相同。

样例代码

演示了 模态/非模态窗口控件的使用

具体窗口控件的使用,参考样例代码中的WindowDemo项目

powered by Gitbooklast modified: 2021-05-28 12:00:31

results matching ""

    No results matching ""