将自定义 widget 嵌入 Kuix 界面-CFANZ编程社区

将自定义 widget 嵌入 Kuix 界面

        在上一篇博客《在 Kuix 框架下绘制自己定义的画布》中，我们谈论了如何在以低级界面实现的 Kuix 框架下绘制自定义画布，以及自定义画布用户事件的加入的问题。我们已经可以使用 Kuix 按照我们的意图来运行自定义的低级界面了。然而关于自定义画布的调用，采用的是显式地 new 的方法：
Screen screen = new Screen(); PmapWidget map = new ChildPmapWidget("Child of widget"); screen.add(map); screen.setCurrent();
        这样做不足之处有二：其一，我们自定义的 widget 没有返回按钮，没有标题。也就是说，我们的 widget 全屏显示了，而且没有任何按钮来让用户返回上一步操作，而且也没有标题通知用户当前操作所处的位置；其二，Kuix 所有的界面可以使用 Screen 从 xml 配置文件中读取，也就是说我们看到的任何组件，都可以在 xml 文件中进行配置。显式地 new 出 widget，显然与 Kuix 的框架思路背道而驰。
        如何将自定义 widget 在 kuix 的 xml 文件中进行配置？如何调用我们自定义的 widget？如何将自定义 widget 嵌入 Kuix 界面，和其他 Kuix 组件（比如按钮等）一起显示？我们就在这篇博客中详细地讨论解决这些问题的步骤。
        仍然采用我们在上一篇博客中写的自定义的 widget 的例子，PmapWidget.java 的源代码不变。但是其子类 ChildPmapWidget.java 的源码略有改动。改动后的源代码如下：

/**
 * 文件名：ChildPmapWidget.java
 *
 * 版本信息：
 * 日期：2009-12-19
 * Copyright XXX Corporation 2009 
 * 版权所有
 *
 */
package com.xxx.kuix.widget;
/**
 * 
 * 项目名称：Canvasdemo4-position-map
 * 类名称：ChildPmapWidget
 * 类描述：PmapWidget 的孩子类。目前还没有任何自己的功能实现
 * 创建人：Defonds
 * 创建时间：2009-12-19 上午10:54:07
 * 修改人：Defonds
 * 修改时间：2009-12-19 上午10:54:07
 * 修改备注：
 * @version 
 * 
 */
public class ChildPmapWidget extends PmapWidget {
  
  /**
   * ChildPmapWidget 的标签
   */
  public static final String CHILD_PMAP_WIDGET_TAG = "childpmapwidget";
  /**
   * 创建一个新的实例 ChildPmapWidget.
   */
  public ChildPmapWidget() {
    super(CHILD_PMAP_WIDGET_TAG);
  }
}

定义一个 Frame，MovMapFrame 来负责显示我们自定义的 widget：

/**
 * 文件名：MovMapFrame.java
 *
 * 版本信息：
 * 日期：2009-12-21
 * Copyright XXX Corporation 2009 
 * 版权所有
 *
 */
package com.xxx.kuix.frame;
import org.kalmeo.kuix.core.Kuix;
import org.kalmeo.util.frame.Frame;
/**
 * 
 * 项目名称：Canvasdemo12-bus
 * 类名称：MovMapFrame
 * 类描述：显示我们自定义的 widget
 * 创建人：Defonds
 * 创建时间：2009-12-21 下午04:44:11
 * 修改人：Defonds
 * 修改时间：2009-12-21 下午04:44:11
 * 修改备注：
 * @version 
 * 
 */
public class MovMapFrame implements Frame {
  /**
   * 需要加载的界面
   */
  public void onAdded() {
    Kuix.loadScreen("/xml/CustomMap.xml", null).setCurrent();
  }
  /**
   * 处理用户信息事件
   */
  public boolean onMessage(Object identifier, Object[] arguments) {
    
    /**
     * 返回主界面
     */
    if ("back".equals(identifier)){
      Kuix.getFrameHandler().removeFrame(this);
         Kuix.getFrameHandler().getTopFrame().onAdded();
         return false;
    }
    return false;
  }
  public void onRemoved() {}
}

在项目的 res 下的 xml 文件夹中加入 CustomMap.xml，其源代码如下：

<screen title="自定义的 widget" cleanUpWhenRemoved="true" >
    <childpmapwidget/>
    <screenFirstMenu onAction="back">上一步</screenFirstMenu>
</screen>
         然后在我们的 KuixMIDlet 程序中将其父类 org.kalmeo.kuix.core.KuixMIDlet 的 createNewConverterInstance 方法重写：
    /**
     * 注册自定义 Widget
     */
    protected KuixConverter createNewConverterInstance(){
        return new KuixConverter(){
            public Widget convertWidgetTag(String tag){
               
                /**
                 * 注册 com.XXX.kuix.widget.ChildPmapWidget
                 */
                if(ChildPmapWidget.CHILD_PMAP_WIDGET_TAG.equals(tag)){
                    return new ChildPmapWidget();
                }
               
                return super.convertWidgetTag(tag);
            }
        };
    }

运行程序，效果图如下：

进入这个界面后，我们按下向上键，或者长按向左键，泡泡已经可以运动了；而当我们按下“上一步”按钮后，也可以返回上一个 Frame 了。