home *** CD-ROM | disk | FTP | other *** search
/ Aminet 18 / aminetcdnumber181997.iso / Aminet / misc / emu / AROSdev.lha / AROS / rom / intuition / setwindowtitles.c < prev    next >
C/C++ Source or Header  |  1997-01-27  |  3KB  |  104 lines
  1. /*
  2.     (C) 1995-96 AROS - The Amiga Replacement OS
  3.     $Id: setwindowtitles.c,v 1.6 1997/01/27 00:36:43 ldp Exp $
  4.     $Log: setwindowtitles.c,v $
  5.     Revision 1.6  1997/01/27 00:36:43  ldp
  6.     Polish
  7.  
  8.     Revision 1.5  1996/12/10 14:00:09  aros
  9.     Moved #include into first column to allow makedepend to see it.
  10.  
  11.     Revision 1.4  1996/11/08 11:28:04  aros
  12.     All OS function use now Amiga types
  13.  
  14.     Moved intuition-driver protos to intuition_intern.h
  15.  
  16.     Revision 1.3  1996/10/24 15:51:25  aros
  17.     Use the official AROS macros over the __AROS versions.
  18.  
  19.     Revision 1.2  1996/08/29 13:57:38  digulla
  20.     Commented
  21.     Moved common code from driver to Intuition
  22.  
  23.     Revision 1.1  1996/08/23 17:28:18  digulla
  24.     Several new functions; some still empty.
  25.  
  26.  
  27.     Desc:
  28.     Lang: english
  29. */
  30. #include "intuition_intern.h"
  31.  
  32. /*****************************************************************************
  33.  
  34.     NAME */
  35. #include <proto/intuition.h>
  36.  
  37.     AROS_LH3(void, SetWindowTitles,
  38.  
  39. /*  SYNOPSIS */
  40.     AROS_LHA(struct Window *, window, A0),
  41.     AROS_LHA(UBYTE         *, windowTitle, A1),
  42.     AROS_LHA(UBYTE         *, screenTitle, A2),
  43.  
  44. /*  LOCATION */
  45.     struct IntuitionBase *, IntuitionBase, 46, Intuition)
  46.  
  47. /*  FUNCTION
  48.     Changes the current window and/or the screen title.
  49.  
  50.     INPUTS
  51.     window - Change the title for this window or the screen which the
  52.         window contains.
  53.     windowTitle - New title for the window or ((UBYTE *)~0L) to keep the
  54.         old title or NULL for no title. If you specify a string,
  55.         this string is *NOT* copied.
  56.     screenTitle - New title for the screen of the window or ((UBYTE *)~0L)
  57.         to keep the old title or NULL for no title. If you specify
  58.         a title for the screen, this title will be shown when the
  59.         window becomes active. If you specify a string, this string
  60.         is *NOT* copied.
  61.  
  62.     RESULT
  63.     None.
  64.  
  65.     NOTES
  66.     You should be careful with specifying a screen title because that
  67.     may irritate the user.
  68.  
  69.     EXAMPLE
  70.  
  71.     BUGS
  72.  
  73.     SEE ALSO
  74.  
  75.     INTERNALS
  76.  
  77.     HISTORY
  78.     29-10-95    digulla automatically created from
  79.                 intuition_lib.fd and clib/intuition_protos.h
  80.  
  81. *****************************************************************************/
  82. {
  83.     AROS_LIBFUNC_INIT
  84.     AROS_LIBBASE_EXT_DECL(struct IntuitionBase *,IntuitionBase)
  85.  
  86.     /* Call driver before changing the window to allow it to examine
  87.     the old values. */
  88.     intui_SetWindowTitles (window, windowTitle, screenTitle);
  89.  
  90.     /* Change window's title */
  91.     if (!windowTitle)
  92.     window->Title = NULL;
  93.     else if (windowTitle != (UBYTE *)~0L)
  94.     window->Title = windowTitle;
  95.  
  96.     /* Change screen's title */
  97.     if (!screenTitle)
  98.     window->ScreenTitle = NULL;
  99.     else if (screenTitle != (UBYTE *)~0L)
  100.     window->ScreenTitle = screenTitle;
  101.  
  102.     AROS_LIBFUNC_EXIT
  103. } /* SetWindowTitles */
  104.