modules/midp-lcdui/src/main/java/cc/squirreljme/runtime/lcdui/scritchui/MenuActionTreeLeaf.java

   1 // -*- Mode: Java; indent-tabs-mode: t; tab-width: 4 -*-
   2 // ---------------------------------------------------------------------------
   3 // Multi-Phasic Applications: SquirrelJME
   4 //     Copyright (C) Stephanie Gawroriski <xer@multiphasicapps.net>
   5 // ---------------------------------------------------------------------------
   6 // SquirrelJME is under the Mozilla Public License Version 2.0.
   7 // See license.mkd for licensing and copyright information.
   8 // ---------------------------------------------------------------------------
   9
  10 package cc.squirreljme.runtime.lcdui.scritchui;
  11
  12 import cc.squirreljme.jvm.mle.scritchui.ScritchInterface;
  13 import cc.squirreljme.jvm.mle.scritchui.brackets.ScritchMenuKindBracket;
  14 import cc.squirreljme.runtime.cldc.annotation.SquirrelJMEVendorApi;
  15 import javax.microedition.lcdui.Displayable;
  16 import javax.microedition.lcdui.Menu;
  17
  18 /**
  19  * A single leaf within the tree.
  20  *
  21  * @since 2024/07/21
  22  */
  23 @SquirrelJMEVendorApi
  24 public final class MenuActionTreeLeaf
  25 {
  26         /** The node this maps to. */
  27         @SquirrelJMEVendorApi
  28         final MenuActionNode _node;
  29
  30         /** The ScritchUI bracket used. */
  31         @SquirrelJMEVendorApi
  32         final ScritchMenuKindBracket _scritch;
  33
  34         /**
  35          * Initializes the leaf from the node.
  36          *
  37          * @param __node The node to map to.
  38          * @throws NullPointerException On null arguments.
  39          * @since 2024/07/21
  40          */
  41         @SquirrelJMEVendorApi
  42         MenuActionTreeLeaf(MenuActionNode __node)
  43                 throws NullPointerException
  44         {
  45                 if (__node == null)
  46                         throw new NullPointerException("NARG");
  47
  48                 MenuActionApplicable owner = __node.owner();
  49                 ScritchInterface api = DisplayManager.instance().scritch();
  50
  51                 // Determine the item that should be created
  52                 ScritchMenuKindBracket scritch;
  53                 if (owner instanceof Displayable)
  54                         scritch = api.menu().menuBarNew();
  55                 else if (owner instanceof Menu)
  56                         scritch = api.menu().menuNew();
  57                 else
  58                         scritch = api.menu().menuItemNew();
  59
  60                 // Store
  61                 this._node = __node;
  62                 this._scritch = scritch;
  63         }
  64
  65         /**
  66          * Returns the leaf's owner.
  67          *
  68          * @return The leaf's owner.
  69          * @since 2024/07/30
  70          */
  71         @SquirrelJMEVendorApi
  72         public final MenuActionApplicable owner()
  73         {
  74                 return this._node.owner();
  75         }
  76
  77         /**
  78          * Returns the native widget.
  79          *
  80          * @param <K> The widget type.
  81          * @param __cl The widget type.
  82          * @return The resultant widget.
  83          * @throws NullPointerException On null arguments.
  84          * @since 2024/07/23
  85          */
  86         @SquirrelJMEVendorApi
  87         public <K extends ScritchMenuKindBracket> K scritchWidget(
  88                 Class<? extends K> __cl)
  89                 throws NullPointerException
  90         {
  91                 if (__cl == null)
  92                         throw new NullPointerException("NARG");
  93
  94                 return __cl.cast(this._scritch);
  95         }
  96 }