home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 2000 February: Tool Chest / Dev.CD Feb 00 TC.toast / pc / what's new? / sample code / human interface toolbox / packagetool / sample package / htmlsample sources / aboutbox.h < prev    next >
Encoding:
C/C++ Source or Header  |  1999-12-02  |  2.4 KB  |  79 lines
  1. /*
  2.     file AboutBox.h
  3.     
  4.     Description:
  5.     This file contains the routine prototypes for calls defined in AboutBox.c
  6.     These routines are used to manage the about box window displayed when
  7.     the user chooses 'About HTMLSample...' from the file menu.
  8.     
  9.     HTMLSample is an application illustrating how to use the new
  10.     HTMLRenderingLib services found in Mac OS 9. HTMLRenderingLib
  11.     is Apple's light-weight HTML rendering engine capable of
  12.     displaying HTML files.
  13.  
  14.     Copyright: © 1999 by Apple Computer, Inc.
  15.     all rights reserved.
  16.     
  17.     Disclaimer:
  18.     You may incorporate this sample code into your applications without
  19.     restriction, though the sample code has been provided "AS IS" and the
  20.     responsibility for its operation is 100% yours.  However, what you are
  21.     not permitted to do is to redistribute the source as "DSC Sample Code"
  22.     after having made changes. If you're going to re-distribute the source,
  23.     we require that you make it clear in the source that the code was
  24.     descended from Apple Sample Code, but that you've made changes.
  25.     
  26.     Change History (most recent first):
  27.     10/16/99 created
  28. */
  29.  
  30.  
  31. #ifndef __ABOUTBOX__
  32. #define __ABOUTBOX__
  33.  
  34. #include <Types.h>
  35. #include <Windows.h>
  36.  
  37.  
  38. /* OpenAboutBox opens the about box window and returns
  39.     a pointer to the window in *aboutBox.  There can only
  40.     be one about box open at a time, so if the about box is
  41.     already open, then this routine brings it to the front
  42.     by calling SelectWindow before returning a pointer to
  43.     it. */
  44. OSStatus OpenAboutBox(WindowPtr *aboutBox);
  45.  
  46.  
  47. /* EnsureAboutBoxIsClosed closes the about box window
  48.     if it is open.  If it is not open then this routine does
  49.     nothing. */
  50. void EnsureAboutBoxIsClosed(void);
  51.  
  52.  
  53. /* AboutBoxUpdate should be called for update events
  54.     directed at the about box window.  It calls
  55.     BeginUpdate and EndUpdate and does all of the
  56.     drawing required to refresh the about box window. */
  57. void AboutBoxUpdate(WindowPtr aboutBox);
  58.  
  59.  
  60. /* AboutBoxActivate should be called for activate events
  61.     directed at the about box window. */
  62. void AboutBoxActivate(WindowPtr aboutBox, Boolean activate);
  63.  
  64.  
  65. /* AboutBoxCloseWindow closes the about box window. 
  66.     this routine deallocates any structures allocated
  67.     by the OpenAboutBox. */
  68. void AboutBoxCloseWindow(WindowPtr aboutBox);
  69.  
  70.  
  71. /* IsAboutBox returns true if the window pointer
  72.     in the aboutBox parameter is not NULL and
  73.     points to the about box. */
  74. Boolean IsAboutBox(WindowPtr aboutBox);
  75.  
  76.  
  77. #endif
  78.  
  79.