home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / genapps / hp22dc.arj / USRGUIDE / MSGBOX.TXT < prev    next >
Text File  |  1991-05-16  |  18KB  |  557 lines
  1.  
  2.  
  3.  
  4.  
  5.     ________________________________________________________________________
  6.                                         Chapter 15: The Message Box   277
  7.     ________________________________________________________________________
  8.  
  9.  
  10.     CHAPTER 15:  THE MESSAGE BOX
  11.  
  12.     The message box is a communication gateway between HyperPAD and you.
  13.     This chapter will explain how to use the message box to display
  14.     messages, evaluate expressions like a calculator, and execute commands.
  15.  
  16.  
  17.     DISPLAYING STATUS MESSAGES
  18.  
  19.     The message box is a window in which the pad displays status information
  20.     and other messages. For example, in the DOS pad, when you click on a
  21.     work file, HyperPAD displays a status message in the message box
  22.     indicating that it is searching for programs.
  23.  
  24.  
  25.     USING THE MESSAGE BOX AS A CALCULATOR
  26.  
  27.     The message box can also be used as a calculator. Any arithmetic
  28.     expression typed into the message box is evaluated by HyperPAD and the
  29.     result is placed in the message box.
  30.  
  31.  
  32.     USING THE MESSAGE BOX TO EXECUTE PADTALK COMMANDS
  33.  
  34.     Commands typed in the message box are immediately executed by HyperPAD.
  35.     Thus, you can observe the effects of a PADtalk command on the HyperPAD
  36.     environment immediately.
  37.  
  38.  
  39.  
  40.     ________________________________________________________________________
  41.                                         Chapter 15: The Message Box   278
  42.     ________________________________________________________________________
  43.  
  44.  
  45.     THE MESSAGE BOX IS A POPUP WINDOW
  46.  
  47.     The message box, like the tool box, is a popup window that you can
  48.     reposition anywhere on the screen using the mouse. HyperPAD remembers
  49.     the last location of the message box. So the next time you run HyperPAD,
  50.     the message box will be located in the same place.
  51.  
  52.     Below is a picture of the message box.
  53.  
  54.  ┌───────────────────────────────────────────────────────────────────────┐
  55.  │                                                                       │
  56.  │ **** The Printed Documentation has a picture or screen shot here **** │
  57.  │                                                                       │
  58.  └───────────────────────────────────────────────────────────────────────┘
  59.     
  60.  
  61.  
  62.     SHOWING THE MESSAGE BOX
  63.  
  64.     The message box can be hidden or shown while you are browsing or
  65.     designing pads. If you're designing a pad and need to perform a quick
  66.     calculation, you can show the message box, perform the calculation, and
  67.     then hide the message box before continuing to design.
  68.  
  69.     Even though the message box is visible, all painting and object tools
  70.     still function normally. If the message box is not in a convenient
  71.     position, simply use the mouse to move it to another location on the
  72.     screen.
  73.  
  74.  
  75.     To view the message box:
  76.  
  77.     1.  Select the Message Box command from the Workspace menu (ALT+W,M).
  78.     The shortcut for this command is F4.
  79.  
  80.     When the message box is displayed, the Message Box command on the
  81.     Workspace menu will be checked.
  82.  
  83.     2.  When you initially show the message box, the cursor is positioned
  84.     for you to begin typing. If you want to skip typing, press TAB to move
  85.     the focus to an object.
  86.  
  87.  
  88.  
  89.     ________________________________________________________________________
  90.                                         Chapter 15: The Message Box   279
  91.     ________________________________________________________________________
  92.  
  93.  
  94.     HIDING THE MESSAGE BOX
  95.  
  96.     When you're done with the message box, you can hide it.
  97.  
  98.  
  99.     To hide the message box with the keyboard:
  100.  
  101.     Select the Message Box command from the Workspace menu (ALT+W,M). The
  102.     shortcut for this command is F4.
  103.  
  104.     By pressing F4, you can quickly show and hide the message box.
  105.  
  106.  
  107.     To hide the message box with the mouse:
  108.  
  109.     Click on the close box in the upper left corner.
  110.  
  111.  
  112.     MOVING THE MESSAGE BOX
  113.  
  114.     You can only change the location of the message box if you have a mouse.
  115.  
  116.  
  117.     To move the message box with the mouse:
  118.  
  119.     1.  Position the mouse on one of the borders of the message box.
  120.  
  121.     2.  While pressing the left mouse button, drag the message box to a new
  122.     location.
  123.  
  124.     3.  Release the left mouse button.
  125.  
  126.  
  127.     EDITING THE MESSAGE BOX
  128.  
  129.     This section describes the message box editing keys.
  130.  
  131.         0  If the message box is not displayed, press F4 to show it. This
  132.            automatically positions the cursor within the message box ready
  133.            for you to begin typing.
  134.  
  135.         0  If the message box is already displayed, press ALT+F4 to put
  136.            the cursor in it.
  137.  
  138.         0  If you have a mouse, click in the message box to place the
  139.            cursor there.
  140.  
  141.  
  142.  
  143.     ________________________________________________________________________
  144.                                         Chapter 15: The Message Box   280
  145.     ________________________________________________________________________
  146.  
  147.  
  148.     The following table describes the editing keys available when working
  149.     with the message box.
  150.  
  151.     To:                                               Press:
  152.     ------------------------------------------------------------------
  153.     Erase the contents of the message box             CTRL+D, CTRL+Y
  154.  
  155.     Continue browsing without executing any commands  TAB
  156.  
  157.     Move the cursor to the beginning of the line      HOME
  158.  
  159.     Move the cursor to the end of the line            END
  160.  
  161.     Move the cursor left one character                Left arrow key
  162.  
  163.     Move the cursor right one character               Right arrow key
  164.  
  165.     Cycle through list of executed commands           Up/Down arrow keys
  166.  
  167.     Delete the character to the left of the cursor    BACKSPACE
  168.  
  169.  
  170.     USING THE MESSAGE BOX AS A CALCULATOR
  171.  
  172.     The message box provides a quick and easy way to perform calculations.
  173.     The result of a calculation is placed in the message box.
  174.  
  175.  
  176.     TYPING IN AN EXPRESSION
  177.  
  178.     For example, suppose you need to know the number of seconds in a day:
  179.  
  180.     1.  Press ALT+F4 to position the text cursor within the message box.
  181.  
  182.     2.  Type 60*60*24 into the message box.
  183.  
  184.     3.  Press ENTER.
  185.  
  186.     The result of the calculation (86400) will be placed in the message box.
  187.  
  188.  
  189.  
  190.     ________________________________________________________________________
  191.                                         Chapter 15: The Message Box   281
  192.     ________________________________________________________________________
  193.  
  194.  
  195.     EXPRESSION OPERATORS
  196.  
  197.     HyperPAD recognizes many operators that you can use within expressions.
  198.     The following table contains some of the more common operators and
  199.     examples of their use. (For a complete listing of operators, see the
  200.     PADtalk Reference Guide.)
  201.  
  202.     Operator:                 Example:             Result:
  203.     --------------------------------------------------------
  204.     ^ (exponentation)         2^4                  16
  205.  
  206.     / (division)              21/7                 3
  207.  
  208.     * (multiplication)        3*4                  12
  209.  
  210.     - (subtraction)           6-2                  4
  211.  
  212.     + (addition)              3+4                  7]
  213.  
  214.  
  215.     OPERATOR PRECEDENCE
  216.  
  217.     HyperPAD normally evaluates expressions from left to right. Some
  218.     operators, however, are evaluated before others. For example, the
  219.     expression 2+3*4 evaluates to 14 (not 20) because the multiplication
  220.     operator has precedence over the addition operator. The table above
  221.     listed the operators in the order of highest to lowest precedence.
  222.  
  223.     To change the order of evaluation, use parenthese:
  224.  
  225.     Expression:        Result:
  226.     ----------------------------
  227.     2+3*4              14
  228.  
  229.     (2+3)*4            20
  230.  
  231.  
  232.  
  233.     ________________________________________________________________________
  234.                                         Chapter 15: The Message Box   282
  235.     ________________________________________________________________________
  236.  
  237.  
  238.     FUNCTIONS
  239.  
  240.     HyperPAD also understands functions in expressions. For example, the
  241.     expression 5+sin(90) uses the built-in HyperPAD function called sin().
  242.     Functions often take parameters, such as the sin() function. The
  243.     following table lists a few of HyperPAD's built-in functions. (For a
  244.     complete listing, refer to the PADtalk Reference Guide.)
  245.  
  246.     Function:             Example:            Returns:
  247.     -------------------------------------------------------
  248.     sin()                 sin(90)             1
  249.  
  250.     cos()                 cos(45)             0.707107
  251.  
  252.     tan()                 tan(30)             0.57735
  253.  
  254.     directory()           directory()         "C:\HPAD2"
  255.  
  256.     diskSpace()           diskSpace()         6554012
  257.  
  258.     date()                date()              "5/12/90"
  259.  
  260.  
  261.     You can incorporate functions into your expressions, as in the following
  262.     examples:
  263.  
  264.     8 * sin(30) / .4
  265.  
  266.     diskSpace() - 35640
  267.  
  268.  
  269.     TYPING COMMANDS INTO THE MESSAGE BOX
  270.  
  271.     In addition to calculatorlike expressions, you can type commands into
  272.     the message box. Commands are actually "words" in the PADtalk vocabulary
  273.     that direct HyperPAD to perform some action. Typing commands into the
  274.     message box allows you to experiment with PADtalk and immediately
  275.     observe the effects the commands have on the HyperPAD environment.
  276.  
  277.  
  278.     To type a command into the message box:
  279.  
  280.     1.  Press ALT+F4 to position the text cursor in the message box. If the
  281.     message box is hidden, this command makes it visible.
  282.  
  283.     2.  Type your command in the message box.
  284.  
  285.     3.  Press ENTER.
  286.  
  287.     If you want to execute the same command more than once, press
  288.     CTRL+ENTER.
  289.  
  290.  
  291.  
  292.     ________________________________________________________________________
  293.                                         Chapter 15: The Message Box   283
  294.     ________________________________________________________________________
  295.  
  296.  
  297.     Since you can only enter one command at a time, there is no need to type
  298.     a semicolon at the end of the line.
  299.  
  300.     The most common PADtalk commands are described in the following section.
  301.     (For a complete listing, see the PADtalk Reference Guide.)
  302.  
  303.  
  304.     THE GO COMMAND
  305.  
  306.     You can use the go command to navigate to any other page or pad in the
  307.     HyperPAD environment. The following are examples:
  308.  
  309.     go home
  310.  
  311.     go help
  312.  
  313.     go to pad "phone"
  314.  
  315.     go to pad "ideas"
  316.  
  317.     go to page 4
  318.  
  319.     go to page "Preferences"
  320.  
  321.  
  322.     THE DIAL COMMAND
  323.  
  324.     The dial command uses a Hayes-compatible modem to dial the phone. The
  325.     following are some examples that you can type into the message box:
  326.  
  327.     dial "3154743400"
  328.  
  329.     dial "18005551212"
  330.  
  331.     When dialing the phone, HyperPAD displays a message indicating that the
  332.     phone is being dialed. After dialing is completed, a dialog box will
  333.     instruct you to pick up the phone. When you select <<Ok>>, the modem
  334.     will disconnect from the line, allowing you to talk.
  335.  
  336.  
  337.  
  338.     ________________________________________________________________________
  339.                                         Chapter 15: The Message Box   284
  340.     ________________________________________________________________________
  341.  
  342.  
  343.     THE FIND COMMAND
  344.  
  345.     The find command helps you locate information anywhere in your pad. Some
  346.     examples of what you can type into the message box are:
  347.  
  348.     find part "lawyer"
  349.  
  350.     find part "John" in field "Name"
  351.  
  352.     find whole "Smith" in field "Last Name"
  353.  
  354.     The text that you want to find is enclosed within quotes. The words
  355.     part and whole specify whether you want to find the text as part of
  356.     another word or as a whole word.
  357.  
  358.     While HyperPAD is searching, a message is displayed to indicate a find
  359.     is in progress. If the search is successful, the found text will be
  360.     highlighted. If the search is unsuccessful, HyperPAD will beep twice.
  361.  
  362.  
  363.     THE SET COMMAND
  364.  
  365.     The set command allows you to change an object's properties. Normally,
  366.     you change an object's properties using the Info dialog boxes. However,
  367.     a few object properties can only be assigned by with the set command.
  368.  
  369.  
  370.     REFERING TO AN OBJECT
  371.  
  372.     To use the set command to change a property of an object, you must
  373.     reference a specific button or field on either the page or background.
  374.  
  375.     Specifically, you need to know:
  376.  
  377.         0  The object type--whether the object is a button or a field.
  378.  
  379.         0  The ID of the object. You can determine the ID of a button or
  380.            field by looking at either the Button Info or Field Info dialog
  381.            boxes. The ID is listed below the name.
  382.  
  383.         0  Whether the object is on the page or the background.
  384.  
  385.  
  386.     To determine an object's reference information:
  387.  
  388.     1.  Use the Selector tool and TAB until the button or field you want to
  389.     change is selected.
  390.  
  391.     2.  Press ENTER to view the Info dialog box.
  392.  
  393.     Note the object's ID and position (whether the object is on the page or
  394.     background).
  395.  
  396.  
  397.  
  398.     ________________________________________________________________________
  399.                                         Chapter 15: The Message Box   285
  400.     ________________________________________________________________________
  401.  
  402.  
  403.     ALIGNING A BUTTON'S NAME
  404.  
  405.     The Align property determines whether a button's name is aligned left,
  406.     right, or centered. For fields, this property is set from the Field Info
  407.     dialog box. For buttons, however, this property can only be assigned
  408.     with the set command.
  409.  
  410.  
  411.     To change the alignment of the button's name:
  412.  
  413.     1.  Press ALT+F4 to edit the contents of the message box.
  414.  
  415.     2.  Type one of the following commands replacing the number 4 with the
  416.     ID of your button. Replace the word "page" with "background" if the
  417.     button is on the background:
  418.  
  419.     set the align of page button id 4 to left
  420.  
  421.     set the align of page button id 4 to right
  422.  
  423.     set the align of page button id 4 to centered
  424.  
  425.  
  426.     LOCK TEXT (BUTTONS)
  427.  
  428.     The Lock Text property specifies whether an object can be given the
  429.     focus. Locked buttons cannot be clicked on with the mouse or highlighted
  430.     using the TAB key. Locked fields cannot be edited or scrolled.
  431.  
  432.     For fields, this property is set from the Field Info dialog box. For
  433.     buttons, however, this property can only be set from the message box.
  434.  
  435.  
  436.     To change the Lock Text property of a button:
  437.  
  438.     1.  Press ALT+F4 to edit the contents of the message box.
  439.  
  440.     2.  Type in a command similar to one of the following:
  441.  
  442.     set the lockText of page button 4 to true
  443.  
  444.     set the lockText of background button 4 to true
  445.  
  446.  
  447.     THE HIDE AND SHOW COMMANDS
  448.  
  449.     Buttons and fields are normally visible, allowing users to TAB to
  450.     different objects; type into fields, and select buttons.
  451.  
  452.     The hide command makes an object invisible on the page or background.
  453.     However, the hide command doesn't delete the object, it simply hides it
  454.     from view. The show command makes the hidden object visible.
  455.  
  456.  
  457.  
  458.     ________________________________________________________________________
  459.                                         Chapter 15: The Message Box   286
  460.     ________________________________________________________________________
  461.  
  462.  
  463.     In the Phone pad, for example, you may not have an immediate need for
  464.     the Fax Phone field, but you want to keep it around for future use.
  465.     Instead of deleting the field, simply hide it.
  466.  
  467.  
  468.     To hide a button or field:
  469.  
  470.     1.  Press ALT+F4 to activate the message box.
  471.  
  472.     2.  For buttons, type one of the following commands, replacing the
  473.     number 4 with the ID of your button:
  474.  
  475.     hide page button id 4
  476.  
  477.     hide background button id 4
  478.  
  479.     For fields, type one of the following commands:
  480.  
  481.     hide page field id 4
  482.  
  483.     hide background field id 4
  484.  
  485.  
  486.     To show a button or field:
  487.  
  488.     show page button id 4
  489.  
  490.     show background field id 4
  491.  
  492.  
  493.     ADVANCED COMMANDS
  494.  
  495.     Use the following examples to perform advanced functions with the
  496.     message box. You can enhance these commands with skills learned in this
  497.     chapter. In some cases, you'll need to replace the information contained
  498.     in the command with data specific to your pad.
  499.  
  500.     Each command can be typed into the message box and executed by pressing
  501.     ENTER. If the command is longer than the width of the message box, the
  502.     message box will scroll horizontally to accommodate a longer line.
  503.  
  504.  
  505.     To hide all of the buttons on a page:
  506.  
  507.     for i = 1 to the number of page buttons do hide page button i
  508.  
  509.  
  510.     To sort the pad using a field as a sort key:
  511.  
  512.     sort by field 1
  513.  
  514.  
  515.  
  516.     ________________________________________________________________________
  517.                                         Chapter 15: The Message Box   287
  518.     ________________________________________________________________________
  519.  
  520.  
  521.     To run another program:
  522.  
  523.     run "c:\word5\word"
  524.  
  525.     To place a bookmark on the current page:
  526.  
  527.     push this page
  528.  
  529.  
  530.     To return to a bookmarked page:
  531.  
  532.     pop page
  533.  
  534.  
  535.     To display a Show Partner F/X presentation:
  536.  
  537.     fxshow "C:\FX\SHOWS\ANIMATE.PRO"
  538.  
  539.  
  540.     To change the location of the message box:
  541.  
  542.     set the location of the message box to 4,4
  543.  
  544.  
  545.     CONCLUSION
  546.  
  547.     This chapter introduced the message box, the gateway between you and
  548.     HyperPAD. You've learned how to display the message box, move it around
  549.     the screen using a mouse, and hide it when you'rr done. The message box
  550.     can be used as a calculator or as a way of immediately executing
  551.     statements so that you can observe their effects on the HyperPAD
  552.     environment.
  553.  
  554.     This chapter also introduced you to some PADtalk commands that you can
  555.     use from the message box. You were shown how to modify object properties
  556.     that don't appear in the Info dialog boxes by using these commands.
  557.