rom/intuition/itemaddress.c

   1 /*
   2     Copyright © 1995-2013, The AROS Development Team. All rights reserved.
   3     Copyright © 2001-2003, The MorphOS Development Team. All Rights Reserved.
   4     $Id$
   5 */
   6
   7 #include "intuition_intern.h"
   8
   9 #define DEBUG_ITEMADDRESS(x)    ;
  10 #define DEBUG_ITEMADDRESS2(x)   ;
  11
  12 /*****************************************************************************
  13
  14     NAME */
  15 #include <proto/intuition.h>
  16
  17         AROS_LH2(struct MenuItem *, ItemAddress,
  18
  19 /*  SYNOPSIS */
  20         AROS_LHA(struct Menu *, menustrip, A0),
  21         AROS_LHA(UWORD        , menunumber, D0),
  22
  23 /*  LOCATION */
  24         struct IntuitionBase *, IntuitionBase, 24, Intuition)
  25
  26 /*  FUNCTION
  27         Returns the address of the menuitem 'menunumber' of 'menustrip'.
  28         The number is the one you get from intuition after the user has
  29         selected a menu.
  30         The menunumber must be well-defined.
  31         Valid numbers are MENUNULL, which makes the routine return NULL,
  32         or valid item number of your menustrip, which contains
  33         - a valid menu number
  34         - a valid item number
  35         - if the menu-item has a sub-item, a valid sub-item number
  36         Menu number and item number must be specified. Sub-item, if
  37         available, is optional, therefore this function returns either
  38         the item or sub-item.
  39
  40     INPUTS
  41         menustrip - Pointer to the first menu of the menustrip.
  42         menunumber - Packed value describing the menu, item and if
  43             appropriate sub-item.
  44
  45     RESULT
  46         Returns NULL for menunumber == MENUNULL or the address of the
  47         menuitem described by menunumber.
  48
  49     NOTES
  50
  51     EXAMPLE
  52
  53     BUGS
  54
  55     SEE ALSO
  56
  57     INTERNALS
  58
  59 *****************************************************************************/
  60 {
  61     AROS_LIBFUNC_INIT
  62
  63     struct Menu     *thismenu;
  64     struct MenuItem *thisitem = NULL;
  65     int              i;
  66
  67     DEBUG_ITEMADDRESS(dprintf("ItemAddress: Strip %p Number 0x%lx (%d/%d/%d)\n",
  68                               menustrip, menunumber, MENUNUM(menunumber),
  69                               ITEMNUM(menunumber), SUBNUM(menunumber)));
  70
  71     IntuitionBase = IntuitionBase;  /* shut up the compiler */
  72
  73     SANITY_CHECKR(menustrip,NULL)
  74
  75     if ( menunumber != MENUNULL )
  76     {
  77         thismenu = menustrip;
  78         DEBUG_ITEMADDRESS2(dprintf("ItemAddress: Menu %p\n", thismenu));
  79
  80         for ( i = 0 ; thismenu && i < MENUNUM ( menunumber ) ; i++ )
  81         {
  82             thismenu = thismenu->NextMenu;
  83             DEBUG_ITEMADDRESS2(dprintf("ItemAddress: Menu %p\n", thismenu));
  84         }
  85
  86         if (thismenu)
  87         {
  88             thisitem = thismenu->FirstItem;
  89             DEBUG_ITEMADDRESS2(dprintf("ItemAddress: Item %p\n", thisitem));
  90
  91             for ( i = 0 ; thisitem && i < ITEMNUM ( menunumber ) ; i++ )
  92             {
  93                 thisitem = thisitem->NextItem;
  94                 DEBUG_ITEMADDRESS2(dprintf("ItemAddress: Item %p\n", thisitem));
  95             }
  96
  97             if (thisitem && ( SUBNUM ( menunumber ) != NOSUB ) && thisitem->SubItem )
  98             {
  99                 thisitem = thisitem->SubItem;
 100                 DEBUG_ITEMADDRESS2(dprintf("ItemAddress: SubItem %p\n", thisitem));
 101
 102                 for ( i = 0 ; thisitem && i < SUBNUM ( menunumber ) ; i++ )
 103                 {
 104                     DEBUG_ITEMADDRESS2(dprintf("ItemAddress: SubItem %p\n", thisitem));
 105                     thisitem = thisitem->NextItem;
 106                 }
 107             }
 108         }
 109     }
 110
 111     DEBUG_ITEMADDRESS(dprintf("ItemAddress: return %p\n", thisitem));
 112
 113     return thisitem;
 114
 115     AROS_LIBFUNC_EXIT
 116 } /* ItemAddress */