home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 1995 March / SOFM_Mar1995.bin / pc / utility / os2 / clock / english.ipf < prev    next >
Text File  |  1995-01-27  |  6KB  |  146 lines
  1. #include "clock.h"
  2. :userdoc.
  3. :title."Clock" Help
  4. :body.
  5.  
  6. :h1 res=ID_MAIN.Introduction
  7. :i1.Introduction
  8. :artwork name='clock.bmp' align=center.
  9. :p.
  10. This program is a substantial revision of Charles Petzold's Clock program,
  11. which can be found in his book, "Programming the OS/2 Presentation Manager".
  12. It displays an analog clock, updated once per second.
  13. :p.
  14. For Frank's Nursery, this program has been modified to monitor system task
  15. count or processing load and to change its border color according to the
  16. current level.
  17. :p.
  18. The help facility is active, as you've already seen, and those program
  19. commands that exist may be accessed via the window's system menu.  The
  20. following commands are available:
  21. :sl compact.
  22. :li.:hpt.Save Defaults:ehpt.:hdref res=IDM_SAVE_APPLICATION.
  23. :li.:hpt.Reset Defaults:ehpt.:hdref res=IDM_RESET_DEFAULTS.
  24. :li.:hpt.Hide Controls:ehpt.:hdref res=IDM_HIDE_CONTROLS.
  25. :li.:hpt.Configure...:ehpt.:hdref res=IDM_CONFIGURE.
  26. :li.:hpt.About...:ehpt.:hdref res=IDM_ABOUT.
  27. :esl.
  28. Außer den schon beschriebenen Vorrichtungen akzeptiert das Programm
  29. auch Kommandos von den OS/2 2.0-Programmen zur Farb- und Schriftartpalette.
  30.  
  31. :h1 res=IDM_SAVE_APPLICATION.Save Defaults (Menu Option)
  32. :i1.Save Defaults (Menu Option)
  33. When you select this menu option, the program saves its current position
  34. and the status of the Hide Controls option.  The next time the program
  35. is started, it will be started with that position and with the controls
  36. hidden (or not) according to the saved state.
  37. :note.The short-cut key for this command is F2.
  38.  
  39. :h1 res=IDM_RESET_DEFAULTS.Reset Defaults (Menu Option)
  40. :i1.Reset Defaults (Menu Option)
  41. Selecting this menu option will reset the program's font and color
  42. attributes to their default values.
  43.  
  44. :h1 res=IDM_HIDE_CONTROLS.Hide Controls (Menu Option)
  45. :i1.Hide Controls (Menu Option)
  46. This menu option, when selected, will cause the program's frame controls
  47. (the system menu, the titlebar and the minimize button) to be hidden.
  48. This option can be toggled with a double-click on either mouse button.
  49. Also, since I saw it as very useful to be able to move the window while
  50. the controls were hidden, the window has been set up so that you can
  51. drag it with either mouse button.
  52. :note.The short-cut key for this command is Alt+H.
  53.  
  54. :h1 res=IDM_CONFIGURE.Configure (Menu Option)
  55. :i1.Configure (Menu Option)
  56. This menu option, when selected, will cause the program's configuration
  57. dialog to be displayed.
  58. :note.The short-cut key to this option is Alt+C.
  59.  
  60. :h1 res=IDD_CONFIGURE.Configure (Dialog)
  61. :i1.Configure (Dialog)
  62. This dialog allows you to change all configurable aspects of this
  63. program's operation.  To escape without effecting any changes, press
  64. the ESCAPE key or click on the Escape pushbutton.
  65. To save the changes you've made, press the ENTER key
  66. or click on the OK pushbutton.
  67. .br
  68. The configurable items include the following:
  69. :p.
  70. :hp2.Clock Type:ehp2.
  71. The clock face can be either analog (with hands) or digital.
  72. When the clock is iconized, the face is always analog.
  73. :p.
  74. :hp2.24-Hour Clock:ehp2.
  75. The digital clock can display time either as a 24-hour military-style
  76. time, from 00&colon.00 to 23&colon.59, or as a 12-hour civilian time,
  77. with 'am' and 'pm' appended to the numeric time.
  78. :p.
  79. :hp2.Hide Controls:ehp2.
  80. When the clock is not iconized, it can be show with or without the usual
  81. title bar, system menu and minimize/maximize buttons.  If you chose to
  82. hide these controls, the sizing border remains.  The window may be
  83. positioned by dragging its center area.  It may be resized by dragging
  84. any of the four borders or the corners.
  85. :p.
  86. :hp2.Chime:ehp2.
  87. This button activates an hourly chime function.  When this button has
  88. been check-marked, the clock will beep twice at the top of every hour.
  89. :p.
  90. :hp2.Float to Top:ehp2.
  91. This button activates an window's float-to-top function.
  92. When this button has been check-marked, the clock will float to the top
  93. of the window stack, making itself visible all the time.
  94. :p.
  95. :hp2.Animate:ehp2.
  96. This button activates the window open & close animation feature.
  97. When this is active, the program window will open and close in the
  98. same way as the folder objects do: with sound and motion.
  99. As with folders, animation will not occur unless it has been
  100. enabled at the system level.
  101. :p.
  102. :hp2.Alert Type:ehp2.
  103. The clock's border changes color according to system load or task count.
  104. You may select which item it will monitor.
  105. :p.
  106. :hp2.Alert Levels:ehp2.
  107. You may adjust the task counts or CPU load levels at which the clock's
  108. border will change from green to yellow and from yellow to red.  Use
  109. the up or down arrows to adjust the values, or use the mouse to press
  110. the up or down buttons to the right of the values.
  111.  
  112. :h1 res=IDM_ABOUT.About (Menu Option)
  113. :i1.About (Menu Option)
  114. This menu option, when selected, will cause the program's About dialog
  115. to be displayed.
  116.  
  117. :h1 res=IDD_ABOUT.About (Dialog)
  118. :i1.About (Dialog)
  119. This dialog box displays the program name, icon and copyright information.
  120. To exit the dialog, press the ENTER key, the SPACE bar or the ESCAPE key.
  121.  
  122. :h1 res=IDM_KEYS_HELP.Keys Help
  123. :i1.Keys Help
  124. The following function keys have been defined for this program:
  125. :sl compact.
  126. :li.F1 - Help
  127. :li.F2 - Save Defaults
  128. :li.F3 - Exit
  129. :li.Alt+H - Hide Controls
  130. :li.Alt+C - Configure
  131. :esl.
  132.  
  133. :h1 res=IDD_PROFILE_PATH.Set Profile Path
  134. :i1.Set Profile Path
  135. This dialog is displayed when the program cannot find its profile (INI) file,
  136. and asks you where the file is or where it is to be created.
  137. :p.
  138. Only a valid existing directory name will be accepted.
  139. Once you have entered the name, press the ENTER key or click on the OK
  140. button for the program to continue.
  141. :p.
  142. If you wish to abort the program's initialization sequence, press
  143. the ESC key or click on the escape button.
  144.  
  145. :euserdoc.
  146.