移动信息设备描述（mobile information device profile，midp) 1.0 版本提供了一套基本组件，用于支持应用程序需要的大多数用户界面（ui）。但是，如果您的需求比较复杂，那么一般必须要从 canvas 派生子类，并重新设计。

   midp 2.0 改变了所有这些。现在您可以建立自定义组件，这样您就可以对用户交互进行细粒度的控制，而且可以适应现有的窗体框架，符合设备本身的观感。

    在这篇文章里，我们通过建立一个简单的 outliner midlet，来研究这些新的定制功能。大纲是用来组织想法、保持列表，甚至进行项目计划的工具――是一个在移动设备上非常有用的应用程序。outliner midlet让用户可以构建层次结构良好的窗体项目大纲。它们可以加入或删除，缩进或凸出，还可以用一种在 midp 2.0 出现之前不可能的方法折叠和展开项目。

outliner 类自己就是一个普通的 midlet。功能的核心是 customitem 的子类，叫做 outlineitem。你要实现自己的 customitem 类时需要做的事，在这个类里都做了，所以您应当好好在源代码里看看它。构造函数是一个开始的好地方：

/*** 用指定的初始缩进和文本建立  outlineitem*/public outlineitem( int inindent, string intext ){    // 我们不想要系统提供的标签

    super( null );    indent = inindent;    text = intext;    hiddenchildren = null;    // 定义布局    setlayout( layout_expand | layout_top | layout_newline_after );    // 加入一直适用的命令    addcommand( editcommand );    addcommand( insertcommand );}            

调用构造函数，把要显示的文本、项目应当缩进的次数传递给构造函数，就可以建立 outlineitem。

    在构造函数里，第一项任务是调用超类的构造函数。midp 项目不仅仅代表 ui 小部件本身，还有一个标签向用户标识部件。例如，一个文本字段是一个包含文本的框；它的标签通常出现在它的左边，是描述文本框中内容的单词，比如 name 或 password。大纲项不需要标签，所以我们的构造函数把 null 作为必要参数传给超类的构造函数。

    在使用传递给构造函数的参数初始化对象的状态之后，下一步就是配置项目的布局指令，把一些命令直接加给项目。稍后我会解释布局指令和专门用于项目的命令。

  customitem 有 5 个我们必须实现的抽象方法。在这些方法里，paint() 方法可以让您控制项目的外观。paint()方法的参数包含项目的宽度和高度，它们由窗体的布局逻辑、图形对象、转换方式决定，所以它的原点项目的左上角。下面是 outlineitem 中 paint() 的实现：

public void paint( graphics g, int w, int h ){    // 用背景色全部清除    g.setcolor( display.getcolor( display.color_background ) );    g.fillrect( 0, 0, w, h );    // 现在用前景色来画图    g.setcolor( display.getcolor( display.color_foreground ) );    if ( iscollapsed() )    {        // 画一个代表隐藏项目的填充的圆        g.fillarc( indent * indent_margin + 2, 2,             font_height-7, font_height-7, 0, 360 );    }    else    {        // 没有隐藏项目，所以画一个空心圆        g.drawarc( indent * indent_margin + 2, 2,             font_height-7, font_height-7, 0, 360 );    }    // 画出文本    g.drawstring( text,         indent * indent_margin + font_height, 0, g.top | g.left );}            

    通过二次调用 display 的 getcolor() 方法，我们找到设备的默认背景色和前景色，每次把适当的常数传递给这个方法，先用 color_background（背景色），然后用 color_foreground（前景色）。不管我们选择使用默认颜色还是指定自己的颜色，outlineitem.paint()都会用背景色填充一个矩形，然后切换成前景色画剩下的内容。

    请注意：midp 规范要求，在画图的时候，必须覆盖项目显示区域的每一个象素。有些实现可能会在调用 paint() 之前清除项目覆盖的区域，但是其它一些实现可能不会。如果您没有先用背景色填充矩形，那么您就会冒着失去可移植性的风险。

     然后 outlineitem 以每一缩进级别 8 个象素，从左向右画圆，如果项目处在折叠状态，就填充圆。圆的宽度和高度由字体的高度决定，所以圆的大小会根据不同的字体和尺寸在设备上恰当地缩放。因为圆的尺寸永远不会超过字体高度，所以文本挨着缩进边际加上字体宽度之后向右偏移。

     请注意：长的字符串可能会弄乱屏幕，因为 outlineitem 没有把行的长度考虑在内。我很乐意把文本环绕的实现作为一个练习留给您。

     剩下的抽象方法让 customitem 基类请求子类计算项目的合适的最小尺寸和期望尺寸。outlineitem 的实现很简单：

public int getmincontentheight(){    return font_height;}public int getmincontentwidth(){    return indent * indent_margin + font_height;}public int getprefcontentwidth( int height ){    return indent * indent_margin         + font.stringwidth( text ) + font_height;}public int getprefcontentheight( int width ){    return font_height;}            

    您可以把这些方法当作 customitem 所实现的最小尺寸和期望尺寸访问器的回调。除非您覆盖它们，否则您的项目的 getminimumwidth() 方法将返回 getmincontentwidth() 方法的结果，而项目的 getminimumheight() 方法将返回 getmincontentheight()方法的结果。

    项目的期望宽度和高度几乎是用同样的方式决定，区别在于应用程序可以修改期望尺寸。一旦调用项目的 setpreferredwidth()方法或 setpreferredheight()方法，那么对应的尺寸就相当于被锁定了。获取期望尺寸的调用将总是返回锁定的值。在建立项目时，两个维度都被解锁，您可以通过把某一维的尺寸设置为 -1 来解除它的锁定。

    只有当 getprefcontentwidth()方法和 getprefcontentheight()方法各自的维度解除锁定的时候，才调用这二个方法。它们应当返回最佳尺寸，让项目内容最佳显示，行环绕最小，没有剪辑。

  outlineitem 没有环绕，所以最小高度和期望高度都等于当前字体的高度。期望宽度就是当前文本的宽度，等于文本当前字体所占空间加上扩展指示器的空间加上当前缩进的空间。最小宽度就是指示器的空间加上缩进的空间。

    要建立布局，窗体不仅需要每个项目的最小尺寸和期望尺寸，还需要每个项目的布局指令：一位的标志，用于指定对齐和断行。项目的布局指令组合成一个整数。如果您没有指定任何布局指定，那么会得到默认的兼容 midp 1.0 的布局，在这种布局里，项目按行摆放，一个接一个。要指定不同的布局，可以使用位运算符 or ，把各个预定义的的布局指令组合成一个整数，把它传递给 setlayout()方法。

item类定义了布局指令常量：

    对于水平和垂直维度来说，每个项目都有对齐方式以及缩小或放大到适合指定行空间的设置。通过查询换行是在项目之前还是在项目之后，还可以指定项目是在行首还是在行尾出现。

    为了保证移植性，您指定的布局指令不应该比实际需要多。默认的对齐选项，在不同的实现和不同的语言之间，会有差异，一般在那些不是从左到右阅读的语言上会出现。您不必指定布局，但是如果指定布局，会给项目一个默认布局，可能会帮助项目在外观或行为上实现预期的一致性。

outlineitem 在构造函数里用下面这个调用设置自己的布局指令：

// 定义布局             
setlayout( layout_expand | layout_top | layout_newline_after ); 

    布局指令包括 layout_expand, layout_top,以及 layout_newline_after。不需要水平对齐选项，因为项目会充满所有可用水平空间。因为没有指定 layout_vshrink 和 layout_vexpand，窗体会用自己的期望高度设置项目的高度，并用顶端对齐方式在行的垂直空间里对齐项目。在窗体中的项目，会在它的位置后面得到一个断行，所以每个项目都出现在自己的行里。

    因为 outliner 的窗体只包含 outlineitems，所以这个布局指令组合会把每个项目放在自己的行里，每行的宽度与窗体宽度一样，高度为项目的期望高度。

    迄今为止，我们一直侧重的是定制项目的外观。现在，我们要考虑一下它的行为――它对用户输入响应的感知。

    midp 窗体有自己的内置术语，叫做游历（traversal)。这与桌面应用程序中切换输入焦点的概念类似。不管是在桌面还是在移动环境里，在任何给定时刻，只有一个 ui 组件拥有焦点，这意味着所有的用户输入动作都被导向这个组件。

    例如，如果文本字段拥有焦点，那么按下键盘就会造成在文本字段的插入点之后出现字符。在典型的桌面应用程序里，箭头键在文本字段内移动插入点，制表键则把焦点转移到下一个组件。移动设备可能没有完整键盘。实际上，它甚至可能没有四个方向箭头。如果移动设备有方向键，那么左、右键可能负责移动插入点，上、下键可能负责转移焦点为。如果只有二个方向键，那么上、下键可能承担双重责任：移动插入点，在插入点到达字段的开始或结束位置的时候，转移焦点。

    因为设备的差异很大，所以 midp 为定制项目提供了一种机制，支持用一致的、可移植的方式进行游历。在 customitem 的一个方法里包含了这个机制：

protected boolean traverse(     int dir,    int viewportwidth,    int viewportheight,    int[] visrect_inout )            

    当用户按下能够引起我们的项目接收焦点的导航键时（通常是箭头键），就调用定制项目的 traverse() 方法。如果方法返回 true，那么用户下次按下导航键时，还会调用这个方法，循环往复，直到方法返回 false 为止。

    传递给 traverse()方法的第一个参数，是造成焦点转移到我们项目的按键。参数值是 canvas 类中定义的方向性游戏动作（game actions）中的一个：canvas.up, canvas.down, canvas.left,和 canvas.right,或者为空值 customitem.none。如果值为none, 那么一些与平台相关的事件，例如改变窗体大小，会使项目获得焦点。

    剩下的参数负责描述屏幕的尺寸和项目在屏幕上的可见区域。某些项目，特别是是那些显示大量文本的项目，比屏幕的尺寸大，它们必须能够响应游历事件，滚动它们的可视内容。traverse()方法的文档详细解释了这些参数，但是您现在没有必要考虑它们。

    如果您想让项目对用户的按键响应仍然保留焦点，那么您的实现就应当返回 true。在 customitem 中的实现总返回false, 这样形成了与 stringitem 的行为类似的行为：按下任何导航键，都会把焦点转移到不同的项目。这个行为对于 customitem 的大多数简单子类都合适。

    更具交互性的项目可能需要覆盖 traverse()方法来定制导航键的行为。一个比较好的例子是 gauge 项目，在某些实现里，按下右键和左键可以增减组件里的值。当值达到最大或最小值时，traverse()方法返回 false，允许按键把焦点移动到与按键方向对应的下一个组件上。文本字段的某些实现工作也来也类似，把插入点向左或向右移动，只在插入点到达字段的开始或结束时才转移焦点。

    对于 outlineitem，上、下方向键按照常规把焦点转移到另一个组件。因为没有插入点需要考虑――所有的编辑都在另外一个屏幕处理――outlineitem 把右键和左键解释为缩进或凸出文本。在没有水平方向键的设备上，outliner midlet 会显示额外的菜单项，表示缩进文本或凸出文本，就象我稍后说明的那样。

下面是 traverse 的实现：

/*** 用来在可能的时候缩进项目或凸出项目。*/protected boolean traverse(     int dir,    int viewportwidth,    int viewportheight,    int[] visrect_inout ){    // 用这个标记来区分焦点是    // 游历进本项目，还是    // 在本项目内游历：    if ( traversingitem != this )    {        // 游历进：标记自己，返回 true        traversingitem = this;        return true;    }    // 处理在本项目内的游历    switch ( dir )    {        case canvas.right:            if ( isindentable() )            {                indent();            }            repaint();            return true;        case canvas.left:            if ( isoutdentable() )            {                outdent();            }            repaint();            return true;        case none:            // 什么都不做：只是重绘窗体布局            return true;        default:            // 退出    }    return false;}            

    请注意：当焦点游历进您的项目时，就会调用traverse()方法，只要您的实现返回 true，那么每次焦点都是在您的项目内游历。您应当在代码中区分这些情况。outlineitem 保持了一个静态引用，用它来判断项目是否由于这次调用 traverse() 而获得焦点。如果是这样，它就返回 true ，这样它就可以接收下一个方向键。

    对于接下来针对 traverse()的调用， outlineitem 查看按下了哪个键。如果按下的是右键或左键，它就修改缩进级别。在 none 的情况下，outlineitem 什么也不做，但是返回 true，以便重新获得焦点。对于剩下的二种情况，上和下，则返回 false ，允许焦点游历到下一个或上一个项目。

    因为改变缩进级别也会改变项目的可视外观，所以 traverse()方法调用 repaint()方法，告诉窗体重绘它自己。因为 outlineitem 没有做文字环绕，所以项目的期望尺寸不会变化。如果尺寸发生了变化，traverse() 方法应用调用 invalidate() ，而不是调用 repaint()，好让窗体重新安排它的布局。

private void updatecommands(){    if ( !haspointerpress() )    {        removecommand( expandcommand );        removecommand( collapsecommand );        // 进入展开或折叠的命令        if ( iscollapsed() )            addcommand( expandcommand );        else            addcommand( collapsecommand );    }    if ( !hashorizontaltraversal() )    {        removecommand( indentcommand );        removecommand( outdentcommand );        // 进入缩进、凸出的命令        if ( isindentable() )            addcommand( indentcommand );        if ( isoutdentable() )                            addcommand( outdentcommand );    }    removecommand( upcommand );    removecommand( downcommand );    if ( canmoveup() )        addcommand( upcommand );    if ( canmovedown() )                        addcommand( downcommand );    removecommand( deletecommand );    if ( getindex() > 0 )    {        // 如果不为根        addcommand( deletecommand );    }            }

private boolean haspointerpress(){    return ( getinteractionmodes() & pointer_press ) != 0;}private boolean hashorizontaltraversal(){    return ( getinteractionmodes() & traverse_horizontal ) != 0;}            

protected void pointerpressed( int x, int y ){    // 如果在小部件区域内    if ( x < font_height )    {        if ( iscollapsed() )             expand();        else             collapse();    }}