home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / zincdemo.zip / ZINCDEMO / ZINCPOST.DAT (.txt) < prev   
Zinc Data  |  1993-03-26  |  94KB  |  636 lines

  1. Zinc Data File Version 3.0
  2. )oTz+
  3. UIW_WINDOW
  4. UI_BITMAP
  5. UI_ICON+
  6. UI_HPP,
  7. UI_HELPo
  8. DERIVE_TABLE
  9. hardDrive
  10. softDrive
  11. networkDrive
  12. string    
  13. fmtstr
  14. number
  15. button
  16. radio
  17. check
  18. hlist
  19. APPLICATION$
  20. EXCLAMATION%
  21. HAND'
  22. minIcon)
  23. analog*
  24. wdesign(
  25. desk&
  26. QUESTION#
  27. ASTERISK
  28. gTz+gTz+2
  29. vlist
  30. combo
  31. hscroll
  32. vscroll
  33. toolbar
  34. prompt
  35. group
  36. parentDirectory
  37. childDirectory
  38. popitem
  39. popmenu
  40. pllitem 
  41. pllmenu!
  42. window
  43.                     
  44.                                     
  45.                                     
  46.                     
  47.                                                                                                                     
  48.                                                                                                                     
  49.                                                                                                                     
  50. HELP_CONTEXTS
  51. HELP_ORDER_INFORMATION/
  52. HELP_GENERAL0
  53. HELP_STRING1
  54. HELP_FORMATTED_STRING2
  55. HELP_TEXT3
  56. HELP_DATE4
  57. HELP_TIME5
  58. HELP_BIGNUM6
  59. HELP_BUTTON7
  60. HELP_RADIO_BUTTON8heck Box Help...[
  61. const UI_HELP_CONTEXT INFO_HLIST                       = 0x002D; // Horizontal List Help...Y
  62. const UI_HELP_CONTEXT INFO_VLIST                       = 0x002E; // Vertical List Help...U
  63. const UI_HELP_CONTEXT INFO_COMBO_BOX                  26; // Text Help...P
  64. const UI_HELP_CONTEXT INFO_DATE                        = 0x0027; // Date Help...P
  65. const UI_HELP_CONTEXT INFO_TIME                        = 0x0028; // Time Help...R
  66. const UI_HELP_CONTEXT INFO_BIGNUM                      = 0x0029; // Numix character mode, Apple Macintosh, and Novell NLM.
  67. You may freely copy and distribute this demonstration program as long as it is distributed with all original files and copyright information.
  68. Zinc is a registered trademark and Zinc Application Framluding: input fields, icons and buttons.
  69. A compare function may be added in the argument list to sort list elements.
  70. Constructor => UIW_HZ_LIST(left, top, width, height, cell width, cell Height, compare function, list flags, window flags, advanced flGeneral Help...R
  71. const UI_HELP_CONTEXT INFO_STRING                      = 0x0024; // String Help...\
  72. const UI_HELP_CONTEXT INFO_FORMATTED_STRING            = 0x0025; // Formatted String Help...P
  73. const UI_HELP_CONTEXT INFO_TEXT                        = 0x00<Alt+F4> to continue...
  74. General Help...
  75. Welcome to this demonstration of Zinc Application Framework 3.5.  Zinc 3.5 is an object-oriented, multiplatform development tool.  Zinc supports Microsoft Windows and Windows NT, IBM OS/2, OSF/Motif, DOS Text and DOS Graphics (in real or protected mode), and CIC PenDOS with one set of source code.  (NOTE: This demo, recompiled for each platform, can be downloaded free of charge from Zinc's BBS (801-785-8997 or +44(0)81 317 2310 in Europe, 1200-9600, 8, N, 1).
  76. This demonstration program features all of the window objects that are provided with Zinc Application Framework.  If you select an object from the menu, the tool bar, or the vertical list, example(s) of the object will appear in the upper right corner of the display area.  Informat     = 0x0012; // Pull-down Menu Item Help...W
  77. const UI_HELP_CONTEXT HELP_POP_UP_MENU                 = 0x0013; // Pop-up Menu Help...\
  78. const UI_HELP_CONTEXT HELP_POP_UP_MENU_ITEM            = 0x0014; // Pop-up Menu Item Help...T
  79. const UI_HELP_CONTEXT HELPser functions receive messages from Zinc and can be executed when PULL DOWN MENU ITEM is selected, becomes current and/or becomes non-current.
  80. Constructor => UIW_PULL_DOWN_ITEM(text, menu flags, user function, programmer assigned value)
  81. Press <Alt+F4ontal List Help...Y
  82. const UI_HELP_CONTEXT HELP_VLIST                       = 0x000D; // Vertical List Help...U
  83. const UI_HELP_CONTEXT HELP_COMBO_BOX                   = 0x000E; // Combo-Box Help...V
  84. const UI_HELP_CONTEXT HELP_SCROLL_BAR                  = 0
  85. Constructor => UIW_STRING(left, top, width, text, maximum length, string flags, window flags, user function)
  86. Press <Alt+F4> to continue...
  87.  = 0x002F; // Combo-Box Help...V
  88. const UI_HELP_CONTEXT INFO_SCROLL_BAR                  = 0x0030; // Scroll-Bar Help...R
  89. const UI_HELP_CONTEXT INFO_WINDOW                      = 0x0031; // Window Help...Z
  90. const UI_HELP_CONTEXT INFO_PULL_DOWN_MENU          x000F; // Scroll-Bar Help...R
  91. const UI_HELP_CONTEXT HELP_WINDOW                      = 0x0010; // Window Help...Z
  92. const UI_HELP_CONTEXT HELP_PULL_DOWN_MENU              = 0x0011; // Pull-down Menu Help..._
  93. const UI_HELP_CONTEXT HELP_PULL_DOWN_ITEM         r function or validation routine by adding the name of the function to the argument list of the constructor (shown below).  User functions receive messages from Zinc and can be executed when DATE is selected, becomes current and/or becomes non-current.
  94. p...X
  95. const UI_HELP_CONTEXT HELP_RADIO_BUTTON                = 0x000A; // Radio Button Help...U
  96. const UI_HELP_CONTEXT HELP_CHECK_BOX                   = 0x000B; // Check Box Help...[
  97. const UI_HELP_CONTEXT HELP_HLIST                       = 0x000C; // Horizwindow flags, user function)
  98. Press <Alt+F4> to continue...
  99. Formatted String Help...%
  100. FORMATTED STRING is used to enter, modify and display alphanumeric information in a pre-defined format that you specify (e.g., phone number, part number, serial number).
  101. FORMATTED STRING allows you to perform edit functions such as mark, cut, copy and paste both within the formatted string itself and among any other edit object (e.g., number, text, date).
  102. You may associate a user function or validation routine by adding the name of the function to the argument list of the constructor (shown below).  User functions receive messages from Zinc and can be executed when FORMATTED STRING is selected, becomes current and/or becomes non-current.
  103. Constructor => UIW_FORMATTED_STRING(left, top, width, text, edit mask, literal mask, left, top, width, height, text, maximum length, text flags, window flags, user function)
  104. Press <Alt+F4> to continue...
  105. Text Help...m
  106. TEXT is used to enter, modify and display multiple-line text information.  It features mark, cut, copy, paste, optional word wrap, home, end, page-up, page-down, word-left, word-right, etc.
  107. You may associate a user function or validation routine by adding the name of the function to the argument list of the constructor (shown below).  User functions receive messages from Zinc and can be executed when TEXT is selected, becomes current and/or becomes non-current.
  108. Constructor => UIW_TEXT(Constructor => UIW_DATE(left, top, width, date, range, date flags, window flags, user function)
  109. Press <Alt+F4> to continue...
  110. data structure.  If the resource is large then performance can be affected when accessing objects at the end of the stream.  Zinc POST resources use a high-performance, Unix-like directory structure which allows you to create very large resources without ssor devices.
  111.      UI_EVENT_MANAGER *eventManager =
  112.      new UI_EVENT_MANAGER(display);
  113.      *eventManager
  114.           + new UID_KEYBOARD
  115.           + new UID_PENDOS
  116.           + new UID_CURSOR;
  117. Press <Alt+F4> to continue...
  118.  US, Germany, United Kingdom, France, Italy, Sweden, Canada, Mexico and Brazil.
  119. Press <Alt+F4> to continue...
  120. re, documentation and Zinc's technical support.  If you aren't satisfied for any reason, simply return the product for a full refund of the purchase price.  (NOTE: Your reseller may have a different return policy--please check with your reseller before your => UIW_TIME(left, top, width, time, range, time flags, window flags, user function)
  121. Press <Alt+F4> to continue...
  122. Time Help...j
  123. TIME is used to enter, modify and display country-independent time information.  13 time specific flags determine the appropriate display formatting, including: colon separator, zero fill, hours, minutes, seconds, 12 Hour, 24 Hour, upper case and lower case.
  124. TIME examines the country information provided by the operating system to display the appropriate format.  For example, the time 3:25pm will display as 15:25 if a European country code is detected.
  125. You may associate a user function or validation routine by adding the name of the function to the argument list of the constructor (shown below).  User functions receive messages from Zinc and can be executed when TIME is selected, becomes current and/or becomes non-current.
  126. Constructogs, window flags, user function)
  127. Press <Alt+F4> to continue...
  128. Number Help...3
  129. BIGNUM is used to enter, modify and display country-independent numeric information.  BIGNUM has a default maximum value of 30 digits to the left and 8 digits to the right of the decimal.  Six number flags determine how the number is displayed, including: currency, credit ( ), commas, decimal (0 to 8 places) and percent.
  130. BIGNUM examines the country information provided by the operating system to display the appropriate format.  For example, $100.00 (US) will display as DM100.00 if the German country code is detected.
  131. NOTE: Zinc 3.5 also provides INTEGER and REAL objects for more specific numeric processing.
  132. You may associate a user function or validation routine by adding the name of the function to the argument list of the constructor (shown below).  User functions receive messages from Zinc and can be executed when BIGNUM, REAL or INTEGER is selected, becomes current and/or becomes non-current.
  133. Constructor => UIW_BIGNUM(left, top, width, number, list of valid ranges, number fla <Alt+F4> to continue...
  134. Persistent Objects Help...*
  135. POST (Persistent Object Storage Technology) resources in Zinc 3.5 dramatically improve your productivity by allowing you to store windows and window objects in a platform-independent data file.  Objects that you create and sto
  136. Button Help...
  137. BUTTON is a selectable field used to perform run-time operations. You may attach a bitmap to customize the button.
  138. You may associate a user function or validation routine by adding the name of the function to the argument list of the c#
  139. Zi    = 0x0032; // Pull-down Menu Help...W
  140. const UI_HELP_CONTEXT INFO_POP_UP_MENU                 = 0x0033; // Pop-up Menu Help...\
  141. const UI_HELP_CONTEXT INFO_POP_UP_MENU_ITEM            = 0x0034; // Pop-up Menu Item Help...T
  142. const UI_HELP_CONTEXT INFO_TOOL_TTON(left, top, width, button text, BTF_RADIO_BUTTON, window flags, user function, programmer assigned value, bitmap name)
  143. Press <Alt+F4> to continue...
  144. Radio Button Help...
  145. RADIO BUTTON is a button control that allows only one item in a group to be selected.  RADIO BUTTON is a button with the BTF_RADIO_BUTTON button flag used in the argument list.
  146. You may associate a user function or validation routine by adding the name of the function to the argument list of the constructor (shown below).  User functions receive messages from Zinc and can be executed when RADIO BUTTON is selected, becomes current and/or becomes non-current.
  147. Constructor => UIW_BU
  148. HELP_CHECK_BOX9
  149. HELP_HLIST:
  150. HELP_VLIST;
  151. HELP_COMBO_BOX<
  152. HELP_SCROLL_BAR=
  153. HELP_WINDOW>
  154. HELP_PULL_DOWN_MENU?
  155. HELP_PULL_DOWN_ITEM@
  156. HELP_POP_UP_MENUA
  157. HELP_POP_UP_MENU_ITEMB
  158. , width, button text, BTF_CHECK_BOX, window flags, user Function, programmer assigned value, bitmap name)
  159. Press <Alt+F4> to continue...
  160. Check Box Help...y
  161. CHECK BOX is a button control that allows multiple items in a group to be selected.  CHECK BOX is a button with the BTF_CHECK_BOX button flag used in the argument list.
  162. You may associate a user function or validation routine by adding the name of the function to the argument list of the constructor (shown below).  User functions receive messages from Zinc and can be executed when CHECK BOX is selected, becomes current and/or becomes non-current.
  163. Constructor => UIW_BUTTON(left, topags)
  164. Press <Alt+F4> to continue...
  165.                     = 0x0038; // Icon Help...T
  166. const UI_HELP_CONTEXT INFO_KEYBOARD                    = 0x0039; // Keyboard Help...Q
  167. const UI_HELP_CONTEXT INFO_MOUSE                       = 0x003A; // Mouse Help...Z
  168. const UI_HELP_CONTEXT INFO_WINDOW_MANAGEnu option.
  169. This program does not demonstrate the features of Zinc's interactive design tool, Zinc Designer.  Zinc Designer runs on each target platform and allows you to interactively design your application windows and window objects.  Zinc POST (Persiion on the object appears in the text field immediately below the object.  If you press F1, additional information including the constructor will appear in a help window.  The entire class hierarchy can be viewed by selecting the "Help, Class hierarchy" meue...
  170. Vertical List Help...
  171. VERTICAL LIST is used to enter, modify and display related information in a vertical list format.  You can add a scroll bar to vertically scroll the list.  A wide variety of window objects can be placed in VERTICAL LIST, including: input fields, icons and buttons.
  172. A compare function may be added in the argument list to sort list elements.
  173. Constructor => UIW_VT_LIST(left, top, width, height, compare function, list flags, window flags, advanced flags)
  174. Press <Alt+F4> to contin width, height, compare function, list flags, window flags, advanced flags) 
  175. Press <Alt+F4> to continue...
  176. Combo-Box Help...Z
  177. COMBO BOX is a combination input field and vertical list.  COMBO BOX can contain input fields, icons and buttons.
  178. A compare function may be added in the argument list to sort list elements.
  179. Constructor => UIW_COMBO_BOX(left, top,ntinue...
  180. _TOOL_BAR                    = 0x0015; // Tool-Bar Help...R
  181. const UI_HELP_CONTEXT HELP_PROMPT                      = 0x0016; // Prompt Help...Q
  182. const UI_HELP_CONTEXT HELP_GROUP                       = 0x0017; // Group Help...P
  183. const UI_HELP_CONTEXT HELP_IC
  184. General Help...B
  185. Zinc Application Framework 3.5
  186. Demonstration Program
  187. Press <F1> for General Help information
  188. You may freely copy and distribute this demonstration program as long as it is distributed with all original files and copyright informat flags, help context)
  189. Press <Alt+F4> to continue...
  190. Window Help...(
  191. WINDOW is a rectangular region of the display used as the controlling structure for window objects.  Zinc supports parent, child, MDI, modal and dialog windows.
  192. Constructor => UIW_WINDOW(left, top, width, height, window flags, advanced
  193. Pull-down Menu Help...
  194. PULL DOWN MENU is used to organize and control pull-down menu items (PULL DOWN ITEMS).
  195. Constructor => UIW_PULL_DOWN_MENU(indentation, item)
  196. Press <Alt+F4> to continue...
  197. > to continue...
  198.      Pleasant Grove, Utah 84062 USA
  199.      Tel: (801) 785-8900
  200.      Fax: (801) 785-8996
  201.      BBS: (801) 785-8997
  202. For more information or to order in Europe, please call or write:
  203.      Zinc Software (UK) Limited
  204.      58-60 Beresford Street
  205.      London, SE18 6BG United Kingdom
  206.      Tel: +44 (0)81 855 9918
  207.      Fax: +44 (0)81 316 7778
  208.      BBS: +44 (0)81 317 2310
  209. Press <Alt+F4> to continue...
  210. tecture, multiplatform issues, and object-oriented programming techniques such as message processing, callback functions, and deriving objects from Zinc's base classes.
  211. Zinc offers a 60-day money-back period during which time you can evaluate the softwa
  212. Pop-up Menu Help...
  213. POP UP MENU is used to organize and control pop-up menu items. POP UP MENUS are also used for cascading menus.
  214. Constructor => UIW_POP_UP_MENU(left, top, menu flags, item)
  215. Press <Alt+F4> to continue...
  216. nue...
  217. Pop-up Menu Item Help...
  218. POP UP MENU ITEM is used to select a specific action from a pop-up menu.
  219. You may associate a user function or validation routine by adding the name of the function to the argument list of the constructor (shown below).  User functions receive messages from Zinc and can be executed when POP UP MENU ITEM is selected, becomes current and/or becomes non-current.
  220. Constructor => UIW_POP_UP_ITEM(text, menu flags, user function, programmer assigned value)
  221. Press <Alt+F4> to conti
  222. HELP_TOOL_BARC
  223. HELP_PROMPTD
  224. HELP_GROUPE
  225. HELP_ICONF
  226. HELP_KEYBOARDG
  227. HELP_MOUSEH
  228. HELP_WINDOW_MANAGERI
  229. HELP_EVENT_MANAGERJ
  230. HELP_SCREEN_DISPLAYK
  231. HELP_HELP_SYSTEML
  232. HELP_ERROR_SYSTEBAR(left, top, width, height, tool bar flags, window flags, advanced flags)
  233. Press <Alt+F4> to continue...
  234. R              = 0x003B; // Window Manager Help...Y
  235. const UI_HELP_CONTEXT INFO_EVENT_MANAGER               = 0x003C; // Event Manager Help...Z
  236. const UI_HELP_CONTEXT INFO_SCREEN_DISPLAY              = 0x003D; // Screen Display Help...W
  237. const UI_HELP_CONTEXTre in one environment can be retrieved at run-time into any other environment that Zinc supports.
  238. Some class libraries provide a type of object persistence.  However these products use the concept of streamable objects, which is essentially a flat-file 
  239. Prompt Help...
  240. PROMPT is a static control that is used to provide the user with information regarding input fields and program activity.
  241. Constructor => UIW_PROMPT(left, top, text, window flags)
  242. Press <Alt+F4> to continue...
  243. Group Help...
  244. GROUP is a static control that is used to group radio buttons and check boxes.
  245. Constructor => UIW_GROUP(left, top, width, height, text, group flags, window flags)
  246. Press <Alt+F4> to continue...
  247. ue...
  248. ere spaces are converted to the underscore character).
  249. Zinc strings allow you to perform edit functions such as mark, cut, copy and paste both within the string itself and among any other edit object (e.g., number, text, date).
  250. You may associate a usework, Zinc Designer, and Zinc POST are trademarks of Zinc Software Incorporated. All other trademarks or tradenames used herein are owned by their respective companies.
  251. COPYRIGHT (C) 1990-1993 Zinc Software Incorporated.  All Rights Reserved.
  252. Press EVENT_MANAGER(display);
  253.      *eventManager
  254.           + new UID_KEYBOARD
  255.           + new UID_MOUSE
  256.           + new UID_CURSOR;
  257. Press <Alt+F4> to continue...
  258. Keyboard Help...
  259. KEYBOARD is used to collect information from the keyboard.  It is attached to a list that is maintained by the Event Manager (see Event Manager).  The KEYBOARD feeds information to the Event Queue when polled by the Event Manager.
  260. The KEYBOARD is attached to the Event Manager at run-time using the Add member function or the overloaded '+' operator:
  261. // Initialize the event manager and attach the keyboard, mouse and cursor devices.
  262.      UI_EVENT_MANAGER *eventManager =
  263.      new UI_ay);
  264.      *eventManager
  265.           + new UID_KEYBOARD
  266.           + new UID_MOUSE
  267.           + new UID_CURSOR;
  268. Press <Alt+F4> to continue...
  269. Mouse Help...
  270. MOUSE is used to collect information from a mouse input device. It is attached to a list which is maintained by Zinc's Event Manager (see Event Manager).  The MOUSE feeds input information directly to the Event Queue.
  271. The MOUSE is attached to the Event Manager at run-time using the Add member function or the overloaded '+' operator:
  272. // Initialize the event manager and attach the keyboard, mouse and cursor devices.
  273.      UI_EVENT_MANAGER *eventManager =
  274.      new UI_EVENT_MANAGER(displ UIW_WINDOW("FILENAME~WINDOW1");
  275. Press <Alt+F4> to continue...
  276. Tool-Bar Help...\
  277. TOOL BAR is a menu control used to group buttons, icons, and input fields.  A tool bar can be static or wrapped when re-sizing the window.  It can be independent of or used in conjunction with PULL DOWN MENU.
  278. Constructor => UIW_TOOL_
  279. Icon Help...
  280. ICON is a static control used to present graphical information.  Icons may be used to select a user-defined action.
  281. Constructor => UIW_ICON(left, top, icon name, title, icon flags, window flags, user function)
  282. Press <Alt+F4> to contined to the new window:
  283. // Initialize the window manager.
  284.      UI_WINDOW_MANAGER *windowManager =
  285.      new UI_WINDOW_MANAGER(display, eventManager);
  286. // Read in persistent object resource created in Zinc Designer.
  287.      *windowManager
  288.           + new
  289. Order Information Help...
  290. Zinc Application Framework 3.5 is composed of an engine and one or more platform specific modules (or Keys).  The currently available options are:
  291.      Zinc Engine (required)
  292.      DOS Key (text and graphics)
  293.      Microsoft
  294. String Help...
  295. STRING is used to enter, modify and display single-line alphanumeric string information.  Five string flags determine how the string is formatted and edited, including: no formatting, upper-case, lower-case, password and variable name (whventManager
  296.           + new UID_KEYBOARD
  297.           + new UID_MOUSE
  298.           + new UID_CURSOR;
  299. Press <Alt+F4> to continue...
  300. Event Manager Help...m
  301. The backbone of Zinc Application Framework 3.5 is its event-driven architecture.  This architecture exploits the power of object-orientation to insulate you from the complexities of the operating environment without restricting your access to environment specific features, like the Microsoft Windows messages or the raw scan codes from the keyboard.
  302. Events are received and processed in a Zinc application with Zinc's Event Manager, Window Manager and Event Mapping.  The Event Manager maintains a list of run-time devices.  Devices included with the library are the keyboard, mouse, and cursor. A pen input device is included with the optional PenDOS Key.  You can also create your own input devices such as serial communications, by deriving a new device from the UI_DEVICE base class.
  303. All events are stored in the event queue in their raw state.  Raw event information when running under DOS is the keyboard scan code or mouse state.  Under Microsoft Windows or OS/2 it is the native environment message.
  304. Zinc lets you avoid dealing with raw event information (e.g., F1 key, left mouse click, WM_PAINT message), by logically mapping events at the object level (e.g., L_HELP, L_BEGIN_MARK, S_DISPLAY_ACTIVE).  Raw input is mapped to the appropriate logical event for the current object.  For example, the left mouse click is mapped to L_BEGIN_SELECT if the current object is the window object, and L_BEGIN_MARK if the current object is the text object.  This unique feature of Zinc Application Framework permits you to work with event information in a device and object independent fashion and doesn't require you to know specific information about the device that generated the event or the object that receives the event.
  305. The following code demonstrates how the EVENT MANAGER is initialized and how input devices are attached using the overloaded '+' operator:
  306. // Initialize the event manager and attach input devices.
  307.      UI_EVENT_MANAGER *eventManager =
  308.      new UI_EVENT_MANAGER(display);
  309.      *eay = new UI_GRAPHICS_DISPLAY;
  310.      if (!display->installed)
  311.      {
  312.           delete display;
  313.           display = new UI_TEXT_DISPLAY;
  314.      }
  315. Press <Alt+F4> to continue...
  316. Screen Display Help...
  317. Zinc's display classes abstract hardware or operating-specific display standards, including: Monochrome, Hercules, CGA, EGA, VGA, SVGA, Microsoft Windows, Windows NT, IBM OS/2 and OSF/Motif.  Zinc Application Framework for DOS includes a high-performance graphics library as well as support for third party graphics libraries such as Borland, Microsoft, and Zortech.
  318. You can create a display class for your own graphics library by deriving from the UI_DISPLAY base class.  You can also create a single executable program that supports both DOS Graphics and DOS Text.
  319.      UI_BGI_DISPLAY: Borland Graphics Display
  320.      UI_FG_DISPLAY: Zortech Flash Graphics Display
  321.      UI_GRAPHICS_DISPLAY: Zinc Graphics Display
  322.      UI_MOTIF_DISPLAY: OSF/Motif Display
  323.      UI_MSC_DISPLAY: Microsoft Graphics Display
  324.      UI_MSWINDOWS_DISPLAY: Microsoft Windows Display
  325.      UI_OS2_DISPLAY: IBM OS/2 Display
  326.      UI_TEXT_DISPLAY: DOS Text Mode Display
  327. The following code demonstrates how a Zinc DISPLAY CLASS is initialized:
  328. // Initialize MS Windows 3.X display class
  329.       UI_DISPLAY *display =
  330.       new UI_MSWINDOWS_DISPLAY(instance, hPrevInstance, nCmdShow);
  331. // Initialize DOS display, trying for graphics first.
  332.      UI_DISPLAY *displ demonstrates how a Zinc HELP SYSTEM is initialized:
  333. UI_WINDOW_OBJECT::helpSystem =
  334.   new UI_HELP_SYSTEM("SAMPLE.DAT", windowManager);
  335. Press <Alt+F4> to continue...
  336.  by simply passing a status flag (button flag) in the constructor argument list.
  337. Constructor => UIW_BUTTON(left, top, width, button text, button flags, window flags,  user function, programmer assigned value, bitmap name associated with button)
  338. Presser function or validation routine by adding the name of the function to the argument list of the constructor (shown below).  User functions receive messages from Zinc and can be executed when STRING is selected, becomes current and/or becomes non-current.
  339. HELP_ZINC_DESIGNERN
  340. HELP_PERSISTENT_OBJECTSO
  341. HELP_CLASS_HIERARCHYP
  342. INFO_GENERALQ
  343. INFO_STRINGR
  344. INFO_FORMATTED_STRINGS
  345. INFO_TEXTT
  346. INFO_DATEU
  347. INFO_TIMEV
  348. INFO_BIGNUMW
  349. INonstrates how a Zinc ERROR SYSTEM is initialized:
  350. UI_WINDOW_OBJECT::errorSystem = new UI_ERROR_SYSTEM;
  351. Press <Alt+F4> to continue...
  352. Error System Help...v
  353. Zinc provides an error system to allow you to generate error messages for your users.  The ERROR SYSTEM is derived from the UI_ERROR_SYSTEM class.  You may also derive your own error system from this class.
  354. The following code demntinue...
  355. Zinc Designer Help...
  356. Zinc 3.5 offers the tightest integration available between an interactive design tool and the supporting class library.  Most Windows developers use a resource tool to help create their program interface.  Resource tools are language and library independent by design and therefore cannot access all the features of a given class library.  This results in a fragmented approach to application development with isolated user functions and non-specific documentation.  You are saddled with the not-so-obvious details of integrating your code with both the class library and the resources you create with the resource tool.  The seamless integration of Zinc Designer and Zinc 3.5 contrasts sharply with this a la carte approach.
  357. Zinc Designer lets you interactively create your application screens using Zinc objects AND objects that you have derived from Zinc classes.  You use a mouse to select windows and window objects from the menu or tool bar and place them on the screen.  You can easily customize objects with Zinc Designer's interactive editors.  For example, create input fields for formatted information such as a part number or phone number. Just double click on the formatted-string object to open the editor.  Now you can enter formatting codes, modify the string identifier, attach context-sensitive help and attach a user function.  User functions are attached to input objects, controls and menus via their respective editors.  (User procedures can be executed when the field is made current, non-current and/or selected.)
  358. After creating your screens you save them to disk in a platform-independent resource file with a .DAT extension using Zinc POST (Persistent-Object Storage Technology) resources. You add these resources to your application with one line of code.  You can also load resources you create with the Windows version of Zinc Designer into the DOS, OS/2, Motif versions and vice versa.
  359. Zinc Designer's complete access to the Zinc class library, straightforward integration of your codignificantly affecting performance.
  360. Press <Alt+F4> to continue...
  361. er).  The PEN feeds input information directly to the Event Queue.
  362. The PEN is attached to the Event Manager at run-time using the Add member function or the overloaded '+' operator:
  363. // Initialize the event manager and attach the keyboard, pen and cur
  364. Horizontal List Help...
  365. HORIZONTAL LIST is used to enter, modify and display related information in row and column format.  You can add a scroll bar to horizontally scroll the list.  A wide variety of window objects can be placed in HORIZONTAL LIST, inc
  366. (UI = user interface)
  367. (UID = user interface device)
  368. (UIW = user interface window object)
  369. Press <Alt+F4> to continue...
  370. Class Hierarchy Help...f
  371. Zinc Application Framework CLASS HIERARCHY
  372. class UI_APPLICATION
  373. class UI_DISPLAY
  374.       - *class UI_BGI_DISPLAY
  375.       - *class UI_FG_DISPLAY
  376.       - *class UI_GRAPHICS_DISPLAY
  377.       - *class UI_TEXT_DISPLAY
  378.       -  class UI_MOTIF_DISPLAY
  379.       - *class UI_MSC_DISPLAY
  380.       -  class UI_MSWINDOWS_DISPLAY
  381.       -  class UI_OS2_DISPLAY
  382. class UI_ELEMENT
  383.       - class UI_DEVICE
  384.             - class UID_CURSOR
  385.             - class UID_KEYBOARD
  386.             - class UID_MOUSE
  387.             - class UID_PENDOS
  388.       - class UI_PATH_ELEMENT
  389.       - class UI_QUEUE_ELEMENT
  390.       - class UI_REGION_ELEMENT
  391.       - class UI_WINDOW_OBJECT
  392.             - class UIW_BORDER
  393.             - class UIW_BUTTON
  394.                   - class UIW_MAXIMIZE_BUTTON
  395.                   - class UIW_MINIMIZE_BUTTON
  396.                   - class UIW_POP_UP_ITEM
  397.                   - class UIW_PULL_DOWN_ITEM
  398.                   - class UIW_SYSTEM_BUTTON
  399.                   - class UIW_TITLE
  400.             - class UIW_ICON
  401.             - class UIW_PROMPT
  402.             - class UIW_STRING
  403.                   - class UIW_BIGNUM
  404.                   - class UIW_DATE
  405.                   - class UIW_FORMATTED_STRING
  406.                   - class UIW_INTEGER
  407.                   - class UIW_REAL
  408.                   - class UIW_TIME
  409.            - *class UIW_WINDOW
  410.                   - class UI_WINDOW_MANAGER
  411.                   - class UIW_COMBO_BOX
  412.                   - class UIW_GROUP
  413.                   - class UIW_HZ_LIST
  414.                   - class UIW_POP_UP_MENU
  415.                   - class UIW_PULL_DOWN_MENU
  416.                   - class UIW_SCROLL_BAR
  417.                   - class UIW_TEXT
  418.                   - class UIW_TOOL_BAR
  419.                   - class UIW_VT_LIST
  420. class UI_ERROR_SYSTEM
  421. class UI_HELP_SYSTEM
  422. class UI_INTERNATIONAL
  423.       - class UI_BIGNUM
  424.       - class UI_DATE
  425.       - class UI_TIME
  426. class UI_LIST
  427.       - class UI_EVENT_MANAGER
  428.       - class UI_LIST_BLOCK
  429.             - class UI_QUEUE_BLOCK
  430.       - class UI_PATH
  431.       - class UI_REGION_LIST
  432.             - *class UI_BGI_DISPLAY
  433.             - *class UI_FG_DISPLAY
  434.             - *class UI_GRAPHICS_DISPLAY
  435.             - *class UI_TEXT_DISPLAY
  436.             - *class UI_MSC_DISPLAY
  437.       - *class UIW_WINDOW
  438. COPYRIGHT (C) 1990-1993 Zinc Software Incorporated.  All Rights Reserved.
  439. .  Over 98 percent of the attendees said the conference was very worthwhile (and they paid $1,500.00 to attend!).  Companies attending included EDS, Hewlett Packard, Lotus, Novell, Iomega, Schlumberger Technologies and WordPerfect.  Attendees came from theer case and lower case.
  440. DATE examines the country information provided by the operating system to display the appropriate format.  For example, the date 12/25/92 will display as 25/12/92 if a European country code is detected.
  441. You may associate a userted to the underscore character).
  442. NOTE: With the Password flag set, STRING accepts input characters but only displays a blank space to the screen.
  443. String Help...
  444. STRING is used to enter, modify and display single-line alphanumeric string information.  String flags determine formatting of the string including: no formatting, upper-case, lower-case, password and variable name (where spaces are conve
  445. Formatted String Help...
  446. FORMATTED STRING is used to enter, modify and display alphanumeric information in a pre-defined format that you specify, such as phone number, part number or serial number.
  447. Text Help...
  448. TEXT is used to enter, modify and display multiple-line text information.  It features mark, cut, copy, paste, word wrap, home, end, page-up, page-down, word-left, word-right, etc.
  449. ON                        = 0x0018; // Icon Help...T
  450. const UI_HELP_CONTEXT HELP_KEYBOARD                    = 0x0019; // Keyboard Help...Q
  451. const UI_HELP_CONTEXT HELP_MOUSE                       = 0x001A; // Mouse Help...Z
  452. const UI_HELP_CONTEXT HELP_WINDOW_er case and lower case.
  453. Date Help...
  454. DATE is used to enter, display and modify country-independent date information.  15 date specific flags determine appropriate display formatting, including: U.S., European, Japanese, military, short (day, month, year), slash, zero fill, uppse and lower case.
  455. Time Help...
  456. TIME is used to enter, modify and display country-independent time information.  13 time specific flags determine the appropriate display formatting, including: colon separator, zero fill, hours, minutes, seconds, 12 Hour, 24 Hour, upper calayed, including: currency, credit ( ), commas, decimal (0 to 8 places) and percent.
  457. BAR                    = 0x0035; // Tool-Bar Help...R
  458. const UI_HELP_CONTEXT INFO_PROMPT                      = 0x0036; // Prompt Help...Q
  459. const UI_HELP_CONTEXT INFO_GROUP                       = 0x0037; // Group Help...P
  460. const UI_HELP_CONTEXT INFO_ICON     INFO_HELP_SYSTEM                 = 0x003E; // Help System Help...X
  461. const UI_HELP_CONTEXT INFO_ERROR_SYSTEM                = 0x003F; // Error System Help...X
  462. const UI_HELP_CONTEXT INFO_FONT_SUPPORT                = 0x0040; // Font Support Help...X
  463. const UIFO_BUTTONX
  464. INFO_RADIO_BUTTONY
  465. INFO_CHECK_BOXZ
  466. INFO_HLIST[
  467. INFO_VLIST\
  468. INFO_COMBO_BOX]
  469. INFO_SCROLL_BAR^
  470. INFO_WINDOW_
  471. INFO_PULL_DOWN_MENU`
  472. INFO_POP_UP_MENUa
  473. INFO_POP_UP_MENU_ITEM
  474. Button Help...v
  475. BUTTON is a selectable field used to perform run-time operations. You may attach a bitmap to customize the button.
  476. Radio Button Help...
  477. RADIO BUTTON is a button control that allows only one item in a group to be selected.  RADIO BUTTON is a button with the BTF_RADIO_BUTTON button flag set in the argument list.
  478. Check Box Help...
  479. CHECK BOX is a button control that allows multiple items in a group to be selected.  CHECK BOX is a button with the BTF_CHECK_BOX button flag set in the argument list.
  480. Scroll-Bar Help...
  481. SCROLL BAR is a selectable region used to scroll the displayed portion of a window, list box or text input field.
  482. Constructor => UIW_SCROLL_BAR(left, top, width, height, HORIZONTAL OR VERTICAL, window flags)
  483. Press <Alt+F4> to coluding: input fields, icons and controls.
  484. Horizontal List Help...
  485. HORIZONTAL LIST is used to enter, modify and display related information in row and column format.  You can add a scroll bar to horizontally scroll the list.  A wide variety of window objects can be placed in HORIZONTAL LIST, inc input fields, icons and controls.
  486. Vertical List Help...
  487. VERTICAL LIST is used to enter, modify and display related information in a vertical list format.  You can add a scroll bar to vertically scroll the list.  A wide variety of window objects can be placed in VERTICAL LIST, including:
  488. Combo-Box Help...u
  489. COMBO BOX is a combination input field and vertical list.  COMBO BOX can contain input fields, icons and buttons.
  490. rary and the designer.
  491. In addition to powerful multiplatform technology and over 1,400 pages of detailed documentation, Zinc offers a four-hour, videotape training series.  The videotape series provides a conceptual overview of Zinc's event-driven archi
  492. Scroll-Bar Help...u
  493. SCROLL BAR is a selectable region used to scroll the displayed portion of a window, list box or text input field.
  494. Window Help...
  495. WINDOW is a rectangular region of the display used as the controlling structure for window objects.  Zinc supports parent, child, MDI, modal and dialog windows.
  496. Pull-down Menu Help...
  497. NOTE: MS Windows does not allow a pull-down menu in a child window.  However, this feature IS demonstrated in DOS, OS/2 and Motif .
  498. PULL DOWN MENU is used to organize and control pull-down menu items (PULL DOWN ITEMS).
  499.  Zinc Application Framework 3.5 (i.e., the class library and designer) is also included.
  500. For more information or to order in the United States or outside of Europe, please call or write:
  501.      Zinc Software Incorporated
  502.      405 South 100 East 2nd Fl*
  503. UP MENUS are used for cascading menus.
  504. Pop-up Menu Help...
  505. NOTE: MS Windows does not allow a pull-down menu in a child window.  However, PULL DOWN MENU with a cascading POP UP MENU is demonstrated in DOS, OS/2, and Motif.
  506. POP UP MENU is used to organize and control pop-up menu items. POP 
  507. Pop-up Menu Item Help...L
  508. POP UP MENU ITEM is used to select a specific action from a pop-up menu.
  509. INFO_TOOL_BARc
  510. INFO_PROMPTd
  511. INFO_GROUPe
  512. INFO_ICONf
  513. INFO_KEYBOARDg
  514. INFO_MOUSEh
  515. INFO_WINDOW_MANAGERi
  516. INFO_EVENT_MANAGERj
  517. INFO_SCREEN_DISPLAYk
  518. INFO_HELP_SYSTEMl
  519. INFO_ERR
  520. Tool-Bar Help...
  521. TOOL BAR is a menu control used to group buttons, icons, and input fields.  A tool bar can be static or wrapped when re-sizing the window.  It can be independent of or used in conjunction with PULL DOWN MENU.
  522. e and platform-independent, persistent object storage can dramatically enhance your productivity.  With Zinc you can focus your efforts on building great applications instead of wasting time trying to integrate your interface tools.
  523. Press <Alt+F4> to co
  524. Prompt Help...}
  525. PROMPT is a static control that is used to provide the user with information regarding input fields and program activity.
  526. Group Help...R
  527. GROUP is a static control that is used to group radio buttons and check boxes.
  528. Icon Help...w
  529. ICON is a static control used to present graphical information.  Icons may be used to select a user-defined action.
  530. stent-Object Storage Technology) allows you to save the resources you create with Zinc Designer in a platform-independent binary data file.  Zinc Designer is included with Zinc Application Framework along with the complete source code to both the class lib
  531. Keyboard Help...
  532. KEYBOARD is used to collect raw scan code information from the keyboard.  It is attached to a list that is maintained by the Event Manager (see Event Manager).  The KEYBOARD feeds information to the Event Queue when polled by the Event Manager.
  533. Mouse Help...
  534. MOUSE is used to collect raw scan code information from a mouse input device.  It is attached to a list which is maintained by Zinc's Event Manager (see Event Manager).  The MOUSE feeds input information directly to the Event Queue.
  535. Window Manager Help...
  536. Zinc's WINDOW MANAGER maintains a list of window objects and controls their positioning and their state (e.g., current, non-current).  The WINDOW MANAGER forwards event information to the current window object.
  537.  Windows Key
  538.      Windows NT Key
  539.      IBM OS/2 Key
  540.      OSF/Motif Key
  541.      CIC or IBM PenDOS Key
  542.      Video Training Series (NTSC or PAL)
  543. NOTE: Zinc Designer is provided for each platform key that you order. In addition, the COMPLETE source code to
  544. Event Manager Help...
  545. Events are received and processed in a Zinc application with Zinc's Event Manager, Window Manager and Event Mapping.  The Event Manager maintains a list of run-time devices such as the keyboard, mouse, and cursor.  Programmer defined devices may also be added to the Event Manager.
  546. ludes a high-performance graphics library as well as support for third party graphics libraries such as Borland, Microsoft, and Zortech.
  547. You can create a display class for your own graphics library by deriving from the UI_DISPLAY base class.  You can also create a single executable program that supports both DOS Graphics and DOS Text.
  548. Screen Display Help...<
  549. Zinc's display classes abstract hardware or operating-specific display standards, including: Monochrome, Hercules, CGA, EGA, VGA, SVGA, Microsoft Windows, Windows NT, IBM OS/2 and OSF/Motif.  Zinc Application Framework for DOS inc
  550. Help System Help...
  551. Zinc provides a help system to allow you to create context sensitive help screens for your users.  HELP SYSTEM is derived from the UI_HELP_SYSTEM class.  You may also derive your own help system from this class.
  552. Help System Help...
  553. Zinc provides a help system to allow you to create context sensitive help screens for your users.  HELP SYSTEM is derived from the UI_HELP_SYSTEM class.  You may also derive your own help system from this class.
  554. The following codeass UI_STORAGE
  555. class UI_STORAGE_OBJECT
  556. struct UI_EVENT
  557. struct UI_EVENT_MAP
  558. struct UI_ITEM
  559. struct UI_KEY
  560. struct UI_PALETTE
  561. struct UI_PALETTE_MAP
  562. struct UI_POSITION
  563. struct UI_REGION
  564. struct UI_SCROLL_INFORMATION
  565. * indicates multiple inheritanceOR_SYSTEMm
  566. INFO_FONT_SUPPORTn
  567. HELP_FONT_SUPPORTp
  568. HELP_APPLICATIONq
  569. HELP_VIDEOr
  570. HELP_PEN
  571. Error System Help...
  572. Zinc provides an error system to allow you to generate error messages for your users.  ERROR SYSTEM is derived from the UI_ERROR_SYSTEM class.  You may also derive your own error system from this class.
  573. Font Support Help...
  574. Zinc allows multiple font support in DOS Graphics, Microsoft Windows, Windows NT, IBM OS/2, and OSF/Motif.  The three fonts above are provided with Zinc, but you may define more fonts if needed.
  575. Font Support Help...
  576. Zinc allows multiple font support in DOS Graphics, Microsoft Windows, Windows NT, IBM OS/2, and OSF/Motif.  The three fonts above are provided with Zinc, but you may define more fonts if needed.
  577. Press <Alt+F4> to continue...
  578. onstructor (shown below).
  579. User functions receive messages from Zinc and can be executed when BUTTON is selected, becomes current and/or becomes non-current.
  580. BUTTON is also used to create Radio Buttons, Buttons with associated bitmaps, and Check Boxes Help...\
  581. const UI_HELP_CONTEXT HELP_FORMATTED_STRING            = 0x0004; // Formatted String Help...P
  582. const UI_HELP_CONTEXT HELP_TEXT                        = 0x0005; // Text Help...P
  583. const UI_HELP_CONTEXT HELP_DATE                        = 0x0006; // Da
  584. Date Help...t
  585. DATE is used to enter, display and modify country-independent date information.  15 date specific flags determine appropriate display formatting, including: U.S., European, Japanese, military, short (day, month, year), slash, zero fill, uppis continues until the event is either successfully processed or is discarded.
  586. The sample code below demonstrates how the WINDOW MANAGER is initialized and how window objects (in this case a window with its contents was created in Zinc Designer) are addte Help...P
  587. const UI_HELP_CONTEXT HELP_TIME                        = 0x0007; // Time Help...R
  588. const UI_HELP_CONTEXT HELP_BIGNUM                      = 0x0008; // Number Help...R
  589. const UI_HELP_CONTEXT HELP_BUTTON                      = 0x0009; // Button Hel
  590. Number Help...F
  591. BIGNUM is used to enter, modify and display country-independent numeric information.  BIGNUM has a default maximum value of 30 digits to the left and 8 digits to the right of the decimal.  Six number flags determine how the number is disp Help...O
  592. const UI_HELP_CONTEXT HELP_PEN                         = 0x0044; // Pen Help...
  593. Window Manager Help...+
  594. Zinc's Window Manager maintains a list of window objects and controls their positioning and their state (e.g., current, non-current).
  595. Event information (whether received from a polled or interrupt driven device) is placed in an
  596. Text, DOS Graphics, Microsoft Windows and Windows NT, IBM OS/2 and OSF/Motif; initialize the Event Manager and attach the Keyboard, Mouse and Cursor input devices; and create the Window Manager.  The UI_APPLICATION class also has a member function to process events and perform system cleanup. 
  597. Press <Alt+F4> to continue...
  598. UI_APPLICATION Help.../
  599. The UI_APPLICATION class significantly reduces the number of steps required to create a Zinc application.  UI_APPLICATION allows you to write one line of code to initialize the main routine, create the appropriate display for DOS onst UI_HELP_CONTEXT HELP_PERSISTENT_OBJECTS          = 0x0021; // Persistent Objects Help...[
  600. const UI_HELP_CONTEXT HELP_CLASS_HIERARCHY             = 0x0022; // Class Hierarchy Help...S
  601. const UI_HELP_CONTEXT INFO_GENERAL                     = 0x0023; // _HELP_CONTEXT HELP_FONT_SUPPORT                = 0x0041; // Font Support Help...Z
  602. const UI_HELP_CONTEXT HELP_APPLICATION                 = 0x0042; // UI_APPLICATION Help...Z
  603. const UI_HELP_CONTEXT HELP_VIDEO                       = 0x0043; // Video TrainingMANAGER              = 0x001B; // Window Manager Help...Y
  604. const UI_HELP_CONTEXT HELP_EVENT_MANAGER               = 0x001C; // Event Manager Help...Z
  605. const UI_HELP_CONTEXT HELP_SCREEN_DISPLAY              = 0x001D; // Screen Display Help...W
  606. const UI_HELP_C]
  607. const UI_HELP_CONTEXT HELP_ORDER_INFORMATION           = 0x0001; // Order Information Help...S
  608. const UI_HELP_CONTEXT HELP_GENERAL                     = 0x0002; // General Help...R
  609. const UI_HELP_CONTEXT HELP_STRING                      = 0x0003; // Stringber Help...R
  610. const UI_HELP_CONTEXT INFO_BUTTON                      = 0x002A; // Button Help...X
  611. const UI_HELP_CONTEXT INFO_RADIO_BUTTON                = 0x002B; // Radio Button Help...U
  612. const UI_HELP_CONTEXT INFO_CHECK_BOX                   = 0x002C; // C
  613. Pull-down Menu Item Help...
  614. PULL DOWN ITEM is used as the first-level selection within a menu system.
  615. You may associate a user function or validation routine by adding the name of the function to the argument list of the constructor (shown below).  U
  616. Pen Help...
  617. Zinc Software supports the IBM PenDOS operating system with a pen input object.  The PEN is used to collect pen input information from a pen input device.  It is attached to a list which is maintained by Zinc's Event Manager (see Event Managssing
  618.      Deriving Input Devices
  619.      Deriving Window Objects
  620.      Deriving Windows
  621.      Odds and Ends
  622. The videotapes are based on the Zinc Developer's Conference held October 1992 at Snowbird, Utah.  The response to the conference was overwhelmingApplication Framework.  This training series addresses object-oriented programming techniques with Zinc 3.5 in a manner that is impossible to duplicate with hard copy documentation.  The videotapes include the following sections:
  623.      Overview of Zinc A purchase.)
  624. A fully internationalized version of Zinc Application Framework (featuring double-byte character, unicode and multiple language support) is scheduled for release 3rd quarter 1993.  In addition, Zinc's development plans include support for UnONTEXT HELP_HELP_SYSTEM                 = 0x001E; // Help System Help...X
  625. const UI_HELP_CONTEXT HELP_ERROR_SYSTEM                = 0x001F; // Error System Help...Y
  626. const UI_HELP_CONTEXT HELP_ZINC_DESIGNER               = 0x0020; // Zinc Designer Help...^
  627. c event queue and is dispatched to the Window Manager via the application's event loop.  The Window Manager forwards event information to the current window object. The window object processes the event or passes it to its parent object (if one exists).  Th
  628. Video Training Help...Z
  629. Although generic C++ training videos are widely available, product-specific video-based training has been virtually non-existent.  In response, Zinc Software has developed an intensive four-hour videotape training series for Zinc pplication Framework
  630.      Introduction to Windows and Window Objects
  631.      Understanding Zinc Header and Code files
  632.      Using Persistent Objects
  633.      Understanding the Zinc Architecture
  634.      Zinc Message Handling
  635.      User Functions and Message Proce
  636.