ARSperl

 view release on metacpan or  search on metacpan

html/manual/ars_GetCharMenuItems.html  view on Meta::CPAN

<HTML>
<HEAD>
<TITLE>ARSperl Manual - ars_GetCharMenuItem</TITLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF">

   <H2><CODE>ars_GetCharMenuItems(ctrl,name)</CODE></H2>

      This function builds a "linked list" of menu items. It returns an
      array pointer to the top level menu that is made up of 
      <I>(name, value)</I> pairs. If the <I>value</I> is, in turn, another
      array pointer, then it points to a submenu structure. <P>

      <B>Illustration</B>
      <PRE>
      @menu_struct
       ($name = "Item1"   , $value = "This is item1")
             .
             .
             .
       ($name = "Sub Menu", $value = array reference)
                                +------&gt; @sub_menu_struct
                                          ($name = "SubItem1", $value = ...)
                                    . 
                                    .
                                    .
      </PRE>
      See <I>Show_Menu.pl</I> for a demonstration of using this function 
      and its output.<P>

      <DL>
          <DT><B>On success</B><DD>
              A reference to an array.
          <DT><B>On failure</B><DD>
              <CODE>undef</CODE>.
      </DL>

      <P>Example:

      <PRE>
      $m = ars_GetCharMenuItems($ctrl, $menu_name));
      @menu_struct = @$m;
      </PRE>

<P>
<HR WIDTH="30%">
<P>
<A HREF="toc.html"><IMG ALT="&lt;--" SRC="arrow.gif" ALIGN=CENTER> Table of Contents </A>
<p>
<address>
Last changes to this page 26th June 1997 by d.j.adams@soton.ac.uk<br>
&#169; J.C.Murphy, J.W.Murphy 1997 arsperl@arsperl.org
</address>
</BODY>
</HTML>



( run in 0.487 second using v1.01-cache-2.11-cpan-cdf2f3d4e48 )