home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 18 REXX / 18-REXX.zip / vxcliser.zip / VXREXX.2 / MACROS / PROFILE.VRM < prev    next >
Text File  |  1994-12-23  |  4KB  |  96 lines
  1. /*
  2.     Profile.VRM
  3.     ===========
  4.  
  5.     Sample profile macro for VX-REXX version 2.1
  6.  
  7.     The VX-REXX profile macro is executed when VX-REXX is
  8.     started.  It must be located in the Macros directory under
  9.     the VX-REXX directory.
  10.  
  11.     The Macros directory contains a number of sample macros and,
  12.     where appropriate, their source.  The macros are briefly
  13.     described below.  To use these macros uncomment the calls
  14.     to VREMacroAdd.
  15.  
  16.     For more information on writing macros see the Programmer's
  17.     Guide and the file MACROS.TXT in the Macros directory.
  18. */
  19.  
  20.  
  21. /*  The profile is passed a single argument, the internal name (handle) 
  22.     of the primary VX-REXX window.  You should use this as the
  23.     parent of any dialogs you create in the profile.
  24. */    
  25.     parse arg parent
  26.  
  27. /*  Property editor
  28.     ---------------
  29.     The property editor allows you to edit the properties of one or
  30.     more objects without using their property notebooks.  This allows you
  31.     to quickly edit one property on a number of objects, or set a property 
  32.     to the same value on a number of objects at once.  It also provides
  33.     the ability to edit longer text items, such as HelpText, in a
  34.     multiple line entry field.
  35.  
  36.     For example, to edit all of the hints on a window:
  37.  
  38.     a) Select the objects you wish to edit.
  39.     b) Invoke the "Set properties" macro.
  40.     c) From the Property list select the HintText item.
  41.     d) Type the hint for the current object and press Enter.
  42.     e) Enter the next hint ... and so on.
  43.  
  44.     Note: The "Set all" push button is only enabled if all selected objects
  45.     are the same type (e.g. all PushButtons).
  46. */
  47.  
  48. /*  call VREMacroAdd "Property editor...", "SetProps.VRM" */
  49.  
  50.  
  51. /*  Match sizes
  52.     -----------
  53.     The match sizes macro sets the size of all selected objects to the
  54.     size of the object from which the macro was invoked.  A typical
  55.     use is to force a number of push buttons to the same size.
  56. */
  57.  
  58. /*  call VREMacroAdd "Match sizes", "Resize.VRM" */
  59.  
  60.  
  61. /*  Object list
  62.     -----------
  63.     The object list macro can be used to discover and change
  64.     objects that cannot be directly manipulated (either because they
  65.     are too small or because they are behind another object).  When
  66.     invoked the macro displays a list of all the objects on the window.
  67.     You can then select one or more objects and open the property
  68.     notebook for each.
  69. */
  70.  
  71. /*   call VREMacroAdd "Object list...", "ObjList.VRM", "Window" */
  72.  
  73.  
  74. /*  Generate code
  75.     -------------
  76.     The following two macros can be used to access the
  77.     automatic code generation dialogs of VX-REXX when using
  78.     an external editor.  (The drag and drop programming feature only
  79.     works with the built-in editor).  The generated code is inserted
  80.     into the OS/2 clipboard, and can be inserted into an external
  81.     editor with its "Paste" command (Shift+Insert).
  82.  
  83.     The first macro invokes the general code insertion dialog (the
  84.     dialog invoked from the "Insert code" menu item in the built-in
  85.     editor).  The second macro invokes the object-specific dialog (the
  86.     dialog invoked when you drag an object onto a built-in editor).
  87.  
  88.     Note: The "Paste block" menu item in the Enhanced Editor (EPM)
  89.     maintains a uniform indent when pasting several lines of code.
  90. */
  91.  
  92. /*  call VREMacroAdd "Generate code...", "GenCodeG.VRM", "Window" */
  93. /*  call VREMacroAdd "Generate object code...", "GenCodeO.VRM" */
  94.  
  95.  
  96.