home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / pmpopup2.zip / PMPopUp2.eng next >
Text File  |  1995-08-31  |  6KB  |  171 lines
  1.                                         PMPopup/2
  2.                                        -----------
  3.  
  4. PmPopup/2 creates a configurable dialog box für IBM OS/2 upwards of V.2.1 with
  5. up to 255 characters text (also  on several lines),  up to  three buttons and a 
  6. timer function.  On leaving the dialog an ErrorLevel will be returned.
  7.  
  8.  
  9. Parameter:
  10.         "message"
  11.                 The message which the box should display. ( in double quotation 
  12.                 marks )
  13.                 The message text will automatically be wrapped 
  14.                 To insert manual 'newlines' into the message, a Tilda (~)
  15.                 is inserted at the desired position. 
  16.             eg: "line 1~line 2" 
  17.     
  18.  
  19.         "title"
  20.                 The title of the dialog box ( in double quotation marks )
  21.         eg: "This is the title line"
  22.            
  23.  
  24.         /B1:"text"
  25.                 Establishes a button in the lower left hand corner with the 
  26.                 given text (in double quotation marks). When this button in the
  27.         dialog is pressed, the program outputs the Errorlevel 10.
  28.                 A Tilda (~) in the button text defines a Hotkey.
  29.         eg: /b1:"~OK" (Hotkey O)
  30.  
  31.         /B2:"text"
  32.                 as seen above:
  33.                 The button is centrally placed and generates the Errorlevel 20
  34.  
  35.         /B3:"text"
  36.                 as seen above:
  37.                 The button is placed on the right hand side and outputs 
  38.                 Errorlevel 30
  39.  
  40.         /T:time
  41.                 A timer will be created, der which will complete the dialog 
  42.                 after the number of seconds given in 'time'. Errorlevel 40 will 
  43.                 be generated.
  44.         eg: /t:5
  45.                 Due to system restrictions of OS/2 2.xx (not WARP) the time 
  46.                 must not exceed 65 seconds.
  47.  
  48.         /SM
  49.                 The dialog  window is SYSTEM MODAL. No other window can be se-
  50.                 lected until the dialog is ended.
  51.  
  52.         /F:"size.font name"
  53.                 Here a system font type can be selected for the text window.
  54.                 ( in double quotation marks )
  55.                 eg: /f:"8.Helv"
  56.  
  57.         /A:arrangement
  58.                 The arrangement the message:
  59.                         L left hand side
  60.                         C centered
  61.                         R right hand side
  62.                 Note: The parameter (L,C,R) can only be entered WITHOUT double 
  63.                 quotation marks. 
  64.         eg: /a:c (centered)
  65.  
  66.         /BELL
  67.                 A short double tone is generated upon popping up.
  68.  
  69.  
  70. defaults:
  71.         message
  72.                 A four line help text
  73.         Title
  74.                 "PMPopUp/2"
  75.         Buttons
  76.                 If no button and and no timer are given, button 2 will be
  77.                 generated with the text "OK".
  78.  
  79.         Timer
  80.                 Standard value 0.
  81.  
  82.         Font
  83.                 10.System Proportional
  84.  
  85.         Arrangement
  86.                 bound to the left hand side
  87.  
  88.         Beep
  89.                 No Beep
  90.  
  91. Errorlevel:
  92.         10      The left button was pressed
  93.         20      The middle button was pressed
  94.         30      The right button was pressed
  95.         40      Timeout
  96.  
  97.  
  98. Examples:
  99. 1.      pmpopup2
  100.  
  101.                 Opens a dialog box with the title "PMPopUp/2", the Help text 
  102.                 and centrally placed OK-button
  103.  
  104. 2.      pmpopup2 "This is a oneliner" /a:c
  105.  
  106.                 Opens a dialog box with the title "PMPopUp/2", the text "This is 
  107.                 a oneliner" (centered) and a centrally placed OK-button.
  108.  
  109. 3.      pmpopup2 "This is a threeliner~...~Hello!" "testrun" /b1:"ohh!"
  110.                  /b3:"so!"
  111.  
  112.                 Opens a dialog box mit with the title "testrun", three lines of 
  113.                 text (because of ~ in the text), a button on the left hand side 
  114.                 ("ohh") and a button on the right hand side ("so!")
  115.  
  116. 4.      pmpopup2 "This box will close in 5 seconds." "testrun 4" /t:5 /a:r
  117.  
  118.                 Opens a dialog box with the default-title, a line of text
  119.                 (bound to the right hand side), without buttons. This Box 
  120.                 closes automatically after 5 seconds.
  121.  
  122. 5.      pmpopup2 "This box will close in 15 seconds.~or over the button."
  123.                 "testrun" /t:15 /b2:"~immediately off!" /f:"8.Helv" /sm /bell
  124.  
  125.                 Opens a dialog box with the title "testrun", a twoline-
  126.                 text in the font type Helv, 8 pixels in size, a centrally placed
  127.                 button with Hotkey 'S' and a 15-second-timer. The dialog
  128.                 is system modal, no other window on the desktop can be chosen.
  129.                 An acoustic signal is being generated.
  130.  
  131.  
  132. Files:
  133.         PMPopUp2.Exe
  134.                 the program
  135.         PMPopUp2.Ger
  136.                 the german readme file
  137.         PMPopUp.Eng
  138.                 the english readme file
  139.         TestPop.Cmd
  140.                 a example-program to explain usage
  141.                 
  142.  
  143.  
  144. ...the usual:
  145.  
  146.         (c) 1995 Christian Biskup, Bonn
  147.  
  148.         This program is freeware. It can be freely distributed, so long as the
  149.         package remains complete and the accompanying Texts and the Copyright-
  150.         line  s not changed.
  151.  
  152.         The Author will be neither implicitly or explicitly responsible for any 
  153.         damage done due to the use of this program. 
  154.  
  155.         FYI: This program was developed using SpeedPascal/2 ( (c) by SpeedSoft 
  156.         Gbr, Chemnitz, GER) and the OPML.
  157.  
  158.     Comments and problems by E-Mail:
  159.         Internet:   christian.biskup@bonn.netsurf.de
  160.         Compuserve: 100034,2123
  161.  
  162.  
  163. Version:
  164.         V.1.0        First Release
  165.  
  166.  
  167. with thanks to:
  168.         Ulrich Sturmberg for invaluable hints on PM-Programming.
  169.         Hugh Hayes for translating this help text.
  170.  
  171.