home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / PRESPM.ZIP / FNTDEMO.IPF < prev    next >
Text File  |  1991-04-15  |  29KB  |  699 lines
  1. :userdoc.
  2. :title.EASEL FntDemo
  3. :author.Brian J. Buck
  4. .* 
  5. :body.
  6. .*
  7. :h1 id=us         .Usage Instructions  
  8. :hp2.How to Use the Contents:ehp2.
  9. .*
  10. :p.:hp1.(The following instructions are taken from the OS/2 online
  11. Command Reference.):ehp1.
  12. .*
  13. :p.When the Contents window first appears, some topics have a plus (+) sign
  14. beside them. 
  15. The plus sign indicates that additional topics are available. 
  16. .*
  17. :p.To expand the Contents if you are using a mouse, click on the plus sign.  If you are 
  18. using the keyboard, use the Up or Down Arrow key to highlight the topic, and press the 
  19. plus (+) key. For example, :hp2.Keyword Instructions:ehp2. has a plus 
  20. sign beside it. To see the complete list of REXX keyword instructions, click on the plus sign or 
  21. highlight that topic and press the plus (+) key. 
  22. .*
  23. :p.To view a topic, double-click on the topic (or press the Up or Down Arrow key to highlight 
  24. the topic, and then press the Enter key). 
  25. .*
  26. :p.:hp2.How to Obtain Additional Information:ehp2.
  27. .*
  28. :p.After you select a topic, the information for that topic appears in a window.
  29. You will notice that 
  30. certain words in the text may be specially highlighted (The default color for this
  31. special highlighting is green). These words are links to additional information.  
  32. If you are using a mouse, 
  33. double-click on the highlighted word.  If you are using a keyboard, press the Tab key to 
  34. move to the highlighted word, and then press the Enter key.  Additional information will 
  35. appear in a pop-up window. 
  36. .*
  37. :p.:hp2.How to Use Action Bar Choices:ehp2.
  38. .*
  39. :p.A number of choices are available for managing information presented in the REXX 
  40. Quick Reference. If you want to see more information about these choices, click on 
  41. the name of the choice (or press the Tab key to move to the choice and press Enter). 
  42. .*
  43. :dl tsize=8 break=all.
  44. :dt.:link reftype=fn refid=fnbookmk.Bookmark:elink.
  45. :dd.Allows you to set a placeholder so you can retrieve information of interest to you. 
  46. (This choice is available from the :hp2.Services:ehp2. pull-down). 
  47. :dt.:link reftype=fn refid=fnsearch.Search:elink. 
  48. :dd.Allows you to find occurrences of a word or phrase in the current topic, selected 
  49. topics, or all topics. (This choice is available from the :hp2.Services:ehp2. pull-down). 
  50. :dt.:link reftype=fn refid=fnprint.Print:elink. 
  51. :dd.Allows you to print one or more topics. (This choice is available from the :hp2.Services:ehp2. 
  52. pull-down). 
  53. :dt.:link reftype=fn refid=fncopy.Copy:elink. 
  54. :dd.Allows you to copy a topic you are viewing to a file you can edit. (This choice is 
  55. available from the :hp2.Services:ehp2. pull-down). 
  56. :dt.:link reftype=fn refid=fnoption.Options:elink. 
  57. :dd.Allows you to change the way your Contents is displayed. 
  58. :edl. 
  59. .*
  60. .* Footnotes
  61. .*
  62. .*
  63. .*
  64. .*
  65. :fn id=fnbookmk.BookMark 
  66. .*
  67. :p.When you place a bookmark on a topic, 
  68. it is added to a list of bookmarks you 
  69. have previously set.  You can view the 
  70. list, and you can remove one or all 
  71. bookmarks from the list.  If you have not 
  72. set any bookmarks, the list is empty. 
  73. .*
  74. :p.To set a bookmark, do the following: 
  75. .*
  76. :ol.
  77. :li.Select a topic from the Contents. 
  78. :li.When that topic appears, choose the :hp2.Bookmark:ehp2. option from the
  79. :hp2.Services:ehp2. pull-down. 
  80. :li.If you want to change the name used for the bookmark, type the new name 
  81. in the field. 
  82. :li.Click on the :hp2.Place:ehp2. radio button (or press the Up or Down Arrow key to 
  83. select it) 
  84. :li.Click on :hp2.OK:ehp2. (or select it and press Enter). The bookmark is then added 
  85. to the bookmark list. 
  86. :eol.  
  87. :efn.
  88. .*
  89. :fn id=fnsearch.Search 
  90. .*
  91. :p.You can specify a word or phrase to be searched.  You can also limit the search 
  92. to a set of topics by first marking the topics on the Contents list. 
  93. .*
  94. :p.To search for a word or phrase in all topics, do the following: 
  95. .*
  96. :ol.
  97. :li.Choose the :hp2.Search:ehp2. option from the :hp2.Services:ehp2. pull-down. 
  98. :li.Type the word or words to be searched. 
  99. :li.Click on :hp2.All sections:ehp2. (or press the Up or Down Arrow keys to select it) 
  100. :li.Click on :hp2.Search:ehp2. (or select it and press Enter) to begin the search. 
  101. :li.The list of topics where the word or phrase appears is displayed. If only one 
  102. topic contains the word or phrase, a window containing that topic appears. 
  103. :eol.
  104. :efn.
  105. .*
  106. :fn id=fnprint.Print  
  107. .*
  108. :p.You can print one or more topics.  You can also print a set of topics by first marking 
  109. the topics on the Contents list. 
  110. .*
  111. :p.To print the document Contents list, do the following: 
  112. .*
  113. :ol.
  114. :li.Choose :hp2.Print:ehp2. from the :hp2.Services:ehp2. pull-down. 
  115. :li.Click on :hp2.Contents:ehp2. (or press the Up or Down Arrow key to select it) 
  116. :li.Click on :hp2.Print:ehp2. (or select it and press Enter). 
  117. :li.The :hp2.Contents:ehp2. list is printed on your printer. 
  118. :eol.
  119. :efn.
  120. .*
  121. .*
  122. .*
  123. :fn id=fncopy.Copy   
  124. .*
  125. :p.You can copy a topic you are viewing into a temporary file named TEXT.TMP.  You can 
  126. later edit that file by using the editor of your choice.
  127. :p.To copy a topic, do the following: 
  128. .*
  129. :ol.
  130. :li.Expand the Contents list and select a topic. 
  131. :li.When the topic appears, choose :hp2.Copy to file:ehp2. from the :hp2.Services:ehp2. pull-down. 
  132. :li.The system puts the text pertaining to that topic in the temporary TEXT.TMP file. 
  133. :eol.
  134. .*
  135. "p.For information on one of the other choices in the :hp2.Services:ehp2. pull-down, highlight the 
  136. choice and press the F1 key. 
  137. :efn.
  138. .*
  139. .*
  140. .*
  141. :fn id=fnoption.Options
  142. .*
  143. :p.You can control the appearance of the Contents list. 
  144. :p.To expand the Contents and show all levels for all topics, choose :hp2.Expand all:ehp2. from the 
  145. :hp2.Options:ehp2. pull-down. You can also press the Ctrl and * keys together. 
  146. .*
  147. :p.For information on one of the other choices in the :hp2.Options:ehp2. pull-down, highlight the 
  148. choice and press the F1 key. 
  149. :efn.
  150. .*
  151. .*
  152. .*
  153. .*
  154. :h1.About this package     
  155. .*
  156. :p.This package contains (among other things) the C code for a DLL
  157. that enables the use of any font (including monospaced ones) in
  158. EASEL listboxes.
  159. .*
  160. :p.I originally changed fonts only in listboxes, and to do so I
  161. subclassed the dialog procedure, and changed the listbox style to
  162. owner draw.  This works just fine, but adds the nuisance of having
  163. to keep around instance data for each listbox while not being able to
  164. use window words (in EASEL) to store it. 
  165. .*
  166. :p.With the advent of OS/2 1.2, I switched techniques for font
  167. manipulation;  I employ the WinSetPresParam API, which does not
  168. require me to store instance data on a per listbox basis.  Now I
  169. can change fonts in any dialog control.  I can change colors, also,
  170. although unless the user is given some options to change them this
  171. is not really CUA.  
  172. .*
  173. :p.The original font changing program was based on the ideas found in a
  174. program called LBFONT that was written by Easel Corp. and given away
  175. at one of their EASEL training classes, and a different program called 
  176. LBFONT that was found on BIX.  The program in this package bears no
  177. real resemblance to either of those;  parts of the logic are based on ideas
  178. in Charles Petzold's fontlist.exe program, and the IBM 1.2 PTI sample
  179. program fonttest.exe.  This was all done pre-1.3, pre-ATM.  It *does* not
  180. appear as though there is any way to specify an outline font for use with
  181. WinSetPresParam.  I would appreciate hearing from anyone who finds a
  182. way to do so.
  183. .*
  184. :p.This package is released into the public domain; use it any way you like.
  185. I would appreciate hearing of any errors or omissions that you find.
  186. .*
  187. :p.Now, to satisfy the lawyers: no warranties, guarantees, etc. are implied,
  188. no liability is assumed.  You break it and you own both halves.
  189. Any opinions expressed herein are my own, not that of
  190. my employer or any vendor.  
  191. .*  
  192. :dl tsize=20 compact break=none.
  193. :dt.Brian Buck 
  194. :dd.23SEP90
  195. :dt.Internet
  196. :dd.76666.60@Compuserve.COM
  197. :dt.Compuserve 
  198. :dd.76666,60
  199. :dt.Phone
  200. :dd.(708) 620-5000
  201. :edl.
  202. .*
  203. :p.:hp2.Trademark Information.:ehp2.
  204. :p.:hp5.EASEL:ehp5. is a trademark of Easel Corporation.
  205. :p.:hp5.OS/2:ehp5. is a trademark of International Business Machines Corporation.
  206. :p.:hp5.Presentation Manager:ehp5. is a trademark of International Business Machines Corporation.
  207. :h1.What's in this package?
  208. .*
  209. :p.The following sections detail the contents of this package.
  210. .*
  211. :h2.Read&period.Me  
  212. .*
  213. :p.The :hp2.Read&period.Me:ehp2. file just tells you how to view this online
  214. reference.
  215. .*
  216. :h2.FntDemo&period.IPF  
  217. .*
  218. :p.:hp2.FntDemo&period.IPF:ehp2. contains (in source form) the information 
  219. you are viewing now.
  220. :p.The Information Presentation Facility (IPF, also known as the Help
  221. Manager) provides an undocumented but nonetheless :link reftype=fn refid=fnsuppor.supported:elink.
  222. method for creating standalone online references like the one you are 
  223. using now, or like the OS/2 Command Reference.  
  224. :p.You can use the IPF compiler to create modular online documentation
  225. for your library of reusable code.  
  226. It is possible to view multiple .INF
  227. files as a composite book -- just look at how the IBM OS/2 1.2 
  228. PTI (Programming Tools and Information, aka toolkit) organizes the 
  229. online programming reference.  
  230. .*
  231. :p.:hp2.How to compile:ehp2.
  232. :p.To compile an IPF file into a standalone reference (an INF file),
  233. you must have the PTI (1.2 toolkit) installed.  Use the following&colon.
  234. .*
  235. :xmp.
  236. ipfc yourfile.ipf /inf /cou=001 /codepage=850 /l=enu
  237. :exmp. 
  238. .*
  239. :p.When you include the :hp2./inf:ehp2. command line switch,
  240. you generate an &period.INF file rather than the default &period.HLP file.
  241. .*
  242. :fn id=fnsuppor.
  243. IBM Level 2 says that the method for creating standalone references
  244. :hp2.will:ehp2. be documented in a future release, and :hp2.is:ehp2.
  245. supported.
  246. :efn.    
  247. .*
  248. :h2.FntDemo&period.INF
  249. .*
  250. The :hp2.FntDemo&period.INF:ehp2. file is the compiled form of the &period.IPF
  251. file for the online reference.  
  252. :p.:hp2.How to view:ehp2.
  253. To view this (or any other &period.INF file) you can simply type&colon.
  254. :xmp.
  255. view fntdemo.inf
  256. :exmp.
  257. :p.from the command line of any OS/2 command session.  You must fully
  258. qualify the name of the &period.INF file if it is not in your current
  259. directory.  You can also install this in an OS/2 program group.
  260. .*
  261. :h2.FntDemo&period.C  
  262. .*
  263. :p.The :hp2.FntDemo&period.C:ehp2. file contains the source code for the
  264. FntDemo&period.DLL dynalink library.  This library contains the 
  265. subroutines&colon. 
  266. :ul compact.
  267. :li.ChangeHANDLE_FontToPOINTSFACE_
  268. :li.ChangeHANDLE_FontToDefault
  269. :li.MakeHANDLE_ForegroundCOLOR_
  270. :li.MakeHANDLE_BackgroundCOLOR_
  271. :li.MakeHANDLE_HiliteForegroundCOLOR_
  272. :li.MakeHANDLE_HiliteBackgroundCOLOR_
  273. :li.MakeHANDLE_DisabledForegroundCOLOR_
  274. :li.MakeHANDLE_DisabledBackgroundCOLOR_
  275. :li.MakeHANDLE_BorderCOLOR_
  276. :li.ErrMsgFromChangeHANDLEFont
  277. :li.ErrMsgFromMakeHANDLECOLOR
  278. :eul.    
  279. :p.Because these subroutines are intended for use in EASEL programs,
  280. an EASEL style nomenclature is used rather than C style.  The idea is
  281. that you would ideally want to be able to code&colon.
  282. :xmp.
  283. change LB_MyListbox font to 10 "System Monospaced"
  284. :exmp.                    
  285. :p.But since EASEL is not fully object-oriented, you can't define new
  286. methods using the same syntax as the underlying language.
  287. So instead you code&colon.
  288. :xmp.  
  289. string FONT_10_SYSTEM_MONOSPACED is "10.System Monospaced"
  290. string Handle
  291. &period.&period.&period.
  292. copy handle of LB_MyListbox to Handle
  293. call ChangeHANDLE_FontToPOINTSFACE_ ( Handle, FONT_10_SYSTEM_MONOSPACED )
  294. if (errorlevel != 0) then
  295.     # handle errors 
  296.     send errorlevel " " 
  297.         ErrMsgFromChangeHANDLEFont ( errorlevel ) 
  298.         to errorlog
  299.     end if
  300. :exmp.                    
  301.  
  302. .*
  303. :h2.FntDemo&period.INC
  304. .*
  305. :p.The :hp2.FntDemo&period.INC:ehp2. file is the EASEL include file that
  306. contains the subroutine and function definitions for the following
  307. routines&colon.
  308. :ul compact.
  309. :li.ChangeHANDLE_FontToPOINTSFACE_
  310. :li.ChangeHANDLE_FontToDefault
  311. :li.MakeHANDLE_ForegroundCOLOR_
  312. :li.MakeHANDLE_BackgroundCOLOR_
  313. :li.MakeHANDLE_HiliteForegroundCOLOR_
  314. :li.MakeHANDLE_HiliteBackgroundCOLOR_
  315. :li.MakeHANDLE_DisabledForegroundCOLOR_
  316. :li.MakeHANDLE_DisabledBackgroundCOLOR_
  317. :li.MakeHANDLE_BorderCOLOR_
  318. :li.ErrMsgFromChangeHANDLEFont
  319. :li.ErrMsgFromMakeHANDLECOLOR
  320. :eul.    
  321. .*
  322. :h2.FntDemo&period.EAL
  323. .*
  324. :p.The :hp2.FntDemo&period.EAL:ehp2. file contains a trivial EASEL
  325. program that simply demonstrates the use of the FntDemo subroutines.
  326. .*
  327. :h2.FntDemo&period.EBI
  328. .*
  329. :p.The :hp2.FntDemo&period.EBI:ehp2. file contains the compiled form
  330. of the :hp2.FntDemo&period.EAL:ehp2. program.
  331. .*
  332. :h2.FntDemo&period.DEF
  333. .*
  334. :p.The :hp2.FntDemo&period.DEF:ehp2. file is the link definition file
  335. for the :hp2.FntDemo&period.DLL:ehp2. dynalink library.
  336. .*
  337. :h2.FntDemo&period.DLL
  338. .*
  339. :p.The :hp2.FntDemo&period.DLL:ehp2. file contains the compiled and
  340. linked Dynalink library required for EASEL programs to use the 
  341. subroutines.  This file must be in a directory that is specified in
  342. your LIBPATH in your CONFIG.SYS file.  Rather than dedicate one
  343. directory to contain DLLs, I find it convenient to include a "&period."
  344. as the first thing in my LIBPATH.  This means that the current directory
  345. is searched first for DLLs.  A variation is to specify :hp2.&period.\DLL;:ehp2
  346. which will search the \DLL directory of the current directory.  
  347. For example&colon.
  348. :xmp.
  349. LIBPATH=&period.;&period.\DLL;C&colon.\OS2\DLL;E&colon.\EASEL-EE\DLL;&period.&period.&period.:hp1.etc&period.:ehp1.
  350. :exmp.
  351. .*
  352. :h2.FntDemo&period.CMD
  353. .*
  354. :p.Why a &period.CMD file and not a make file?
  355. Because the IBM C/2 Make and the Microsoft C Make are so different
  356. that it is too confusing to provide only one, and too much work for me
  357. to provide both.  A command file is not ambiguous.            
  358. .*
  359. .*
  360. :h2.MakeINF&period.CMD
  361. .*
  362. :p.Compiles the :hp2.FntDemo&period.IPF:ehp2. file with the
  363. IPF compiler.  It compiles it into the :hp2.FntDemo&period.INF:ehp2. file.
  364. .*
  365. :h1.OS/2 1.2 Fonts
  366. :p.The following sections provide some information on the fonts that are
  367. distributed with OS/2 1.2 and are by default installed.
  368. :p.Sources of info are visual comparisons of info from&colon.
  369. :sl compact.
  370. :li.fontlist.exe (Petzold)
  371. :li.fonttest.exe (IBM 1.2 PTI)
  372. :li.system editor (1.2)
  373. :esl.
  374. :h2.VGA Fonts
  375. :lines.
  376.   Font Device Res = 96 x 96
  377.   Cell &colon.= Average character width 
  378.         x Max baseline extent  
  379. :elines.
  380. :cgraphic.
  381. ┌────────────────────┬─────────┬──────┐ 
  382. │                    │Character│ Point│
  383. │Face name           │  Cell   │ Size │
  384. ├════════════════════┼═════════┼══════┤ 
  385. │System Proportional │  6 x 16 │  10  │
  386. ├────────────────────┼─────────┼──────┤
  387. │  System Monospaced │  9 x 20 │  12  │
  388. │  System Monospaced │  8 x 16 │  10  │
  389. ├────────────────────┼─────────┼──────┤
  390. │            Courier │  8 x 13 │   8  │
  391. │            Courier │  9 x 16 │  10  │
  392. │            Courier │ 12 x 20 │  12  │  
  393. ├────────────────────┼─────────┼──────┤
  394. │               Helv │  5 x 13 │   8  │
  395. │               Helv │  6 x 16 │  10  │
  396. │               Helv │  7 x 20 │  12  │
  397. │               Helv │  8 x 24 │  14  │
  398. │               Helv │ 11 x 29 │  18  │
  399. │               Helv │ 14 x 37 │  24  │ 
  400. ├────────────────────┼─────────┼──────┤
  401. │            Tms Rmn │  4 x 13 │   8  │
  402. │            Tms Rmn │  5 x 16 │  10  │
  403. │            Tms Rmn │  6 x 19 │  12  │
  404. │            Tms Rmn │  7 x 21 │  14  │
  405. │            Tms Rmn │ 10 x 27 │  18  │
  406. │            Tms Rmn │ 13 x 35 │  24  │
  407. └────────────────────┴─────────┴──────┘ 
  408. :ecgraphic.                     
  409. :h2.EGA Fonts
  410. :lines.
  411.   Font Device Res = 96 x 72
  412.   Cell &colon.= Average character width 
  413.         x Max baseline extent  
  414. :elines.
  415. :cgraphic.
  416. ┌────────────────────┬─────────┐ 
  417. │                    │Character│
  418. │Face name           │  Cell   │
  419. ├════════════════════┼═════════┤ 
  420. │  System Monospaced │  8 x 12 │
  421. ├────────────────────┼─────────┤
  422. │            Courier │  6 x 12 │
  423. │            Courier │  7 x 15 │
  424. │            Courier │  8 x 10 │
  425. │            Courier │  8 x 18 │
  426. │            Courier │  9 x 12 │
  427. │            Courier │ 12 x 10 │
  428. │            Courier │ 12 x 15 │
  429. │            Courier │ 10 x 22 │
  430. │            Courier │ 14 x 28 │
  431. ├────────────────────┼─────────┤
  432. │               Helv │  5 x 10 │
  433. │               Helv │  6 x 12 │
  434. │               Helv │  7 x 15 │
  435. │               Helv │  8 x 18 │
  436. │               Helv │ 10 x 22 │
  437. │               Helv │ 14 x 28 │
  438. ├────────────────────┼─────────┤
  439. │            Tms Rmn │  4 x 10 │
  440. │            Tms Rmn │  5 x 12 │
  441. │            Tms Rmn │  6 x 15 │
  442. │            Tms Rmn │  7 x 16 │
  443. │            Tms Rmn │ 10 x 20 │
  444. │            Tms Rmn │ 13 x 26 │
  445. └────────────────────┴─────────┘ 
  446. :ecgraphic.                     
  447. :h2.CGA Fonts
  448. :lines.
  449.   Font Device Res = 96 x 48
  450.   Cell &colon.= Average character width 
  451.         x Max baseline extent  
  452. :elines.
  453. :cgraphic.
  454. ┌────────────────────┬─────────┐ 
  455. │                    │Character│
  456. │Face name           │  Cell   │
  457. ├════════════════════┼═════════┤ 
  458. │  System Monospaced │  8 x  8 │          
  459. ├────────────────────┼─────────┤
  460. │            Courier │  8 x  7 │          
  461. │            Courier │  9 x  8 │          
  462. │            Courier │ 12 x 10 │          
  463. ├────────────────────┼─────────┤
  464. │               Helv │  5 x  6 │          
  465. │               Helv │  6 x  8 │          
  466. │               Helv │  7 x 10 │          
  467. │               Helv │  8 x 12 │          
  468. │               Helv │ 11 x 15 │          
  469. │               Helv │ 14 x 19 │          
  470. ├────────────────────┼─────────┤
  471. │            Tms Rmn │  4 x  6 │          
  472. │            Tms Rmn │  6 x  8 │          
  473. │            Tms Rmn │  7 x 10 │          
  474. │            Tms Rmn │  7 x 11 │          
  475. │            Tms Rmn │ 10 x 14 │          
  476. │            Tms Rmn │ 14 x 18 │          
  477. └────────────────────┴─────────┘ 
  478. :ecgraphic.                     
  479. :h2.8514 Fonts
  480.   Font Device Res = 120 x 72
  481.   Cell &colon.= Average character width 
  482.         x Max baseline extent  
  483. :elines.
  484. :cgraphic.
  485. ┌────────────────────┬─────────┐ 
  486. │                    │Character│
  487. │Face name           │  Cell   │
  488. ├════════════════════┼═════════┤ 
  489. │            Courier │10 x 10  │        
  490. │            Courier │12 x 12  │        
  491. │            Courier │15 x 15  │        
  492. ├────────────────────┼─────────┤
  493. │               Helv │ 6 x 10  │        
  494. │               Helv │ 7 x 12  │        
  495. │               Helv │ 9 x 15  │        
  496. │               Helv │10 x 18  │        
  497. │               Helv │13 x 22  │        
  498. │               Helv │18 x 28  │        
  499. ├────────────────────┼─────────┤
  500. │            Tms Rmn │ 6 x 10  │        
  501. │            Tms Rmn │ 7 x 12  │        
  502. │            Tms Rmn │ 9 x 15  │        
  503. │            Tms Rmn │10 x 16  │        
  504. │            Tms Rmn │13 x 21  │         
  505. │            Tms Rmn │17 x 27  │        
  506. └────────────────────┴─────────┘ 
  507. :ecgraphic.                     
  508. :h1.EASEL Subroutines, Functions 
  509. .*
  510. :p.The following sections describe the EASEL subroutines and functions
  511. provided by the FntDemo package through the FntDemo.INC and FntDemo.DLL
  512. files.
  513. :p.The convention used for naming the subroutines corresponds as closely
  514. as possible with the nomenclature used in the base EASEL language, and 
  515. in the descriptions of EASEL syntax.  A subroutine or function name 
  516. consists of several words.  Words that are descriptive of the function
  517. appear with the first letter capitalized, and the rest in lower case.
  518. Words that represent a parameter to be passed appear in all upper case,
  519. and are suffixed with an underscore character.  For example, in the
  520. subroutine name :hp2.ChangeHANDLE_FontToPOINTSFACE_:ehp2. the words that
  521. describe the function are :hp2.Change, Font,:ehp2. and :hp2.To&period.:ehp2.
  522. The words that represent the parameters to be passed are :hp2.HANDLE&us.:ehp2.
  523. and :hp2.POINTSFACE_&period.:ehp2.    
  524. :p.This naming convention seems to :hp1.mesh:ehp1. best with the native
  525. EASEL language syntax.
  526. .*
  527. :h2.ChangeHANDLE_FontToPOINTSFACE_    
  528. :p.Changes the font used in displaying a dialog control.  Any EASEL
  529. control object can be specified.  
  530. :p.This subroutine sets the builtin EASEL errorlevel function to zero
  531. for a successful change, and to a non-zero value for an unsuccessful
  532. change.  The error message for an unsuccessful change can be retrieved
  533. with the ErrMsgFromChangeHANDLEFont function.
  534. :p.:xmp.
  535. subroutine ChangeHANDLE_FontToPOINTSFACE_
  536.     ( integer   : Handle                    # input   handle of CONTROL
  537.     , string    : PointsDotFaceName         # input   e.g., "12.Helv"
  538.     )                                       #
  539.     library "FNTDEMO"                       # sets errorlevel
  540. :exmp.
  541. :h2.ChangeHANDLE_FontToDefault
  542. :p.Restores the dialog control's font to its original font.  
  543. :p.:xmp.
  544. subroutine ChangeHANDLE_FontToDefault
  545.     ( integer   : Handle                    # input   handle of CONTROL
  546.     )                                       #
  547.     library "FNTDEMO"                       # sets errorlevel
  548. :exmp.
  549. :h2.MakeHANDLE_PP_COLOR_
  550. :p.This is primarily an internal routine for use by the other EASEL
  551. MakeHANDLE_<xxx>COLOR_ subroutines, but it can be called directly
  552. using the PP_ defined constants from the 'C' header file PMWIN.H.
  553. Only the PP_ constants for color changes should be used; no error
  554. checking is performed on the passed PP_ constant.
  555. :p.This subroutine sets the builtin EASEL errorlevel function to zero
  556. for a successful change, and to a non-zero value for an unsuccessful
  557. change.  The error message for an unsuccessful change can be retrieved
  558. with the ErrMsgFromMakeHANDLECOLOR function.
  559. :xmp.
  560. subroutine MakeHANDLE_PP_COLOR_
  561.     ( integer   : Handle                    # input   handle of CONTROL
  562.     , integer   : PresParamConstant         # input   e.g., PP_BORDERCOLOR
  563.     , integer   : ColorNumber               # input   e.g., 1
  564.     )                                       #
  565.     library "FNTDEMO"                       # sets errorlevel
  566. :exmp.
  567. :h2.MakeHANDLE_ForegroundCOLOR_
  568. :p.Changes the foreground color of the specified dialog control by
  569. changing the value of its PP_FOREGROUNDCOLORINDEX presentation parameter.
  570. :p.This subroutine sets the builtin EASEL errorlevel function to zero
  571. for a successful change, and to a non-zero value for an unsuccessful
  572. change.  The error message for an unsuccessful change can be retrieved
  573. with the ErrMsgFromMakeHANDLECOLOR function.
  574. :xmp.
  575. subroutine MakeHANDLE_ForegroundCOLOR_
  576.     ( integer   : Handle                    # input   handle of CONTROL
  577.     , integer   : ColorNumber               # input   e.g., 1
  578.     )                                       #
  579.     library "FNTDEMO"                       # sets errorlevel
  580. :exmp.
  581. :h2.MakeHANDLE_BackgroundCOLOR_
  582. :p.Changes the background color of the specified dialog control by
  583. changing the value of its PP_BACKGROUNDCOLORINDEX presentation parameter.
  584. :p.This subroutine sets the builtin EASEL errorlevel function to zero
  585. for a successful change, and to a non-zero value for an unsuccessful
  586. change.  The error message for an unsuccessful change can be retrieved
  587. with the ErrMsgFromMakeHANDLECOLOR function.
  588. :xmp.
  589. subroutine MakeHANDLE_BackgroundCOLOR_
  590.     ( integer   : Handle                    # input   handle of CONTROL
  591.     , integer   : ColorNumber               # input   color, e.g., 1
  592.     )                                       #
  593.     library "FNTDEMO"                       # sets errorlevel
  594. :exmp.
  595. :h2.MakeHANDLE_HiliteForegroundCOLOR_
  596. :p.Changes the hilite foreground color of the specified dialog control by
  597. changing the value of its PP_HILITEFOREGROUNDCOLORINDEX presentation parameter.
  598. :p.This subroutine sets the builtin EASEL errorlevel function to zero
  599. for a successful change, and to a non-zero value for an unsuccessful
  600. change.  The error message for an unsuccessful change can be retrieved
  601. with the ErrMsgFromMakeHANDLECOLOR function.
  602. :xmp.
  603. subroutine MakeHANDLE_HiliteForegroundCOLOR_
  604.     ( integer   : Handle                    # input   handle of CONTROL
  605.     , integer   : ColorNumber               # input   e.g., 1
  606.     )                                       #
  607.     library "FNTDEMO"                       # sets errorlevel
  608. :exmp.
  609. :h2.MakeHANDLE_HiliteBackgroundCOLOR_
  610. :p.Changes the hilite background color of the specified dialog control by
  611. changing the value of its PP_HILITEBACKGROUNDCOLORINDEX presentation parameter.
  612. :p.This subroutine sets the builtin EASEL errorlevel function to zero
  613. for a successful change, and to a non-zero value for an unsuccessful
  614. change.  The error message for an unsuccessful change can be retrieved
  615. with the ErrMsgFromMakeHANDLECOLOR function.
  616. :xmp.
  617. subroutine MakeHANDLE_HiliteBackgroundCOLOR_
  618.     ( integer   : Handle                    # input   handle of CONTROL
  619.     , integer   : ColorNumber               # input   color, e.g., 1
  620.     )                                       #
  621.     library "FNTDEMO"                       # sets errorlevel
  622. :exmp.
  623. :h2.MakeHANDLE_DisabledForegroundCOLOR_
  624. :p.Changes the disabled background color of the specified dialog control by
  625. changing the value of its PP_DISABLEDBACKGROUNDCOLORINDEX presentation parameter.
  626. :p.This subroutine sets the builtin EASEL errorlevel function to zero
  627. for a successful change, and to a non-zero value for an unsuccessful
  628. change.  The error message for an unsuccessful change can be retrieved
  629. with the ErrMsgFromMakeHANDLECOLOR function.
  630. :xmp.
  631. subroutine MakeHANDLE_DisabledForegroundCOLOR_
  632.     ( integer   : Handle                    # input   handle of CONTROL
  633.     , integer   : ColorNumber               # input   e.g., 1
  634.     )                                       #
  635.     library "FNTDEMO"                       # sets errorlevel
  636. :exmp.
  637. :h2.MakeHANDLE_DisabledBackgroundCOLOR_
  638. :p.Changes the disabled background color of the specified dialog control by
  639. changing the value of its PP_DISABLEDBACKGROUNDCOLORINDEX presentation parameter.
  640. :p.This subroutine sets the builtin EASEL errorlevel function to zero
  641. for a successful change, and to a non-zero value for an unsuccessful
  642. change.  The error message for an unsuccessful change can be retrieved
  643. with the ErrMsgFromMakeHANDLECOLOR function.
  644. :xmp.
  645. subroutine MakeHANDLE_DisabledBackgroundCOLOR_
  646.     ( integer   : Handle                    # input   handle of CONTROL
  647.     , integer   : ColorNumber               # input   color, e.g., 1
  648.     )                                       #
  649.     library "FNTDEMO"                       # sets errorlevel
  650. :exmp.
  651. :h2.MakeHANDLE_BorderCOLOR_
  652. :p.Changes the border color of the specified dialog control by
  653. changing the value of its PP_BORDERCOLORINDEX presentation parameter.
  654. :p.This subroutine sets the builtin EASEL errorlevel function to zero
  655. for a successful change, and to a non-zero value for an unsuccessful
  656. change.  The error message for an unsuccessful change can be retrieved
  657. with the ErrMsgFromMakeHANDLECOLOR function.
  658. :xmp.
  659. subroutine MakeHANDLE_BorderCOLOR_
  660.     ( integer   : Handle                    # input   handle of CONTROL
  661.     , integer   : ColorNumber               # input   e.g., 1
  662.     )                                       #
  663.     library "FNTDEMO"                       # sets errorlevel
  664. :exmp.
  665. :h2.ErrMsgFromChangeHANDLEFont
  666. :p.
  667. :p.Returns an error message associated with the given errorlevel number
  668. passed from EASEL.  It is assumed that&colon.                            
  669. :ol compact.                                                       
  670. :li.the errorlevel represents an errorlevel due to the
  671. ChangeHANDLE_FontToPOINTSFACE_  call.                      
  672. :li.no other PM Winxxx errors have occurred between the
  673. ChangeHANDLE_FontToPOINTSFACE_  call and this call.        
  674. :eol.
  675. :xmp.
  676. function   ErrMsgFromChangeHANDLEFont
  677.     ( integer   : Errorlevel                # input   errorlevel 
  678.     ) 
  679.     returns string                          # output  error message
  680.     library "FNTDEMO"                       #
  681. :exmp.
  682. :h2.ErrMsgFromMakeHANDLECOLOR
  683. :p.Returns an error message associated with the given errorlevel number
  684. passed from EASEL.  It is assumed that&colon.                            
  685. :ol compact.                                                       
  686. :li.the errorlevel represents an errorlevel due to one of the
  687. MakeHANDLE_<xxx>COLOR_ calls.
  688. :li.no other PM Winxxx errors have occurred between the
  689. MakeHANDLE_<xxx>COLOR_  call and this call.        
  690. :eol.
  691. :xmp.
  692. function   ErrMsgFromMakeHANDLEColor 
  693.     ( integer   : Errorlevel                # input   errorlevel 
  694.     ) 
  695.     returns string                          # output  error message
  696.     library "FNTDEMO"                       #
  697. :exmp.
  698. :euserdoc.
  699.