workbench/libs/reqtools/rtscreentofrontsafely.c

   1 /*
   2     Copyright © 1995-2001, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Desc:
   6     Lang: English
   7 */
   8
   9 #include <exec/types.h>
  10 #include <proto/exec.h>
  11 #include <proto/reqtools.h>
  12 #include <proto/intuition.h>
  13 #include <exec/libraries.h>
  14 #include <exec/memory.h>
  15 #include <aros/libcall.h>
  16 #include "general.h"
  17 #include "reqtools_intern.h"
  18 #include "rtfuncs.h"
  19
  20 /*****************************************************************************
  21
  22     NAME */
  23
  24     AROS_LH1(VOID, rtScreenToFrontSafely,
  25
  26 /*  SYNOPSIS */
  27
  28         AROS_LHA(struct Screen *, screen, A0),
  29
  30 /*  LOCATION */
  31
  32         struct ReqToolsBase *, ReqToolsBase, 23, ReqTools)
  33
  34 /*  FUNCTION
  35         Brings the specified screen to the front of the display, but only after
  36         checking it is still in the list of currently open screens.
  37
  38         This function can be used to bring a screen back to the front of the
  39         display after bringing another screen to the front.  If the first screen
  40         closed while you where busy it is harmless to call this function, unlike
  41         calling the normal ScreenToFront().
  42
  43     INPUTS
  44         screen  --  pointer to the screen
  45
  46     RESULT
  47         none
  48
  49     NOTES
  50         This function is for the advanced ReqTools user.
  51
  52     EXAMPLE
  53
  54     BUGS
  55         none known
  56
  57     SEE ALSO
  58
  59         intuition.library/ScreenToFront()
  60
  61     INTERNALS
  62
  63     HISTORY
  64
  65 ******************************************************************************/
  66 {
  67     AROS_LIBFUNC_INIT
  68
  69     RTFuncs_ScreenToFrontSafely(screen);
  70
  71     AROS_LIBFUNC_EXIT
  72
  73 } /* rtScreenToFrontSafely*/