home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 16 Announce / 16-Announce.zip / custctrl.txt < prev    next >
Text File  |  1995-08-06  |  9KB  |  204 lines
  1.  
  2. ObjectPM Custom Control Pack Description
  3. ========================================
  4.  
  5. (Extracted from the Secant's WWW Home Page: http://www.secant.com)
  6.  
  7. The Custom Control Pack provides a set of controls that do not exist 
  8. in OS/2 itself.  Some of these controls build upon familiar OS/2 
  9. controls and some are completely new.  All of the controls are 
  10. supported by Prominare Designer and the forthcoming Universal 
  11. Resource Editor from IBM (the next generation resource editor).  
  12. Each control has an implementation for ObjectPM, Borland's OWl and 
  13. IBM's ICLUI class libraries as well as a C interface.  If you 
  14. purchase ObjectPM, the ObjectPM implementations are automatically 
  15. included.  These controls are just a start, so look for more in the 
  16. future!
  17.  
  18. The following is a description of the controls included in the pack.  
  19. Click on the control name to see a screenshot of that control.
  20.  
  21.  
  22. SpreadSheet
  23. -----------
  24.  
  25.     The SpreadSheet control consists of rows and columns of cells, 
  26.     just like your favorite spreadsheet program. Each cell has a 
  27.     number of attributes associated with it including text color and 
  28.     font, fillpattern, borders and alignment, which can be changed.  
  29.     The rows and columns have headers on them which can be hidden 
  30.     and whose text can be changed. The rows and columns can be sized 
  31.     or hidden, resulting in all the cells in the row or column 
  32.     having their size changed or geing hidden. The cells contain 
  33.     textual data which can be directly edited.  No formula 
  34.     processing is provided by the control.  Rather, it is up to the 
  35.     programmer to add additional functionality.
  36.  
  37.  
  38. Calendar
  39. --------
  40.  
  41.     The Calendar control displays a calendar, one month at a time, 
  42.     allowing a user to click on a day to select it or to flip 
  43.     between months and years.  You can manipulate the calendar in a 
  44.     number of ways.  Days can be disabled, hidden, replaced by 
  45.     bitmaps or have their color set.  Additionally, you can specify 
  46.     a range of valid dates and the control will automatically 
  47.     disable dates before and after those specified.  The weekday 
  48.     names can be changed, have their color set or replaecd by 
  49.     bitmaps.  You can set a list of special dates (such as holidays, 
  50.     bithdays, etc) which have their color changed, etc. This control 
  51.     is very useful when you need to prompt the user for a valid 
  52.     date, as all validation is done for you and you can limit the 
  53.     users choices by setting a range.
  54.  
  55.  
  56. DateComboBox
  57. ------------
  58.  
  59.     The DateComboBox control combines the functionality of a 
  60.     standard OS/2 combo box and the new Calendar control, allowing a 
  61.     user to "drop-down" a calendar and pick a day.  It supports the 
  62.     simple and drop-down-list styles of a normal combo box control, 
  63.     but replaces the list of choices with a calendar.  The drop-down 
  64.     list style is particularly useful, as it saves space on a 
  65.     crowded dialog by only displaying the calendar when the user is 
  66.     making a choice.
  67.  
  68.  
  69. CellBox
  70. -------
  71.  
  72.     The CellBox control provides enhancements, including multiple 
  73.     columns and colors, to the standard PM List Box. Each row of the 
  74.     wCellBox consists of a number of cells, forming columns within 
  75.     the wCellBox.  Text can be placed into these cells and can also 
  76.     be assigned different colors and attributes.  Rows can be 
  77.     underlined and columns rightscored and bitmaps and icons can be 
  78.     placed in the cells. In addition, multiple column "groups" can 
  79.     be created, each having their own set of subcolumn definitions.  
  80.     This is useful, for instance, for creating a title row that 
  81.     spans multiple subcolumns.  You would create 2 column groups, 1 
  82.     with 1 subcolumn 75 units wide and another with 3 subcolumns of 
  83.     25 units.
  84.  
  85.  
  86. CellComboBox
  87. ------------
  88.  
  89.     The CellComboBox control is another one which combines the 
  90.     functionality of a normal OS/2 comobo box with a new control - 
  91.     in this case the CellBox.  Using this control, you can create a 
  92.     multi-column listbox that "drops-down" instead of the usual 
  93.     single-column OS/2 list box (of course you could still use it 
  94.     with only a single column).  Additionaly, the CellComboBox 
  95.     supports multiple selection, allowing a user to select multiple 
  96.     items from the list and having them be displayed as a 
  97.     comma-separated list in the edit field portion of the control.
  98.  
  99.  
  100. ControlList
  101. -----------
  102.  
  103.     The ControlList control "contains" other controls, allowing them 
  104.     to be scrolled.  This allows a larger number of controls to fit 
  105.     in an area than otherwise would be possible.  The control 
  106.     displays a title and controls in a two-column format with the 
  107.     title on the left.  With the ControlList, you can create 
  108.     a scrollable list of "options", using edit fields, checkboxes, 
  109.     etc (possibly for a setup program or questionaire).
  110.  
  111.  
  112. RTFViewer
  113. ---------
  114.  
  115.     The RTFViewer control is a displayer/printer for Rich Text 
  116.     Format (RTF) files.  RTF is a tagged file format which preserves 
  117.     character, paragraph, and document formatting such as bold, 
  118.     italic, left indent, page size, etc. It is an optional output 
  119.     format for many word processors.  With this control, you can 
  120.     create highly formatted documents from other programs and use 
  121.     this control to view and print them.  It currently supports most 
  122.     of the RTF spec including tables, headers/footers, stylesheets, 
  123.     multiple fonts, character formatting, left/right/first paragraph 
  124.     indents, etc.  It currently does not support multiple snaking 
  125.     columns, left/right/first page formatting differences, footnotes 
  126.     or multipe sectioned documents but that will change in the 
  127.     future as it is updated.
  128.  
  129.  
  130. Thermometer
  131. -----------
  132.  
  133.     The Thermometer control is a static slider-like control that 
  134.     displays a numeric value as mercury in a thermometer.  You can 
  135.     set the indicator color and title text, as well as the range, 
  136.     tick marks and tick mark text.
  137.  
  138.  
  139. SplitBar
  140. --------
  141.  
  142.     The SplitBar control is rather simple.  It is displayed as a 
  143.     vertical or horizontal bar that you can click and drag around a 
  144.     window.  When you release the mouse button, it notifies its 
  145.     owner of the move, allowing the owner to update sizes and 
  146.     positions of other windows.
  147.  
  148.  
  149. GIFImage
  150. --------
  151.  
  152.     The GIFImage loads a ".GIF" file and converts it to a bitmap for 
  153.     displaying or manipulating.  The ObjectPM, OWL, and ICLUI 
  154.     implentations derive from their respective bitmap or (bitmap 
  155.     handle) classes, allowing a GIF to be treated as a bitmap 
  156.     object.  The C interface loads a GIF file and returns a bitmap 
  157.     handle for displaying and manipulating.
  158.  
  159.  
  160. GIFControl
  161. ----------
  162.  
  163.     The GIFControl custom control is a static control like the 
  164.     bitmap or icon static controls.  By specifying the name of a 
  165.     ".GIF" file as the text of the control (Using WinSetText or 
  166.     equivalent class method call), it will load and display it.  The 
  167.     control shrinks to wrap around the image it is displaying.
  168.  
  169.  
  170. Formatted Data Entry Control
  171. ----------------------------
  172.  
  173.     The DataField control is an extension of the standard OS/2 PM 
  174.     single line entry control.  It adds the ability to do masks, as 
  175.     well as using a buffer to store and retrieve data in its native 
  176.     type.  For example, you can specify a mask of "(999) 999-9999" 
  177.     and a character buffer to prompt a user for a telephone number.  
  178.     To prompt for a date, you could either use a character buffer 
  179.     and "99-99-9999" as a mask, or a BDATE and "%m-%d-%y" to 
  180.     automatically generate a mask for month, day and year.  In this 
  181.     scenario, the data buffer would be a BDATE structure which would 
  182.     be filled in for you.  You can use a "long" as a buffer and 
  183.     specify all numeric input, in which case the Convert() and 
  184.     Update() methods would store and retrieve the user input in a 
  185.     "long" instead of requiring you to do the conversion yourself. 
  186.  
  187.  
  188. If you are already own one of our products and need support, send 
  189. your question/comment to support@secant.com and we will reply as 
  190. soon as possible.
  191.  
  192. If you would like additional information on any of our products or 
  193. services, send a message to info@secant.com.
  194.  
  195. email to:   info@secant.com
  196. Web page:   http://www.secant.com
  197.  
  198.  
  199. -------
  200.  
  201. * GIF and 'Graphics Interchange Format'are trademarks (tm)
  202.     of Compuserve, Incorporated, an H&R Block Company.
  203.  
  204.