home *** CD-ROM | disk | FTP | other *** search
/ RISCWORLD 7 / RISCWORLD_VOL7.iso / Software / Issue4 / SDL / gcc346 / !SDL / man / SDL_ActiveEvent.3 next >
Encoding:
Text File  |  2006-09-20  |  2.3 KB  |  74 lines
  1. <!-- manual page source format generated by PolyglotMan v3.0.8+X.Org, -->
  2. <!-- available at http://polyglotman.sourceforge.net/ -->
  3.  
  4. <html>
  5. <head>
  6. <title>"SDL_ActiveEvent"("3") manual page</title>
  7. </head>
  8. <body bgcolor='#efefef' text='black' link='blue' vlink='#551A8B' alink='red'>
  9. <a href='#toc'>Table of Contents</a><p>
  10.  
  11. <h2><a name='sect0' href='#toc0'>Name</a></h2>
  12. SDL_ActiveEvent- Application visibility event structure 
  13. <h2><a name='sect1' href='#toc1'>Structure Definition</a></h2>
  14. <p>
  15. <br>
  16. <pre>CWtypedef struct{
  17.   Uint8 type;
  18.   Uint8 gain;
  19.   Uint8 state;
  20. } SDL_ActiveEvent;
  21. </pre><p>
  22.  
  23. <h2><a name='sect2' href='#toc2'>Structure Data</a></h2>
  24.  
  25. <dl>
  26.  
  27. <dt><b>type</b> </dt>
  28. <dd><b>SDL_ACTIVEEVENT.</b> </dd>
  29.  
  30. <dt><b>gain</b> </dt>
  31. <dd>0 if the event is a loss or 1 if
  32. it is a gain. </dd>
  33.  
  34. <dt><b>state</b> </dt>
  35. <dd><b>SDL_APPMOUSEFOCUS</b> if mouse focus was gained or lost,
  36. <b>SDL_APPINPUTFOCUS</b> if input focus was gained or lost, or <b>SDL_APPACTIVE</b> if
  37. the application was iconified (<b>gain</b>=0) or restored(<b>gain</b>=1). </dd>
  38. </dl>
  39.  
  40. <h2><a name='sect3' href='#toc3'>Description</a></h2>
  41. <p>
  42. <b>SDL_ActiveEvent</b>
  43. is a member of the <i><b>SDL_Event</b></i> union and is used when an event of type <b>SDL_ACTIVEEVENT</b>
  44. is reported. <p>
  45. When the mouse leaves or enters the window area a <b>SDL_APPMOUSEFOCUS</b>
  46. type activation event occurs, if the mouse entered the window then <b>gain</b>
  47. will be 1, otherwise <b>gain</b> will be 0. A <b>SDL_APPINPUTFOCUS</b> type activation
  48. event occurs when the application loses or gains keyboard focus. This usually
  49. occurs when another application is made active. Finally, a <b>SDL_APPACTIVE</b>
  50. type event occurs when the application is either minimised/iconified (<b>gain</b>=0)
  51. or restored. <p>
  52. <blockquote><b>Note:   <p>
  53. This event does not occur when an application window
  54. is first created. </blockquote>
  55.  
  56. <h2><a name='sect4' href='#toc4'></b>See Also</a></h2>
  57. <p>
  58. <i><b>SDL_Event</b></i>, <i><b>SDL_GetAppState</b></i> 
  59. <!--
  60.   
  61.  <p>
  62.  
  63. <hr><p>
  64. <a name='toc'><b>Table of Contents</b></a><p>
  65. <ul>
  66. <li><a name='toc0' href='#sect0'>Name</a></li>
  67. <li><a name='toc1' href='#sect1'>Structure Definition</a></li>
  68. <li><a name='toc2' href='#sect2'>Structure Data</a></li>
  69. <li><a name='toc3' href='#sect3'>Description</a></li>
  70. <li><a name='toc4' href='#sect4'>See Also</a></li>
  71. </ul>
  72. </body>
  73. </html>
  74.