workbench/libs/muimaster/mui_getclass.c

   1 /*
   2     Copyright © 2002-2007, The AROS Development Team. All rights reserved.
   3     $Id$
   4 */
   5
   6 #include <stdio.h>
   7
   8 #include <proto/exec.h>
   9 #include <proto/intuition.h>
  10 #include <proto/muimaster.h>
  11
  12 #include "muimaster_intern.h"
  13 #include "mui.h"
  14 #include "support.h"
  15 #include "support_classes.h"
  16
  17 /*#define MYDEBUG 1*/
  18 #include "debug.h"
  19
  20 /*****************************************************************************
  21
  22     NAME */
  23         AROS_LH1(struct IClass *, MUI_GetClass,
  24
  25 /*  SYNOPSIS */
  26         AROS_LHA(ClassID, classid, A0),
  27
  28 /*  LOCATION */
  29         struct Library *, MUIMasterBase, 13, MUIMaster)
  30
  31 /*  FUNCTION
  32         Get a pointer to a MUI Class.
  33
  34         The main use for this function is to retrieve the pointer to a MUI class
  35         for use by intuition.library/MakeClass() as superclass pointer. However,
  36         this function is obsolete since MUI V8, so DO NOT USE IT, use
  37         MUI_CreateCustomClass() instead.
  38
  39     INPUTS
  40         classid - the ID of the class whose pointer is to be retrieved.
  41
  42     RESULT
  43         The class pointer is returned. DO NOT use it for any other reason that
  44         as an argument of intuition.library/MakeClass(). DO NOT assume anything
  45         about its content.
  46
  47     NOTES
  48         Once the pointer is not needed anymore, do not forget to call MUI_FreeClass().
  49
  50         This function is OBSOLETE, don't use it, use MUI_CreateCustomClass instead.
  51
  52     EXAMPLE
  53
  54     BUGS
  55
  56     SEE ALSO
  57         MUI_FreeClass(), MUI_CreateCustomClass(), MUI_DeleteCustomClass()
  58
  59
  60     INTERNALS
  61
  62 *****************************************************************************/
  63 {
  64     AROS_LIBFUNC_INIT
  65
  66     Class *cl;
  67
  68     if (!classid)
  69         return NULL;
  70
  71     cl = ZUNE_GetBuiltinClass(classid, MUIMasterBase);
  72
  73     if (!cl)
  74         cl = ZUNE_GetExternalClass(classid, MUIMasterBase);
  75
  76     return cl;
  77
  78     AROS_LIBFUNC_EXIT
  79
  80 } /* MUIA_GetClass */
  81