rom/intuition/getdefaultpubscreen.c

   1 /*
   2     Copyright © 1995-2007, The AROS Development Team. All rights reserved.
   3     Copyright © 2001-2003, The MorphOS Development Team. All Rights Reserved.
   4     $Id$
   5 */
   6
   7 #include <string.h>
   8 #include "intuition_intern.h"
   9
  10 /*****************************************************************************
  11
  12     NAME */
  13 #include <proto/intuition.h>
  14
  15     AROS_LH1(struct Screen *, GetDefaultPubScreen,
  16
  17 /*  SYNOPSIS */
  18          AROS_LHA(UBYTE *, nameBuffer, A0),
  19
  20 /*  LOCATION */
  21          struct IntuitionBase *, IntuitionBase, 97, Intuition)
  22
  23 /*  FUNCTION
  24     Returns the name of the current default public screen.
  25     This will be "Workbench" if there is no default public screen.
  26
  27     INPUTS
  28     nameBuffer - A buffer of length MAXPUBSCREENNAME
  29
  30     RESULT
  31     None.
  32
  33     NOTES
  34     Only Public Screen Manager utilities want to use this function
  35     since it is easy to open a window on the default public screen
  36     without specifying a name.
  37
  38     EXAMPLE
  39
  40     BUGS
  41
  42     SEE ALSO
  43     SetDefaultPubScreen(), OpenWindow()
  44
  45     INTERNALS
  46
  47 *****************************************************************************/
  48 {
  49     AROS_LIBFUNC_INIT
  50
  51     struct Screen *defscreen;
  52     STRPTR         name;
  53
  54     DEBUG_GETDEFAULTPUBSCREEN(dprintf("GetDefaultPubScreen(%s)\n",nameBuffer));
  55
  56     LockPubScreenList();
  57
  58     defscreen = GetPrivIBase(IntuitionBase)->DefaultPubScreen;
  59
  60     if (defscreen)
  61     {
  62         name = GetPrivScreen(defscreen)->pubScrNode->psn_Node.ln_Name;
  63     }
  64     else
  65     {
  66         name = "Workbench";
  67     }
  68
  69     if (nameBuffer)
  70     {
  71         strcpy(nameBuffer, name);
  72     }
  73
  74     UnlockPubScreenList();
  75
  76     return defscreen;
  77
  78     AROS_LIBFUNC_EXIT
  79 } /* GetDefaultPubScreen */