home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / tolkit45.zip / os2tk45 / book / ipfref.inf (.txt) < prev    next >
OS/2 Help File  |  1999-05-12  |  896KB  |  21,671 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. What's New ΓòÉΓòÉΓòÉ
  3.  
  4. Two new files have been added to provide better support for the Simplified 
  5. Chinese language and code page 1386.:  IPFGBK.NLS and APSY1386.APS. 
  6.  
  7. Two files have been modified to provide better support for the Simplified 
  8. Chinese language and for code page 1381:  IPFPRD.NLS and APSY1381.APS. 
  9.  
  10.  
  11. ΓòÉΓòÉΓòÉ 2. Introducing IPF ΓòÉΓòÉΓòÉ
  12.  
  13. The Information Presentation Facility (IPF) is a tool that enables you to 
  14. create online information, to specify how it will appear on the screen, to 
  15. connect various parts of the information, and to provide help information that 
  16. can be requested by the user. 
  17.  
  18. It is a tool for both the information author and the application programmer. 
  19. IPF implements guidelines recommended by the Common User Access* (CUA*) element 
  20. of the Systems Application Architecture* (SAA*) platform. 
  21.  
  22. *  Trademark of the IBM Corporation 
  23.  
  24.  
  25. ΓòÉΓòÉΓòÉ 2.1. What IPF Offers ΓòÉΓòÉΓòÉ
  26.  
  27. As an author of online information, you need to know what type of information 
  28. users need - tutorial, reference, or help. For example, they might need a 
  29. tutorial to learn a software program, reference information for additional 
  30. topics, or help information for assistance with the program. 
  31.  
  32. As a programmer implementing or customizing online information, you need to 
  33. know how the IPF programming interface supports your intended design. 
  34.  
  35. IPF features include: 
  36.  
  37.      A tagging language that formats text, provides ways to connect 
  38.       information units, and customizes windows 
  39.      A compiler that creates online documents and help windows 
  40.      A viewing program that displays formatted online documents 
  41.      A help manager programming interface that allows you to control and 
  42.       customize the display of online information. 
  43.  
  44.  
  45. ΓòÉΓòÉΓòÉ 2.1.1. The Tag Language ΓòÉΓòÉΓòÉ
  46.  
  47. The IPF tagging language provides the instructions for how online information 
  48. is to be displayed.  With these instructions, or tags, you can: 
  49.  
  50.      Highlight text 
  51.      Set margins 
  52.      Add lists, notes, and notices 
  53.      Create tables 
  54.      Change the size and style (font), and the color of displayed information 
  55.      Control the formatting of lines of text 
  56.      Illustrate with examples, figures, and art 
  57.      Customize windows 
  58.      Define ways to connect information units 
  59.      Establish communication links to other applications. 
  60.  
  61.  
  62. ΓòÉΓòÉΓòÉ 2.1.2. The IPF Compiler ΓòÉΓòÉΓòÉ
  63.  
  64. When you have finished writing and tagging, information is ready to be 
  65. compiled. The IPF compiler interprets the tags in your source file and converts 
  66. the information into the appropriate format.  The compiler is able to 
  67. distinguish between tags and text because each tag starts with a colon (:), is 
  68. immediately followed by the tag name, and then ends with a period (.). For 
  69. example, the tag that indicates a new paragraph is the :p. tag.  When the 
  70. compiler encounters this tag, it interprets it as, "Insert a blank line before 
  71. the paragraph tag and start the text that follows the paragraph tag." 
  72.  
  73. At compile time, you specify what format you want.  For online documents, you 
  74. direct IPF to generate a file with an INF extension.  For help information, you 
  75. specify a file with an HLP extension.  For information about compiler commands 
  76. and options, see Starting the IPF Compiler. 
  77.  
  78.  
  79. ΓòÉΓòÉΓòÉ 2.1.3. The View Program ΓòÉΓòÉΓòÉ
  80.  
  81. The View program (VIEW) enables you to display your compiled document. VIEW 
  82. retrieves files with an INF extension and displays the formatted information in 
  83. a standard OS/2 window. 
  84.  
  85. Note:  You cannot use VIEW to display files with an HLP extension. For 
  86.        information about how to use VIEW, see Viewing an Online Document or see 
  87.        the Command Reference. 
  88.  
  89.  
  90. ΓòÉΓòÉΓòÉ 2.1.4. The Help Manager Programming Interface ΓòÉΓòÉΓòÉ
  91.  
  92. You can use IPF to develop a user interface that provides help for application 
  93. windows and fields within windows. You can even customize help information by 
  94. writing Presentation Manager programs that communicate with IPF. 
  95.  
  96.  
  97. ΓòÉΓòÉΓòÉ 2.2. Features of the IPF Interface ΓòÉΓòÉΓòÉ
  98.  
  99. Online designs need to communicate information through a simple interface that 
  100. lets the user find information quickly and easily.  With IPF you can develop an 
  101. interface that provides unique usability features, including: 
  102.  
  103.      Hypertext links 
  104.      Push buttons 
  105.      Customized windows 
  106.      Master help index and glossary. 
  107.  
  108.  
  109. ΓòÉΓòÉΓòÉ 2.2.1. Hypertext and Hypergraphic Links ΓòÉΓòÉΓòÉ
  110.  
  111. IPF gives the user the ability to connect to different units of text and 
  112. graphics. The connections that join these units are known as hypertext or 
  113. hypergraphic links.  For example, a user can select a particular link to obtain 
  114. related information or perhaps to see a graphical description of the topic. 
  115.  
  116. An advantage of using hypertext or hypergraphic links is that the author can 
  117. present information in a nonlinear way. Users can then access information both 
  118. sequentially and randomly. This lets them explore or branch into subject matter 
  119. that may be unclear or that needs to be reviewed.  For information about 
  120. hypertext and hypergraphic links, see Linking. 
  121.  
  122.  
  123. ΓòÉΓòÉΓòÉ 2.2.2. Push Buttons ΓòÉΓòÉΓòÉ
  124.  
  125. Push buttons provide users with a fast and easy way to access commonly used IPF 
  126. tasks.  When a user selects a push button, the action represented by the text 
  127. on the push button is carried out immediately.  IPF provides one set of push 
  128. buttons for online documents and another set for Help windows.  IPF also 
  129. provides help on how to use the push buttons. 
  130.  
  131. As a designer, you can change the text of a push button, select which push 
  132. buttons you want to use, add your own push buttons, and specify the area of a 
  133. window to place them.  For more information, see Push Buttons. 
  134.  
  135.  
  136. ΓòÉΓòÉΓòÉ 2.2.3. Customized Windows ΓòÉΓòÉΓòÉ
  137.  
  138. A window is the area of the screen in which information is displayed. As an 
  139. author of online information, you can customize windows.  Different windowing 
  140. effects are achieved with the IPF tagging language. For example, a window can 
  141. be split so that scrollable text can be displayed beside a stationary 
  142. illustration that the text describes. 
  143.  
  144. The following figure shows an IPF split-window design that describes the IBM* 
  145. Personal System/2* Model 90 XP 486** series. 
  146.  
  147. * Trademark of the IBM Corporation 
  148.  
  149. ** Trademark of Intel Corporation 
  150.  
  151. IPF Split Window 
  152.  
  153. For more information, see Customizing Windows. 
  154.  
  155.  
  156. ΓòÉΓòÉΓòÉ 2.2.4. Master Help Index and Glossary ΓòÉΓòÉΓòÉ
  157.  
  158. The OS/2 operating system provides online help that can be accessed through 
  159. both a Master Help Index and a Glossary. The Master Help Index and the Glossary 
  160. are both collections of alphabetized pointers to information panels. Their 
  161. primary purpose is to provide quick access to help topics. With them, you can 
  162. provide such features as: 
  163.  
  164.      Availability of the Master Help Index from anywhere in the WorkPlace 
  165.       Shell 
  166.  
  167.      A side-by-side window design that lets the user scan index entries on one 
  168.       side, then display the help-text information on the other side 
  169.  
  170.      A menu and buttons that let the user perform a search, print help-text 
  171.       windows, or request assistance. 
  172.  
  173.  The following figure shows an example of the Master Index window and the 
  174.  opened help-text window, "Changing, Adding, and Deleting Fonts." 
  175.  
  176.  For more information, see Customizing Master Help Index and Glossary Objects 
  177.  
  178.  
  179. ΓòÉΓòÉΓòÉ 3. IPF User Interface ΓòÉΓòÉΓòÉ
  180.  
  181. This chapter describes the components of the IPF user interface.  As an author, 
  182. you will use these components when developing an online document or online 
  183. help. As a programmer, you should understand the IPF user interface before you 
  184. enable your application to work with online help. 
  185.  
  186. Online documents include reference or procedural information, such as converted 
  187. printed material, tutorials, and organization charts.  Online help includes 
  188. information that users of online documents or application programs might want 
  189. to access. 
  190.  
  191. Because they have varying backgrounds, interests, motivations, and experiences, 
  192. no two users of online information are exactly alike.  To accommodate 
  193. differences, IPF provides a flexible interface that can be customized according 
  194. to personal preference.  However, when an online document requires no special 
  195. design considerations, the IPF compiler provides an automatic default design 
  196. that includes: 
  197.  
  198.      A Contents window 
  199.  
  200.      Standard OS/2 windows 
  201.  
  202.      Help. 
  203.  
  204.  
  205. ΓòÉΓòÉΓòÉ 3.1. The Contents Window ΓòÉΓòÉΓòÉ
  206.  
  207. When users first select a document for viewing, IPF displays an OS/2 window 
  208. that includes a table of contents (Contents window) similar to the window shown 
  209. in the following figure. 
  210.  
  211. A Contents Window. Users select the highlighted item and go directly to a 
  212. window of text. 
  213.  
  214.  
  215. ΓòÉΓòÉΓòÉ 3.2. The Standard Window ΓòÉΓòÉΓòÉ
  216.  
  217. Unless special window characteristics are defined with IPF tags, the IPF 
  218. compiler formats a window that includes the following elements: 
  219.  
  220.      Menu bar 
  221.      Title bar icon 
  222.      Title bar 
  223.      Maximize button 
  224.      Hide button 
  225.      Horizontal scroll bar 
  226.      Vertical scroll bar 
  227.      Push buttons. 
  228.  
  229.  The following figure shows a standard window and its elements. 
  230.  
  231.  Standard Window and Elements 
  232.  
  233.  The title bar icon, and the maximize and hide buttons allow a user to change 
  234.  the size and position of a window.  The menu bar, push buttons, and scroll 
  235.  bars allow a user to work with the window's contents.  The window title 
  236.  indicates the subject of the information, or name of the object, seen in the 
  237.  window. 
  238.  
  239.  
  240. ΓòÉΓòÉΓòÉ 3.3. Help ΓòÉΓòÉΓòÉ
  241.  
  242. While using an online document or application program, a user occasionally 
  243. requires additional information about choices, fields, or procedures for a 
  244. task. CUA guidelines recommend that a product provide information to a user 
  245. about how to use the product. Information about how to use a product is known 
  246. as help information. The OS/2 user interface for help information is developed 
  247. with IPF and is accessible from the menu bar.  Help can also be accessed from 
  248. push buttons located at the bottom of the window or by pressing the F1 key. 
  249.  
  250.  
  251. ΓòÉΓòÉΓòÉ 3.3.1. Main Help Window ΓòÉΓòÉΓòÉ
  252.  
  253. When a user requests help from a window, IPF displays the main help window, the 
  254. characteristics of which are: 
  255.  
  256.      Menu bar 
  257.      Title bar icon 
  258.      Title bar 
  259.      Maximize button 
  260.      Horizontal scroll bar 
  261.      Vertical scroll bar 
  262.      Push buttons. 
  263.  
  264.  The main help window cannot be minimized. 
  265.  
  266.  Within the main help window is the help-text window. The help-text window 
  267.  contains the response to the user's request for help. The characteristics of 
  268.  this window are: 
  269.  
  270.      Title bar icon 
  271.      Title bar (shows title of the selected help window) 
  272.      Maximize button 
  273.      Hide button 
  274.      Horizontal scroll bar 
  275.      Vertical scroll bar. 
  276.  
  277.  The windows shown in the lower right corner of the following figure are main 
  278.  help and help-text windows. 
  279.  
  280.  An IPF Main Help Window with its Help-Text Window. The title "Help for Viewing 
  281.  a Document" that appears in the title bar was created by the author of the 
  282.  help-text window. 
  283.  
  284.  When the main help window is first opened, its position is such that it covers 
  285.  the smallest part of the online document or application window as possible. 
  286.  The help-text window is opened at its maximum size within the main help 
  287.  window. 
  288.  
  289.  However, when the main help window is opened, it can be moved and resized, as 
  290.  can the help-text window. If the user makes the help-text window larger or 
  291.  smaller, the text within the window is reformatted to fit the new window size. 
  292.  
  293.  
  294. ΓòÉΓòÉΓòÉ 3.3.2. Selection Lists ΓòÉΓòÉΓòÉ
  295.  
  296. Selection lists appear when some of the following menu bar choices are 
  297. selected: 
  298.  
  299.      Viewed pages, under Options 
  300.      Contents, under Options 
  301.      Help index, under Help 
  302.      Libraries 
  303.  
  304.  The following figure shows the Viewed Pages selection list. 
  305.  
  306.  View Pages Selection List 
  307.  
  308.  Search results also are displayed in a selection list. Selection lists differ 
  309.  from the help-text window in that they can be closed, either by selecting the 
  310.  Close symbol or by pressing the Esc key. 
  311.  
  312.  Selecting the hide button from the title bar while a help-text window, 
  313.  Contents window, Viewed Pages window, Index window, or Search results window 
  314.  is displayed, results in the window being replaced by an icon. 
  315.  
  316.  
  317. ΓòÉΓòÉΓòÉ 3.3.3. Menu Bar ΓòÉΓòÉΓòÉ
  318.  
  319. The following figure shows the menu bar that has the choices Services, Options, 
  320. and Help. 
  321.  
  322. When Services, Options, or Help is selected, a menu appears with a list of 
  323. entries that also can be selected. Some entries have an associated shortcut key 
  324. or key combination.  These are shown to the right of the menu item. 
  325.  
  326.  
  327. ΓòÉΓòÉΓòÉ 3.3.3.1. Services Menu ΓòÉΓòÉΓòÉ
  328.  
  329. The Services menu shows a list of available services. 
  330.  
  331. Services Menu 
  332.  
  333.  
  334. ΓòÉΓòÉΓòÉ 3.3.3.1.1. Search ΓòÉΓòÉΓòÉ
  335.  
  336. This choice, and the Search push button, display the window shown in the 
  337. following figure. The user can type a text string consisting of letters, 
  338. numbers, blank spaces, and special characters, then select any of the choices 
  339. to search for the text string. 
  340.  
  341. Search Window 
  342.  
  343. Global file-name characters (wildcards) can be used with the text string; for 
  344. example: 
  345.  
  346. *current directory*
  347.  
  348. The global file-name character, in this case an asterisk, automatically finds 
  349. all possibilities of the current directory string. 
  350.  
  351. Following are descriptions of Search window choices: 
  352.  
  353.  This section 
  354.          Searches the currently displayed help-text window and highlights all 
  355.          occurrences of the search string that are found. 
  356.  
  357.  Marked sections 
  358.          Searches the online-document windows or help windows whose titles were 
  359.          marked in the Contents window.  IPF does not search unmarked secondary 
  360.          windows, or windows attached to the marked window by hypertext links. 
  361.          Before selecting Marked sections, the user must select Contents then 
  362.          mark the help titles to be searched. If no help titles are marked, the 
  363.          Marked sections choice is dimmed. 
  364.  
  365.          Sections are marked with the mouse by pressing and holding the Ctrl 
  366.          key then clicking mouse button 1. Sections are marked with the 
  367.          keyboard by using the cursor keys to highlight the item and then 
  368.          pressing the spacebar.  The same key sequences are used to unmark the 
  369.          selection. 
  370.  
  371.          If the search is successful, IPF displays a list of the window titles 
  372.          where the text string was found.  The search string is shown in the 
  373.          title bar of the search results window. 
  374.  
  375.  All sections 
  376.          Searches the entire help library or online document and displays a 
  377.          list of the window titles where occurrences of the search string were 
  378.          found. The search string is shown in the title bar of the search 
  379.          results window. It does not search title text. 
  380.  
  381.  Index 
  382.          Searches the index and displays a list of index entries in which the 
  383.          text string was found. 
  384.  
  385.          If no search string is entered, this choice displays an alphabetic 
  386.          list of all index topics in the help library or online document. 
  387.  
  388.  Marked libraries 
  389.          Searches selected help libraries or online documents. The user must be 
  390.          in an active window of an online document or help library and follow 
  391.          this procedure: 
  392.  
  393.          1.     Select Options then Libraries. 
  394.  
  395.          2.     Mark one or more libraries. 
  396.  
  397.          3.     Select Services, then Search, then Marked libraries. 
  398.  
  399.          4.     Select the Search push button. 
  400.  
  401.  All libraries 
  402.          Searches all help libraries or online documents and displays a list of 
  403.          the window titles where the text string was found. The search string 
  404.          is shown in the title bar of the window. 
  405.  
  406.  
  407. ΓòÉΓòÉΓòÉ 3.3.3.1.2. Print ΓòÉΓòÉΓòÉ
  408.  
  409. This choice, and the Print push button, display the window shown in the 
  410. following figure. The output is the text within the window. The user can select 
  411. any of the choices to print online information. All of the printed output is 
  412. sent to the default printer. All of the information prints as WYSIWYG 
  413. (What-You-See-Is-What-You-Get). 
  414.  
  415. Print Window 
  416.  
  417. Following are descriptions of Print window choices: 
  418.  
  419.  This section 
  420.          Sends the contents of the current window to be printed. 
  421.  
  422.  Marked sections 
  423.          Sends the sections whose titles were marked in the Contents window to 
  424.          be printed. Before selecting this choice, the user must select 
  425.          Contents and mark the titles to be printed. If no titles are marked, 
  426.          Marked sections is dimmed. 
  427.  
  428.          Sections are marked with the mouse by pressing and holding the Ctrl 
  429.          key then clicking mouse button 1. Sections are marked with the 
  430.          keyboard by using the cursor keys to highlight the item and then 
  431.          pressing the spacebar.  The same key sequences are used to unmark the 
  432.          selection. 
  433.  
  434.  All sections 
  435.          Sends the entire online document or help library to be printed. 
  436.  
  437.  Index 
  438.          Sends the help-index or online document index to be printed. 
  439.  
  440.  Contents 
  441.          Sends the help library or online-document contents list to be printed. 
  442.  
  443.  
  444. ΓòÉΓòÉΓòÉ 3.3.3.1.3. Bookmark ΓòÉΓòÉΓòÉ
  445.  
  446. This choice displays the window shown in the following figure. 
  447.  
  448. Bookmark Window 
  449.  
  450.  Place       Saves the user's place in the document being viewed. 
  451.  
  452.  View        Redisplays a specific place that was marked. 
  453.  
  454.  Remove      Deletes one marked place. 
  455.  
  456.  Remove all  Deletes all marked places. 
  457.  
  458.  Note        The Bookmark selections are saved across invocations in a file 
  459.              with the same name as that of the book but with a CP extension. 
  460.              Bookmarks are only available in online books. 
  461.  
  462.  
  463. ΓòÉΓòÉΓòÉ 3.3.3.1.4. New window ΓòÉΓòÉΓòÉ
  464.  
  465. This choice opens a new window for the currently selected item (for example, 
  466. table of content entry, hypertext link, index list, or search list) so the user 
  467. can see more than one topic displayed at the same time. The user can resize the 
  468. new window so the previous window also can be seen, then resize both to view 
  469. both windows. 
  470.  
  471.  
  472. ΓòÉΓòÉΓòÉ 3.3.3.1.5. Copy ΓòÉΓòÉΓòÉ
  473.  
  474. Copies the window currently being viewed to the system clipboard. The user can 
  475. then select Paste from the menu of the OS/2 System Editor (or any other editor 
  476. with this capability) to view or edit the information. 
  477.  
  478.  
  479. ΓòÉΓòÉΓòÉ 3.3.3.1.6. Copy to file ΓòÉΓòÉΓòÉ
  480.  
  481. Copies the information to the file, TEXT.TMP. This file is placed in the 
  482. current directory. If TEXT.TMP already exists, it is replaced. 
  483.  
  484.  
  485. ΓòÉΓòÉΓòÉ 3.3.3.1.7. Append to file ΓòÉΓòÉΓòÉ
  486.  
  487. Copies the information to the file, TEXT.TMP. This file is placed in the 
  488. current directory. If TEXT.TMP already exists, the new information is added to 
  489. the existing information. 
  490.  
  491.  
  492. ΓòÉΓòÉΓòÉ 3.3.3.2. Options Menu ΓòÉΓòÉΓòÉ
  493.  
  494. Selecting Options displays the menu shown in the following figure. 
  495.  
  496. Options Menu 
  497.  
  498. The first five choices are active when the Contents window is active. If the 
  499. Contents window is not active, these choices are dimmed. These choices control 
  500. how the table of contents will be displayed. 
  501.  
  502. A tree-structured table of contents is created if more than one heading level 
  503. is specified with IPF heading tags when the windows are created. (For a 
  504. description of heading tags, see Headings.) 
  505.  
  506. If there are additional entries under a heading, "+" appears to the left of the 
  507. entry.  When an entry is expanded one level, the next level of entries 
  508. subordinate to the selected entry is displayed, and the "+" is replaced by a 
  509. "-". The user can click on the "+" or "-" symbols to expand or contract the 
  510. contents. 
  511.  
  512.  
  513. ΓòÉΓòÉΓòÉ 3.3.3.2.1. Expand one level ΓòÉΓòÉΓòÉ
  514.  
  515. Expands the first level subordinate to the selected entry. 
  516.  
  517.  
  518. ΓòÉΓòÉΓòÉ 3.3.3.2.2. Expand branch ΓòÉΓòÉΓòÉ
  519.  
  520. Expands all levels subordinate to the selected entry. 
  521.  
  522.  
  523. ΓòÉΓòÉΓòÉ 3.3.3.2.3. Expand all ΓòÉΓòÉΓòÉ
  524.  
  525. Displays the entire tree structure of the contents. 
  526.  
  527.  
  528. ΓòÉΓòÉΓòÉ 3.3.3.2.4. Collapse branch ΓòÉΓòÉΓòÉ
  529.  
  530. Contracts all levels subordinate to the selected entry. 
  531.  
  532.  
  533. ΓòÉΓòÉΓòÉ 3.3.3.2.5. Collapse all ΓòÉΓòÉΓòÉ
  534.  
  535. Displays only the highest level entries in the contents. 
  536.  
  537.  
  538. ΓòÉΓòÉΓòÉ 3.3.3.2.6. Contents ΓòÉΓòÉΓòÉ
  539.  
  540. Lists the table of contents for the document you are viewing. You can select 
  541. from the topics shown. This choice has the same function as the Contents push 
  542. button. 
  543.  
  544.  
  545. ΓòÉΓòÉΓòÉ 3.3.3.2.7. Index ΓòÉΓòÉΓòÉ
  546.  
  547. Displays an alphabetic list of the topics in the document.  You can select from 
  548. the index entries shown. This choice has the same function as the Index push 
  549. button. 
  550.  
  551.  
  552. ΓòÉΓòÉΓòÉ 3.3.3.2.8. Viewed pages ΓòÉΓòÉΓòÉ
  553.  
  554. This selection displays a list of all windows viewed during the current 
  555. session. Window titles are listed in the order that windows were viewed. If a 
  556. window is viewed more than once, its title appears as many times as it was 
  557. viewed. 
  558.  
  559. The maximum number of entries that can appear in the Viewed Pages window is 50. 
  560.  
  561.  
  562. ΓòÉΓòÉΓòÉ 3.3.3.2.9. Libraries ΓòÉΓòÉΓòÉ
  563.  
  564. Displays a list of online libraries that are available.  The libraries are 
  565. identified by their directory path. The help files are the directories 
  566. identified in the HELP environment variable.  The online books are the 
  567. directories identified in the BOOKSHELF. 
  568.  
  569.  
  570. ΓòÉΓòÉΓòÉ 3.3.3.2.10. Previous ΓòÉΓòÉΓòÉ
  571.  
  572. Displays the previously viewed window. Each time Previous is selected, the 
  573. previously viewed window is displayed, until the first window viewed in the 
  574. current session is shown. Selecting Previous again from a help window, ends the 
  575. current session. This choice has the same function as when the user selects the 
  576. Previous push button; or presses the Esc key. 
  577.  
  578.  
  579. ΓòÉΓòÉΓòÉ 3.3.3.3. Help Menu ΓòÉΓòÉΓòÉ
  580.  
  581. Selecting Help displays the menu shown in the following figure. 
  582.  
  583. Help Menu 
  584.  
  585.  
  586. ΓòÉΓòÉΓòÉ 3.3.3.3.1. Help index ΓòÉΓòÉΓòÉ
  587.  
  588. Displays an alphabetic list of topics for which help information is provided. 
  589.  
  590.  
  591. ΓòÉΓòÉΓòÉ 3.3.3.3.2. General help ΓòÉΓòÉΓòÉ
  592.  
  593. Displays general information describing the user interface and how to access 
  594. it. 
  595.  
  596.  
  597. ΓòÉΓòÉΓòÉ 3.3.3.3.3. Using help ΓòÉΓòÉΓòÉ
  598.  
  599. Displays a list that describes the different help information that is available 
  600. to users of the OS/2 operating system. 
  601.  
  602.  
  603. ΓòÉΓòÉΓòÉ 3.3.3.3.4. Keys help ΓòÉΓòÉΓòÉ
  604.  
  605. Displays information describing key assignments for the application. 
  606.  
  607. Note:  Providing Keys help is the responsibility of the application programmer. 
  608.        A simple help window can be created that lists each key combination 
  609.        assigned to an application function, and a brief description of what the 
  610.        function does. 
  611.  
  612.  
  613. ΓòÉΓòÉΓòÉ 3.3.3.3.5. Product information ΓòÉΓòÉΓòÉ
  614.  
  615. Displays copyright information. Providing product information also is the 
  616. responsibility of the application programmer. 
  617.  
  618.  
  619. ΓòÉΓòÉΓòÉ 3.3.3.3.6. Tutorial ΓòÉΓòÉΓòÉ
  620.  
  621. This choice is included in the Help menu if your application tells IPF that it 
  622. has created a Presentation Manager tutorial application. This choice has the 
  623. same function as the Tutorial push button. 
  624.  
  625. When the user selects Tutorial, IPF sends a message to the application that the 
  626. selection has been made.  The application then starts the tutorial. 
  627.  
  628.  
  629. ΓòÉΓòÉΓòÉ 3.3.3.4. Push Buttons ΓòÉΓòÉΓòÉ
  630.  
  631. Push buttons provide users with a fast and easy way to access commonly used IPF 
  632. functions.  When a user selects a push button, the action represented is 
  633. carried out immediately.  IPF provides the following set of push buttons: 
  634.  
  635.  
  636. ΓòÉΓòÉΓòÉ 3.3.3.4.1. Previous ΓòÉΓòÉΓòÉ
  637.  
  638. This push button lets the user see information from the previously viewed 
  639. window. This is the same function as when the user selects Options then 
  640. Previous from the menu bar, or presses the Esc key. 
  641.  
  642.  
  643. ΓòÉΓòÉΓòÉ 3.3.3.4.2. Search ΓòÉΓòÉΓòÉ
  644.  
  645. This push button displays a window that lets the user search for a word or 
  646. phrase.  This is the same function as when the user selects Services then 
  647. Search from the menu bar. 
  648.  
  649.  
  650. ΓòÉΓòÉΓòÉ 3.3.3.4.3. Print ΓòÉΓòÉΓòÉ
  651.  
  652. This push button displays a window that lets the user print one or more topics. 
  653. This is the same function as when the user selects Services then Print from the 
  654. menu bar. 
  655.  
  656.  
  657. ΓòÉΓòÉΓòÉ 3.3.3.4.4. Index ΓòÉΓòÉΓòÉ
  658.  
  659. This push button displays an alphabetic list of the index topics in a help 
  660. library or an online document.  This is the same function as when the user 
  661. selects Options then Index from the menu bar. 
  662.  
  663.  
  664. ΓòÉΓòÉΓòÉ 3.3.3.4.5. Contents ΓòÉΓòÉΓòÉ
  665.  
  666. This push button displays the Contents window.  This is the same function as 
  667. when the user selects Options then Contents from the menu bar. 
  668.  
  669.  
  670. ΓòÉΓòÉΓòÉ 3.3.3.4.6. Back ΓòÉΓòÉΓòÉ
  671.  
  672. This push button displays the previous page in the table of contents hierarchy. 
  673.  
  674.  
  675. ΓòÉΓòÉΓòÉ 3.3.3.4.7. Forward ΓòÉΓòÉΓòÉ
  676.  
  677. This push button displays the next page in the table of contents hierarchy. 
  678.  
  679.  
  680. ΓòÉΓòÉΓòÉ 3.3.3.4.8. Tutorial ΓòÉΓòÉΓòÉ
  681.  
  682. This push button is included only if a tutorial was specified in your 
  683. application.  This is the same function as when the user selects Help then 
  684. Tutorial from the menu bar. 
  685.  
  686.  
  687. ΓòÉΓòÉΓòÉ 4. Starting with the Tag Language ΓòÉΓòÉΓòÉ
  688.  
  689. As the author of online information, you can use the IPF tag language to define 
  690. various characteristics of text format. You also can use tags to define 
  691. characteristics of the window in which the text is displayed. 
  692.  
  693. There are 45 tags (excluding symbols) that make up the IPF tag language.  The 
  694. tags are mnemonic, making it easy to associate them with their functions. 
  695. However, before you can begin to use this language, you need to familiarize 
  696. yourself with the elements that make up the syntax of the tags, and special 
  697. rules that govern the use of the tags. 
  698.  
  699.  
  700. ΓòÉΓòÉΓòÉ 4.1. Syntax Conventions ΓòÉΓòÉΓòÉ
  701.  
  702. Each tag must start with a colon (:) and end with a period (.). (The period is 
  703. also known as a delimiter.) For example, the tag for a paragraph is: 
  704.  
  705. :p.
  706.  
  707. A tag indicates how the text that immediately follows it is to be processed. In 
  708. the following example, the text immediately after the paragraph tag (:p.) is 
  709. the actual text that is displayed in the window, and it will begin a new 
  710. paragraph. 
  711.  
  712. :p.There are fewer than 1200 manatees...
  713.  
  714.  
  715. ΓòÉΓòÉΓòÉ 4.1.1. End Tags ΓòÉΓòÉΓòÉ
  716.  
  717. Some tags require end tags. An end tag is e immediately followed by the tag. 
  718. For example, the end tag for the :userdoc. tag is: 
  719.  
  720. :euserdoc.
  721.  
  722. Most of the tags that have end tags affect text format or appearance. The end 
  723. tag tells the IPF compiler to end the operation associated with the tag.  If 
  724. you forget an end tag, the compiler displays an error message. 
  725.  
  726.  
  727. ΓòÉΓòÉΓòÉ 4.1.2. Nested Tags ΓòÉΓòÉΓòÉ
  728.  
  729. Nested tags are tags within other tags.  For example, a common way of 
  730. presenting information is in a list form; a tag begins the list, another tag 
  731. identifies each list item, and yet another tag ends the list.  An example of 
  732. the tagging for a simple list follows: 
  733.  
  734. :sl.
  735. :li.List item 1
  736. :li.List item 2
  737. :li.List item 3
  738. :esl.
  739.  
  740. The list-item tag (:li.) is required for each item in the list.  The :li. tags 
  741. are nested between the :sl. tag and the :esl. tag. 
  742.  
  743. Note:  After paragraph and heading tags, you will probably use list tags most 
  744.        often.  IPF provides general-purpose lists (simple, unordered, and 
  745.        ordered), and special-purpose lists (definition and parameter). 
  746.  
  747.  
  748. ΓòÉΓòÉΓòÉ 4.1.3. Text Strings ΓòÉΓòÉΓòÉ
  749.  
  750. Some tags have text strings associated with them. The string can immediately 
  751. follow the tag, or it can start the line immediately following the tag. For 
  752. example, the tagging for the title bar of a window is :h1. (one of the heading 
  753. tags) and a text string, which is called a title string.  You can enter it like 
  754. this: 
  755.  
  756. :h1.Save the Manatee
  757. or like this: 
  758.  
  759. :h1.
  760. Save the Manatee
  761.  
  762.  
  763. ΓòÉΓòÉΓòÉ 4.1.4. Attributes ΓòÉΓòÉΓòÉ
  764.  
  765. A tag also can have one or more attributes. An attribute contains additional 
  766. information about a tag's operation. The attribute has a name, which may have a 
  767. value or keyword assigned to it. 
  768.  
  769. In the following example, the attribute res= specifies a window identifier. 
  770.  
  771. :h1 res=001.Save the Manatee 
  772.  
  773. In this case, 001 is the assigned value.  The value assigned to a res= 
  774. attribute must be unique for each heading tag. This value also will be the 
  775. identifier for linking to the heading from elsewhere in the information. The 
  776. concept of linking is described in Hypertext Links. 
  777.  
  778. Notice that the period follows the attribute, not the heading tag.  The period 
  779. always follows the last attribute in the tag. 
  780.  
  781. You can specify many attributes in one tag, and they can extend over several 
  782. lines.  However, you cannot split an attribute.  For example, you cannot put 
  783. the res= attribute of the heading tag on one line, and its value, 001, on the 
  784. next line. 
  785.  
  786. Some attributes are optional and have a default (an assumed value) if they are 
  787. not included with the tag; other attributes are required. Tag attributes can be 
  788. specified in any order. 
  789.  
  790. As mentioned, some attributes are required.  For example, if you are creating a 
  791. help library, the res= attribute of a heading tag is required as a window 
  792. identifier (see Window Identifiers). 
  793.  
  794. An attribute also can have a keyword associated with it. For example, an 
  795. attribute of the :color. tag is fc= (foreground color), which is used to 
  796. specify the color of the text.  Its value can be equal to any of the following 
  797. keywords: 
  798.  
  799.      DEFAULT 
  800.      BLUE 
  801.      CYAN 
  802.      GREEN 
  803.      NEUTRAL 
  804.      RED 
  805.      YELLOW. 
  806.  
  807.  Not all attributes have values or keywords. For example, if you want a simple 
  808.  list with no blank lines between the list items, add the compact attribute to 
  809.  the simple-list tag (:sl.).  In the following example, notice the compact 
  810.  attribute stands by itself: 
  811.  
  812.   :sl compact.
  813.   :li.List item 1
  814.   :li.List item 2
  815.   :li.List item 3
  816.   :esl.
  817.  
  818.  
  819. ΓòÉΓòÉΓòÉ 4.1.4.1. Attribute Values with Blank Spaces ΓòÉΓòÉΓòÉ
  820.  
  821. If an attribute value includes blank spaces, the value must be enclosed in 
  822. single quotes.  For example: 
  823.  
  824. :font facename='Tms Rmn'.
  825.  
  826. Notice that the value has initial capitals.  For this particular case, they are 
  827. required; otherwise, the IPF compiler will not recognize them as valid values. 
  828.  
  829. Using some of the tags described thus far, you could produce a source file like 
  830. this: 
  831.  
  832. :userdoc.
  833. :h1 res=001.Save the Manatee
  834. :p.
  835. There are fewer than 1200 manatees in the state of Florida.
  836. Ten percent of the existing herds die each year
  837. because of:
  838. :sl compact.
  839. :li.Contact with boat propellers
  840. :li.Impact from boats and barges
  841. :li.Entrapment in locks and dams.
  842. :esl.
  843. :euserdoc.
  844.  
  845. The output produced from the source file is an OS/2 standard window. 
  846.  
  847. The menu-bar choices, Services, Options, and Help are provided automatically by 
  848. IPF. The title-bar line, "Save the Manatee," is generated by the :h1. tag. The 
  849. viewing area of the window displays the formatted information. 
  850.  
  851. An OS/2 Standard Window Produced from Source File 
  852.  
  853. The best way to learn about tags is to study the examples provided in the 
  854. following sections, then create some windows of your own. 
  855.  
  856.  
  857. ΓòÉΓòÉΓòÉ 4.2. Symbols ΓòÉΓòÉΓòÉ
  858.  
  859. You use symbols to produce characters that cannot be entered from the keyboard. 
  860. A symbol begins with an ampersand (&) and is followed by the symbol name and a 
  861. period.  For example, to produce a square bullet, which looks like this: 
  862.  
  863. Γûá
  864. Enter the symbol like this: 
  865.  
  866. &sqbul.
  867.  
  868. If you want the ampersand character (&) to appear in text, define it as the 
  869. symbol,  &.  Otherwise, the IPF compiler tries to interpret whatever text 
  870. follows the ampersand character as the name of a symbol, and will return the 
  871. error message, Invalid symbol. 
  872.  
  873. Symbols are case-sensitive.  That is, if you do not type them exactly as the 
  874. appear in the symbols table (see Symbols) you could get either the message, 
  875. Invalid Symbol, or a symbol different from the one you want. 
  876.  
  877. Note:  The symbols table is also available online when you install the Online 
  878.        Information component of the Developer's Toolkit for OS/2. 
  879.  
  880.  
  881. ΓòÉΓòÉΓòÉ 4.3. Headings ΓòÉΓòÉΓòÉ
  882.  
  883. Perhaps the most versatile tag is the heading tag. Heading tags enable 
  884. information to be displayed in windows, control entries in the Contents window, 
  885. control placement of push buttons in a window, and define the shape and size of 
  886. windows. With IPF, you can specify six levels of headings, :h1 through :h6. 
  887. For information about default heading levels that start a window and place 
  888. entries in the table of contents window, see the following topic on Controlling 
  889. Entries in the Contents Window. 
  890.  
  891.  
  892. ΓòÉΓòÉΓòÉ 4.3.1. Displaying Window Titles ΓòÉΓòÉΓòÉ
  893.  
  894. Every heading tag that starts a window must have an associated text string. The 
  895. text string becomes the window title and appears in the title bar of the 
  896. window.  The window title also becomes an entry in the Contents window, which 
  897. lists the headings of all topics in an online document. 
  898.  
  899. For a window that occupies the full width of the screen, the maximum length of 
  900. a text string, including spaces and blanks, is 70 characters. A narrower window 
  901. requires a shorter text string. The text string can be on the same line as the 
  902. heading tag, or at the beginning of the next line. 
  903.  
  904. The following example shows the tagging for the first three heading levels, 
  905. with a paragraph following each heading. 
  906.  
  907. :userdoc.
  908. :title.An Online Document
  909. :h1.First Heading Level
  910. :p.
  911. This window is defined by a first-level heading tag.
  912. :h2.Second-Level Heading
  913. :p.
  914. This window is defined by a second-level heading tag.
  915. :h3.Third-Level Heading
  916. :p.
  917. This window is defined by a third-level heading tag.
  918. :euserdoc.
  919.  
  920. The Contents window for the formatted output shows the three heading-level 
  921. entries. 
  922.  
  923. A Contents Window 
  924.  
  925.  
  926. ΓòÉΓòÉΓòÉ 4.3.2. Hiding Window Titles ΓòÉΓòÉΓòÉ
  927.  
  928. If you do not want a title to appear in the Contents window, use the hide 
  929. attribute. The heading definition would be entered like this: 
  930.  
  931. :h3 hide.
  932. Another Third-Level Heading
  933.  
  934. Note:  Your source file must contain at least one heading tag without the hide 
  935.        attribute. 
  936.  
  937.  
  938. ΓòÉΓòÉΓòÉ 4.3.3. Controlling Entries in the Contents Window ΓòÉΓòÉΓòÉ
  939.  
  940. The following example shows some tagging that will control what entries appear 
  941. in the Contents window, as well as what headings will start windows. 
  942.  
  943. :userdoc.
  944. :docprof toc=12.
  945. :h1.Heading Levels
  946. :h2.Second-Level Heading
  947. :p.
  948. This window is defined by a heading-level 2 tag.
  949. :h2.Second-Level Heading
  950. :p.
  951. This window also is defined by a heading-level 2 tag.
  952. :p.
  953. :h3.Third-Level Heading
  954. :p.
  955. Because the &colon.docprof. tag at the beginning of the file
  956. specifies that only heading levels 1 and 2 can be entries in the
  957. Contents window (toc=12), the preceding "Third-Level Heading"
  958. and THIS text, which follows it, become part of the
  959. window defined by the preceding heading-level 2 tag.
  960. :h2 toc=123.Another Second-Level Heading
  961. :p.
  962. The heading-level 2 tag for this window contains
  963. a toc=123 specification.
  964. :h3.Third-Level Heading
  965. :p.
  966. Because the toc=123 in the preceding heading-level 2
  967. tag overrides the toc=12 in the &colon.docprof. tag, this
  968. heading-level 3 tag defines a new window and creates a
  969. Contents entry.
  970. :euserdoc.
  971.  
  972. Unless otherwise specified, the default set of heading tags that create entries 
  973. in the Contents window and define the start of windows are :h1., :h2., and 
  974. :h3.. To change this default, specify a numeric sequence with the table of 
  975. content attribute (toc=) of the :docprof. tag. The :docprof. tag controls the 
  976. heading levels displayed in the Contents window. The sequence must begin with 
  977. level 1 and cannot skip a level in the descending hierarchy. For example, the 
  978. :h4., :h5. and :h6. tags do not start separate windows, but control the 
  979. appearance of the text of the window unless you specify: 
  980.  
  981. :docprof toc=123456.
  982.  
  983. To specify that only heading levels 1 and 2 are to define windows and appear as 
  984. entries in the Contents window, the following tag was used: 
  985.  
  986. :docprof toc=12.
  987.  
  988. The value specified for the toc= attribute remains in effect for all the 
  989. heading definitions in the file.  You can override it by specifying another 
  990. value for the toc= attribute in a heading definition. The new value is then in 
  991. effect for the rest of the headings in the file, or until overridden in another 
  992. heading definition. 
  993.  
  994. In the preceding example, the toc= attribute of the :docprof. tag is overridden 
  995. by the toc= attribute of a heading tag. 
  996.  
  997. The next example shows the results of the tagging. Notice the effect of 
  998. including a heading level that is lower in the hierarchy than the range of 
  999. heading levels specified with the :docprof. tag. 
  1000.  
  1001. Contents Window with Displayed Third-Level Heading Window 
  1002.  
  1003. When the file is viewed, the :h3. title and the text following it are included 
  1004. as part of the window defined by the preceding :h2. tag. 
  1005.  
  1006.  
  1007. ΓòÉΓòÉΓòÉ 4.3.4. Special Rules ΓòÉΓòÉΓòÉ
  1008.  
  1009. Sequential Coding for Heading Tags:  Headings for a series of windows must 
  1010. always start with :h1. and proceed in sequence. That is, you cannot have :h1. 
  1011. followed by :h3.. However, you can follow :h3. with :h1.. 
  1012.  
  1013. Source File Size between Heading Tags:  Do not exceed 16 000 words, numbers, 
  1014. and punctuation marks between two consecutive heading tags in your source file. 
  1015. This includes blank spaces, but does not include commented lines (see Comment). 
  1016. If the source file exceeds this limit, the compiler will generate an error 
  1017. message. To correct the error, use another heading tag. 
  1018.  
  1019. For more information about heading tags and attributes that define 
  1020. characteristics of windows, see Customizing Windows. 
  1021.  
  1022. Note:  At least one :h1. must not be hidden. 
  1023.  
  1024.  
  1025. ΓòÉΓòÉΓòÉ 4.4. Push Buttons ΓòÉΓòÉΓòÉ
  1026.  
  1027. Push buttons provide users with a fast and easy way to access commonly used IPF 
  1028. tasks.  When a user selects a push button, the action represented by the text 
  1029. on the push button is carried out immediately. Push buttons are displayed in a 
  1030. window called a control area.  A control area can be defined within the IPF 
  1031. coverpage window, or the IPF text window (the child of the coverpage window), 
  1032. or both.  For information about the IPF coverpage, see the following figure. 
  1033.  
  1034. IPF provides one set of push buttons for online documents and another set for 
  1035. help windows. 
  1036.  
  1037.  For online documents, the set of push buttons consists of: 
  1038.  
  1039.         Previous 
  1040.         Search 
  1041.         Print 
  1042.         Index 
  1043.         Contents 
  1044.         Back 
  1045.         Forward 
  1046.         Tutorial (only if a tutorial is available). 
  1047.  
  1048.  For help windows, the set of push buttons consists of 
  1049.  
  1050.         Previous 
  1051.         Search 
  1052.         Print 
  1053.         Index 
  1054.         Tutorial (only if a tutorial is available). 
  1055.  
  1056.  The following figure shows an online document with a set of push buttons in 
  1057.  the control area of the the coverpage window (the default control area). 
  1058.  
  1059.  The IPF Default Window for Push Buttons. These push buttons appear in the 
  1060.  control area of the coverpage window. 
  1061.  
  1062.  Notice the difference in the following figure. This example shows a help 
  1063.  window with a set of push buttons in the control area of the IPF text window. 
  1064.  
  1065.  A Help Window. These push buttons were defined in the control area of the IPF 
  1066.  page window. 
  1067.  
  1068.  If the user changes the size of the window, the push buttons in the control 
  1069.  area will wrap around onto the next line. The push buttons cannot be clipped 
  1070.  or scrolled horizontally, because the control area is not part of the 
  1071.  scrollable area of the IPF text window. 
  1072.  
  1073.  
  1074. ΓòÉΓòÉΓòÉ 4.4.1. Tagging Example for the Default Set of Push Buttons ΓòÉΓòÉΓòÉ
  1075.  
  1076. The following example shows the minimum tagging required for an online document 
  1077. that is to have a control area with the default set of push buttons displayed 
  1078. in the coverpage window. 
  1079.  
  1080. :userdoc.
  1081. :title.Coverpage Window
  1082. :h1.IPF Text Window
  1083. :p.Text goes here.
  1084. :euserdoc.
  1085.  
  1086. Notice no extra tagging is necessary. 
  1087.  
  1088.  
  1089. ΓòÉΓòÉΓòÉ 4.4.2. Specifying Push Buttons for the Control Area of a Window ΓòÉΓòÉΓòÉ
  1090.  
  1091. The control area tag (:ctrl.) specifies where push buttons are to be displayed, 
  1092. and which push buttons you want displayed.  When specifying a control area, 
  1093. always precede the tagging with :docprof., then imbed :ctrl. between the 
  1094. control-area definition tags (:ctrldef. and :ectrldef.). For example: 
  1095.  
  1096. :docprof toc=123.
  1097. :ctrldef.
  1098. :ctrl.
  1099. :ectrldef.
  1100.  
  1101.  
  1102. ΓòÉΓòÉΓòÉ 4.4.3. Attribute Values for the Control Area of a Window ΓòÉΓòÉΓòÉ
  1103.  
  1104. The controls= attribute of :ctrl. identifies the push buttons that you want in 
  1105. the control area of a window.  Push buttons are displayed in the order in which 
  1106. they are defined. Values that can be specified are: 
  1107.  
  1108.  Search         Specifies the Search push button.  When selected, this push 
  1109.                 button displays a window that lets the user search for a word 
  1110.                 or phrase. 
  1111.  
  1112.  Print          Specifies the Print push button.  When selected, this push 
  1113.                 button displays a window that lets the user print one or more 
  1114.                 topics. 
  1115.  
  1116.  Index          Specifies the Index push button.  When selected, this push 
  1117.                 button displays an alphabetic list of the topics in the 
  1118.                 document. 
  1119.  
  1120.  Contents       Specifies the Contents push button.  When selected, this push 
  1121.                 button displays the Contents window. 
  1122.  
  1123.  Esc            Specifies the Previous push button.  When selected, this push 
  1124.                 button lets the user see information from an earlier request. 
  1125.  
  1126.  Back           Specifies the Back push button.  When selected, this push 
  1127.                 button displays the previous page in the table of contents 
  1128.                 hierarchy. 
  1129.  
  1130.  Forward        Specifies the Forward push button.  When selected, this push 
  1131.                 button displays the next page in the table of contents 
  1132.                 hierarchy. 
  1133.  
  1134.  Note:  A value for the Tutorial push button is not provided because it is 
  1135.         displayed automatically if a tutorial exists. 
  1136.  
  1137.  Both the page and coverpage attributes of :ctrl. affect where push buttons are 
  1138.  displayed.  For example, you use page to specify that push buttons are to be 
  1139.  in the IPF text window; similarly, you use coverpage to specify that push 
  1140.  buttons are to be in the IPF coverpage window. 
  1141.  
  1142.  A control area also can have a value associated with it.  The ctrlid= 
  1143.  attribute specifies the value, which can be either alpha or alphanumeric, and 
  1144.  is referred to by a heading tag. In the following example, ctrlid= specifies a 
  1145.  window identifier, and instructs the compiler to display the Previous, 
  1146.  Forward, and Back push buttons in the control area of the coverpage window: 
  1147.  
  1148.   :docprof toc=123.
  1149.   :ctrldef.
  1150.   :ctrl ctrlid=new1 controls='ESC FORWARD BACK' coverpage.
  1151.   :ectrldef.
  1152.  
  1153.  Conversely, the following example shows the tagging for an online document 
  1154.  that will display the Previous, Forward, and Back push buttons in the control 
  1155.  area of an IPF page window. 
  1156.  
  1157.   :docprof toc=123 ctrlarea=page.
  1158.   :ctrldef.
  1159.   :ctrl ctrlid=new1 controls='ESC FORWARD BACK' page.
  1160.   :ectrldef.
  1161.  
  1162.  Notice the ctrlarea=page attribute of :docprof..  When the IPF compiler 
  1163.  encounters ctrlarea=page, it defines the control area as the IPF page window 
  1164.  and removes the push buttons from the control area of the coverpage window. 
  1165.  You must ALWAYS specify the ctrlarea= attribute in :docprof. when overriding 
  1166.  the default control area in a window. 
  1167.  
  1168.  Other values for ctrlarea= are: 
  1169.  
  1170.  coverpage     Identifies the control area as the bottom of the coverpage 
  1171.                window.  This is the default value. 
  1172.  
  1173.  both          Specifies both the control area within an IPF text window, and 
  1174.                the coverpage window. 
  1175.  
  1176.  none          Specifies that you do not want a control area (that is, you do 
  1177.                not want push buttons). 
  1178.  
  1179.  You can define more than one control area with different sets of push buttons 
  1180.  for the IPF text window; however, only one set of push buttons can be defined 
  1181.  for the coverpage window. 
  1182.  
  1183.  
  1184. ΓòÉΓòÉΓòÉ 4.4.4. Controlling the Display of Push Buttons in Designated Windows ΓòÉΓòÉΓòÉ
  1185.  
  1186. Suppose your document consisted of 100 windows, and you wanted only one window 
  1187. to display push buttons in the control area of the IPF text window.  The 
  1188. ctrlarea= attribute of a heading tag specifies which control area in a window 
  1189. you want to display push buttons.  You would tag your source file as follows: 
  1190.  
  1191. :docprof ctrlarea=none.
  1192. .
  1193. .
  1194. .
  1195. :h1 ctrlarea=page.One Window
  1196.  
  1197. When ctrlarea= is encountered in a heading tag, it overrides the ctrlarea= 
  1198. attribute specified by :docprof.. 
  1199.  
  1200.  
  1201. ΓòÉΓòÉΓòÉ 4.4.5. Disabling the Display of Push Buttons ΓòÉΓòÉΓòÉ
  1202.  
  1203. The following example shows the minimum tagging for an online document without 
  1204. push buttons. 
  1205.  
  1206. :userdoc.
  1207. :title.Coverpage Window Title
  1208. :docprof toc=123 ctrlarea=none.
  1209. :h1.IPF Text Window
  1210. :p.Text goes here.
  1211. :euserdoc.
  1212.  
  1213.  
  1214. ΓòÉΓòÉΓòÉ 4.4.6. Author-Defined Push Buttons ΓòÉΓòÉΓòÉ
  1215.  
  1216. IPF also supports author-defined pushbuttons. For example, you can define a 
  1217. push button for Examples that can be included in the control area of a 
  1218. coverpage or IPF text window.  When an author-defined push button is selected, 
  1219. the message HM_NOTIFY is sent to the application or communication object. It is 
  1220. the responsibility of the application or communication object to respond to 
  1221. this message.  For information about communication objects, see Controlling 
  1222. Windows with Applications (ACVIEWPORTS). 
  1223.  
  1224. The push button tag (:pbutton.) defines author-defined push buttons.  This tag 
  1225. must be imbedded within the :ctrldef. and :ectrldef. tags, and it must precede 
  1226. the :ctrl. tag. 
  1227.  
  1228. The following example shows how to override the default set of push buttons in 
  1229. the coverpage window with a set that consists of Search, Index, Previous, and 
  1230. Example. 
  1231.  
  1232. :userdoc.
  1233. :docprof toc=123 dll='example' objectname='xmpbutton'.
  1234. :ctrldef.
  1235. :pbutton id=xmp res=257 text='~Example'.
  1236. :ctrl ctrlid=new1 controls='SEARCH INDEX ESC XMP' coverpage.
  1237. :ectrldef.
  1238.  
  1239. Notice that a dynamic link library (DLL) is required to support the function 
  1240. you want to provide with an author-defined push button. For more information, 
  1241. see :pbutton. (Push Button). 
  1242.  
  1243.  
  1244. ΓòÉΓòÉΓòÉ 4.4.7. About the Tutorial Push Button ΓòÉΓòÉΓòÉ
  1245.  
  1246. When the Tutorial push button is selected, the message HM_TUTORIAL is sent to 
  1247. the application or communication object.  This is the same message that is sent 
  1248. when the Tutorial choice is selected from the Help pull-down, or when the 
  1249. tutorial attribute is specified with the heading tag. 
  1250.  
  1251. The Tutorial push button is included only if a tutorial was specified in the 
  1252. initialization structure (HMINIT) or with the tutorial attribute in a heading 
  1253. tag. 
  1254.  
  1255.  
  1256. ΓòÉΓòÉΓòÉ 4.5. Indexing ΓòÉΓòÉΓòÉ
  1257.  
  1258. IPF provides an index for both online documents and help windows from the 
  1259. following tags. 
  1260.  
  1261. :i1.
  1262. :i2.
  1263.  
  1264. The :i1. tag creates a primary entry, which means the entry is at the first 
  1265. level. The :i2. tag provides a secondary entry to the primary one. 
  1266.  
  1267. Index entries are imbedded in the text of a window.  You should create at least 
  1268. one index entry for each window, using the :i1. tag. The text of an index entry 
  1269. must be on the same line as the tag. 
  1270.  
  1271. You form an index for online documents and help windows the same way.  For 
  1272. example, to create the index entry: 
  1273.  
  1274. copy program
  1275.  
  1276. use the following tagging 
  1277.  
  1278. :i1.copy program
  1279.  
  1280. To create two levels of index entries, you use the :i1. tag with the id= 
  1281. attribute, and the :i2. tag, with the refid= attribute. Here is how to do it. 
  1282.  
  1283.    1. Create the primary index entry and give it an identifier; for example: 
  1284.  
  1285.             :i1 id=prnt.printers and plotters
  1286.  
  1287.    2. Create the secondary index entries that will be listed under the primary 
  1288.       index entry, and refer to the identifier of the primary entry; for 
  1289.       example: 
  1290.  
  1291.             :i2 refid=prnt.change printer
  1292.             :i2 refid=prnt.add printer
  1293.             :i2 refid=prnt.printer properties
  1294.  
  1295.  When an :i1. tag has an identifier that is referred to by refid= attributes of 
  1296.  :i2. tags, the :i1. tag must precede the :i2. tags in the file. Index entries 
  1297.  can be located in any of the windows defined in your source file; however, 
  1298.  they cannot be in a footnote. 
  1299.  
  1300.  After your source file is compiled and the user selects Index from the Options 
  1301.  menu, or the Index push button, the index entries look like this: 
  1302.  
  1303.   printers and plotters
  1304.      add printer
  1305.      change printer
  1306.      printer properties
  1307.  
  1308.  
  1309. ΓòÉΓòÉΓòÉ 4.5.1. Index-Synonyms ΓòÉΓòÉΓòÉ
  1310.  
  1311. As a way of helping the user search for index entries by using synonyms, IPF 
  1312. provides the index-synonym tag (:isyn.).  This tag requires the root= 
  1313. attribute.  With these, you can specify synonyms that will be associated with 
  1314. primary index entries.  The :i1. tags for these primary entries require a 
  1315. roots='' attribute that associates the entry with the synonyms. 
  1316.  
  1317. For example, assume you have the following entries in your file: 
  1318.  
  1319. :isyn root=copy.
  1320. copy copying duplicate duplicating
  1321. :isyn root=folder.
  1322. folder folders document documents
  1323. :i1 roots='copy folder'.
  1324. copying a document
  1325.  
  1326. The roots=' ' attribute of the :i1. tag associates "copying a document" with 
  1327. the synonyms of the root= attributes of the two :isyn. tags. 
  1328.  
  1329. Now if a user, when requesting a search of the index, specifies any of the 
  1330. words in either of the two :isyn. entries, the search results will include all 
  1331. :i1. entries that contain the specified word, as well as any :i1. entries that 
  1332. have been associated with the word by a roots= attribute. 
  1333.  
  1334. For example, the user enters "duplicating" in a search request.  When the 
  1335. search is completed, one of the entries in the search results window is: 
  1336.  
  1337. copying a document
  1338.  
  1339.  
  1340. ΓòÉΓòÉΓòÉ 4.5.2. Customizing Master Help Index and Glossary Objects ΓòÉΓòÉΓòÉ
  1341.  
  1342. OS/2 online information is accessible through the "Master Help Index" and 
  1343. "Glossary" Workplace Shell objects. Users can access alphabetized lists of 
  1344. index entries simply by double clicking on the icons for these objects. 
  1345.  
  1346. As an author who wants to create or modify Help Indexes and Glossaries, you 
  1347. need to understand that the Master Help Index object and Glossary object that 
  1348. are installed by default with the OS/2 operating system are the same class of 
  1349. object. In other words, they are the exact same kind of object. Like the rest 
  1350. of the Workplace Shell user objects, they can be created, shadowed, copied, and 
  1351. so on. This also means that they can be modified through the "Settings 
  1352. Notebook". To look at the Settings Notebook for the Master Help Index, simply 
  1353. do the following: 
  1354.  
  1355.    1. Select the Master Help Index user object by single-clicking on its icon 
  1356.       with mouse button 1. 
  1357.  
  1358.    2. Press mouse button 2 for the object's pop-up menu. 
  1359.  
  1360.    3. Select "Open" with mouse button 1, then select "Settings" from the pop-up 
  1361.       menu that appears. 
  1362.  
  1363.  The "Properties" page of the Master Help Index object's Settings Notebook can 
  1364.  be modified. On this page, the "Files/Environment name(s):" setting can be 
  1365.  modified. This setting specifies where online helps (.HLP files) containing 
  1366.  Master Help Index entries are located. The Master Help Index object's default 
  1367.  setting is defined in the file CONFIG.SYS by the "HELP" environment variable. 
  1368.  
  1369.  The global attribute of the :i1. and :i2. tags identifies index entries as 
  1370.  candidates for the Master Help Index or Glossary. Good candidates are pointers 
  1371.  to procedural and conceptual topics.  For example, a simple Master Help Index 
  1372.  entry for conceptual information about batch files might look like this: 
  1373.  
  1374.   :i1 global.batch files, creating
  1375.  When referring to an :i1. tag, use the global attribute in both the :i1. and 
  1376.  :i2. tags.  For example: 
  1377.  
  1378.   :i1 id=copy global.copying
  1379.   :i2 refid=copy global.help topics
  1380.   :i2 refid=copy global.document topics
  1381.  
  1382.  As an author, you can create product-specific indexes and glossaries, add 
  1383.  entries to the Master Help Index or Glossary (or customized, renamed copies of 
  1384.  either user object), change their Notebook "Files/Environment name(s):" 
  1385.  Settings to match online helps with global index entries, and so on. However, 
  1386.  it requires programming skills to enable applications to do these tasks at 
  1387.  installation or run time (see Creating Master Indexes and Glossaries with 
  1388.  Applications). 
  1389.  
  1390.  
  1391. ΓòÉΓòÉΓòÉ 4.6. Control Words ΓòÉΓòÉΓòÉ
  1392.  
  1393. In addition to tags, you can include control words in your source files to 
  1394. request special processing from the IPF compiler. A control word is placed at 
  1395. the beginning of a line, and starts with a period (.). Control words must begin 
  1396. in column one. 
  1397.  
  1398. The IPF compiler recognizes the following control words: 
  1399.  
  1400.  .im filename        Imbed this file in the current file. 
  1401.  
  1402.  .*                  Treat this line of text as a comment and do not interpret. 
  1403.  
  1404.  .br                 Start a new line of text. 
  1405.  
  1406.  .nameit             Perform compile time symbol substitution. 
  1407.  
  1408.  .ce                 Centers Text 
  1409.  
  1410.  
  1411. ΓòÉΓòÉΓòÉ 4.6.1. Imbed ΓòÉΓòÉΓòÉ
  1412.  
  1413. The IPF compiler can produce a single output document by processing one master 
  1414. source file that imbeds other source files. The imbed control word (.im) sends 
  1415. a signal to the compiler to process each file in the sequence listed in the 
  1416. master file. 
  1417.  
  1418. This process is most often associated with online documents.  A portion of the 
  1419. master file for the online IPF Reference looks like this: 
  1420.  
  1421. :userdoc.
  1422. .
  1423. .
  1424. .
  1425. .im ipfcch01.ipf
  1426. .im ipfcch02.ipf
  1427. .im ipfcch03.ipf
  1428. .
  1429. .
  1430. .
  1431.  
  1432. If you are imbedding files, the source file that begins with the :userdoc. tag 
  1433. is considered the master file. The imbedded files cannot have :userdoc. and 
  1434. :euserdoc.. 
  1435.  
  1436.  
  1437. ΓòÉΓòÉΓòÉ 4.6.2. Comment ΓòÉΓòÉΓòÉ
  1438.  
  1439. Occasionally, you might want to insert comments in your source file solely for 
  1440. the purpose of providing information. The .* enables you to do this.  Any text 
  1441. on the same line as this control word is ignored by the compiler. For example, 
  1442. the compiler would recognize the following lines as comment lines and ignore 
  1443. them. 
  1444.  
  1445. .*********************************
  1446. .* This file contains the
  1447. .* introduction to IPF.
  1448. .**********************************
  1449.  
  1450.  
  1451. ΓòÉΓòÉΓòÉ 4.6.3. Break ΓòÉΓòÉΓòÉ
  1452.  
  1453. The break control word (.br) interrupts the display of text on a line, and 
  1454. continues it on the next line.  The break control word must be the only entry 
  1455. on the line.  For example, assume the source file has the following lines. 
  1456.  
  1457. :p.These words
  1458. appear on
  1459. the same line.
  1460. .br
  1461. These words
  1462. .br
  1463. do not.
  1464.  
  1465. The output looks like this: 
  1466.  
  1467. These words appear on the same line.
  1468. These words
  1469. do not.
  1470.  
  1471. If you enter text on the same line as the break control word, the IPF compiler 
  1472. ignores the break control word. 
  1473.  
  1474.  
  1475. ΓòÉΓòÉΓòÉ 4.6.4. Nameit ΓòÉΓòÉΓòÉ
  1476.  
  1477. The nameit control word (.nameit) is a macro that allows you to create a 
  1478. special kind of symbol. Nameit has two operands that are used in IPF, SYMBOL 
  1479. and TEXT.  The operands can be in any order (.nameit symbol=name 
  1480. text='string'). 
  1481.  
  1482. Symbol=name identifies the name of the symbols (just the name, without the 
  1483. preceding & or the trailing period) you want to create. It can be up to 10 
  1484. characters long (A-Z, 0-9), with no blanks or special characters; the first 
  1485. character must be a letter. 
  1486.  
  1487. Text='string' identifies the content of the value to be assigned to the symbol 
  1488. and is what is printed. 
  1489.  
  1490. Here's an example of how .nameit could be used in your document: 
  1491.  
  1492. .nameit symbol=os text='operating system'
  1493. .
  1494. .
  1495. :p.The &os supports multitasking.
  1496.  
  1497. The output looks like this: 
  1498.  
  1499. The operating system supports multitasking.
  1500.  
  1501. Note:  You do not use the & in the .nameit when you actually use the symbol. 
  1502.        Also, you must use a period at the end of the symbol name when you use 
  1503.        the symbol. 
  1504.  
  1505.  
  1506. ΓòÉΓòÉΓòÉ 4.6.5. Center Text ΓòÉΓòÉΓòÉ
  1507.  
  1508. The ce control word (.ce) enables you to center text. For example, assume the 
  1509. source file has the following lines. 
  1510.  
  1511. :p.These words
  1512. appear as normal
  1513. text on the same
  1514. line.
  1515. .ce These words appear as centered text on the same line.
  1516.  
  1517. The output looks like this: 
  1518.  
  1519. These words appear as normal text on the same line.
  1520. These words appear as centered text on the same line.
  1521.  
  1522.  
  1523. ΓòÉΓòÉΓòÉ 5. Displaying Text and Graphics ΓòÉΓòÉΓòÉ
  1524.  
  1525. Once you have defined your window, you need to consider the various ways text 
  1526. can be displayed.  This chapter describes how you can use tags and symbols to: 
  1527.  
  1528.      Highlight text 
  1529.      Add notes, notices, and lists 
  1530.      Define tables for a structured display of data 
  1531.      Illustrate your text with examples, figures, and character graphics 
  1532.      Control the formatting of lines of text 
  1533.      Change the font and color of the displayed information 
  1534.      Set the margins of the text 
  1535.      Display art. 
  1536.  
  1537.  
  1538. ΓòÉΓòÉΓòÉ 5.1. Highlighted Phrases ΓòÉΓòÉΓòÉ
  1539.  
  1540. Text can be highlighted by using different type styles or color.  There are 
  1541. nine highlighted-phrase tags you can use to emphasize text (:hp1. through 
  1542. :hp9.). Each tag requires a corresponding end tag (:ehp1. through :ehp9.). 
  1543.  
  1544. In the following example, the highlighted phrases are shown as list items in a 
  1545. compact simple list. 
  1546.  
  1547. Input Example 
  1548.  
  1549.       :sl compact. 
  1550.       :li.:hp1.Highlighted phrase 1 looks like this.:ehp1. 
  1551.       :li.:hp2.Highlighted phrase 2 looks like this.:ehp2. 
  1552.       :li.:hp3.Highlighted phrase 3 looks like this.:ehp3. 
  1553.       :li.:hp4.Highlighted phrase 4 looks like this.:ehp4. (BLUE) 
  1554.       :li.:hp5.Highlighted phrase 5 looks like this.:ehp5. 
  1555.       :li.:hp6.Highlighted phrase 6 looks like this.:ehp6. 
  1556.       :li.:hp7.Highlighted phrase 7 looks like this.:ehp7. 
  1557.       :li.:hp8.Highlighted phrase 8 looks like this.:ehp8. (RED) 
  1558.       :li.:hp9.Highlighted phrase 9 looks like this.:ehp9. (PINK) 
  1559.       :esl. 
  1560.  
  1561.  The following example shows the output produced by these tags. 
  1562.  
  1563.  Formatted Output 
  1564.  
  1565.       Highlighted phrase 1 looks like this. 
  1566.  
  1567.       Highlighted phrase 2 looks like this. 
  1568.  
  1569.       Highlighted phrase 3 looks like this. 
  1570.  
  1571.       Highlighted phrase 4 looks like this. 
  1572.  
  1573.       Highlighted phrase 5 looks like this. 
  1574.  
  1575.       Highlighted phrase 6 looks like this. 
  1576.  
  1577.       Highlighted phrase 7 looks like this. 
  1578.  
  1579.       Highlighted phrase 8 looks like this. 
  1580.  
  1581.       Highlighted phrase 9 looks like this. 
  1582.  
  1583.  Highlighted Phrases 
  1584.  
  1585.  The type styles displayed for highlighted phrases correspond to the typeface 
  1586.  currently being used by IPF. You can change the typeface to Courier, 
  1587.  Helvetica** or Times New Roman** by using the :font. tag.  See Changing Fonts. 
  1588.  
  1589.  ** Helvetica is a trademark of Linotype AG 
  1590.  ** Times New Roman is a trademark of Monotype Corporation 
  1591.  
  1592.  
  1593. ΓòÉΓòÉΓòÉ 5.2. Notes ΓòÉΓòÉΓòÉ
  1594.  
  1595. To include notes in your information, you use a note tag: either :note. or :nt. 
  1596. (with its corresponding :ent.). 
  1597.  
  1598. The one you use depends on whether your note consists of one paragraph or more 
  1599. than one. 
  1600.  
  1601.  
  1602. ΓòÉΓòÉΓòÉ 5.2.1. :note. ΓòÉΓòÉΓòÉ
  1603.  
  1604. Use :note. for single-paragraph notes. You do not need an end tag. 
  1605.  
  1606. Following is an example of :note. and the resulting output. 
  1607.  
  1608. Input Example 
  1609.  
  1610. :note.Complete all entry fields before leaving
  1611. this window.  If you do not, all your information will be lost.
  1612.  
  1613. Formatted Output 
  1614.  
  1615. Note:  Complete all entry fields before leaving this window. If you do not, all 
  1616. your information will be lost. 
  1617.  
  1618.  
  1619. ΓòÉΓòÉΓòÉ 5.2.2. :nt. ΓòÉΓòÉΓòÉ
  1620.  
  1621. Use :nt. to create notes with more than one paragraph.  Remember to end the 
  1622. note with :ent.. In the following example, notice how the IPF compiler indents 
  1623. the text for the paragraphs in the note. 
  1624.  
  1625. Input Example 
  1626.  
  1627. :nt.Complete all entry fields before leaving
  1628. this window.  If you do not, all your information will be lost.
  1629. :p.If your information is lost, retype it in
  1630. the entry fields.
  1631. :ent.
  1632.  
  1633. Formatted Output 
  1634.  
  1635. Note:  Complete all entry fields before leaving this window.  If you do not, 
  1636.        all your information will be lost. 
  1637.  
  1638. If your information is lost, retype it in the entry fields. 
  1639.  
  1640.  Another Name for a Note:  Both :nt. and :note. provide the text= attribute, so 
  1641.  you can substitute your own word or phrase for the word "Note."  The following 
  1642.  shows the use of this attribute: 
  1643.  
  1644.  Input Example 
  1645.  
  1646.   :note text='Reminder'.Complete all
  1647.   entry fields before leaving this window.
  1648.  
  1649.  Formatted Output 
  1650.  
  1651.  Reminder:  Complete all entry fields before leaving this window. 
  1652.  
  1653.  
  1654. ΓòÉΓòÉΓòÉ 5.3. Notices ΓòÉΓòÉΓòÉ
  1655.  
  1656. Two tags enable you to include caution and warning notices in your information. 
  1657. Both tags require end tags. 
  1658.  
  1659.  
  1660. ΓòÉΓòÉΓòÉ 5.3.1. :caution. ΓòÉΓòÉΓòÉ
  1661.  
  1662. The following example shows how :caution. is used: 
  1663.  
  1664. Input Example 
  1665.  
  1666. :caution.
  1667. Be sure to save your data.  If you do not, all data will be lost.
  1668. :ecaution.
  1669.  
  1670. Formatted Output 
  1671.  
  1672. CAUTION:
  1673. Be sure to save your data.  If you do not, all data will be lost.
  1674.  
  1675.  
  1676. ΓòÉΓòÉΓòÉ 5.3.2. :warning. ΓòÉΓòÉΓòÉ
  1677.  
  1678. The following example shows how :warning. is used: 
  1679.  
  1680. Input Example 
  1681.  
  1682. :warning.
  1683. The disk contains bad sectors.
  1684. :ewarning.
  1685.  
  1686. Formatted Output 
  1687.  
  1688. Warning: The disk contains bad sectors. 
  1689.  
  1690. Place the caution and warning statements before the help information to which 
  1691. they apply so the user is cautioned or warned in advance. You can use the text= 
  1692. attribute if you want to use words other than "Caution" and "Warning" with 
  1693. these notices. 
  1694.  
  1695.  
  1696. ΓòÉΓòÉΓòÉ 5.4. Simple List ΓòÉΓòÉΓòÉ
  1697.  
  1698. Simple lists are vertical arrangements of items without any symbol or character 
  1699. preceding the items in the list.  Use simple lists when the order of the items 
  1700. is not important. 
  1701.  
  1702. To create a simple list, use the simple-list tag (:sl.) to begin the list and 
  1703. its corresponding end tag, :esl.. Identify each item in the list with a 
  1704. list-item tag (:li.). 
  1705.  
  1706. Input Example 
  1707.  
  1708. :p.Bring the following for lunch:
  1709. :sl.
  1710. :li.Fruit
  1711. :li.Sandwich
  1712. :li.Drink
  1713. :esl.
  1714.  
  1715. Formatted Output 
  1716.  
  1717. Bring the following for lunch: 
  1718.  
  1719.       Fruit 
  1720.  
  1721.       Sandwich 
  1722.  
  1723.       Drink 
  1724.  
  1725.  A Compact Simple List:  Use the compact attribute to produce a list with no 
  1726.  blank lines between the list items. 
  1727.  
  1728.  Input Example 
  1729.  
  1730.   :p.Bring the following for lunch:
  1731.   :sl compact.
  1732.   :li.Fruit
  1733.   :li.Sandwich
  1734.   :li.Drink
  1735.   :esl.
  1736.  
  1737.  Formatted Output 
  1738.  
  1739.  Bring the following for lunch: 
  1740.  
  1741.       Fruit 
  1742.       Sandwich 
  1743.       Drink 
  1744.  
  1745.  Nested Lists:  A nested list is a list that is contained within another list. 
  1746.  The following shows the tagging for a simple list nested within another simple 
  1747.  list, and the resulting output. 
  1748.  
  1749.  Input Example 
  1750.  
  1751.   :p.Bring the following for lunch:
  1752.   :sl.
  1753.   :li.Fruit, for example:
  1754.   :sl compact.
  1755.   :li.Apple
  1756.   :li.Orange
  1757.   :li.Pear
  1758.   :li.Banana
  1759.   :esl.
  1760.   :li.Sandwich
  1761.   :li.A drink
  1762.   :esl.
  1763.  
  1764.  Formatted Output 
  1765.  
  1766.  Bring the following for lunch: 
  1767.  
  1768.       Fruit, for example: 
  1769.  
  1770.            Apple 
  1771.            Orange 
  1772.            Pear 
  1773.            Banana 
  1774.  
  1775.       Sandwich 
  1776.  
  1777.       A drink 
  1778.  
  1779.  
  1780. ΓòÉΓòÉΓòÉ 5.5. Unordered List ΓòÉΓòÉΓòÉ
  1781.  
  1782. Unordered lists are vertical arrangements of items, with each item in the list 
  1783. preceded by a special character, usually the lowercase "o" (called a bullet). 
  1784.  
  1785. Use unordered lists when the order of the items is not important. 
  1786.  
  1787. To create an unordered list, use the unordered-list tag (:ul.) to begin the 
  1788. list and :eul. to end it.  Identify each item in the list with :li.. 
  1789.  
  1790. Input Example 
  1791.  
  1792. :ul.
  1793. :li.Information typed in Window A will be stored in the
  1794. STORES.DAT file in whatever directory you designate.
  1795. :li.Information typed in Window B will be stored in the
  1796. SALES.DAT file in the current directory.
  1797. :li.Information typed in Window C will be stored in the
  1798. LOSSES.DAT file in the C:\FINANCE directory.
  1799. :eul.
  1800.  
  1801. Formatted Output 
  1802.  
  1803.      Information typed in Window A will be stored in the STORES.DAT file in 
  1804.       whatever directory you designate. 
  1805.  
  1806.      Information typed in Window B will be stored in the SALES.DAT file in the 
  1807.       current directory. 
  1808.  
  1809.      Information typed in Window C will be stored in the LOSSES.DAT file in 
  1810.       the C:\FINANCE directory. 
  1811.  
  1812.  Note:  To change bullet or dash character, change the appropriate .NLS file 
  1813.         coding of ULITEM IDX=' ', located in the \TOOLKIT\IPFC subdirectory. 
  1814.  
  1815.  A Compact Unordered List:  Use the compact attribute to produce a list with no 
  1816.  blank lines between the list items. 
  1817.  
  1818.  Input Example 
  1819.  
  1820.   :ul compact.
  1821.   :li.Information typed in Window A will be stored in the
  1822.   STORES.DAT file in whatever directory you designate.
  1823.   :li.Information typed in Window B will be stored in the
  1824.   SALES.DAT file in the current directory.
  1825.   :li.Information typed in Window C will be stored in the
  1826.   LOSSES.DAT file in the C:\FINANCE directory.
  1827.   :eul.
  1828.  
  1829.  Formatted Output 
  1830.  
  1831.      Information typed in Window A will be stored in the STORES.DAT file in 
  1832.       whatever directory you designate. 
  1833.      Information typed in Window B will be stored in the SALES.DAT file in the 
  1834.       current directory. 
  1835.      Information typed in Window C will be stored in the LOSSES.DAT file in 
  1836.       the C:\FINANCE directory. 
  1837.  
  1838.  Nested Unordered Lists:  The following example contains two nested, unordered 
  1839.  lists. Notice that a bullet (lowercase "o") precedes items in the first-level 
  1840.  list and that a dash (-) precedes items in the second-level lists.  The 
  1841.  bullets and dashes alternate for each level of the list.  That is, third-level 
  1842.  list items would be preceded by bullets, fourth-level by dashes, and so on. 
  1843.  
  1844.  Input Example 
  1845.  
  1846.   :ul compact.
  1847.   :li.C:\REPORTS\SALES.89
  1848.   :ul compact.
  1849.   :li.FIRST.QTR
  1850.   :li.SECOND.QTR
  1851.   :li.THIRD.QTR
  1852.   :li.FOURTH.QTR
  1853.   :eul.
  1854.   :li.C:\REPORTS\SALES.90
  1855.   :ul compact.
  1856.   :li.FIRST.QTR
  1857.   :li.SECOND.QTR
  1858.   :li.THIRD.QTR
  1859.   :li.FOURTH.QTR
  1860.   :eul.
  1861.   :eul.
  1862.  
  1863.  Formatted Output 
  1864.  
  1865.      C:\REPORTS\SALES.89 
  1866.         -  FIRST.QTR 
  1867.         -  SECOND.QTR 
  1868.         -  THIRD.QTR 
  1869.         -  FOURTH.QTR 
  1870.      C:\REPORTS\SALES.90 
  1871.         -  FIRST.QTR 
  1872.         -  SECOND.QTR 
  1873.         -  THIRD.QTR 
  1874.         -  FOURTH.QTR 
  1875.  
  1876.  When nesting lists, make sure you end each list with an end-list tag. 
  1877.  
  1878.  
  1879. ΓòÉΓòÉΓòÉ 5.6. Ordered List ΓòÉΓòÉΓòÉ
  1880.  
  1881. Ordered lists are vertical arrangements of items, with each item in the list 
  1882. preceded by a number or letter.  Use ordered lists when the sequence of the 
  1883. items is important, such as in a procedure. 
  1884.  
  1885. To create an ordered list, use the ordered-list tag (:ol.) to begin the list 
  1886. and :eol. to end it.  Identify each item in the list with :li.. 
  1887.  
  1888. Input Example 
  1889.  
  1890. :ol.
  1891. :li.Open the diskette-drive door.
  1892. :li.Remove the diskette.
  1893. :li.Store the diskette in a safe place.
  1894. :eol.
  1895.  
  1896. Formatted Output 
  1897.  
  1898.    1. Open the diskette-drive door. 
  1899.  
  1900.    2. Remove the diskette. 
  1901.  
  1902.    3. Store the diskette in a safe place. 
  1903.  
  1904.  A Compact Ordered List:  Use the compact attribute to produce a list with no 
  1905.  blank lines between the list items. 
  1906.  
  1907.  Input Example 
  1908.  
  1909.   :ol compact.
  1910.   :li.Open the diskette-drive door.
  1911.   :li.Remove the diskette.
  1912.   :li.Store the diskette in a safe place.
  1913.   :eol.
  1914.  
  1915.  Formatted Output 
  1916.  
  1917.    1. Open the diskette-drive door. 
  1918.    2. Remove the diskette. 
  1919.    3. Store the diskette in a safe place. 
  1920.  
  1921.  Nested Ordered Lists:  The following example contains two nested, ordered 
  1922.  lists. Notice that sequential numbers precede items in the first-level list, 
  1923.  and sequential letters precede items in the second-level list. Numbers and 
  1924.  letters alternate for each level of the list.  That is, third-level list items 
  1925.  would be preceded by numbers, fourth-level by letters, and so on. 
  1926.  
  1927.  Input Example 
  1928.  
  1929.   :ol.
  1930.   :li.First item in the first-level list.
  1931.   :li.Second item in the first-level list.
  1932.   This item has a nested list within it.
  1933.   :ol.
  1934.   :li.First item in the second-level list.
  1935.   :li.Second Item in the second-level list.
  1936.   :eol.
  1937.   :li.Third item in the first-level list.
  1938.   :eol.
  1939.  
  1940.  Formatted Output 
  1941.  
  1942.    1. First item in the first-level list. 
  1943.  
  1944.    2. Second item in the first-level list. This item has a nested list within 
  1945.       it. 
  1946.  
  1947.         a. First item in the second-level list. 
  1948.  
  1949.         b. Second Item in the second-level list. 
  1950.  
  1951.    3. Third item in the first-level list. 
  1952.  
  1953.  When nesting lists, make sure you end each list with an end-list tag. 
  1954.  
  1955.  
  1956. ΓòÉΓòÉΓòÉ 5.7. Definition List ΓòÉΓòÉΓòÉ
  1957.  
  1958. A definition list is a special list that pairs a term and its description. 
  1959.  
  1960. To create a definition list, use the definition-list tag (:dl.) to begin the 
  1961. list and :edl. to end it.  Identify each term in the list with a 
  1962. definition-term tag (:dt.) and each description with a definition-description 
  1963. tag (:dd.). 
  1964.  
  1965. Column Width for Definition Terms:  :dl. has several attributes that let you 
  1966. control the appearance of definition lists.  The tsize= attribute specifies the 
  1967. width, in character spaces, for the term column. If tsize= is not specified, 
  1968. the default width for the term column is 10 character spaces. 
  1969.  
  1970. Definition-List Headings:  If you want headings for the columns of terms and 
  1971. definitions, use the definition-term heading tag (:dthd.) to identify the 
  1972. heading for the terms and the definition-description tag (:ddhd.) to identify 
  1973. the heading for the definition descriptions. 
  1974.  
  1975. Compact Definition List:  The compact attribute produces a list with no blank 
  1976. lines. 
  1977.  
  1978. The following example shows the tagging for a compact definition list with 
  1979. headings for the terms and descriptions.  It also shows the use of the tsize= 
  1980. attribute. 
  1981.  
  1982. Input Example 
  1983.  
  1984. :dl compact tsize=13.
  1985. :dthd.:hp2.Key:ehp2.
  1986. :ddhd.:hp2.Purpose:ehp2.
  1987. :dt.Insert key
  1988. :dd.Switches between insert and replace modes.
  1989. :dt.Home key
  1990. :dd.Moves the cursor to the beginning of the current line.
  1991. :dt.End key
  1992. :dd.Moves the cursor to the end of the current line.
  1993. :edl.
  1994.  
  1995. Formatted Output 
  1996.  
  1997.  Key          Purpose 
  1998.  Insert key   Switches between insert and replace modes. 
  1999.  Home key     Moves the cursor to the beginning of the current line. 
  2000.  End key      Moves the cursor to the end of the current line. 
  2001.  
  2002.  Specifying where the Definition Descriptions Start:  The break= attribute 
  2003.  defines where the descriptions appear in relation to their terms: 
  2004.  
  2005.  break=none     Places the description on the same line as the term.  This is 
  2006.                 the default.  If the term is longer than the specified or 
  2007.                 default tsize= value, the term extends into the description 
  2008.                 column. 
  2009.  
  2010.  break=all      Places the description on the line below the term. 
  2011.  
  2012.  break=fit      Places the description on the line below the term only when the 
  2013.                 term is longer than the tsize= value. 
  2014.  
  2015.  The following example shows the tagging that starts the definition 
  2016.  descriptions on the line below the term. 
  2017.  
  2018.  Input Example 
  2019.  
  2020.   :dl break=all tsize=3.
  2021.   :dt.:hp2.Insert key:ehp2.
  2022.   :dd.Switches between insert and replace modes.
  2023.   :dt.:hp2.Home key:ehp2.
  2024.   :dd.Moves the cursor to the beginning of the current line.
  2025.   :dt.:hp2.End key:ehp2.
  2026.   :dd.Moves the cursor to the end of the current line.
  2027.   :edl.
  2028.  
  2029.  Formatted Output 
  2030.  
  2031.  Insert key 
  2032.     Switches between insert and replace modes. 
  2033.  
  2034.  Home key 
  2035.     Moves the cursor to the beginning of the current line. 
  2036.  
  2037.  End key 
  2038.     Moves the cursor to the end of the current line. 
  2039.  
  2040.  A definition description can apply to more than one definition term; that is, 
  2041.  you can specify more than one :dt. in the sequence before specifying a 
  2042.  matching :dd.. 
  2043.  
  2044.  The following example shows the tagging for a definition list with 
  2045.  descriptions that apply to more than one term. 
  2046.  
  2047.  Input Example 
  2048.  
  2049.   :dl compact break=fit tsize=20.
  2050.   :dthd.:hp2.Grocery Item:ehp2.
  2051.   :ddhd.:hp2.Type:ehp2.
  2052.   :dt.:hp2.Orange:ehp2.
  2053.   :dt.:hp2.Apple:ehp2.
  2054.   :dd.A fruit.
  2055.   :dt.:hp2.Carrot:ehp2.
  2056.   :dt.:hp2.Celery:ehp2.
  2057.   :dd.A vegetable.
  2058.   :edl.
  2059.  
  2060.  Formatted Output 
  2061.  
  2062.  Grocery Item        Type 
  2063.  Orange 
  2064.  Apple               A fruit. 
  2065.  Carrot 
  2066.  Celery              A vegetable. 
  2067.  
  2068.  
  2069. ΓòÉΓòÉΓòÉ 5.8. Parameter List ΓòÉΓòÉΓòÉ
  2070.  
  2071. Parameter lists are similar to definition lists in appearance and the way you 
  2072. use tags to create them.  The only difference between the two types of lists is 
  2073. that a parameter list cannot have headings. 
  2074.  
  2075. The parameter-list tag (:parml.) begins the list; its corresponding :eparml. 
  2076. ends it.  Identify each term in the list with a parameter-term tag (:pt.) and 
  2077. each description with a parameter-description tag (:pd.). 
  2078.  
  2079. :parml. has the same attributes as :dl..  The tsize= attribute specifies the 
  2080. width for the term column.  If tsize= is not specified, the default width is 10 
  2081. character spaces. 
  2082.  
  2083. Compact Parameter List:  The compact attribute produces a list with no blank 
  2084. lines. 
  2085.  
  2086. Specifying where the Parameter Descriptions Start:  The break= attribute 
  2087. defines where the descriptions appear in relation to their terms: 
  2088.  
  2089.  break=none     Places the description on the same line as the term.  This is 
  2090.                 the default.  If the term is longer than the specified or 
  2091.                 default tsize= value, the term extends into the description 
  2092.                 column. 
  2093.  
  2094.  break=all      Places the description on the line below the term. 
  2095.  
  2096.  break=fit      Places the description on the line below the term only when the 
  2097.                 term is longer than the tsize= value. 
  2098.  
  2099.  Nested Parameter Lists:  Like simple, unordered, and ordered lists, parameter 
  2100.  lists can be nested. 
  2101.  
  2102.  Input Example 
  2103.  
  2104.   :parml compact tsize=3.
  2105.   :pt.:hp2.KEYWORD-1:ehp2.
  2106.   :pd.Is explained here.
  2107.   :pt.:hp2.KEYWORD-2:ehp2.
  2108.   :pd.Is explained here, and its nested subparameters:
  2109.   :parml compact.
  2110.   :pt.:hp2.SUBPARM1:ehp2.
  2111.   :pt.:hp2.SUBPARM2:ehp2.
  2112.   :pd.Are explained here.
  2113.   :eparml.
  2114.   :pt.:hp2.KEYWORD-3:ehp2.
  2115.   :pd.Is explained here.
  2116.   :eparml.
  2117.  
  2118.  Formatted Output 
  2119.  
  2120.  KEYWORD-1 
  2121.     Is explained here. 
  2122.  KEYWORD-2 
  2123.     Is explained here, and its nested subparameters: 
  2124.     SUBPARM1 
  2125.     SUBPARM2 
  2126.                    Are explained here. 
  2127.  KEYWORD-3 
  2128.     Is explained here. 
  2129.  
  2130.  A parameter description can apply to more than one parameter; that is, you can 
  2131.  specify more than one :pt. in the sequence before specifying a matching :pd.. 
  2132.  
  2133.  The following example shows the tagging for a parameter list with descriptions 
  2134.  that apply to more than one term. 
  2135.  
  2136.  Input Example 
  2137.  
  2138.   :parml compact tsize=3.
  2139.   :pt.:hp2.KEYWORD-1:ehp2.
  2140.   :pt.:hp2.KEYWORD-2:ehp2.
  2141.   :pd.Is explained here.
  2142.   :pt.:hp2.KEYWORD-3:ehp2.
  2143.   :pd.Is not explained here.
  2144.   :eparml.
  2145.  
  2146.  Formatted Output 
  2147.  
  2148.  KEYWORD-1 
  2149.  KEYWORD-2 
  2150.     Is explained here. 
  2151.  KEYWORD-3 
  2152.     Is not explained here. 
  2153.  
  2154.  
  2155. ΓòÉΓòÉΓòÉ 5.9. Tables ΓòÉΓòÉΓòÉ
  2156.  
  2157. Table tags enable you to display text in an arrangement of rows and columns. 
  2158. The system font used to create tables is the monospace font. 
  2159.  
  2160. The table tag (:table.) signals the start of the table.  It requires a 
  2161. corresponding :etable. at the end of the table. 
  2162.  
  2163. The row tag (:row.) specifies the start of each row in the table.  Each row 
  2164. must have at least one column-entry tag (:c.).  This tag specifies the text for 
  2165. each column in the table. 
  2166.  
  2167. The cols=' ' attribute of :table. specifies numeric values that represent the 
  2168. column widths, in character spaces, of each column in the table.  The combined 
  2169. values cannot exceed 250 characters. 
  2170.  
  2171. The number of columns in your table is determined by the number of column width 
  2172. values you have specified with the cols=' ' attribute.  For example, if you 
  2173. enter the values shown in the following, your table will have three columns, 
  2174. each of which will be eleven characters spaces wide. 
  2175.  
  2176.       cols='11 11 11' 
  2177.  
  2178.  A Table with Three Columns:  The following is a simple example of a table with 
  2179.  two rows and three columns: 
  2180.  
  2181.  Input Example 
  2182.  
  2183.   :table cols='13 13 13'.
  2184.   :row.
  2185.   :c.Column 1
  2186.   :c.Column 2
  2187.   :c.Column 3
  2188.   :row.
  2189.   :c.Row 1 Col 1
  2190.   :c.Row 1 Col 2
  2191.   :c.Row 1 Col 3
  2192.   :row.
  2193.   :c.Row 2 Col 1
  2194.   :c.Row 2 Col 2
  2195.   :c.Row 2 Col 3
  2196.   :etable.
  2197.  
  2198.  Formatted Output 
  2199.  
  2200.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2201.   ΓöéColumn 1   ΓöéColumn 2   ΓöéColumn 3   Γöé
  2202.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2203.   ΓöéRow 1 Col 1ΓöéRow 1 Col 2ΓöéRow 1 Col 3Γöé
  2204.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2205.   ΓöéRow 2 Col 1ΓöéRow 2 Col 2ΓöéRow 2 Col 3Γöé
  2206.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2207.  
  2208.  If you have more :c. tags following a :row. tag than you have column-width 
  2209.  values, the extra column entries are placed in a new row, and the compiler 
  2210.  returns an error message. 
  2211.  
  2212.  If you have fewer :c. tags than column-width values, the compiler does not 
  2213.  consider this an error.  Space is still allocated for the specified columns; 
  2214.  however, only the columns for which you have provided entries will be filled. 
  2215.  
  2216.  Table Rules and Frames:  The rules= attribute of :table. specifies whether the 
  2217.  table will have vertical rules, horizontal rules, a combination of both, or no 
  2218.  rules at all to delineate the items in the table. The values that you can 
  2219.  specify for rules= are: 
  2220.  
  2221.       rules=both 
  2222.       rules=none 
  2223.       rules=horiz 
  2224.       rules=vert 
  2225.  
  2226.  A Table with Horizontal Rules: 
  2227.  
  2228.  Input Example 
  2229.  
  2230.   :table rules=horiz cols='10 15 15'.
  2231.   :row.
  2232.   :c.SYMBOL
  2233.   :c.ELEMENT
  2234.   :c.CHARACTER
  2235.   :row.
  2236.   :c.&.bxas.
  2237.   :c.box ascender
  2238.   :c.&bxas.
  2239.   :row.
  2240.   :c.&.bxcr.
  2241.   :c.box cross
  2242.   :c.&bxcr.
  2243.   :row.
  2244.   :c.&.bxde.
  2245.   :c.box descender
  2246.   :c.&bxde.
  2247.   :etable.
  2248.  
  2249.  Formatted Output 
  2250.  
  2251.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2252.   Γöé SYMBOL                ELEMENT                 CHARACTER  Γöé
  2253.   ΓöéΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöé
  2254.   Γöé &bxas.                box ascender            Γö┤          Γöé
  2255.   ΓöéΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöé
  2256.   Γöé &bxcr.                box cross               Γö╝          Γöé
  2257.   ΓöéΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöé
  2258.   Γöé &bxde.                box descender           Γö¼          Γöé
  2259.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2260.  
  2261.  If you do not specify the rules= attribute, your table will contain both 
  2262.  vertical and horizontal rules (the default). 
  2263.  
  2264.  The frame= attribute of :table. specifies whether the table will have borders. 
  2265.  The values that you can specify are: 
  2266.  
  2267.       frame=none 
  2268.       frame=rules 
  2269.       frame=box 
  2270.  
  2271.  If you specify frame=none, there will be no borders. 
  2272.  
  2273.  Specifying frame=rules results in a horizontal line at the top and bottom of 
  2274.  the table. 
  2275.  
  2276.  If you specify frame=box, or do not specify the frame= attribute, the table is 
  2277.  enclosed in a box. 
  2278.  
  2279.  A Table without a Frame:  Here is the same table without a frame. 
  2280.  
  2281.  Input Example 
  2282.  
  2283.   :table rules=horiz frame=none cols='10 15 15'.
  2284.   :row.
  2285.   :c.SYMBOL
  2286.   :c.ELEMENT
  2287.   :c.CHARACTER
  2288.   :row.
  2289.   :c.&.bxas.
  2290.   :c.box ascender
  2291.   :c.&bxas.
  2292.   :row.
  2293.   :c.&.bxcr.
  2294.   :c.box cross
  2295.   :c.&bxcr.
  2296.   :row.
  2297.   :c.&.bxde.
  2298.   :c.box descender
  2299.   :c.&bxde.
  2300.   :etable.
  2301.  
  2302.  Formatted Output 
  2303.  
  2304.   SYMBOL              ELEMENT             CHARACTER
  2305.   ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  2306.   &bxas.              box ascender        "
  2307.   ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  2308.   &bxcr.              box cross           Γö╝
  2309.   ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  2310.   &bxde.              box descender       "
  2311.  
  2312.  Special Considerations:  None of the text-formatting tags (for example, list 
  2313.  tags) can be used in a table.  You can use character-graphic symbols and 
  2314.  highlighted-phrase tags.  However, boldface and italic highlighting can cause 
  2315.  vertical misalignment of column text and rules.  To use boldface highlighting 
  2316.  in tables and avoid word alignment problems, place the highlighted-phrase tags 
  2317.  (:hp2. and :ehp2.) as shown in the example.  The table rules as well as the 
  2318.  text will be displayed in boldface. 
  2319.  
  2320.  Input Example 
  2321.  
  2322.   :hp2.
  2323.   :table cols='11 11 11'.
  2324.   :row.
  2325.   :c.Row 1 Col 1
  2326.   :c.Row 1 Col 2
  2327.   :c.Row 1 Col 3
  2328.   :row.
  2329.   :c.Row 2 Col 1
  2330.   :c.Row 2 Col 2
  2331.   :c.Row 2 Col 3
  2332.   :etable.
  2333.   :ehp2.
  2334.  
  2335.  Formatted Output 
  2336.  
  2337.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2338.   ΓöéRow 1 Col 1ΓöéRow 1 Col 2ΓöéRow 1 Col 3Γöé
  2339.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2340.   ΓöéRow 2 Col 1ΓöéRow 2 Col 2ΓöéRow 2 Col 3Γöé
  2341.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2342.  
  2343.  The above technique is practical only with :hp2. and does not work for :hp1. 
  2344.  or for the highlighted-phrase tags that change the color of text. 
  2345.  
  2346.  Unformatted Text in a Table Column:  The text in table columns is formatted 
  2347.  only once-at compile time. If you do not want the compiler to format the text 
  2348.  in a column, enclose it with :lines. and :elines., as shown in the following 
  2349.  example. 
  2350.  
  2351.  Input Example 
  2352.  
  2353.   :table cols='10 10 15 10'.
  2354.   :row.
  2355.   :c.Spacecraft
  2356.   :c.Date
  2357.   :c.Astronauts
  2358.   :c.Mission
  2359.   :row.
  2360.   :c.Apollo 11
  2361.   :c.7-16-1969
  2362.   :c.
  2363.   :lines.
  2364.   Neil Armstrong
  2365.   Edwin Aldrin
  2366.   Michael Collins
  2367.   :elines.
  2368.   :c.
  2369.   First landing on the moon.
  2370.   :etable.
  2371.  
  2372.  Formatted Output 
  2373.  
  2374.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2375.   ΓöéSpacecraftΓöéDate      ΓöéAstronauts     ΓöéMission   Γöé
  2376.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2377.   ΓöéApollo 11 Γöé7-16-1969 ΓöéNeil Armstrong ΓöéFirst     Γöé
  2378.   Γöé          Γöé          ΓöéEdwin Aldrin   Γöélanding onΓöé
  2379.   Γöé          Γöé          ΓöéMichael CollinsΓöéthe moon. Γöé
  2380.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2381.  
  2382.  
  2383. ΓòÉΓòÉΓòÉ 5.10. Plain Lines ΓòÉΓòÉΓòÉ
  2384.  
  2385. Normally, lines of text that have no formatting tags are wrapped by IPF; that 
  2386. is, irregular lines in the source file become a continuous string, and one word 
  2387. follows another on a line until the line width of the current window is filled, 
  2388. a formatting tag is encountered, or the end of the window is reached. 
  2389.  
  2390. The :lines. tag and its corresponding end tag, :elines., enable you to control 
  2391. where lines break. 
  2392.  
  2393. The following example shows how the :lines. tag prevents wrapping of text. 
  2394.  
  2395. Input Example 
  2396.  
  2397. Here is how IPF normally wraps lines to fit the window width&colon. 
  2398.  
  2399. :p.&odq.Normally, lines of text that have no formatting tags are wrapped by 
  2400. IPF; that is, irregular lines in the source file become a continuous string, 
  2401. and one word follows another on a line until the line width of the current 
  2402. window is filled, a formatting tag is encountered, or the end of the window is 
  2403. reached.&cdq. 
  2404.  
  2405. In the following example, IPF will not wrap the lines, because we used the 
  2406. :hp2.&colon.lines&per.:ehp2. tag to prevent the lines from being formatted. 
  2407.  
  2408. :lines.
  2409. &odq.Normally, lines of text that have no
  2410. formatting tags are wrapped by IPF;
  2411. that is, irregular lines in the source
  2412. file become a continuous string, and
  2413. one word follows another on a line
  2414. until the line width of the current
  2415. window is filled, a formatting tag
  2416. is encountered, or the end of the
  2417. window is reached.&cdq.
  2418. :elines.
  2419.  
  2420. The quotation appears in two forms. 
  2421.  
  2422. Plain Lines Example 
  2423.  
  2424. Here is how IPF normally wraps lines to fit the window width: 
  2425.  
  2426. "Normally, lines of text that have no formatting tags are wrapped by IPF; that 
  2427. is, irregular lines in the source file become a continuous string, and one word 
  2428. follows another on a line until the line width of the current window is filled, 
  2429. a formatting tag is encountered, or the end of the window is reached." 
  2430.  
  2431. In the following example, IPF will not wrap the lines, because we used the 
  2432. :lines. tag to prevent the lines from being formatted. 
  2433.  
  2434. "Normally, lines of text that have no
  2435. formatting tags are wrapped by IPF;
  2436. that is, irregular lines in the source
  2437. file become a continuous string, and
  2438. one word follows another on a line
  2439. until the line width of the current
  2440. window is filled, a formatting tag
  2441. is encountered, or the end of the
  2442. window is reached."
  2443.  
  2444. In the first case, IPF wraps the lines to fit the window width. In the second, 
  2445. IPF does not wrap the lines, because :lines. prevents them from being 
  2446. formatted. If a line of text were to exceed the width of the current window, it 
  2447. would be clipped.  Also, when IPF encounters other tags between :lines. and 
  2448. :elines., such as quotation tags, the tags are processed. 
  2449.  
  2450. Aligned Lines:  :lines. has an align= attribute, which you use to align text to 
  2451. the left, right, or center of the window. 
  2452.  
  2453. Assume that in the previous example, the tag was: 
  2454.  
  2455. :lines align=center.
  2456.  
  2457. The output would be as shown here. 
  2458.  
  2459.               Normally, lines of text that have no formatting tags
  2460.               are "wrapped" by IPF; that is, irregular lines in the
  2461.               source file become a continuous string, and one word
  2462.               follows another on a line until the line width of the
  2463.                   current window is filled, a formatting tag is
  2464.                 encountered, or the end of the window is reached.
  2465.  
  2466. Text aligned in the center of the window. 
  2467.  
  2468.  
  2469. ΓòÉΓòÉΓòÉ 5.11. Figures and Captions ΓòÉΓòÉΓòÉ
  2470.  
  2471. The figure tag (:fig.) is similar to :lines..  Both convey the same message: 
  2472. "Do not format the text that follows."  Also, both tags have end tags. 
  2473.  
  2474. A Captioned Figure:  Associated with :fig. is :figcap., which enables you to 
  2475. place a descriptive sentence or caption above or below the text. 
  2476.  
  2477. Input Example 
  2478.  
  2479. :h4.Example 1:  A Captioned Figure
  2480. :fig.
  2481. ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  2482.  Bat
  2483.  Black Bear
  2484.  Bobcat
  2485.  Coyote
  2486.  Mink
  2487.  Florida Panther
  2488.  Key Deer
  2489.  Oppossum
  2490.  West Indian Manatee
  2491.  Whitetail Deer
  2492. ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  2493. :figcap.Major Species of Mammals in Florida
  2494. :efig.
  2495.  
  2496. The formatted output looks like this: 
  2497.  
  2498. Example 1:  A Captioned Figure
  2499. ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  2500.  Bat
  2501.  Black Bear
  2502.  Bobcat
  2503.  Coyote
  2504.  Mink
  2505.  Florida Panther
  2506.  Key Deer
  2507.  Oppossum
  2508.  West Indian Manatee
  2509.  Whitetail Deer
  2510. ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  2511. Major Species of Mammals in Florida
  2512.  
  2513. Figure and Figure Caption 
  2514.  
  2515.  
  2516. ΓòÉΓòÉΓòÉ 5.12. Textual Examples ΓòÉΓòÉΓòÉ
  2517.  
  2518. One way of helping readers understand information is to use examples. The 
  2519. example tag (:xmp.) and its corresponding end tag (:exmp.) enable you to 
  2520. illustrate your information with textual examples by turning formatting off so 
  2521. that you can arrange text any way you want it. The text will be displayed in a 
  2522. monospace font.  To change the monospace font, use :font. within :xmp..  For 
  2523. more information about :font., see Changing Fonts. 
  2524.  
  2525. Input Example 
  2526.  
  2527. :xmp.
  2528. File   Edit   View   Options   Help
  2529.  
  2530.                  All
  2531.                  Some . . .
  2532.                  By . . .
  2533. :exmp.
  2534.  
  2535. Formatted Output 
  2536.  
  2537. File   Edit   View   Options   Help
  2538.  
  2539.                  All
  2540.                  Some . . .
  2541.                  By . . .
  2542.  
  2543. Restriction:  You cannot nest :xmp. within another :xmp.. 
  2544.  
  2545.  
  2546. ΓòÉΓòÉΓòÉ 5.13. Character Graphics ΓòÉΓòÉΓòÉ
  2547.  
  2548. If you want to include simple line drawings, use the character graphics tag 
  2549. (:cgraphic.) and its corresponding end tag (:ecgraphic.). Text within this tag 
  2550. is displayed in a monospace font.  To change the monospace font, use :font. 
  2551. within :cgraphic..  For more information about :font., see Changing Fonts. If 
  2552. text does not fit within the boundaries of a window, it is clipped, not 
  2553. wrapped. 
  2554.  
  2555. Place the tags before and after the character graphic, as shown in the 
  2556. following example. 
  2557.  
  2558. Input Example 
  2559.  
  2560. :cgraphic.
  2561.  
  2562. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2563. ΓöéFile   Edit  Γöé View Γöé Options   Help Γöé
  2564. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÿ
  2565.               Γöé All                Γöé
  2566.               Γöé Some . . .         Γöé
  2567.               Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2568.               Γöé By . . .           Γöé
  2569.               ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2570. :ecgraphic.
  2571.  
  2572. Formatted Output 
  2573.  
  2574. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2575. ΓöéFile   Edit  Γöé View Γöé Options   Help Γöé
  2576. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÿ
  2577.               Γöé All                Γöé
  2578.               Γöé Some . . .         Γöé
  2579.               Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2580.               Γöé By . . .           Γöé
  2581.               ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2582.  
  2583. Restriction:  You cannot nest :cgraphic. within another :cgraphic.. 
  2584.  
  2585.  
  2586. ΓòÉΓòÉΓòÉ 5.14. Changing Fonts ΓòÉΓòÉΓòÉ
  2587.  
  2588. The :font. tag is used to change the current font within the text of the 
  2589. current window.  When a heading tag that defines a new window is encountered, 
  2590. the font is reset to the system default font. 
  2591.  
  2592. The font tag has three attributes:  facename= and size= are required; 
  2593. codepage= is optional. If a code page value is not specified, the code page of 
  2594. the active system is used. 
  2595.  
  2596. facename= specifies the name of the font you want to change to.  Some of the 
  2597. common values for this attribute are: 
  2598.  
  2599.       Helv 
  2600.       Courier 
  2601.       default 
  2602.  
  2603.  size= specifies the height and width, in points, of the font you have 
  2604.  selected.  (A point is a typesetting measure equal to approximately 1/72 of an 
  2605.  inch.) The value is expressed in the form, HxW.  For example, suppose you want 
  2606.  to change the current font to an 18-point-high by 10-point-wide Helvetica 
  2607.  font.  You would specify: 
  2608.  
  2609.   :font facename=Helv size=18x10.
  2610.  
  2611.  You do not have to know exact point values.  IPF uses a "best fit" method to 
  2612.  select the font.  If, in the example above, you had specified 20x12 as the 
  2613.  size value, IPF would have selected Helv 18x10 because it is the closest size 
  2614.  to the one you specified. 
  2615.  
  2616.  Using :font., you can make as many font changes within a window as you want. 
  2617.  You can define highlighted phrases while a font tag is in effect, and the 
  2618.  tagged text will be displayed in the font style corresponding to that 
  2619.  typeface. 
  2620.  
  2621.  You can use :font. within the :xmp. and :cgraphic. tags to change the default 
  2622.  system monospace font.  To change the default system monospace font, specify 
  2623.  the desired facename= and size= attribute. 
  2624.  
  2625.  The following resets the font to the default system proportional font. 
  2626.  
  2627.   :font facename=default size=0x0.
  2628.  
  2629.  In the following example, the font style is reset for each list item in the 
  2630.  simple list. 
  2631.  
  2632.  Input Example 
  2633.  
  2634.   :p.The following illustrate available fonts:
  2635.   :sl.
  2636.   :font facename=Courier size=13x8.
  2637.   :li.This sentence is in Courier 13 by 8 font.
  2638.   .*
  2639.   :font facename='Tms Rmn' size=18x14.
  2640.   :li.This sentence is in 'Tms Rmn' 18 by 14 font.
  2641.   .*
  2642.   :font facename=Helv size=28x18.
  2643.   :li.This sentence is in Helvetica 28 by 18 font.
  2644.   .*
  2645.   :font facename=default size=0x0.
  2646.   :li.This sentence is in the default system font.
  2647.   :esl.
  2648.  
  2649.  Here is the formatted output. 
  2650.  
  2651.  Example of the Font Tag 
  2652.  
  2653.       This sentence is in Courier 13 by 8 font. 
  2654.  
  2655.       This sentence is in 'Tms Rmn' 18 by 14 font. 
  2656.  
  2657.       This sentence is in Helvetica 28 by 18 font. 
  2658.  
  2659.       This sentence is in the default system font. 
  2660.  
  2661.  
  2662. ΓòÉΓòÉΓòÉ 5.15. Changing Color ΓòÉΓòÉΓòÉ
  2663.  
  2664. The color tag (:color.), with its attributes fc= and bc=, enables you to change 
  2665. the color of the text (foreground color) and the color of the area behind the 
  2666. text characters (background color). 
  2667.  
  2668. Colors set with this tag remain in effect until others are specified, or until 
  2669. a heading definition is encountered. 
  2670.  
  2671. To return to the system colors, specify: 
  2672.  
  2673. :color fc=default bc=default.
  2674.  
  2675. In the following example, each of the first three color tags specifies 
  2676. different foreground and background colors.  The last color tag returns the 
  2677. colors to the system colors. 
  2678.  
  2679. Input Example 
  2680.  
  2681. :ol.
  2682. :color fc=green bc=blue.
  2683. :li.Color the foreground green; color the background blue.
  2684. .*
  2685. :color fc=blue bc=red.
  2686. :li.Color the foreground blue; color the background red.
  2687. .*
  2688. :color fc=cyan bc=yellow.
  2689. :li.Color the foreground cyan; color the background yellow.
  2690. .*
  2691. :color fc=default bc=default.
  2692. :li.Return to the system colors.
  2693. :eol.
  2694.  
  2695. Output Example:  Color the Foreground and Background 
  2696.  
  2697.       Color the foreground green; color the background blue. 
  2698.  
  2699.       Color the foreground blue; color the background red. 
  2700.  
  2701.       Color the foreground cyan; color the background yellow. 
  2702.  
  2703.       Return to the system colors. 
  2704.  
  2705.  
  2706. ΓòÉΓòÉΓòÉ 5.16. Margins ΓòÉΓòÉΓòÉ
  2707.  
  2708. You can specify the boundaries of text in a window by using the margin tags. 
  2709. The left-margin tag (:lm.) specifies how many character spaces from the left 
  2710. border of the window the text is to start.  The right-margin tag (:rm.) 
  2711. specifies how many character spaces from the right border the text is to end. 
  2712.  
  2713. The margin= attribute sets the margin for the text. If none is specified on the 
  2714. :lm. or :rm. tag, the default is 1. 
  2715.  
  2716. If the margin tag in a line begins beyond the specified boundary, the new 
  2717. margin becomes effective on the next line. 
  2718.  
  2719. You can have multiple margin tags in your file. The specified margins remain in 
  2720. effect until they are reset. 
  2721.  
  2722. Input Example 
  2723.  
  2724. :p.
  2725. :rm margin=10.
  2726. :lm margin=20.This text begins 20 spaces to the right
  2727. of the left window border and ends 10 spaces to the
  2728. left of the right window border.
  2729. All text is aligned as specified
  2730. by the margin values. :lm margin=5.Here the left margin
  2731. is changed to 5.  Because this margin tag begins
  2732. more than 5 spaces on the line, the margin specified
  2733. becomes effective on the following line, and the text
  2734. begins 5 spaces from the left window border.
  2735. The right margin remains unchanged.
  2736.  
  2737. Here is how the window looks: 
  2738.  
  2739.                     This text begins 20 spaces to the right of the left window 
  2740.                     border and ends 10 spaces to the left of the right window 
  2741.                     border. All text is aligned as specified by the margin 
  2742.                     values. Here the left margin is changed to 5.  Because this 
  2743.      margin tag begins more than 5 spaces on the line, the margin specified 
  2744.      becomes effective on the following line, and the text begins 5 spaces from 
  2745.      the left window border. The right margin remains unchanged. 
  2746.  
  2747.      Example of the Margin Tag 
  2748.  
  2749.  
  2750. ΓòÉΓòÉΓòÉ 5.17. Bit Map and Metafile Graphics ΓòÉΓòÉΓòÉ
  2751.  
  2752. In a previous topic, we discussed how you can use :cgraphic. to illustrate your 
  2753. text with character graphics.  With :artwork., you can illustrate your text 
  2754. with bit-map or metafile graphics.  A bit map is a representation of an image, 
  2755. and can be created with such tools as the Icon Editor, which is available with 
  2756. the IBM Developer. Metafiles provide device independence; bit maps do not. The 
  2757. bit map or metafile graphics reside in a file that must be specified with the 
  2758. name=' ' attribute of :artwork.. This file is then loaded when you compile your 
  2759. source file with the IPF compiler. The OS/2 2.0 compress bit map format is not 
  2760. supported by the IPF compiler.  The IPF compiler compresses the bit maps. 
  2761.  
  2762. The artwork tag has other attributes as well: 
  2763.  
  2764.      The align= attribute enables you to position the graphic. The values are 
  2765.       left, right, and center, and are with respect to the current margins. 
  2766.  
  2767.      The fit attribute causes a bit map to be redrawn and scaled to fit the 
  2768.       window. 
  2769.  
  2770.       The ratio between the width and height of the window should be the ratio 
  2771.       of the original width and height of the bit map or metafile; otherwise, 
  2772.       the graphic might appear distorted. 
  2773.  
  2774.      The runin attribute enables you to place a graphic within a line of text. 
  2775.       For example, to include an icon within a line of text, the text and tag 
  2776.       would be as follows: 
  2777.  
  2778.  Input Example 
  2779.  
  2780.   :p.This is an example of artwork displayed within the
  2781.   :artwork runin name='BOOK.BMP'.
  2782.   text of a sentence.
  2783.   .**
  2784.   :p.You can also align the artwork to appear on the
  2785.   :lines align=left.
  2786.   left,
  2787.   :elines.
  2788.   :artwork align=left name='BOOK.BMP'.
  2789.   :lines align=right.
  2790.   right,
  2791.   :elines.
  2792.   :artwork align=right name='BOOK.BMP'.
  2793.   :lines align=center.
  2794.   or center of the window.
  2795.   :elines.
  2796.   :artwork align=center name='BOOK.BMP'.
  2797.  
  2798.  It would bring the artwork into the screen like this. 
  2799.  
  2800.  This is an example of artwork displayed within the text of a sentence. 
  2801.  
  2802.  You also can align the artwork to appear on the 
  2803.  
  2804.   left,
  2805.  
  2806.                                                                           right,
  2807.  
  2808.                              or center of the window.
  2809.  
  2810.  Example of the Artwork Tag 
  2811.  
  2812.  
  2813. ΓòÉΓòÉΓòÉ 6. Linking ΓòÉΓòÉΓòÉ
  2814.  
  2815. Today, the computer's ability to link pieces of information gives the author 
  2816. flexibility in layering and structuring documents, and at the same time, 
  2817. provides cohesive information. 
  2818.  
  2819. This chapter describes the tags that identify, associate, and link one window 
  2820. to another window.  This chapter also describes the different types of linking 
  2821. available with IPF, and what to expect when using them. 
  2822.  
  2823.  
  2824. ΓòÉΓòÉΓòÉ 6.1. Window Identifiers ΓòÉΓòÉΓòÉ
  2825.  
  2826. The link tag (:link.) allows you to link to a heading, a footnote, an external 
  2827. database, or another application. The reftype=  attribute is required with each 
  2828. link tag description.  This attribute identifies the type of link you are 
  2829. defining. 
  2830.  
  2831. The res= attribute and the value specified identify the window you are linking 
  2832. to.  This attribute is the window identifier. A res= number must be in the 
  2833. range 1 through 64 000. The same window identifier must be specified in the 
  2834. tagging of the window you are linking to in order for a hypertext link to exist 
  2835. (see Hypertext Links). 
  2836.  
  2837. The IPF compiler recognizes links to headings (including hidden headings) only 
  2838. when the heading level is within the default range (toc=123) or specified range 
  2839. of heading levels.  If you specify a window identifier for a level that is 
  2840. lower in the hierarchy than that recognized for contents entries, and then 
  2841. attempt to link to it, the compiler returns an error message.  For example, 
  2842. suppose the default is in effect for contents entries; that is, only heading 
  2843. levels 1 through 3 cause entries in the Contents window.  Also suppose your 
  2844. file contains the following heading definition: 
  2845.  
  2846. :h4 res=050.Copy File
  2847.  
  2848. The heading "Copy File"  appears in the same window as the preceding heading 
  2849. level 3.  If you use this window identifier in a link definition to link to the 
  2850. heading from another window, the IPF compiler returns the error message, No res 
  2851. for this reference. 
  2852.  
  2853. If you are creating windows for an online document (a .INF file), you can use 
  2854. the res=, id=, or name= attribute of the heading tag to specify window 
  2855. identifiers. An advantage of using either id= or name= is that you can specify 
  2856. both alphabetic and numeric characters, which can make the job of assigning and 
  2857. remembering window IDs easier.  If you use one of these attributes, you must 
  2858. use the refid= attribute of :link. when defining a hypertext cross-reference to 
  2859. the window. 
  2860.  
  2861. If you need to use both res= numbers and id= values, you can specify both in a 
  2862. window heading. For simplicity, you can assign the same number to both 
  2863. identifiers. 
  2864.  
  2865. Note:  If an OS/2 application needs to communicate with an IPF window, you must 
  2866.        use the res= attribute as a window identifier. 
  2867.  
  2868.  
  2869. ΓòÉΓòÉΓòÉ 6.2. Types of Links ΓòÉΓòÉΓòÉ
  2870.  
  2871. Links are electronic connections between one online element and another.  With 
  2872. IPF, the user can be linked from one window to another by means of selectable 
  2873. text and graphic areas that the author defines.  The user also can be linked to 
  2874. information in another IPF database. 
  2875.  
  2876. Different types of links support document designs and information 
  2877. retrievability in various ways: 
  2878.  
  2879.  Hypertext Links Selectable words or phrases that connect related information. 
  2880.  
  2881.  Hypergraphic Links Selectable graphics that connect related information. 
  2882.  
  2883.  Automatic Links Links that begin a chain reaction at the primary window. When 
  2884.          the user selects the primary window, an automatic link is activated to 
  2885.          display secondary windows. 
  2886.  
  2887.  External Links Links that connect external online document files. 
  2888.  
  2889.  
  2890. ΓòÉΓòÉΓòÉ 6.2.1. Hypertext Links ΓòÉΓòÉΓòÉ
  2891.  
  2892. Hypertext is the linking of online information so the user can navigate from 
  2893. selectable text to related information. A hypertext link is the association 
  2894. between two topics. The origin of the link is the source topic; the destination 
  2895. is the target topic. 
  2896.  
  2897. In the following example, the DIR command is the source topic; it describes the 
  2898. directory command. Within the DIR topic is a reference to the MKDIR command - 
  2899. the target topic. 
  2900.  
  2901.  
  2902.        Source Topic                      Target Topic
  2903. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ      ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2904. ΓöéDIR - Display files in ... Γöé ΓöîΓöÇΓöÇ Γöé MKDIR - Make a new ... Γöé
  2905. Γöé                           Γöé Γöé    Γöé                        Γöé
  2906. Γöé                           Γöé Γöé    Γöé                        Γöé
  2907. Γöé                           Γöé Γöé    Γöé                        Γöé
  2908. Γöé Related command: MKDIR ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÿ    Γöé  Related command: DIR  Γöé
  2909. Γöé                           Γöé      Γöé                        Γöé
  2910. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ      ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2911.  
  2912. You use :link. to establish a hypertext link between a topic in the 
  2913. source-topic window and a topic in the target-topic window.  :link. enables you 
  2914. to create selectable, highlighted text in the source-topic window.  When users 
  2915. select this text, they are linked to the window containing the target topic, 
  2916. and the linked window appears. 
  2917.  
  2918. Consider the following example: 
  2919.  
  2920. :link reftype=hd res=123.MKDIR:elink.
  2921.  
  2922.      reftype=hd indicates the hypertext phrase MKDIR is being linked to a 
  2923.       heading in the target-topic window. 
  2924.  
  2925.       Notice MKDIR is delimited by the period of the :link. tag and the colon 
  2926.       of the :elink. tag. 
  2927.  
  2928.      res=123 is the identifier of the target-topic window. 
  2929.  
  2930.       The heading tag of the target-topic window must contain this identifier. 
  2931.       The following is an example: 
  2932.  
  2933.                 :h2 res=123.MKDIR
  2934.  
  2935.  For more information about hypertext links, see Display Another Window of the 
  2936.  Same Library. 
  2937.  
  2938.  
  2939. ΓòÉΓòÉΓòÉ 6.2.2. Hypergraphic Links ΓòÉΓòÉΓòÉ
  2940.  
  2941. A hypergraphic link is similar to a hypertext link except that the user 
  2942. navigates from a selectable graphic instead of selectable text. 
  2943.  
  2944.  
  2945. ΓòÉΓòÉΓòÉ 6.2.2.1. Bit Maps ΓòÉΓòÉΓòÉ
  2946.  
  2947. Graphic illustrations are usually bit maps.  Bit maps can be monochrome or 
  2948. color and can be created with the Presentation Manager Icon Editor, which is 
  2949. available in the IBM Developer. The bit map resides in a separate file called 
  2950. by IPF at compile time. 
  2951.  
  2952. The artwork tag (:artwork.) identifies the name of the bit-map; for example: 
  2953.  
  2954. :artwork name='mybitmap.bmp'.
  2955.  
  2956. The :artlink. and :eartlink. tags define areas of the bit map that are 
  2957. selectable hypergraphic. This means the user can link from the artwork to 
  2958. additional information. If no :artlink. tag is used, no hypergraphic areas are 
  2959. defined. 
  2960.  
  2961. If you want the entire bit map to be hypergraphic, the tagging is simple.  You 
  2962. have only one art link, and you do not have to define the area.  The following 
  2963. shows the tagging required to establish a link: 
  2964.  
  2965. Input Example 
  2966.  
  2967. :p.This is an example of a hypergraphic.
  2968. Select the Shuttle graphic and get ready for a walk on
  2969. the moon.
  2970. :artwork name='shuttle.bmp'.
  2971. :artlink.
  2972. :link reftype=hd res=001.
  2973. :eartlink.
  2974.  
  2975.  Notice there is no :elink. tag.  Instead, there is an :eartlink. tag.  An 
  2976. :elink. tag is required only to denote the end of a hypertext link. 
  2977.  
  2978. You also need to specify the identifier in the tagging for the window you are 
  2979. linking to.  For example: 
  2980.  
  2981. :h1 res=001.Apollo 11
  2982.  
  2983. The entire bit map as a selectable hypergraphic area. 
  2984.  
  2985. When the user double-clicks on the hypergraphic area, the window whose 
  2986. identifier is 001 ("Apollo 11") appears. 
  2987.  
  2988.  
  2989. ΓòÉΓòÉΓòÉ 6.2.2.2. Metafiles ΓòÉΓòÉΓòÉ
  2990.  
  2991. A metafile is another type of file in which graphics are stored. However, a 
  2992. metafile contains data generated from the Presentation Manager graphics (GPI) 
  2993. functions only. (For information about graphics functions, see the OS/2 2.0 
  2994. Programming Guide, Volume 3.)  IPF supports a metafile as a hypergraphic link 
  2995. only when the entire metafile is defined as a hypergraphic area. 
  2996.  
  2997. The artwork tag identifies the file name of a metafile as follows: 
  2998.  
  2999. :artwork name='myfile.met'.
  3000.  
  3001.  
  3002. ΓòÉΓòÉΓòÉ 6.2.2.3. Segmented Hypergraphics ΓòÉΓòÉΓòÉ
  3003.  
  3004. You can divide your bit map into rectangular segments, make each segment 
  3005. selectable, and have each segment link to different information. You must 
  3006. define each segment in terms of values along the x and y axes. Values for x and 
  3007. y define the origin of the segment. The changes in x and y are given as values 
  3008. for cx and cy. The following is an example of a segmented bit map: 
  3009.  
  3010.     0,16                                32,16
  3011.     | ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3012.     | Γöé                Γöé                  Γöé
  3013.     | Γöé                Γöé                  Γöé
  3014.     y Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3015.     | Γöé                Γöé                  Γöé
  3016.     | Γöé                Γöé                  Γöé
  3017.     | ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3018.     0,0 ---------------x--------------- 32,0
  3019.  
  3020. The following shows the tagging to establish a bit-map segment as a 
  3021. hypergraphic area: 
  3022.  
  3023. :artwork name='show2.bmp'.
  3024. :artlink.
  3025. :link reftype=hd res=001 x=0 y=0 cx=16 cy=8.
  3026. :eartlink.
  3027.  
  3028.  
  3029. ΓòÉΓòÉΓòÉ 6.2.3. Automatic Links ΓòÉΓòÉΓòÉ
  3030.  
  3031. Links also can be made automatically.  An automatic link occurs when the user 
  3032. performs an action that selects a window in which a link is defined. For 
  3033. automatic links to occur, the reftype= attribute of the :link. tag must have a 
  3034. value of hd, inform, or launch. Automatic links allow you to: 
  3035.  
  3036.      Display multiple windows when a heading or link definition is selected 
  3037.       (hd attribute). 
  3038.  
  3039.      Display multiple secondary windows within the coverpage of a primary 
  3040.       window (hd attribute). 
  3041.  
  3042.      Send a message to the application when a window is displayed (inform 
  3043.       attribute). 
  3044.  
  3045.      Start a Presentation Manager program when a window is displayed (launch 
  3046.       attribute). 
  3047.  
  3048.  Automatic links can be associated with selectable links so that another action 
  3049.  occurs in addition to the display of a linked window.  For example, a 
  3050.  Presentation Manager program can be started, or a message can be sent to the 
  3051.  application program. 
  3052.  
  3053.  Restriction: Linking automatically to an external database is not possible. 
  3054.  
  3055.  
  3056. ΓòÉΓòÉΓòÉ 6.2.4. External Links ΓòÉΓòÉΓòÉ
  3057.  
  3058. An external link is a link from a .HLP file to another .HLP file or from a .INF 
  3059. file to another .INF file. 
  3060.  
  3061. If you are linking from one internal database to another, use the res= 
  3062. attribute. If you want to allow external databases to link to a window in your 
  3063. file, the window heading must contain the global attribute, and you must use 
  3064. the id= attribute as a window identifier. 
  3065.  
  3066. Restriction: Linking automatically to an external database is not possible. 
  3067.  
  3068. For more information about external links, see Display a Help Window from 
  3069. Another Help Library. 
  3070.  
  3071.  
  3072. ΓòÉΓòÉΓòÉ 6.3. What Linking Can Do ΓòÉΓòÉΓòÉ
  3073.  
  3074. You now know that :link. makes text phrases and hypergraphic areas within a 
  3075. window selectable. When the user selects a hypertext or hypergraphic area, the 
  3076. following occurs, depending on the content of the :link. tag: 
  3077.  
  3078.      Another window of the same library is displayed. 
  3079.      Another window of a different library is displayed. 
  3080.      A footnote window is displayed. 
  3081.      A message is sent to the application program. 
  3082.      Another application is started. 
  3083.  
  3084.  
  3085. ΓòÉΓòÉΓòÉ 6.3.1. Display Another Window of the Same Library ΓòÉΓòÉΓòÉ
  3086.  
  3087. When you want the user to link to another window in the current library, use 
  3088. the reftype=hd attribute with :link.. For example: 
  3089.  
  3090. :link
  3091. reftype=hd res=21084.What Are Libraries For?
  3092. :elink.
  3093.  
  3094. The hd attribute tells the compiler to link to a heading in another window. The 
  3095. res= attribute value specifies the identification of the window being linked 
  3096. to. 
  3097.  
  3098. The text "What Are Libraries For?" is uniquely highlighted in the window so 
  3099. that the user knows it is selectable. If the user selects it, the window 
  3100. containing the heading defined by res= 21084 appears. 
  3101.  
  3102. Note:  The highlighting of a hypertext phrase is done with a color selected by 
  3103.        IPF and should not be confused with highlighted-phrase tags, which are 
  3104.        used to change the type font. (See Highlighted Phrases for an 
  3105.        explanation of these tags.) 
  3106.  
  3107.  The tagging shown in the following figure contains an example of the link tag. 
  3108.  Also included is the tagging for the window being linked to. 
  3109.  
  3110.   :************************************************
  3111.   :* In the following source, the text of the window
  3112.   :* contains a heading tag with a window
  3113.   :* identifier, a paragraph tag, and a hypertext
  3114.   :* link to another window.
  3115.   :************************************************
  3116.   :h1 res=21083.The Library Manager
  3117.   :i1.object code libraries
  3118.   :p.
  3119.   The Library Manager (LIB) lets you create and maintain
  3120.   libraries of object code.  A library is an organized
  3121.   collection
  3122.   of object code; that is, a library contains functions and data
  3123.   that are already assembled or compiled and ready for linking
  3124.   with your programs. See:
  3125.   :link
  3126.   reftype=hd res=21084.What Are Libraries For?
  3127.   :elink.
  3128.   :p.
  3129.   LIB works with both DOS and OS/2 files.
  3130.   :************************************************
  3131.   :* The following contains a heading tag with a
  3132.   :* window identifier that matches the link-tag
  3133.   :* res= attribute above.
  3134.   :* This file also contains an unordered list.
  3135.   :************************************************
  3136.   :h2 res=21084.What Are Libraries For?
  3137.   :p.Programming libraries of object code are used:
  3138.   :ul.
  3139.   :li.To support high-level languages.
  3140.   :p.Most compilers include libraries to perform standard
  3141.   operations, such as input/output and floating-point mathematics.
  3142.   :p.
  3143.   When your program refers to a library routine, the
  3144.   compiler and linker combine the library routine with your
  3145.   program.
  3146.   :li.To perform complex and specialized activities, such
  3147.   as database management or advanced graphics.
  3148.   :p.Compilers include libraries for specialized tasks. You
  3149.   also can use a library from a third party software vendor.
  3150.   :li.To support your own work.
  3151.   :p.If you have created routines that you use with a
  3152.   variety of programs, you might want to consolidate these routines
  3153.   into a library.  You then can link to one library object module
  3154.   rather than to a large group of object files.
  3155.   :eul.
  3156.  
  3157.  
  3158. ΓòÉΓòÉΓòÉ 6.3.2. Display a Window Linked to Another Database ΓòÉΓòÉΓòÉ
  3159.  
  3160. You also can link a user to a window in another IPF .HLP or .INF file.  You 
  3161. must specify the file name with the database= attribute. If the following were 
  3162. in the source file, selection of the hypertext link would cause the file, 
  3163. EDITOR.HLP to be loaded, and the window whose ID is 001 to be displayed. 
  3164.  
  3165. :link reftype=hd database='editor.hlp' refid=001.
  3166. Editing Functions
  3167. :elink.
  3168.  
  3169. The heading definition in the other file must contain the global attribute.  If 
  3170. the link to the file cannot be resolved, the hypertext phrase in the link is 
  3171. not highlighted.  For example, if the .INF or .HLP file is not available, IPF 
  3172. will not highlight the linked phrase.  If the .INF or .HLP file becomes 
  3173. available, IPF will dynamically highlight the phrase. 
  3174.  
  3175.  
  3176. ΓòÉΓòÉΓòÉ 6.3.3. Display a Help Window from Another Help Library ΓòÉΓòÉΓòÉ
  3177.  
  3178.  If you are creating a window for a help library (a .HLP file), you must use 
  3179. the res= attribute to assign an identifier to each window.  For example: 
  3180.  
  3181. :h1 res=2001 id=2001 global.
  3182. Help for Copy
  3183.  
  3184. IPF uses the value specified for res= (any integer from 1 through 64 000) to 
  3185. associate a window with a user's request for help on a field or window of the 
  3186. application. If you use the res= attribute in a heading tag, you must also use 
  3187. it in a link tag when defining a hypertext cross-reference to the window.  For 
  3188. example: 
  3189.  
  3190. :link reftype=hd res=2001.
  3191. Help for Copy
  3192. :elink.
  3193.  
  3194.  
  3195. ΓòÉΓòÉΓòÉ 6.3.4. Display a Footnote Window ΓòÉΓòÉΓòÉ
  3196.  
  3197. A footnote window results when the user selects a hypertext phrase that is 
  3198. linked to a footnote tag (:fn.).  The text between :fn. and :efn. is what 
  3199. appears in the footnote window.  The following is an example of the tagging for 
  3200. the footnote text: 
  3201.  
  3202. Input Example 
  3203.  
  3204. :fn id=drive.
  3205. :p.The text you enclose in footnote tags appears in a
  3206. small window when the user selects a hypertext or hypergraphic
  3207. link to the footnote.  Notice that
  3208. the title of the window is the same as the hypertext
  3209. phrase "disk drives" that links to the window.
  3210. :efn.
  3211.  
  3212.  The id= attribute identifies the footnote for linking purposes. 
  3213.  
  3214. In the :link tag, use refid= to refer to the footnote identifier (in this case, 
  3215. "drive"), and reftype=fn to indicate that the link is to a footnote, and to 
  3216. specify the title of the footnote window. The following is an example of the 
  3217. tagging for a link to the footnote: 
  3218.  
  3219. :p.Additional information about
  3220. :link refid=drive reftype=fn.disk drives:elink.
  3221. is available.
  3222.  
  3223. The following figure shows the resulting footnote window. 
  3224.  
  3225. Footnote Window 
  3226.  
  3227. The following are some important points to remember about footnotes: 
  3228.  
  3229.      A footnote can be placed anywhere in your source file, as long as it 
  3230.       follows the first heading tag. 
  3231.  
  3232.      Footnotes cannot contain index entries. 
  3233.  
  3234.      Information in a footnote cannot be detected by a search. 
  3235.  
  3236.      A footnote cannot be in a window that has a split attribute in its 
  3237.       heading or link definition. 
  3238.  
  3239.  
  3240. ΓòÉΓòÉΓòÉ 6.3.5. Send a Message to the Application ΓòÉΓòÉΓòÉ
  3241.  
  3242. When the reftype=inform attribute is specified with :link., a message is sent 
  3243. to the application. The res= attribute, instead of being a resource identifier 
  3244. for IPF (a window ID), is a resource identifier for the application. The value 
  3245. specified must be an integer. When the application receives the message, it can 
  3246. then perform an application-specific function. 
  3247.  
  3248. For more information about how messages are sent to application windows using 
  3249. the reftype=inform attribute see Using Communication Windows. 
  3250.  
  3251.  
  3252. ΓòÉΓòÉΓòÉ 6.3.6. Start an Application ΓòÉΓòÉΓòÉ
  3253.  
  3254. The reftype=launch attribute of :link. causes IPF to start another Presentation 
  3255. Manager application. The object= attribute indicates the file specification of 
  3256. the application. The data= attribute specifies parameters associated with the 
  3257. application to be started. 
  3258.  
  3259. You can use the reftype=launch attribute with :link. to start a tutorial. 
  3260.  
  3261.  
  3262. ΓòÉΓòÉΓòÉ 7. Customizing Windows ΓòÉΓòÉΓòÉ
  3263.  
  3264. A window is an area of the screen with visible boundaries within which 
  3265. information is displayed.  Often a single window uses the entire screen for its 
  3266. information. Because online information is best presented in small pieces, or 
  3267. units, most designs call for a multiple window format. This chapter explains 
  3268. how to size and position more than one window on a screen, and how to use 
  3269. attributes that enable IPF to open and close those windows. Before you begin 
  3270. this chapter, make sure you read about the OS/2 standard windows described in 
  3271. IPF User Interface. 
  3272.  
  3273. For a summary of attributes described in this chapter, see Summary Tables of 
  3274. Attribute Values for Origin and Size, Summary Table for Heading Attributes, and 
  3275. Summary Table for Link Attributes. 
  3276.  
  3277.  
  3278. ΓòÉΓòÉΓòÉ 7.1. The Default Window ΓòÉΓòÉΓòÉ
  3279.  
  3280. Both the heading tags (:hn.) and the link tag (:link.) have attributes that 
  3281. affect how windows look on a screen.  For example, the attributes define: 
  3282.  
  3283.      Window size and position 
  3284.      Which window controls are provided to the user 
  3285.      What windows are displayed. 
  3286.  
  3287.  You do not have to use all the attributes provided by a heading tag to define 
  3288.  a window.  The following is an example of the minimum tagging required for a 
  3289.  window: 
  3290.  
  3291.   :h1 res=001.My First Window
  3292.   :p.
  3293.   Here is the text for the first window.
  3294.  
  3295.  In this example, :h1. creates a level-1 entry in the Contents window and the 
  3296.  title, "My First Window," in the title bar of the default window. 
  3297.  
  3298.  The following figure shows the tagging to produce the two default windows 
  3299.  shown in the example that follows the tagging. 
  3300.  
  3301.   :h1 res=001.My First Window
  3302.   :p.
  3303.   Here is the text for the first window.
  3304.   This is a
  3305.   :link reftype=hd res=002.
  3306.   hypertext link
  3307.   :elink.
  3308.   to the second window.
  3309.   :h1 res=002.My Second Window
  3310.   :p.
  3311.   Here is the text for the second window.
  3312.   This is a
  3313.   :link reftype=hd res=001.
  3314.   hypertext link
  3315.   :elink. to the first window.
  3316.  
  3317.  The following figure shows the compiled version of the tagging shown in the 
  3318.  previous figure. "My First Window" is one of the default windows and is 
  3319.  bounded by the window "Default Window Example."  This window is called a 
  3320.  coverpage and provides window controls for the user. 
  3321.  
  3322.  Example of an IPF Default Window 
  3323.  
  3324.  The two windows each have a hypertext link.  Selection of the hypertext link 
  3325.  in "My First Window" causes the other default window "My Second Window" to 
  3326.  display. Each default window has the same characteristics: 
  3327.  
  3328.      Its size is 100% of the coverpage window. 
  3329.      It provides window controls for the user: 
  3330.         -  Title bar with a title bar icon 
  3331.         -  Maximize and hide buttons 
  3332.         -  Vertical and horizontal scroll bars 
  3333.         -  Sizing borders 
  3334.         -  Push buttons. 
  3335.  
  3336.  
  3337. ΓòÉΓòÉΓòÉ 7.1.1. Attribute Values for Window Controls ΓòÉΓòÉΓòÉ
  3338.  
  3339. Both the heading tag and :link. have attributes that define window controls. 
  3340. Following are the names of the window-control attributes, and values you can 
  3341. specify (defaults are underscored): 
  3342.  
  3343.       titlebar=yes|sysmenu|minmax|both|none 
  3344.  
  3345.       scroll=horizontal|vertical|both|none 
  3346.  
  3347.       rules=border|sizeborder|none 
  3348.  
  3349.  You can eliminate window controls altogether by specifying: 
  3350.  
  3351.       titlebar=none scroll=none rules=none 
  3352.  
  3353.  You then can substitute controls of your own.  By eliminating borders around 
  3354.  windows and using :font. to specify fonts, you can design a more sophisticated 
  3355.  layout of text and graphics. The OS/2 system tutorial is an example of this. 
  3356.  
  3357.  For information about the tags that control the display of push buttons, see 
  3358.  Attribute Values for the Control Area of a Window. 
  3359.  
  3360.  
  3361. ΓòÉΓòÉΓòÉ 7.2. Multiple Windows ΓòÉΓòÉΓòÉ
  3362.  
  3363. Windows can be considered to be subdivisions of the screen. They can be either 
  3364. primary or secondary windows. A primary window is where the main topic appears, 
  3365. or where the interaction between a user and an object or application takes 
  3366. place. A secondary window usually supplements the information in the primary 
  3367. window. It is closed when its primary window is closed. The following figure 
  3368. shows a simple multiple-window design with a primary and secondary window. 
  3369.  
  3370. A Primary and Secondary Window Arrangement 
  3371.  
  3372. To create the two-window format shown in the figure, you must define the size 
  3373. of each window, then position them within the boundaries of the coverpage 
  3374. window. When defining window size, you specify horizontal and vertical areas of 
  3375. the window, using window coordinates. 
  3376.  
  3377.  
  3378. ΓòÉΓòÉΓòÉ 7.2.1. Defining Window Origin and Size ΓòÉΓòÉΓòÉ
  3379.  
  3380. Each window represents a rectangle with x and y coordinates. The x-axis is 
  3381. always horizontal; the y-axis is always vertical. The position where the values 
  3382. specified for x and y intersect is the window's origin.  From this position, 
  3383. width and height are measured. The following figure shows the window 
  3384. coordinates of a primary and secondary window. 
  3385.  
  3386. A Window in Relationship to Its Coordinates 
  3387.  
  3388.  
  3389. ΓòÉΓòÉΓòÉ 7.2.2. Attribute Values for Window Origin and Size ΓòÉΓòÉΓòÉ
  3390.  
  3391. Both the heading tags and :link. have attributes that define window origin and 
  3392. size. The heading tag has four attributes: 
  3393.  
  3394.  x=          Specifies a point on the x-axis. The x-axis runs horizontally from 
  3395.              left to right. 
  3396.  y=          Specifies a point on the y-axis. The y-axis runs vertically from 
  3397.              bottom to top. 
  3398.  width=      Specifies the width (horizontal space) of the window. 
  3399.  height=     Specifies the height (vertical space) of the window. 
  3400.  
  3401.  The :link. tag also has four attributes: 
  3402.  
  3403.  vpx=        Specifies a point on the x-axis. The x-axis runs horizontally from 
  3404.              left to right. 
  3405.  vpy=        Specifies a point on the y-axis. The y-axis runs vertically from 
  3406.              bottom to top. 
  3407.  vpcx=       Specifies the width (horizontal space) of the window. 
  3408.  vpcy=       Specifies the height (vertical space) of the window. 
  3409.  
  3410.  Origin and size attributes also can be assigned values of the following types: 
  3411.  
  3412.      Absolute 
  3413.      Relative 
  3414.      Dynamic 
  3415.  
  3416.  
  3417. ΓòÉΓòÉΓòÉ 7.2.2.1. Absolute Values ΓòÉΓòÉΓòÉ
  3418.  
  3419. Absolute values are specified in characters, pixels, or points. The format for 
  3420. an absolute value is an integer followed by one of these letters: 
  3421.  
  3422.  c (characters) 
  3423.     Average character width of the default system font. 
  3424.  x (pixels) 
  3425.     Pixel size, dependent on the display adapter in use. 
  3426.  p (points) 
  3427.     Typesetting measure, equal to approximately 1/72 inch. 
  3428.  
  3429.  
  3430. ΓòÉΓòÉΓòÉ 7.2.2.2. Relative Values ΓòÉΓòÉΓòÉ
  3431.  
  3432. Relative values are specified as percentages of the display area of the 
  3433. coverpage window. The format for a relative value is an integer followed by the 
  3434. percent sign (%). 
  3435.  
  3436.  
  3437. ΓòÉΓòÉΓòÉ 7.2.2.3. Dynamic Values ΓòÉΓòÉΓòÉ
  3438.  
  3439. Dynamic values for x- and y-coordinates identify locations on the 
  3440. coverpage-window perimeter or its center. Values are left and right for x, top 
  3441. and bottom for y, and center for both. 
  3442.  
  3443.  
  3444. ΓòÉΓòÉΓòÉ 7.2.2.4. Heading Definition Example ΓòÉΓòÉΓòÉ
  3445.  
  3446. The window defined in the following example is a primary window; its origin is 
  3447. specified using dynamic values, and its width and height are specified as 
  3448. percentages of its coverpage window. 
  3449.  
  3450. :h1 res=001
  3451.     x=left y=bottom width=50% height=100%
  3452.     group=1.Primary Window
  3453.  
  3454. For now, ignore "group=1."  We will explain it later. 
  3455.  
  3456. The most practical values to use for window size and position are a combination 
  3457. of relative and dynamic values. Then, if the user resizes the coverpage window, 
  3458. IPF automatically resizes and repositions the windows relative to the new size 
  3459. and position of the coverpage window. If you use absolute values, the window 
  3460. might be clipped when the user resizes the coverpage window. 
  3461.  
  3462. When defining window position and size, you cannot mix absolute values with 
  3463. dynamic or relative values for either of the following combinations of 
  3464. attributes: 
  3465.  
  3466.       x= and width= 
  3467.       y= and height= 
  3468.  
  3469.  If no values for x and y are specified, the origin of the window is 0,0. If 
  3470.  you specify an origin other than 0,0, you also must specify width and height 
  3471.  values.  Negative values for these attributes are not allowed. 
  3472.  
  3473.  
  3474. ΓòÉΓòÉΓòÉ 7.2.2.5. Origin and Size Example ΓòÉΓòÉΓòÉ
  3475.  
  3476. The example of a source file shown in the following figure defines two windows. 
  3477. The origin and size attributes specified with the heading definitions place the 
  3478. windows adjacent to one another on the screen. 
  3479.  
  3480. :h1.Origin and Size Window Example
  3481. :h2 res=003
  3482.     x=left y=bottom
  3483.     width=50% height=100%.
  3484. Primary Window
  3485. :p.
  3486. Here is the text for the primary window.  This is a
  3487. :link reftype=hd res=004.
  3488. hypertext link
  3489. :elink.
  3490. to the secondary window.
  3491. :h2 res=004
  3492.     x=right y=bottom
  3493.     width=50% height=100%.
  3494. Secondary Window
  3495. :p.
  3496. Here is the text for the secondary window.  This is a
  3497. :link reftype=hd res=003.
  3498. hypertext link
  3499. :elink.
  3500. to the primary window.
  3501.  
  3502. The origin of the first window is the lower left-hand corner of the coverpage 
  3503. window.  It occupies 50% of the width, but 100% of the height of the coverpage 
  3504. window on the left-hand side. 
  3505.  
  3506. The origin of the second window is the lower right-hand corner of the coverpage 
  3507. window.  It occupies 50% of the width, but 100% of the height of the coverpage 
  3508. window on the right-hand side. 
  3509.  
  3510.  Although these two windows occupy adjacent positions on the screen, you cannot 
  3511. display them both at the same time. To define separate windows, you must 
  3512. specify a group number in the heading definition. 
  3513.  
  3514.  
  3515. ΓòÉΓòÉΓòÉ 7.2.3. Displaying Multiple Windows ΓòÉΓòÉΓòÉ
  3516.  
  3517. To display more than one window on the screen, you must assign a unique group 
  3518. number to each window with the group= attribute. This attribute can be 
  3519. specified with :link. or the heading tag. 
  3520.  
  3521. If you do not specify a group number, a value of 0 is assigned. (This is the 
  3522. default value and is reserved for use by IPF.) If another window is already 
  3523. opened with the number specified for group=, IPF swaps its image (places the 
  3524. image in the same window) for the one defined by the heading or link tag. 
  3525.  
  3526. Note:  If a group number is assigned in both a heading and a hypertext or an 
  3527.        automatic link, the link group number overrides the heading group 
  3528.        number. The numbers you can assign to group= are integers from 1 to 
  3529.        64 000. 
  3530.  
  3531.  Compare the three heading definitions in the following figure. Notice that: 
  3532.  
  3533.      The first and second windows have different group numbers and different 
  3534.       positions. 
  3535.      The second and third windows have the same group number. 
  3536.      The second and third windows have the same size and position. 
  3537.  Source File for Window Group Number 
  3538.  
  3539.   :h1 res=005
  3540.       x=left y=bottom
  3541.       width=50% height=100%
  3542.       group=1.
  3543.   My First Window
  3544.   :p.
  3545.   Here is the text for the first window.
  3546.   This is a
  3547.   :link reftype=hd res=006.
  3548.   hypertext link
  3549.   :elink.
  3550.   to the second window.
  3551.   :p.
  3552.   This is a
  3553.   :link reftype=hd res=007.
  3554.   hypertext link
  3555.   :elink.
  3556.   to the third window.
  3557.   :h1 res=006
  3558.       x=right y=top
  3559.       width=50% height=100%
  3560.       group=2.
  3561.   My Second Window
  3562.   :p.
  3563.   Here is the text for the second window.
  3564.   This is a
  3565.   :link reftype=hd res=005.
  3566.   hypertext link
  3567.   :elink.
  3568.   to the first window.
  3569.   :p.
  3570.   This is a
  3571.   :link reftype=hd res=007.
  3572.   hypertext link
  3573.   :elink.
  3574.   to the third window.
  3575.   :h1 res=007
  3576.       x=right y=top
  3577.       width=50% height=100%
  3578.       group=2.
  3579.   My Third Window
  3580.   :p.
  3581.   Here is the text for the third window.
  3582.   This is a
  3583.   :link reftype=hd res=005.
  3584.   hypertext link
  3585.   :elink.
  3586.   to the first window.
  3587.   :p.
  3588.   This is a
  3589.   :link reftype=hd res=006.
  3590.   hypertext link
  3591.   :elink.
  3592.   to the second window.
  3593.  
  3594.  Now assume that the source file shown in the previous figure is compiled, and 
  3595.  the user selects "My First Window" from the Contents window. The window in the 
  3596.  following figure displays. 
  3597.  
  3598.  Multiple windows display with different group numbers. 
  3599.  
  3600.  If the user selects the hypertext link in this window, "My Second Window" will 
  3601.  appear, as shown in the following figure. 
  3602.  
  3603.  Multiple windows display with same group numbers. 
  3604.  
  3605.  The windows appear next to each other because their heading definitions 
  3606.  specify different group numbers.  If the user now selects the hypertext link 
  3607.  in "My Second Window," the resulting screen will be as shown in the following 
  3608.  figure. 
  3609.  
  3610.  Compiled Output of Third Window from Group Number. "My Third Window" replaced 
  3611.  "My Second Window" because it has the same group number as "My Second Window." 
  3612.  
  3613.  
  3614. ΓòÉΓòÉΓòÉ 7.2.3.1. Preventing Image Swapping in Windows ΓòÉΓòÉΓòÉ
  3615.  
  3616. The group= attribute opens a new window only if no other window with the same 
  3617. group number is already displayed.  When a window is opened and a user selects 
  3618. another window with the same group number, IPF swaps its image in the already 
  3619. opened window. To prevent this, use the viewport attribute; it always opens a 
  3620. window. 
  3621.  
  3622. Suppose you have defined the following hypertext link to a window: 
  3623.  
  3624. :link reftype=hd res=001.
  3625.       vpx=25% vpy=bottom
  3626.       vpcx=75% vpcy=100%
  3627.       viewport group=2.
  3628. Guidance
  3629. :elink.
  3630.  
  3631. When this window is displayed, if the user selects the same hypertext link, the 
  3632. same window will open. You cannot control how many times the user will select a 
  3633. hypertext link. If you do not want another window opened each time the user 
  3634. selects the same hypertext link, use the group= attribute instead of the 
  3635. viewport attribute.  This eliminates the potential for the user to open 
  3636. multiple windows containing the same information. 
  3637.  
  3638.  
  3639. ΓòÉΓòÉΓòÉ 7.2.4. Linking to a Window Automatically ΓòÉΓòÉΓòÉ
  3640.  
  3641. As we have seen, one way to display a secondary window is to enable the user to 
  3642. select a hypertext link from one window to another. Another way is to link the 
  3643. user to the secondary window automatically. For example, in the following 
  3644. figure the window on the right is displayed automatically when the user selects 
  3645. the window on the left (perhaps from the Contents window). 
  3646.  
  3647. Example of a window displayed automatically. The window on the right was 
  3648. displayed automatically. 
  3649.  
  3650.  
  3651. ΓòÉΓòÉΓòÉ 7.2.4.1. Auto Attribute ΓòÉΓòÉΓòÉ
  3652.  
  3653. A window that starts the concurrent display of one or more other windows by 
  3654. automatic or hypertext links is referred to as the owner of the window chain. 
  3655. The auto attribute and the reftype=hd attribute indicate that a window is to be 
  3656. opened automatically whenever the owner window is opened. The group= attribute 
  3657. specifies the number of the window. (For more information about group numbers, 
  3658. see Displaying Multiple Windows.) 
  3659.  
  3660. The vpx, vpy, vpcx, and vpcy attributes indicate the size and position of the 
  3661. window in relation to its coverpage window. 
  3662.  
  3663. Caution: 
  3664.  
  3665. When defining automatic links, you do not want to create an "infinite loop" by 
  3666. linking to the same window or group number more than once in a chain of links. 
  3667.  
  3668. For example, suppose you create three windows, A, B, and C, that contain the 
  3669. following automatic links. 
  3670.  
  3671.    ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3672.    Γöé Window A     Γöé   Γöé Window B     Γöé   Γöé  Window C    Γöé
  3673.    Γöé              Γöé   Γöé              Γöé   Γöé              Γöé
  3674.  Γöî>Γöé Link to B    Γö£ΓöÇΓöÇ>Γöé Link to C    Γö£ΓöÇΓöÇ>Γöé  Link to A   Γö£ΓöÇΓöÉ
  3675.  Γöé ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ Γöé
  3676.  ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3677.  
  3678. When the file containing these links is compiled, the IPF compiler does not 
  3679. return an error message because of the loop.  Now suppose Window A is an entry 
  3680. in the Contents window and the user selects it.  Windows A, B, and C open and 
  3681. close uncontrollably until an error occurs and the process is terminated by the 
  3682. system. 
  3683.  
  3684.  
  3685. ΓòÉΓòÉΓòÉ 7.2.5. Closing a Window Automatically ΓòÉΓòÉΓòÉ
  3686.  
  3687. The dependent attribute causes the window to close automatically when the owner 
  3688. window is closed. 
  3689.  
  3690. In the following example, the link at the end of the heading definition defines 
  3691. the owner window on the left.  It links to the window on the right.  Notice the 
  3692. link tag defining the automatic link does not require :elink.. 
  3693.  
  3694. :h1 res=421
  3695.        x=left y=bottom
  3696.         width=25% height=100%
  3697.        group=1.
  3698. Developing Online Information
  3699. :link reftype=hd res=422
  3700.       vpx=right vpy=bottom
  3701.       vpcx=75% vpcy=100%
  3702.       auto dependent group=2.
  3703. .
  3704. .
  3705. .
  3706. :h1 res=422.Developing Online Information
  3707.  
  3708.  
  3709. ΓòÉΓòÉΓòÉ 7.2.6. Tagging Example for Automatic Windows ΓòÉΓòÉΓòÉ
  3710.  
  3711. The following tagging example defines two automatic window chains.  A window 
  3712. chain has at least one owner window, and an owner window has one or more 
  3713. automatic or hypertext links to other windows in the chain. When an owner 
  3714. window closes, the windows in its chain that have specified the dependent 
  3715. attribute also close. 
  3716.  
  3717. In "Example 1," the only owner window in the chain is the first window 
  3718. (res=008).  It contains links to three other automatic windows, which are 
  3719. referred to as sibling windows of the owner window. 
  3720.  
  3721. In "Example 2," Windows 1 through 3 in the chain are owner windows.  Window 1 
  3722. owns all the windows in the chain and can close all of them.  Window 2 also 
  3723. owns Windows 3 and 4.  Window 3 also owns Window 4, the last window in the 
  3724. chain, which is displayed by means of a hypertext link in the text. 
  3725.  
  3726. :h1.Automatic Windows
  3727. :h2 res=008
  3728.     x=left y=top width=25% height=100%
  3729.     scroll=none group=1 clear.
  3730. Example 1
  3731. :link reftype=hd res=009
  3732.       vpx=25% vpy=top vpcx=25% vpcy=100%
  3733.       group=2 auto dependent.
  3734. :link reftype=hd res=010
  3735.       vpx=50% vpy=top vpcx=25% vpcy=100%
  3736.       group=3 auto dependent.
  3737. :link reftype=hd res=011
  3738.       vpx=75% vpy=top vpcx=25% vpcy=100%
  3739.       group=4 auto dependent.
  3740. :p.
  3741. This is Window 1.
  3742. :p.
  3743. This window has three automatic links to
  3744. Windows 2, 3, and 4.
  3745. :h2 res=009
  3746.     x=25% y=top width=25% height=100%
  3747.     scroll=none hide.
  3748. Window 2
  3749. :p.
  3750. This is Window 2.
  3751. :h2 res=010
  3752.     x=50% y=top width=25% height=100%
  3753.     scroll=none hide.
  3754. Window 3
  3755. :p.
  3756. This is Window 3.
  3757. :h2 res=011
  3758.     x=75% y=top width=25% height=100%
  3759.     scroll=none hide.
  3760. Window 4
  3761. :p.
  3762. This is Window 4.
  3763.  
  3764. :h2 res=012
  3765.     x=left y=top width=25% height=100%
  3766.     scroll=none group=1 clear.
  3767. Example 2
  3768. :link reftype=hd res=013
  3769.       vpx=25% vpy=top vpcx=25% vpcy=100%
  3770.       group=2 auto dependent.
  3771. :p.
  3772. This is Window 1.
  3773. :p.
  3774. This window has an automatic link to
  3775. Window 2.
  3776. :h1 res=013
  3777.     x=25% y=top width=25% height=100%
  3778.     scroll=none hide.
  3779. Window 2
  3780. :link reftype=hd res=014
  3781.       vpx=50% vpy=top vpcx=25% vpcy=100%
  3782.       group=3 auto dependent.
  3783. :p.
  3784. This is Window 2.
  3785. :p.
  3786. This window has an automatic link to
  3787. Window 3.
  3788. :h1 res=014
  3789.     x=50% y=top width=25% height=100%
  3790.     scroll=none hide.
  3791. Window 3
  3792. :p.
  3793. This is Window 3.
  3794. :p.
  3795. This paragraph contains a
  3796. :link reftype=hd res=015
  3797.       vpx=75% vpy=top vpcx=25% vpcy=100%
  3798.       group=4 dependent.
  3799. hypertext link
  3800. :elink.
  3801. to Window 4.
  3802. :h1 res=015
  3803.     x=75% y=top width=25% height=100%
  3804.     scroll=none hide.
  3805. Window 4
  3806. :p.
  3807. This is Window 4.
  3808.  
  3809. Example of four automatic windows. 
  3810.  
  3811. When "Example 1" is selected from the Contents window, four windows are 
  3812. displayed in rapid succession.  When Window 1 is closed, all four windows 
  3813. close. 
  3814.  
  3815. The following figure shows the windows that are displayed when "Example 2" is 
  3816. selected from the Contents window. 
  3817.  
  3818. Example of three automatic windows. 
  3819.  
  3820. Notice Window 4 is not displayed. To display Window 4, you must select the 
  3821. hypertext link in Window 3. 
  3822.  
  3823. Note:  You can use the viewport attribute on an automatic link, because an 
  3824.        automatic link is made only once. 
  3825.  
  3826.  
  3827. ΓòÉΓòÉΓòÉ 7.3. Split Windows ΓòÉΓòÉΓòÉ
  3828.  
  3829. A group of windows can be given the semblance of one window and yet offer the 
  3830. advantage of different windows; for example, text can be displayed next to an 
  3831. object the text describes. The author creates this effect by defining a window 
  3832. that consists of: 
  3833.  
  3834.      :h1. or :h2. primary-window heading tags, followed by automatic links to 
  3835.       secondary windows.  (Text is not allowed.) 
  3836.      :h2. secondary-window heading tags, each followed by text. 
  3837.  
  3838.  The primary window and its secondary windows must reside in the same file. 
  3839.  
  3840.  The position and size of the primary window determines the boundaries for its 
  3841.  secondary windows. If the position and size of a secondary window are defined 
  3842.  in absolute values that exceed the perimeter of the primary window, the 
  3843.  secondary window is clipped.  (When a window is clipped, part of it lies 
  3844.  outside the window boundary and cannot be viewed.) 
  3845.  
  3846.  Sizes of secondary windows can be defined as percentages of the primary-window 
  3847.  size. The minimum size of a secondary window (expressed in percentages) is 
  3848.  zero height by zero width.  Negative values for origin and position are not 
  3849.  allowed. 
  3850.  
  3851.  
  3852. ΓòÉΓòÉΓòÉ 7.3.1. Defining Split Windows ΓòÉΓòÉΓòÉ
  3853.  
  3854. The primary window cannot have any text or graphics, only automatic links to 
  3855. each of its secondary windows.  Each automatic link to a secondary window 
  3856. requires the auto and split attributes.  The following is an example of the 
  3857. tagging for a primary window that contains a split window: 
  3858.  
  3859. :h1 res=001 scroll=none.Primary Window A
  3860. :link reftype=hd res=002 auto split group=10
  3861.       vpx=left vpy=top vpcx=50% vpcy=100%
  3862.       scroll=none titlebar=none.
  3863. :link reftype=hd res=003 auto split group=11
  3864.       vpx=right vpy=top vpcx=50% vpcy=100%
  3865.       scroll=vertical titlebar=none.
  3866.  
  3867. The primary window does not have text and does not need a scroll bar; thus, the 
  3868. heading tag attribute is scroll=none. The primary window can define an overall 
  3869. title bar and disable the title bars in the secondary windows. 
  3870.  
  3871. Caution: 
  3872.  
  3873. When defining split windows, do not link to a footnote from a secondary window. 
  3874.  
  3875. For example, the text of a secondary window cannot have a link such as the 
  3876. following: 
  3877.  
  3878. :link reftype=fn
  3879.       refid=001.
  3880. Display Pop-Up Window
  3881. :elink.
  3882.  
  3883.  
  3884. ΓòÉΓòÉΓòÉ 7.3.2. Tagging Example for Split Windows ΓòÉΓòÉΓòÉ
  3885.  
  3886. The following tagging examples show the tagging for two different split-window 
  3887. arrangements. 
  3888.  
  3889. In the first example, "Primary Window A" (res=016) has automatic links to two 
  3890. secondary windows, (res=017 and res=018).  The tagging for res=017 has two list 
  3891. items, each of which is a hypertext link.  The first list item, "Ducks," links 
  3892. to res=018; the second item, "World," links to res=019. 
  3893.  
  3894. The tagging for both res=018 and res=019 refer to bit-map files. 
  3895.  
  3896. Notice that in "Primary Window A" the link tags for the secondary windows 
  3897. specify titlebar=none, but the heading tags for the secondary windows specify 
  3898. "Dummy" as title text.  You must always provide IPF with a title string in a 
  3899. heading tag, even when you specify that the window will not have a title bar 
  3900. and will not have an entry in the Contents window because you have specified 
  3901. the hide attribute. The link tags for a hypertext link to a secondary window 
  3902. must specify the split attribute. If the split attribute is omitted, the window 
  3903. will not behave as a secondary window; that is, it will not close when the 
  3904. primary window is closed, and instead of moving when the primary window is 
  3905. moved, it will become obscured. 
  3906.  
  3907.  
  3908. ΓòÉΓòÉΓòÉ 7.3.2.1. Hide, Noprint, and Nosearch Attributes ΓòÉΓòÉΓòÉ
  3909.  
  3910. In the examples, each secondary window heading has the hide, noprint, and 
  3911. nosearch attributes.  The hide attribute prevents an entry from appearing in 
  3912. the Contents window.  You do not want a secondary window (in a split-window 
  3913. arrangement) to be displayed by itself; you want it displayed only when the 
  3914. Contents entry for its primary window is selected. 
  3915.  
  3916. The nosearch attribute prevents the title string of the secondary window from 
  3917. being listed as an entry in the Search Results window. The Search option of IPF 
  3918. also searches the secondary window (for a word or phrase) because of the link 
  3919. definition in the primary window; however, only the title string of the primary 
  3920. window is returned in the Search Results window. 
  3921.  
  3922. The Print option of IPF enables the user to print one or more topics, the 
  3923. index, or the table of contents. The noprint attribute in a primary-window 
  3924. heading prevents the contents of a secondary window from being printed. 
  3925. Secondary windows are printed as part of their primary window. The contents of 
  3926. secondary windows are printed only in the order in which the link definitions 
  3927. appear in the primary-window definition. 
  3928.  
  3929. None of the primary-window heading tags specifies a group number with the 
  3930. group= attribute, so IPF assigns 0 (the default) as the group number of each. 
  3931. The clear attribute causes the screen to be cleared of windows before each 
  3932. split window is displayed. 
  3933.  
  3934. :h1 res=016 scroll=none clear.
  3935. Primary Window A
  3936. :link reftype=hd res=017 auto split group=10
  3937.       vpx=left vpy=top vpcx=50% vpcy=100%
  3938.       rules=border scroll=none titlebar=none.
  3939. :link reftype=hd res=018 auto split group=11
  3940.       vpx=right vpy=top vpcx=50% vpcy=100%
  3941.       rules=border scroll=none titlebar=none.
  3942. :h2 res=017 hide nosearch noprint.Dummy
  3943. :p.
  3944. This secondary window contains hypertext links
  3945. to the adjacent secondary window.
  3946. :p.
  3947. Select one:
  3948. :sl compact.
  3949. :li.:link reftype=hd res=018 split group=11
  3950.           vpx=right vpy=top vpcx=50% vpcy=100%
  3951.           rules=border scroll=none titlebar=none.
  3952. Ducks
  3953. :elink.
  3954. :li.:link reftype=hd res=019 split group=11
  3955.           vpx=right vpy=top vpcx=50% vpcy=100%
  3956.           rules=border scroll=none titlebar=none.
  3957. World
  3958. :elink.
  3959. :esl.
  3960. :h2 res=018 hide nosearch noprint.Dummy
  3961. :artwork name='ducks.bmp' fit.
  3962. :h2 res=019 hide nosearch noprint.Dummy
  3963. :p.
  3964. :artwork name='world.bmp' fit.
  3965.  
  3966. Here are both views of the compiled version of Primary Window A. 
  3967.  
  3968. Example of a split window with an automatic link. The window on the right is 
  3969. displayed automatically when "Primary Window A" is selected from the Contents 
  3970. window. 
  3971.  
  3972. Example of a split window with hypertext link. The window on the right is 
  3973. displayed when the second hypertext link is selected. 
  3974.  
  3975. :h1 res=022 scroll=none titlebar=none rules=none clear.
  3976. Primary Window B
  3977. :link reftype=hd res=023 auto split group=10
  3978.       vpx=left vpy=top vpcx=40% vpcy=100%
  3979.       scroll=none titlebar=none rules=none.
  3980. :link reftype=hd res=024 auto split group=11
  3981.       vpx=right vpy=top vpcx=60% vpcy=20%
  3982.       scroll=none titlebar=none rules=none.
  3983. :link reftype=hd res=025 auto split group=12
  3984.       vpx=right vpy=bottom vpcx=60% vpcy=80%
  3985.       scroll=none titlebar=none rules=none.
  3986. :h2 res=023 hide nosearch noprint.Dummy
  3987. :lm margin=5.
  3988. :rm margin=2.
  3989. :p.
  3990. :font facename='Tms Rmn' size=24x12.
  3991. :color bc=green.:hp2.TREES LOVE IPF:ehp2.
  3992. :color bc=cyan.:hp3.TREES LOVE IPF:ehp3.
  3993. :color bc=green.:hp4.TREES LOVE IPF:ehp4.
  3994. :color bc=cyan.:hp5.TREES LOVE IPF:ehp5.
  3995. :color bc=green.:hp6.TREES LOVE IPF:ehp6.
  3996. :color bc=cyan.:hp7.TREES LOVE IPF:ehp7.
  3997. :color bc=green.:hp4.TREES LOVE IPF:ehp4.
  3998. :color bc=cyan.:hp3.TREES LOVE IPF:ehp3.
  3999. :color bc=green.:hp2.TREES LOVE IPF:ehp2.
  4000. :h2 res=024 hide nosearch noprint.Dummy
  4001. :p.
  4002. :h2 res=025 hide rules=none nosearch noprint.Dummy
  4003. :rm margin=3.
  4004. :font facename='Helv' size=18x9.
  4005. :p.
  4006. The Information Presentation Facility (IPF) is a set of tools
  4007. that supports the design and development of an online help
  4008. facility that is accessed by users of your application.
  4009. :p.
  4010. IPF also supports the design and development of online
  4011. information that may be viewed independently of an application.
  4012. These files are compiled with the /INF parameter of the IPF
  4013. compiler, and they are viewed by entering the name of
  4014. the compiled file as a parameter of the VIEW program.
  4015.  
  4016. Here is the compiled version of Primary Window B. 
  4017.  
  4018. Example of a split window without window controls. You cannot see the 
  4019. boundaries of the three windows because the window controls were eliminated. 
  4020.  
  4021.  
  4022. ΓòÉΓòÉΓòÉ 7.3.2.2. Push Buttons for Split Windows ΓòÉΓòÉΓòÉ
  4023.  
  4024. Be careful when using heading tags to define a control area for split windows. 
  4025. A control area cannot be defined in the secondary window heading tag of a split 
  4026. window. You must define the control area (the coverpage window) in the primary 
  4027. window heading tag.  In the previous examples of split windows, the push button 
  4028. feature of IPF was disabled (see Disabling the Display of Push Buttons). 
  4029.  
  4030.  
  4031. ΓòÉΓòÉΓòÉ 7.4. Summary Tables of Attribute Values for Origin and Size ΓòÉΓòÉΓòÉ
  4032.  
  4033. The following tables summarize the attribute values that define a window's 
  4034. origin and size. Values shown in uppercase are keywords (words with special 
  4035. significance to IPF).  Values shown in lowercase italics are to be substituted 
  4036. with your own values.  Values are stacked when more than one value can be used 
  4037. with the attribute. 
  4038.  
  4039. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4040. ΓöéAttribute=Value     ΓöéDescription                             Γöé
  4041. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4042. ΓöéX=CENTER            ΓöéSpecifies the location of the x-axis.   Γöé
  4043. Γöé  LEFT              ΓöéThe x-axis runs horizontally from left  Γöé
  4044. Γöé  RIGHT             Γöéto right.                               Γöé
  4045. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4046. ΓöéY=CENTER            ΓöéSpecifies the location of the y-axis.   Γöé
  4047. Γöé  TOP               ΓöéThe y-axis runs vertically from bottom  Γöé
  4048. Γöé  BOTTOM            Γöéto top.                                 Γöé
  4049. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4050. ΓöéWIDTH=an integer    ΓöéSpecifies the width (horizontal space)  Γöé
  4051. Γöéfollowed by the     Γöéof a window.                            Γöé
  4052. Γöépercent sign (%)    Γöé                                        Γöé
  4053. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4054. ΓöéHEIGHT=an integer   ΓöéSpecifies the height (vertical space) ofΓöé
  4055. Γöéfollowed by the     Γöéa window.                               Γöé
  4056. Γöépercent sign (%)    Γöé                                        Γöé
  4057. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4058.  
  4059. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4060. ΓöéAttribute=Value     ΓöéDescription                             Γöé
  4061. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4062. ΓöéVPX=CENTER          ΓöéSpecifies the location of the x-axis.   Γöé
  4063. Γöé  LEFT              ΓöéThe x-axis runs horizontally from left  Γöé
  4064. Γöé  RIGHT             Γöéto right. Overrides the x-axis attributeΓöé
  4065. Γöé                    Γöévalue specified by the heading tag.     Γöé
  4066. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4067. ΓöéVPY=CENTER          ΓöéSpecifies the location of the y-axis.   Γöé
  4068. Γöé  TOP               ΓöéThe y-axis runs vertically from bottom  Γöé
  4069. Γöé  BOTTOM            Γöéto top. Overrides the y-axis attribute  Γöé
  4070. Γöé                    Γöévalue specified by the heading tag.     Γöé
  4071. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4072. ΓöéVPCX=an integer     ΓöéSpecifies the width (horizontal space)  Γöé
  4073. Γöéfollowed by the     Γöéof a window. Overrides the width        Γöé
  4074. Γöépercent sign (%)    Γöéattribute value specified by the headingΓöé
  4075. Γöé                    Γöétag.                                    Γöé
  4076. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4077. ΓöéVPCY=an integer     ΓöéSpecifies the height (vertical space) ofΓöé
  4078. Γöéfollowed by the     Γöéa window. Overrides the height attributeΓöé
  4079. Γöépercent sign (%)    Γöévalue specified by the heading tag.     Γöé
  4080. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4081.  
  4082. Point to Remember  Origin and size attributes in a link tag override the origin 
  4083. and size attributes in a heading tag. 
  4084.  
  4085.  
  4086. ΓòÉΓòÉΓòÉ 7.5. Summary Table for Heading Attributes ΓòÉΓòÉΓòÉ
  4087.  
  4088. This table summarizes the heading attributes that support a multiple-window 
  4089. format. 
  4090.  
  4091. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4092. ΓöéAttribute=Value     ΓöéFunction                                Γöé
  4093. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4094. Γöéres=                ΓöéDefine references to internal and       Γöé
  4095. Γöéid=                 Γöéexternal sources.                       Γöé
  4096. Γöéname=               Γöé                                        Γöé
  4097. Γöéglobal              Γöé                                        Γöé
  4098. Γöétutorial            Γöé                                        Γöé
  4099. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4100. Γöéx=                  ΓöéDefine the origin and size of a window  Γöé
  4101. Γöéy=                  Γöéin relation to its coverpage or primary Γöé
  4102. Γöéwidth=              Γöéwindow.                                 Γöé
  4103. Γöéheight=             Γöé                                        Γöé
  4104. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4105. Γöétitlebar=           ΓöéDefine the control the user has over theΓöé
  4106. Γöéscroll=             Γöéwindow.                                 Γöé
  4107. Γöérules=              Γöé                                        Γöé
  4108. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4109. Γöéviewport            ΓöéManage the display of information in    Γöé
  4110. Γöégroup=              Γöémultiple windows.                       Γöé
  4111. Γöéclear               Γöé                                        Γöé
  4112. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4113. Γöéhide                ΓöéRestrict user retrieval of information. Γöé
  4114. Γöénosearch            Γöé                                        Γöé
  4115. Γöénoprint             Γöé                                        Γöé
  4116. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4117. Γöétoc=                ΓöéChange heading levels appearing in the  Γöé
  4118. Γöé                    ΓöéContents window.                        Γöé
  4119. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4120.  
  4121.  
  4122. ΓòÉΓòÉΓòÉ 7.6. Summary Table for Link Attributes ΓòÉΓòÉΓòÉ
  4123.  
  4124. This table summarizes the link attributes that support a multiple-window 
  4125. format. 
  4126.  
  4127. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4128. ΓöéAttribute=Value     ΓöéFunction                                Γöé
  4129. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4130. Γöéreftype=            ΓöéDefine references to internal and       Γöé
  4131. Γöéres=                Γöéexternal sources.                       Γöé
  4132. Γöérefid=              Γöé                                        Γöé
  4133. Γöédatabase=           Γöé                                        Γöé
  4134. Γöéobject=             Γöé                                        Γöé
  4135. Γöédata=               Γöé                                        Γöé
  4136. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4137. Γöévpx=                ΓöéDefine the origin and size of a window  Γöé
  4138. Γöévpy=                Γöéin relation to its coverpage or primary Γöé
  4139. Γöévpcx=               Γöéwindow.                                 Γöé
  4140. Γöévpcy=               Γöé                                        Γöé
  4141. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4142. Γöétitlebar=           ΓöéDefine the control the user has over theΓöé
  4143. Γöéscroll=             Γöéwindow.                                 Γöé
  4144. Γöérules=              Γöé                                        Γöé
  4145. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4146. Γöéviewport            ΓöéManage the display of information in    Γöé
  4147. Γöégroup=              Γöémultiple windows.                       Γöé
  4148. Γöédependent           Γöé                                        Γöé
  4149. Γöéauto                Γöé                                        Γöé
  4150. Γöésplit               Γöé                                        Γöé
  4151. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4152.  
  4153. Points to Remember  Link-tag attributes that have the same functions as those 
  4154. specified in a heading tag will override the heading-tag attributes. Although 
  4155. link-tag attributes have different names for x- and y-coordinates and window 
  4156. width and height, they provide the same functions. 
  4157.  
  4158.  
  4159. ΓòÉΓòÉΓòÉ 8. Compiling Source Files ΓòÉΓòÉΓòÉ
  4160.  
  4161. This chapter explains how to prepare your source files so that they will be 
  4162. recognized by the IPF compiler. This chapter also shows you how to enter the 
  4163. compile command, how to interpret error messages, and how to view the compiled 
  4164. document.  A section on national language support (NLS) is also provided. 
  4165.  
  4166.  
  4167. ΓòÉΓòÉΓòÉ 8.1. Source File Requirements ΓòÉΓòÉΓòÉ
  4168.  
  4169. Using a single source file, you can produce a successful display of information 
  4170. with a limited number of tags.  These tags are: 
  4171.  
  4172.             :userdoc.
  4173.  
  4174.             :docprof.
  4175.  
  4176.             :title.
  4177.  
  4178.             :h1.
  4179.  
  4180.             :p.
  4181.  
  4182.             :euserdoc.
  4183.  
  4184.  The :userdoc. tag is always the first item in your source file.  It identifies 
  4185.  the beginning of an IPF file. This tag is a signal to the IPF compiler to 
  4186.  begin translating the tag language. 
  4187.  
  4188.  The :euserdoc. tag is required as the last line of the file to signal the end 
  4189.  of the tagged document. 
  4190.  
  4191.  Place the :docprof. tag at the beginning of your source file after the 
  4192.  :userdoc. tag and before any heading definitions.  Use the function of the toc 
  4193.  (table of contents) attribute of the :docprof. tag to control the heading 
  4194.  levels displayed in the Content window.  For example, if you want only heading 
  4195.  levels 1 and 2 to appear, the tagging is: 
  4196.  
  4197.             :docprof toc=12.
  4198.  
  4199.  If no toc= value is specified, heading level 1 through 3 appear in the 
  4200.  Contents window. 
  4201.  
  4202.  Not to be confused with window titles, the text string specified with a 
  4203.  :title. tag is placed into the title bar of an online document. When the 
  4204.  online document is displayed, the title appears on the title line of the main 
  4205.  window.  The tagging looks like this: 
  4206.  
  4207.             :title.Endangered Mammals
  4208.  
  4209.  The maximum length of a title string specified with a :title. tag is 47 
  4210.  characters, including spaces and blanks. 
  4211.  
  4212.  The title tag provides a name for the online document but is also used for 
  4213.  titles of Help windows.  The title appears in the title bar of the main 
  4214.  window.  You usually place the title tag after the :docprof. tag. 
  4215.  
  4216.  Every file must start with a :h1. tag.  Heading level sequences must not skip 
  4217.  a level in the heading hierarchy.  For example, you cannot have a heading 
  4218.  level 1 tag (:h1.) followed by a heading level 3 tag (:h3.). 
  4219.  
  4220.  You must have at least one paragraph tag (:p.) and associated text to display 
  4221.  a window. 
  4222.  
  4223.  The following figure shows an IPF source file. 
  4224.  
  4225.  The source file contains a :userdoc. tag, a :title. tag, a heading tag with a 
  4226.  window identifier, a :p. tag, and the :euserdoc. tag. 
  4227.  
  4228.   .*
  4229.   :userdoc.
  4230.   :title.Endangered Mammals
  4231.   :h1 res=001.The Manatee
  4232.   .*
  4233.   :p.
  4234.   The Manatee has a broad flat tail and two flipper
  4235.   like forelegs.  There are no back legs.
  4236.   The Manatee's large upper lip is split in two and
  4237.   can be used like fingers to place food into the
  4238.   mouth.  Bristly hair protrudes from its lips,
  4239.   and almost buried in its hide are small eyes, with
  4240.   which it can barely see.
  4241.   .*
  4242.   :euserdoc.
  4243.  
  4244.  Source File Structure 
  4245.  
  4246.  
  4247. ΓòÉΓòÉΓòÉ 8.1.1. Source File Limits ΓòÉΓòÉΓòÉ
  4248.  
  4249.      The maximum size of a line in an IPF source file is 255 characters. 
  4250.  
  4251.      The maximum number of fonts in a source file is 16. 
  4252.  
  4253.      The maximum number of unique words in a compiled file is 64 000. 
  4254.  
  4255.      The maximum number of unique words in a panel is 64 000. 
  4256.  
  4257.      The maximum number of panels is 64 000. 
  4258.  
  4259.      The maximum number of external databases is 255. 
  4260.  
  4261.      Do not exceed 16 000 words, numbers, and punctuation marks between two 
  4262.       consecutive heading tags in your source file.  This includes blank 
  4263.       spaces, but does not include commented lines (see Comment). 
  4264.  
  4265.  These maximum limits are not absolute. Activity in the operating system can 
  4266.  cause them to vary. 
  4267.  
  4268.  
  4269. ΓòÉΓòÉΓòÉ 8.2. Naming Conventions ΓòÉΓòÉΓòÉ
  4270.  
  4271. It is a good idea to give your source files an extension of IPF, so they can be 
  4272. distinguished from your other files. For example: 
  4273.  
  4274.   MYHELP.IPF
  4275.  
  4276. The IPF compiler does not require an IPF file-name extension; however, if your 
  4277. file has an IPF file-name extension, you will not have to type the extension at 
  4278. compile time. 
  4279.  
  4280.  
  4281. ΓòÉΓòÉΓòÉ 8.2.1. Naming Restriction ΓòÉΓòÉΓòÉ
  4282.  
  4283. During the compilation process, IPF creates some files to hold data 
  4284. temporarily, and erases the files when it no longer needs them.  The names of 
  4285. these files are: 
  4286.  
  4287.             filename.clf
  4288.  
  4289.             $0000$ (footnotes)
  4290.  
  4291.             $1111$ (cross references)
  4292.  
  4293.             $2222$ (tables)
  4294.  
  4295.             $3333$ (bit maps)
  4296.  
  4297.  where filename is the name of your source file. Do not give your source file a 
  4298.  CLF extension.  Also, do not give your source file a name of $0000$, $1111$, 
  4299.  $2222$, or $3333$. 
  4300.  
  4301.  Do not use the name of any of the OS/2 environment variables for your file 
  4302.  name.  VIEW checks for an environment variable that matches its first argument 
  4303.  and, if it finds one, such as CPREF, it will take the value of that 
  4304.  environment variable and use the value as the name of the file or files to 
  4305.  open. 
  4306.  
  4307.  
  4308. ΓòÉΓòÉΓòÉ 8.3. Using a Base Source File ΓòÉΓòÉΓòÉ
  4309.  
  4310. The IPF compiler can produce a single output document by processing multiple 
  4311. input files through one base source file. This process is most often associated 
  4312. with online documents.  For example, the online Information Presentation 
  4313. Facility Reference has more than ten separate source files, but all the files 
  4314. were processed through one base file. 
  4315.  
  4316. The .im (imbed) control word sends a signal to the compiler and tells it to 
  4317. process each file in the sequence listed in the base file. 
  4318.  
  4319. A portion of the base file IPFCBASE.IPF for the online Information Presentation 
  4320. Facility Reference looks like this: 
  4321.  
  4322. :userdoc.
  4323. .
  4324. .
  4325. .
  4326. .im ipfcch01.ipf
  4327. .im ipfcch02.ipf
  4328. .im ipfcch03.ipf
  4329. .
  4330. .
  4331. .
  4332.  
  4333. The placement of an imbedded file determines the order of entries in the table 
  4334. of contents. 
  4335.  
  4336. Imbedded files cannot use the :userdoc. or :euserdoc. tags. 
  4337.  
  4338. Note:  When using a base source file to process multiple files, enter the base 
  4339.        file name as the filename parameter of the IPFC command. 
  4340.  
  4341.  
  4342. ΓòÉΓòÉΓòÉ 8.4. Starting the IPF Compiler ΓòÉΓòÉΓòÉ
  4343.  
  4344. You can start the IPF compiler and specify all input from the command line.  A 
  4345. new command-line interface has been introduced. To view it, type IPFC with no 
  4346. parameters. 
  4347. The syntax is: 
  4348.  
  4349. Usage: 
  4350.  
  4351. IPFC [-switch]┬╖┬╖┬╖  [-option]┬╖┬╖┬╖ filename [outfile]
  4352.  
  4353. The switches perform the functions in the following list: 
  4354.  
  4355.  Switches: i - Compiles the source file as an online document 
  4356.  
  4357.            s - Suppresses the performance of the search function 
  4358.  
  4359.            x - Generates and displays a cross-reference list 
  4360.  
  4361.  The options perform the functions in the following list: 
  4362.  
  4363.  Options:  W:level - Warning level 
  4364.  
  4365.            D:dbcscode - Country code 
  4366.  
  4367.            C:codepage - Character code page 
  4368.  
  4369.            L:language - Language ID 
  4370.  
  4371.  The following parameters provide international language support: 
  4372.  
  4373.  -d: nnn     The nnn is the 3-digit country code. 
  4374.  
  4375.  -c: nnnn    The nnnn is the 4-digit code page. 
  4376.  
  4377.  -l: xxx     The xxx is a 3-letter identifier that indicates the language file 
  4378.              to be used. 
  4379.  
  4380.  See Country Code, Code Pages, and Language Parameters for the tables with the 
  4381.  NLS values. 
  4382.  
  4383.  For example: 
  4384.  
  4385.   IPFC myfile.txt /INF -d:033 -c:0437 -l:FRA
  4386.  
  4387.  If you do not specify these parameters, the default for -d: nnn and -c: nnnn 
  4388.  are the values specified in your CONFIG.SYS file. 
  4389.  
  4390.  For help on any of the options, type 
  4391.  
  4392.   IPFC -X:?
  4393.  
  4394.  where "X" is one of the options. 
  4395.  
  4396.  The outfile parameter is used to specify the name of the output file. If this 
  4397.  parameter is not used, the output file will have the same filename as the 
  4398.  input file and an extension of either INF or HLP. For example: 
  4399.  
  4400.   IPFC TEST┬╖IPF C:\FILE┬╖HLP
  4401.  
  4402.  Command Line Interfaces For Previous Versions of the IPF Compiler 
  4403.  The interface from earlier levels of the compiler is still supported. The 
  4404.  syntax is: 
  4405.  
  4406.   IPFC filename [/INF] [/S] [/X] [/W] [> messageoutputfilename] [/COUNTRY] [/CODEPAGE] [/LANGUAGE]
  4407.  
  4408.  where: 
  4409.  
  4410.  filename    Specifies the name of your IPF source file or base file. 
  4411.  
  4412.              If you do not give a file-name extension, the IPF compiler uses 
  4413.              .IPF by default. If your file has a file-name extension other than 
  4414.              IPF, include that file-name extension in the command line. 
  4415.  
  4416.  /INF        Compiles the source file as an online document. 
  4417.  
  4418.              If this parameter is not included, the default is to compile the 
  4419.              source file as a help library, whose extension is .HLP. 
  4420.  
  4421.  /S          Suppresses the performance of the Search function.  This parameter 
  4422.              increases compression of compiled data by about 10% to further 
  4423.              reduce the storage it requires. 
  4424.  
  4425.  /X          Generates and displays a cross-reference list. 
  4426.  
  4427.  /Wn         Generates and displays a list of error messages.  The n indicates 
  4428.              the level of error messages you want to receive.  Values you can 
  4429.              specify for n are 1, 2, or 3.  The default is W3. For more 
  4430.              information, see Interpreting IPFC Error Messages. 
  4431.  
  4432.  messageoutputfilename Specifies the name of the file where error and cross 
  4433.              reference messages are sent. If you do not specify this parameter, 
  4434.              messages generated by /X and /Wn are sent to the display screen. 
  4435.  
  4436.  The following parameters provide international language support (NLS): 
  4437.  
  4438.  /COUNTRY=nnn The nnn is the 3-digit country code. 
  4439.  
  4440.  /CODEPAGE=nnnn The nnnn is the 4-digit code page. 
  4441.  
  4442.  /LANGUAGE=xxx The xxx is a 3-letter identifier that indicates the language 
  4443.              file to be used. 
  4444.  
  4445.  See Country Code, Code Pages, and Language Parameters for the tables with the 
  4446.  NLS values. 
  4447.  
  4448.  For example: 
  4449.  
  4450.   IPFC myfile.txt /INF /COUNTRY=033 /CODEPAGE=437 /LANGUAGE=FRA
  4451.  
  4452.  If you do not specify these parameters, the default for /COUNTRY and /CODEPAGE 
  4453.  are the values specified in your CONFIG.SYS file. 
  4454.  
  4455.  
  4456. ΓòÉΓòÉΓòÉ 8.4.1. Compiling Help Files ΓòÉΓòÉΓòÉ
  4457.  
  4458. To compile a source file that is intended as a help-text window, use the IPFC 
  4459. command without the -i switch or /INF option. For example: 
  4460.  
  4461. IPFC myhelp.txt
  4462.  
  4463.  
  4464. ΓòÉΓòÉΓòÉ 8.4.2. Environment Variables ΓòÉΓòÉΓòÉ
  4465.  
  4466. There are four environment variables that can be used to specify the location 
  4467. of source files. The IPFC environment variable is used to specify where the IPF 
  4468. support files (such as the *.NLS files) are stored. The IPFCIMBED environment 
  4469. variable is used to search for files imbedded with the .im macro.  The 
  4470. IPFCARTWORK environment variable is used to specify the location of artwork 
  4471. files and artlink files.  The TMP environment variable is used to indicate 
  4472. where the compiler should store the intermediate files it creates during the 
  4473. compilation. 
  4474.  
  4475. The IPFC environment variable has been enhanced to allow multiple paths. 
  4476.  
  4477. Note:  IPFCARTWORK=artwork and linkfile path (used for :artwork.) 
  4478.        IPFCIMBED=imbed file path (used for .im) 
  4479.        IPFC=IPFC file path (location of APSYxxxx.APS, IPF*.NLS) 
  4480.        TMP=temporary file path 
  4481.  
  4482.  
  4483. ΓòÉΓòÉΓòÉ 8.5. Viewing an Online Document ΓòÉΓòÉΓòÉ
  4484.  
  4485. If you want to see your formatted online document, you can use the VIEW command 
  4486. to display it. 
  4487.  
  4488. An online document has an extension of INF.  It can be viewed by entering its 
  4489. name as a parameter to the VIEW command; for example: 
  4490.  
  4491. VIEW myfile
  4492.  
  4493. You do not need to include the INF file extension. 
  4494.  
  4495. You cannot use VIEW to display help-text windows for application programs. 
  4496.  
  4497.  
  4498. ΓòÉΓòÉΓòÉ 8.6. Where IPFC Files are Stored ΓòÉΓòÉΓòÉ
  4499.  
  4500. When you first install the Toolkit, the following environment variable is 
  4501. placed into the CONFIG.SYS file: 
  4502.  
  4503. IPFC=C:\TOOLKIT\IPFC
  4504.  
  4505. The IPFC environment variable identifies the directory in which data files 
  4506. needed by the IPF compiler are stored. 
  4507.  
  4508. When you first install the system, the following environment variables are 
  4509. placed into the CONFIG.SYS file: 
  4510.  
  4511. The HELP environment variable identifies the location of .HLP libraries. 
  4512.  
  4513. Help=C:\OS2\HELP
  4514.  
  4515. The BOOKSHELF environment variable identifies the location of online documents 
  4516. and is used by VIEW. 
  4517.  
  4518. BOOKSHELF=C:\OS2\BOOK
  4519.  
  4520.  
  4521. ΓòÉΓòÉΓòÉ 8.7. Concatenating .INF Files ΓòÉΓòÉΓòÉ
  4522.  
  4523. Concatenation of .INF files is useful when you have a large amount of 
  4524. information that cannot be compiled as one file that fits on a diskette. If you 
  4525. want to concatenate files, you must use the res= attribute for window 
  4526. identifiers. 
  4527.  
  4528. After you have created your .INF files, use the SET command to set an 
  4529. environment variable equal to a string that consists of the .INF file names, 
  4530. for example: 
  4531.  
  4532. SET PROGREF=PRINTRO.INF+PRCP.INF+PRWIN.INF+PRDATA.INF
  4533.  
  4534. When you specify the environment value as a parameter to the VIEW program, VIEW 
  4535. displays the online information. Headings from the different files are 
  4536. displayed in the contents window in the order the files are concatenated for 
  4537. the environment variable. 
  4538.  
  4539.  
  4540. ΓòÉΓòÉΓòÉ 8.8. Interpreting IPFC Error Messages ΓòÉΓòÉΓòÉ
  4541.  
  4542. The -W:n or /Wn option of the IPFC command determines the levels of error 
  4543. messages that will be displayed. Following are the values that you can specify 
  4544. for n: 
  4545.  
  4546.  Value   Meaning 
  4547.  
  4548.  1       Returns only warning level 1 messages.  Warning level 1 messages are 
  4549.          the most severe. 
  4550.  
  4551.  2       Returns warning level 1 and 2 messages. 
  4552.  
  4553.  3       Returns all three warning levels of messages.  This is the default. 
  4554.          Warning level 3 messages are the least severe. 
  4555.  
  4556.  When IPF compiles your file, it generates and displays the error messages.  If 
  4557.  no errors are found, IPF tells you that compiling has been completed and no 
  4558.  errors were found. 
  4559.  
  4560.  You may prefer to redirect error messages from the screen to an error file. 
  4561.  You could enter the IPFC command like this: 
  4562.  
  4563.   IPFC myhelp -w:3 > myhelp.err
  4564.  
  4565.  If you have also requested that a cross-reference list be created by 
  4566.  specifying the -X switch, it will be included in the MYHELP.ERR file. 
  4567.  
  4568.  For a list of error messages that the IPF compiler returns, see Compiler Error 
  4569.  Messages. 
  4570.  
  4571.  
  4572. ΓòÉΓòÉΓòÉ 8.9. Differences between .HLP and .INF Files ΓòÉΓòÉΓòÉ
  4573.  
  4574. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4575. Γöé                    ΓöéHelp Libraries                ΓöéOnline Documents    Γöé
  4576. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4577. ΓöéIPFC Command Syntax ΓöéIPFC filename                 ΓöéIPFC filename.INF -iΓöé
  4578. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4579. ΓöéCompiled File       Γöé.HLP                          Γöé.INF                Γöé
  4580. ΓöéExtensions          Γöé                              Γöé                    Γöé
  4581. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4582. ΓöéEnvironment         Γöé                              ΓöéBOOKSHELF= defines  Γöé
  4583. ΓöéVariables Used by   Γöé                              Γöéthe location of .INFΓöé
  4584. Γöéthe VIEW Program    Γöé                              Γöéfiles               Γöé
  4585. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4586. ΓöéEnvironment         ΓöéHELP= defines the location of Γöé                    Γöé
  4587. ΓöéVariables Used by   Γöé.HLP libraries.               Γöé                    Γöé
  4588. ΓöéHelp Manager for    Γöé                              Γöé                    Γöé
  4589. ΓöéHelp Windows        Γöé                              Γöé                    Γöé
  4590. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4591. ΓöéCause of Interface  ΓöéAn application user's request ΓöéEntering the file   Γöé
  4592. ΓöéDisplay             Γöéfor help.                     Γöéname as a parameter Γöé
  4593. Γöé                    Γöé                              Γöéto the VIEW utility.Γöé
  4594. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4595. ΓöéInitial Size of MainΓöé35% of screen (default)       Γöé85% of screen       Γöé
  4596. ΓöéWindow              Γöé                              Γöé(default)           Γöé
  4597. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4598. ΓöéInitial Contents of ΓöéResponse to help request      ΓöéContents window     Γöé
  4599. ΓöéMain Window         Γöé                              Γöé(default)           Γöé
  4600. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4601. ΓöéMain Window Title   ΓöéDefined by the programmer in  ΓöéDefined by the      Γöé
  4602. Γöé                    Γöéthe HELPINIT structure.       Γöé:title. tag, which  Γöé
  4603. Γöé                    Γöé                              Γöéis placed on the    Γöé
  4604. Γöé                    Γöé                              Γöéline following the  Γöé
  4605. Γöé                    Γöé                              Γöé:userdoc. tag.      Γöé
  4606. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4607. ΓöéExternal Links (see Γöé.HLP files can link to other  Γöé.INF files can link Γöé
  4608. Γöéglobal attribute of Γöé.HLP files and to .INF files  Γöéonly to other .INF  Γöé
  4609. Γöéheading tag and     Γöéby launching VIEW.            Γöéfiles.              Γöé
  4610. Γöédatabase attribute  Γöé                              Γöé                    Γöé
  4611. Γöéof :link. tag.)     Γöé                              Γöé                    Γöé
  4612. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4613. ΓöéTo View ConcatenatedΓöéSpecify a string of .HLP filesΓöéSet an environment  Γöé
  4614. ΓöéFiles               Γöéin the HELPINIT structure or  Γöévariable equal to a Γöé
  4615. Γöé                    Γöésend the                      Γöéstring of .INF file Γöé
  4616. Γöé                    ΓöéHM_SET_HELP_LIBRARY_NAMES     Γöénames.              Γöé
  4617. Γöé                    Γöémessage.                      Γöé                    Γöé
  4618. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4619.  
  4620. Note:  Defaults may be overridden by objects that are displayed in 
  4621.        application-controlled windows. 
  4622.  
  4623.  
  4624. ΓòÉΓòÉΓòÉ 8.10. National Language Support (NLS) ΓòÉΓòÉΓòÉ
  4625.  
  4626. The following parameters provide national language support (NLS). These 
  4627. parameters were updated between Version 2.1 and 3.0 of OS/2. All of the 
  4628. parameters shown in the following table are supported in the current IPF 
  4629. compiler. 
  4630.  
  4631. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4632. Γöéup to Version 2.1        ΓöéVersion 3.0 and higher                            Γöé
  4633. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4634. Γöé/COUNTRY = nnn           Γöé-d: nnn (nnn = a numeric value)                   Γöé
  4635. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4636. Γöé/CODEPAGE = nnnn         Γöé-c: nnnn (nnnn = a numeric value)                 Γöé
  4637. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4638. Γöé/LANGUAGE = xxx          Γöé-l: xxx (xxx = alphabetic letters)                Γöé
  4639. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4640.  
  4641. If you do not specify these parameters, the default for /COUNTRY or -d: nnn and 
  4642. /CODEPAGE or -c: nnnn are the values specified in your CONFIG.SYS file. 
  4643.  
  4644. Refer to the "Information Presentation Facility" chapter in the OS/2 
  4645. Bidirectional Language Support Developer's Guide and Reference. 
  4646.  
  4647.  
  4648. ΓòÉΓòÉΓòÉ 8.10.1. Country Code, Code Pages, and Language Parameters ΓòÉΓòÉΓòÉ
  4649.  
  4650. The following table lists the 3-digit country code for the /COUNTRY or -d: nnn 
  4651. parameter, the numeric identifiers of code pages, and the APS filename of the 
  4652. IPFC command supported. 
  4653.  
  4654. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4655. ΓöéCountry               ΓöéCountry CodeΓöéCode Pages        ΓöéAPS File          Γöé
  4656. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4657. ΓöéArabic                Γöé785         Γöé0864              ΓöéAPSY0864.APS      Γöé
  4658. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4659. ΓöéAustralia             Γöé061         Γöé0437, 0850        ΓöéAPSYMBOL.APS      Γöé
  4660. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4661. ΓöéBelgium               Γöé032         Γöé0437, 0850        ΓöéAPSYMBOL.APS      Γöé
  4662. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4663. ΓöéBrazil                Γöé055         Γöé0850, 0437        ΓöéAPSYMBOL.APS      Γöé
  4664. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4665. ΓöéBulgaria              Γöé359         Γöé0915              ΓöéAPSY0915.APS      Γöé
  4666. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4667. ΓöéCanadian English      Γöé001         Γöé0437, 0850        ΓöéAPSYMBOL.APS      Γöé
  4668. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4669. ΓöéCanadian French       Γöé002         Γöé0863, 0850        ΓöéAPSYMBOL.APS      Γöé
  4670. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4671. ΓöéCatalan               Γöé034         Γöé0850, 0437        ΓöéAPSYMBOL.APS      Γöé
  4672. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4673. ΓöéChinese (Simplified)  Γöé086         Γöé1381              ΓöéAPSY1381.APS      Γöé
  4674. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4675. ΓöéChinese (Simplified)  Γöé086         Γöé1386              ΓöéAPSY1386.APS      Γöé
  4676. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4677. ΓöéChinese (Traditional) Γöé088         Γöé0950              ΓöéAPSY0950.APS      Γöé
  4678. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4679. ΓöéCzech                 Γöé421         Γöé0852              ΓöéAPSY0852.APS      Γöé
  4680. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4681. ΓöéDenmark               Γöé045         Γöé0865, 0850        ΓöéAPSYMBOL.APS      Γöé
  4682. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4683. ΓöéFinland               Γöé358         Γöé0437, 0850        ΓöéAPSYMBOL.APS      Γöé
  4684. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4685. ΓöéFrance                Γöé033         Γöé0437, 0850        ΓöéAPSYMBOL.APS      Γöé
  4686. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4687. ΓöéGermany               Γöé049         Γöé0437, 0850        ΓöéAPSYMBOL.APS      Γöé
  4688. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4689. ΓöéGreece                Γöé030         Γöé0869              ΓöéAPSY0869.APS      Γöé
  4690. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4691. ΓöéGreece                Γöé030         Γöé0813              ΓöéAPSY0813.APS      Γöé
  4692. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4693. ΓöéHebrew                Γöé972         Γöé0862              ΓöéAPSY0862.APS      Γöé
  4694. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4695. ΓöéHungary               Γöé036         Γöé0852              ΓöéAPSY0852.APS      Γöé
  4696. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4697. ΓöéItaly                 Γöé039         Γöé0437, 0850        ΓöéAPSYMBOL.APS      Γöé
  4698. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4699. ΓöéJapan                 Γöé081         Γöé0932, 0437, 0850  ΓöéAPSY0932.APS      Γöé
  4700. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4701. ΓöéKorea                 Γöé082         Γöé0949, 0934        ΓöéAPSY0949.APS      Γöé
  4702. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4703. ΓöéLatin America         Γöé003         Γöé0437, 0850        ΓöéAPSYMBOL.APS      Γöé
  4704. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4705. ΓöéLithuania             Γöé370         Γöé0921              ΓöéAPSY0921.APS      Γöé
  4706. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4707. ΓöéNetherlands           Γöé031         Γöé0437, 0850        ΓöéAPSYMBOL.APS      Γöé
  4708. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4709. ΓöéNorway                Γöé047         Γöé0865, 0850        ΓöéAPSYMBOL.APS      Γöé
  4710. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4711. ΓöéPoland                Γöé048         Γöé0852              ΓöéAPSY0852.APS      Γöé
  4712. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4713. ΓöéPortugal              Γöé351         Γöé0860, 0850        ΓöéAPSYMBOL.APS      Γöé
  4714. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4715. ΓöéRussia                Γöé007         Γöé0866              ΓöéAPSY0866.APS      Γöé
  4716. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4717. ΓöéSlovenia              Γöé386         Γöé0852              ΓöéAPSY0852.APS      Γöé
  4718. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4719. ΓöéSpain                 Γöé034         Γöé0437, 0850        ΓöéAPSYMBOL.APS      Γöé
  4720. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4721. ΓöéSweden                Γöé046         Γöé0437, 0850        ΓöéAPSYMBOL.APS      Γöé
  4722. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4723. ΓöéSwitzerland           Γöé041         Γöé0437, 0850        ΓöéAPSYMBOL.APS      Γöé
  4724. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4725. ΓöéThailand              Γöé066         Γöé0874              ΓöéAPSY0874.APS      Γöé
  4726. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4727. ΓöéTurkey                Γöé090         Γöé0857              ΓöéAPSY0857.APS      Γöé
  4728. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4729. ΓöéUnited Kingdom        Γöé044         Γöé0437, 0850        ΓöéAPSYMBOL.APS      Γöé
  4730. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4731. ΓöéUnited States         Γöé001         Γöé0437, 0850        ΓöéAPSYMBOL.APS      Γöé
  4732. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4733.  
  4734. The following table lists the 3-letter identifier for the /LANGUAGE and -l: xxx 
  4735. parameter of the IPFC command: 
  4736.  
  4737. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4738. ΓöéID        ΓöéLanguage                      ΓöéNLS File                      Γöé
  4739. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4740. ΓöéARA       ΓöéArabic                        ΓöéIPFARA.NLS                    Γöé
  4741. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4742. ΓöéBGR       ΓöéBulgarian                     ΓöéIPFBGR.NLS                    Γöé
  4743. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4744. ΓöéCAT       ΓöéCatalan                       ΓöéIPFCAT.NLS                    Γöé
  4745. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4746. ΓöéCHT       ΓöéChinese (Traditional)         ΓöéIPFCHT.NLS                    Γöé
  4747. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4748. ΓöéCZE       ΓöéCzech                         ΓöéIPFCZE.NLS                    Γöé
  4749. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4750. ΓöéDAN       ΓöéDanish                        ΓöéIPFDAN.NLS                    Γöé
  4751. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4752. ΓöéDEU       ΓöéGerman                        ΓöéIPFDEU.NLS                    Γöé
  4753. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4754. ΓöéELL       ΓöéGreek 813                     ΓöéIPFELL.NLS                    Γöé
  4755. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4756. ΓöéENG       ΓöéEnglish UP                    ΓöéIPFENG.NLS                    Γöé
  4757. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4758. ΓöéENU       ΓöéEnglish US                    ΓöéIPFENU.NLS                    Γöé
  4759. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4760. ΓöéESP       ΓöéSpanish                       ΓöéIPFESP.NLS                    Γöé
  4761. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4762. ΓöéFIN       ΓöéFinnish                       ΓöéIPFFIN.NLS                    Γöé
  4763. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4764. ΓöéFRA       ΓöéFrench                        ΓöéIPFFRA.NLS                    Γöé
  4765. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4766. ΓöéFRC       ΓöéCanadian French               ΓöéIPFFRC.NL                     Γöé
  4767. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4768. ΓöéGRK       ΓöéGreek 869                     ΓöéIPFGRK.NLS                    Γöé
  4769. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4770. ΓöéHEB       ΓöéHebrew                        ΓöéIPFHEB.NLS                    Γöé
  4771. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4772. ΓöéHUN       ΓöéHungarian                     ΓöéIPFHUN.NLS                    Γöé
  4773. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4774. ΓöéITA       ΓöéItalian                       ΓöéIPFITA.NLS                    Γöé
  4775. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4776. ΓöéJPN       ΓöéJapanese                      ΓöéIPFJPN.NLS                    Γöé
  4777. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4778. ΓöéKOR       ΓöéKorean                        ΓöéIPFKOR.NLS                    Γöé
  4779. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4780. ΓöéLTU       ΓöéLithuanian                    ΓöéIPFLTU.NLS                    Γöé
  4781. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4782. ΓöéNLD       ΓöéDutch                         ΓöéIPFNLD.NLS                    Γöé
  4783. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4784. ΓöéNOR       ΓöéNorwegian                     ΓöéIPFNOR.NLS                    Γöé
  4785. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4786. ΓöéPOL       ΓöéPolish                        ΓöéIPFPOL.NLS                    Γöé
  4787. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4788. ΓöéPRC       ΓöéChinese (Simplified) 1381     ΓöéIPFPRC.NLS                    Γöé
  4789. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4790. ΓöéPRC       ΓöéChinese (Simplified) 1386     ΓöéIPFGBK.NLS                    Γöé
  4791. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4792. ΓöéPTB       ΓöéBrazilian/Portuguese          ΓöéIPFPTB.NLS                    Γöé
  4793. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4794. ΓöéPTG       ΓöéPortuguese                    ΓöéIPFPTG.NLS                    Γöé
  4795. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4796. ΓöéRUS       ΓöéRussian                       ΓöéIPFRUS.NLS                    Γöé
  4797. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4798. ΓöéSLO       ΓöéSlovene                       ΓöéIPFSLO.NLS                    Γöé
  4799. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4800. ΓöéSVE       ΓöéSwedish                       ΓöéIPFSVE.NLS                    Γöé
  4801. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4802. ΓöéTHI       ΓöéThai                          ΓöéIPFTHI.NLS                    Γöé
  4803. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4804. ΓöéTRK       ΓöéTurkish                       ΓöéIPFTRK.NLS                    Γöé
  4805. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4806. ΓöéUND       ΓöéUser defined                  ΓöéIPFUND.NLS                    Γöé
  4807. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4808.  
  4809. Note:  If there is an APSYxxxx.APS file that matches the code page you are 
  4810.        using to compile your IPF file (either specified or default), the IPFC 
  4811.        will use that file. Otherwise, it will use APSYMBOL.APS file that is 
  4812.        suitable for code page 437 or 850. 
  4813.  
  4814.  
  4815. ΓòÉΓòÉΓòÉ 8.10.2. Creating New Code Pages ΓòÉΓòÉΓòÉ
  4816.  
  4817. The following information tells you how to create an APSYxxxx.APS file and add 
  4818. it to the IPFC directory which allows you to add support for new code pages 
  4819. that you create. 
  4820.  
  4821.  
  4822. ΓòÉΓòÉΓòÉ 8.10.2.1. Creating the Contents of a Code Page File ΓòÉΓòÉΓòÉ
  4823.  
  4824. You can specify a symbol and associate a character with that symbol in a code 
  4825. page file as follows: 
  4826.  
  4827.    1. In the first column, place a character that you want to substitute with 
  4828.       the symbol; for example, +. 
  4829.  
  4830.    2. Define a symbol with text placed between a character ampersand (&) and a 
  4831.       period (.); for example, &plus.. 
  4832.  
  4833.  Following are some examples for defining symbols: 
  4834.  
  4835.       *&asterisk. 
  4836.       .&period. 
  4837.       +&plus. 
  4838.       ,&comma. 
  4839.       -&dash. 
  4840.  Each line in a file must not contain more than one symbol - enter the next 
  4841.  symbol on a new line. 
  4842.  
  4843.  The symbol character must be in the first column of your file and its 
  4844.  associated symbol must start in the second column. 
  4845.  
  4846.  The text in the symbols you define are case sensitive; for example, :&colon. 
  4847.  and :&Colon. are two different symbols. The symbol defined for :&colon. cannot 
  4848.  be used as :&Colon.. If you attempt to use them as two symbols, the compiler 
  4849.  generates a warning message that a symbol is not found. 
  4850.  
  4851.  
  4852. ΓòÉΓòÉΓòÉ 8.10.2.2. Naming the Code Page File ΓòÉΓòÉΓòÉ
  4853.  
  4854. You name a new code page file APSYxxxx.APS where xxxx is a unique four-digit 
  4855. number. You can also use a four-digit number from the "Code Pages" column in 
  4856. the table "NLS Country, Code Page, and Language Parameters for IPF Compiler" 
  4857. for the country you want to use. You substitute your new code page for that 
  4858. code page. For example, to create a new code page for a language called 
  4859. Pidgeon, an appropriate APS filename could be APSY0222.APS or APSYMBOL.APS. 
  4860.  
  4861. Ensure that your APSYxxxx.APS file is located in the following directory: 
  4862.  
  4863. \TOOLKIT\IPFC
  4864.  
  4865.  
  4866. ΓòÉΓòÉΓòÉ 8.10.3. Creating Files for Adding New Languages ΓòÉΓòÉΓòÉ
  4867.  
  4868. You create an IPFxxx.NLS file when you want to add a new language to the 
  4869. compiler. 
  4870.  
  4871. Note:  Not all languages are supported - only use those that are similar to 
  4872.        those already supported by IPFC. 
  4873.  
  4874.  
  4875. ΓòÉΓòÉΓòÉ 8.10.3.1. Creating the Contents of a Language File ΓòÉΓòÉΓòÉ
  4876.  
  4877. You can specify the following attributes in an IPFxxx.NLS file as follows: 
  4878.  
  4879.  Attribute      Description 
  4880.  
  4881.  REM            Use this attribute to specify comments in an IPFxxx.NLS file. 
  4882.                 To enter multiple comments, specify REM on each new line 
  4883.                 followed by the text of the comment. For example: 
  4884.  
  4885.                                 REM This is a comment.
  4886.                                 REM This is another comment.
  4887.  
  4888.  NOTE           Use this attribute to translate the default text of the :note. 
  4889.                 tag. The text specified between the quotation marks is used 
  4890.                 instead of the default word Note. For example, to replace the 
  4891.                 default of Note: with Nota:, enter the following: 
  4892.  
  4893.                                 NOTE="Nota:"
  4894.  
  4895.  CAUTION        Use this attribute to translate the default text of the 
  4896.                 :caution. tag. The text specified between the quotation marks 
  4897.                 is used instead of the default word CAUTION. For example, to 
  4898.                 replace the default of CAUTION: with ATTENZIONE:, enter the 
  4899.                 following: 
  4900.  
  4901.                                 CAUTION="ATTENZIONE:"
  4902.  
  4903.  WARNING        Use this attribute to translate the default text of the 
  4904.                 :warning. tag. The text specified between the quotation marks 
  4905.                 is used instead of the default word Warning. For example, to 
  4906.                 replace the default of Warning: with Avvertenza:, enter the 
  4907.                 following: 
  4908.  
  4909.                                 WARNING="Avvertenza:"
  4910.  
  4911.  DANGER         Use this attribute to translate the default text of the 
  4912.                 :danger. tag. The text specified between the quotation marks is 
  4913.                 used instead of the default word Danger. For example, to 
  4914.                 replace the default of Danger: with Unsafe:, enter the 
  4915.                 following: 
  4916.  
  4917.                                 DANGER="Unsafe:"
  4918.  
  4919.  OLCHARS="single character or a string" Use this attribute to specify the 
  4920.                 ordered list characters you want to use for secondary list 
  4921.                 entries. For example, to use the US alphabetic characters, 
  4922.                 specify the following: 
  4923.  
  4924.                                 OLCHARS="abcdefghijklmnopqrstuvwxyz"
  4925.  
  4926.                 The result is: 
  4927.  
  4928.                                 1.  Entry one.
  4929.                                     a. Line 1 of the secondary entry
  4930.                                     b. Line 2 of the secondary entry
  4931.                                     .
  4932.                                     .
  4933.                                     .
  4934.  
  4935.                 OLCHARS="abcdefghijklmnopqrstuvwxyz" is the default value. 
  4936.  
  4937.  OLCLOSE1="single character or a string" Use this attribute to specify the 
  4938.                 character displayed after the number associated with each list 
  4939.                 item. For example, to use the character ")" after a number in 
  4940.                 the list entry, specify the following: 
  4941.  
  4942.                                 OLCLOSE1=")"
  4943.  
  4944.                 The result is: 
  4945.  
  4946.                                 1)  Entry one.
  4947.                                     a. Line 1 of the secondary entry
  4948.                                     b. Line 2 of the secondary entry
  4949.                                 2)  Entry two.
  4950.                                     .
  4951.                                     .
  4952.                                     .
  4953.  
  4954.                 OLCLOSE1=. is the default value. 
  4955.  
  4956.  OLCLOSE2="single character or a string" Use this attribute to specify the 
  4957.                 character displayed after the value associated with each 
  4958.                 secondary list item. For example, to use the character "-" 
  4959.                 after a number in the secondary list entry, specify the 
  4960.                 following: 
  4961.  
  4962.                                 OLCLOSE2="-"
  4963.  
  4964.                 The result is: 
  4965.  
  4966.                                 1)  Entry one.
  4967.                                     a- Line 1 of the secondary entry
  4968.                                     b- Line 2 of the secondary entry
  4969.                                 2)  Entry two.
  4970.                                     .
  4971.                                     .
  4972.                                     .
  4973.  
  4974.                 OLCLOSE2=. is the default value. 
  4975.  
  4976.  ULITEMID1="single character or a string" Use this attribute to specify the 
  4977.                 first level entries of an unordered list. For example, to use 
  4978.                 the character "-" for first level entries, specify the 
  4979.                 following: 
  4980.  
  4981.                                 ULITEMID1="-"
  4982.  
  4983.                 The result is: 
  4984.  
  4985.                                 - Line 1 of the first level
  4986.                                 - Line 2 of the first level
  4987.                                   .
  4988.                                   .
  4989.                                   .
  4990.                 ULITEMID1=ΓêÖ (Alt 249 in code page 437) is the default value. 
  4991.  
  4992.  ULITEMID2="single character or a string" Use this attribute to specify the 
  4993.                 secondary level entries of an unordered list. For example, to 
  4994.                 use the character "+" for secondary level entries, specify the 
  4995.                 following: 
  4996.  
  4997.                                 ULITEMID2="+"
  4998.  
  4999.                 The result is: 
  5000.  
  5001.                                 - Line 1 of the first level
  5002.                                     + Line 1 of the second level
  5003.                                     + Line 2 of the second level
  5004.                                 - Line 2 of the first level
  5005.                                   .
  5006.                                   .
  5007.                                   .
  5008.  
  5009.                 ULITEMID2=- is the default value. 
  5010.  
  5011.  ULITEMID3="single character or a string" Use this attribute to specify the 
  5012.                 third level entries of an unordered list. For example, to use 
  5013.                 the character "oo" for third level entries, specify the 
  5014.                 following: 
  5015.  
  5016.                                 ULITEMID3="oo"
  5017.  
  5018.                 The result is: 
  5019.  
  5020.                                 - Line 1 of the first level
  5021.                                     + Line 1 of the second level
  5022.                                        oo Line 1 of third level
  5023.                                        oo Line 2 of third level
  5024.                                   .
  5025.                                   .
  5026.                                   .
  5027.  
  5028.                 ULITEMID3=o is the default value. 
  5029.  
  5030.  GRAMMAR        Use this attribute to indicate the beginning of the grammar 
  5031.                 rules. 
  5032.  
  5033.  WORDS          Use this attribute to specify the set of characters that can 
  5034.                 make up a word. For example, to specify that a word can be made 
  5035.                 of alphanumeric characters, specify: 
  5036.  
  5037.                                 WORDS=0 - 9 + A - Z + a - z
  5038.  
  5039.                 WORDS=0 - 9 + A - Z + a - z is the default value for this 
  5040.                 attribute. 
  5041.  
  5042.  GRAPHCS        Use this attribute to specify the range of graphics characters 
  5043.                 that make up a graphic word. 
  5044.  
  5045.                 GRAPHICS="\x01 - \x1F + \x80 - \xFF" is the default value for 
  5046.                 this attribute. 
  5047.  
  5048.  EGRAMMAR       Use this attribute to indicate the end of the grammar rules. 
  5049.  
  5050.  
  5051. ΓòÉΓòÉΓòÉ 8.10.3.2. Naming the Language File ΓòÉΓòÉΓòÉ
  5052.  
  5053. You name a new language file IPFxxx.NLS where xxx is unique for the language 
  5054. you want to use. Name your new file with xxx as different letters than any of 
  5055. the three-letters used in the "ID" column in the table "The 3-Letter Identifier 
  5056. for the /LANGUAGE and -l: xxx Parameter". For example, to create a new language 
  5057. called Pidgeon, an appropriate NLS filename could be IPFPID.NLS. 
  5058.  
  5059. Ensure that your IPFxxx.NLS file is located in the following directory: 
  5060.  
  5061. \TOOLKIT\IPFC
  5062.  
  5063.  
  5064. ΓòÉΓòÉΓòÉ 9. IPF Tag Reference ΓòÉΓòÉΓòÉ
  5065.  
  5066. This section contains an alphabetic listing of the tags used by the IPF 
  5067. compiler to create online documents and help windows. An IPF tag controls the 
  5068. format of the displayed output. 
  5069.  
  5070. The syntax description of each tag includes the tag name, the element that the 
  5071. tag describes, the attributes of the tag, and the end tag. A tag begins with a 
  5072. colon (:) and ends with a period (.). Most tags have an end tag associated with 
  5073. them. An end tag has the same name as the tag, preceded by the letter "e."  For 
  5074. example, the end tag for the :userdoc. tag is the :euserdoc. tag. 
  5075.  
  5076. A tag can have one or more attributes associated with it. An attribute provides 
  5077. additional control information for the tag. Some attributes are followed by an 
  5078. equal sign and a value. If the value contains blanks or special characters, it 
  5079. must be enclosed in apostrophes or single quotation marks. For example: 
  5080.  
  5081. :font facename='Tms Rmn'.
  5082.  
  5083. Notice that the period that ends the tag follows the attributes specified for 
  5084. the tag. If no attributes are specified, the period immediately follows the tag 
  5085. name. For example, when the :note. tag does not have the text=' ' attribute 
  5086. specified, the period immediately follows the word :note.. 
  5087.  
  5088. Some tags are required to be in a specific order before the file can be 
  5089. compiled by the IPF compiler. The following example shows the minimum tags 
  5090. required to compile a file: 
  5091.  
  5092. :userdoc.
  5093. :h1 id=example1.Tag Example 1
  5094. :p.This is the first tag example.
  5095. :euserdoc.
  5096.  
  5097. This section also describes control words used by the IPF compiler.  Control 
  5098. words start with a period (.). A control word tells the IPF compiler about the 
  5099. statement that it is part of. For example, the imbed (.im) control word tells 
  5100. the IPF Compiler to include the specified file in the source file at this 
  5101. point. 
  5102.  
  5103.  
  5104. ΓòÉΓòÉΓòÉ 9.1. .br  (Break) ΓòÉΓòÉΓòÉ
  5105.  
  5106. Purpose 
  5107.  
  5108. Causes a break in a line of text. 
  5109.  
  5110. Syntax 
  5111.  
  5112. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5113. ΓöéControl Word   ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  5114. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5115. Γöé.br            ΓöéBreak          Γöé               Γöé               Γöé
  5116. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5117.  
  5118. Attributes 
  5119.  
  5120. None 
  5121.  
  5122. Description 
  5123.  
  5124. Use the .br control word to stop the display of text on a line, and continue it 
  5125. on the next line. The break control word must be the only statement on the 
  5126. line. If you enter text on the same line as the break control word, the IPF 
  5127. compiler ignores the break control word. 
  5128.  
  5129. The break control word is especially useful before a line of text that contains 
  5130. a symbol. 
  5131.  
  5132. Conditions 
  5133.  
  5134. The .br control word must start in column 1, and be the only statement on the 
  5135. line. 
  5136.  
  5137. Example 
  5138.  
  5139. :p.These words
  5140. appear on
  5141. the same line.
  5142. .br
  5143. These words
  5144. .br
  5145. do not.
  5146.  
  5147. Output 
  5148.  
  5149. These words appear on the same line.
  5150. These words
  5151. do not.
  5152.  
  5153. For more information, see Break. 
  5154.  
  5155.  
  5156. ΓòÉΓòÉΓòÉ 9.2. .ce (Center Text) ΓòÉΓòÉΓòÉ
  5157.  
  5158. Purpose 
  5159.  
  5160. Centers text. 
  5161.  
  5162. Syntax 
  5163.  
  5164. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5165. ΓöéControl Word   ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  5166. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5167. Γöé.ce            ΓöéText           Γöé               Γöé               Γöé
  5168. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5169.  
  5170. Attributes 
  5171.  
  5172. None 
  5173.  
  5174. Description 
  5175.  
  5176. The .ce control word allows you to center text on a line. 
  5177.  
  5178. Conditions 
  5179.  
  5180. The text cannot contain any IPF tags. It can, however, contain nameit symbols 
  5181. and IPFC symbols. 
  5182.  
  5183. The .ce control word's centering effect is limited to text on the same line 
  5184. with the control word. 
  5185.  
  5186. The line will remain centered as you resize the window unless the window 
  5187. becomes so small that the line must be broken, at which point centering 
  5188. justification is lost (when you resize the window to be large enough to hold 
  5189. the line again, centering is restored). 
  5190.  
  5191. The control word must start in column 1. 
  5192.  
  5193. Example 
  5194.  
  5195. .ce The centered text must not contain any IPF tags.
  5196.  
  5197. Output 
  5198.  
  5199. The centered text must not contain any IPF tags.
  5200.  
  5201.  
  5202. ΓòÉΓòÉΓòÉ 9.3. .* (Comment) ΓòÉΓòÉΓòÉ
  5203.  
  5204. Purpose 
  5205.  
  5206. Places a comment into a file. 
  5207.  
  5208. Syntax 
  5209.  
  5210. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5211. ΓöéControl Word   ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  5212. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5213. Γöé.*             ΓöéComment        Γöé               Γöé               Γöé
  5214. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5215.  
  5216. Attributes 
  5217.  
  5218. None 
  5219.  
  5220. Description 
  5221.  
  5222. The .* control word allows you to place a comment line into your file. The IPF 
  5223. compiler ignores any text on the same line as the comment control word, and 
  5224. does not display this text. 
  5225.  
  5226. The comment control word must be the first statement on the line of text that 
  5227. you do not want displayed. Each comment control word must begin on a new line. 
  5228.  
  5229. You can use comment control words to refer to items, to place notes into your 
  5230. file, or to prevent the display of an item. 
  5231.  
  5232. No space is required between the comment control word and the text that follows 
  5233. it. Comment control words are used independently of IPF tags. They are not used 
  5234. between any IPF tags or with any IPF tag and its accompanying text or 
  5235. attributes. 
  5236.  
  5237. Conditions 
  5238.  
  5239. Do not use the comment control word: 
  5240.  
  5241.      Within the IPF tag, that is, between the colon that starts the tag and 
  5242.       the period that ends the tag. 
  5243.  
  5244.      Between an IPF tag and its accompanying text or attributes. 
  5245.  
  5246.  Always start the comment control word in column 1. 
  5247.  
  5248.  Example 
  5249.  
  5250.   .* The comment control word must be the first statement on the line.
  5251.   .* When the source file is compiled, the text on the
  5252.   .* comment line is not displayed.
  5253.  
  5254.  Output 
  5255.  
  5256.  When the file is compiled, the comment control word and the information 
  5257.  following it on the comment line are not displayed. 
  5258.  
  5259.  
  5260. ΓòÉΓòÉΓòÉ 9.4. .im  (Imbed) ΓòÉΓòÉΓòÉ
  5261.  
  5262. Purpose 
  5263.  
  5264. Specifies that text files are to be included at process time. 
  5265.  
  5266. Syntax 
  5267.  
  5268. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5269. ΓöéControl Word   ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  5270. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5271. Γöé.im            ΓöéImbed          Γöé               Γöé               Γöé
  5272. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5273.  
  5274. Attributes 
  5275.  
  5276. None 
  5277.  
  5278. Description 
  5279.  
  5280. The .im control word enables you to include text files when you are ready to 
  5281. compile your file. 
  5282.  
  5283. Conditions 
  5284.  
  5285.      If the file to be included is not in the current directory, you must 
  5286.       enter a complete file name. 
  5287.  
  5288.      Imbedded files must not use the :userdoc. or :euserdoc. tag. 
  5289.  
  5290.  Always start the .im control word in column 1. 
  5291.  
  5292.  Example 
  5293.  
  5294.   :userdoc.
  5295.   .im filename.ext
  5296.   .im c:\main\filename.ext
  5297.   :euserdoc.
  5298.  
  5299.  Output 
  5300.  
  5301.  The text and art in the imbedded files are displayed when you access the 
  5302.  compiled file. 
  5303.  
  5304.  
  5305. ΓòÉΓòÉΓòÉ 9.5. .nameit (Nameit) ΓòÉΓòÉΓòÉ
  5306.  
  5307. Purpose 
  5308.  
  5309. Defines symbols in a document. 
  5310.  
  5311. Syntax 
  5312.  
  5313. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5314. ΓöéControl Word   ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  5315. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5316. Γöé.nameit        ΓöéNameit         Γöésymbol=        Γöé               Γöé
  5317. Γöé               Γöé               Γöétext='string'  Γöé               Γöé
  5318. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5319.  
  5320. Attributes 
  5321.  
  5322.  symbol=name 
  5323.     Identifies a name for the symbol you want to create. It can be up to 10 
  5324.     characters long (A-Z, 0-9), with no blanks or special characters; the first 
  5325.     character must be a letter. The & character cannot be used in the name. 
  5326.  
  5327.  text='string' 
  5328.     Identifies the content of the value to be assigned to the symbol and is 
  5329.     what is displayed. In addition to text, the text string can contain other 
  5330.     nameit symbols, IPFC symbols, and IPFC tags. 
  5331.  
  5332.  Description 
  5333.  
  5334.  The .nameit control word enables you to create symbols. 
  5335.  
  5336.  Conditions 
  5337.  
  5338.  Do not use the & character as part of the name of the symbol. You must use the 
  5339.  & character when you actually use the symbol. 
  5340.  
  5341.  Always start the nameit control word in column 1. 
  5342.  
  5343.  Example 
  5344.  
  5345.   .nameit symbol=os text='operating system'
  5346.   .
  5347.   .
  5348.   :p.The &os. supports multitasking.
  5349.  
  5350.  The output looks like this: 
  5351.  
  5352.   The operating system supports multitasking.
  5353.  
  5354.  
  5355. ΓòÉΓòÉΓòÉ 9.6. :acviewport. (Application-Controlled Window) ΓòÉΓòÉΓòÉ
  5356.  
  5357. Purpose 
  5358.  
  5359. Enables an application to dynamically control what is displayed in an IPF 
  5360. window. 
  5361.  
  5362. Syntax 
  5363.  
  5364. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5365. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  5366. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5367. Γöé:acviewport.   ΓöéHave IPF call aΓöédll=' '        Γöé               Γöé
  5368. Γöé               Γöéfunction in a  Γöéobjectname=' ' Γöé               Γöé
  5369. Γöé               Γöédynamic-link   Γöéobjectinfo=' ' Γöé               Γöé
  5370. Γöé               Γöémodule.        Γöéobjectid=' '   Γöé               Γöé
  5371. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5372. Γöé               ΓöéDefine the     Γöévpx=           Γöé               Γöé
  5373. Γöé               Γöéwindow in whichΓöévpy=           Γöé               Γöé
  5374. Γöé               Γöéthe function   Γöévpcx=          Γöé               Γöé
  5375. Γöé               Γöéruns.          Γöévpcy=          Γöé               Γöé
  5376. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5377.  
  5378. Attributes 
  5379.  
  5380.  dll=' ' 
  5381.     Specifies a dynamic-link module for IPF to load so that a communication 
  5382.     object (a function) in the module can be run in a window (an 
  5383.     application-controlled window). 
  5384.  
  5385.  objectname=' ' 
  5386.     Identifies the entry point of the communication object in the dynamic-link 
  5387.     module.  The value specified for this attribute is case sensitive. 
  5388.  
  5389.  objectinfo=' ' 
  5390.     Identifies parameters to be passed to the object. 
  5391.  
  5392.  objectid=' ' 
  5393.     Specifies an identifier that will associate the window with the object. The 
  5394.     application or communication object can get this value from the Object ID 
  5395.     field in the ACVP data structure and use it to determine the panel that 
  5396.     activated the viewport. 
  5397.  
  5398.   vpx=
  5399.   vpy=
  5400.   vpcx=
  5401.   vpcy=
  5402.     Define the location and size of the window. vpx= and vpy= are positions 
  5403.     along the x (horizontal) and y (vertical) axes.  The point where the values 
  5404.     intersect represents the origin of the window.  vpcx= and vpcy= represent 
  5405.     changes along the x and y axes with respect to the origin. 
  5406.  
  5407.     These attributes can be expressed as absolute values, relative values, or 
  5408.     dynamic values: 
  5409.  
  5410.     Absolute value: 
  5411.             A number followed by a letter, which indicates the unit of measure: 
  5412.  
  5413.             c           (Characters):  Average character width of the default 
  5414.                         system font. 
  5415.             x           (Pixels):  Dependent on the display adapter in use. 
  5416.             p           (Points):  Typesetting measure; equal to approximately 
  5417.                         1/72 inch. 
  5418.  
  5419.     Relative value: 
  5420.             A number followed by the percent sign (%), indicating a percentage 
  5421.             of the parent-window width or height. 
  5422.  
  5423.     Dynamic value: 
  5424.             A term indicating a window coordinate location that is dependent on 
  5425.             the current size and position of the parent window: 
  5426.  
  5427.             left | center | right 
  5428.                     For x values, flush left with, in the center of, or flush 
  5429.                     right with the parent window. 
  5430.             top | center | bottom 
  5431.                     For y values, at the top, center, or bottom of the parent 
  5432.                     window. 
  5433.  
  5434.  Description 
  5435.  
  5436.  :acviewport. is used in either a help file or an online document file to 
  5437.  specify that a window will be under the control of a routine that was written 
  5438.  and compiled as part of a dynamic-link module. When an IPF window is selected 
  5439.  for display at run time, and :acviewport. is encountered, IPF passes control 
  5440.  to the entry point (objectname=) in the dynamic-link module. At this point, 
  5441.  the routine in the module takes control. For more information, see Customizing 
  5442.  IPF with Communication Objects. 
  5443.  
  5444.  The definition for :acviewport. must follow a primary heading; for example: 
  5445.  
  5446.   :h2 res=2000
  5447.       x=left y=top width=100% height=100%
  5448.       scroll=none titlebar=both clear group=1.Information Windows
  5449.   :acviewport dll='My_DLL' objectname='My_Routine' objectid='1'
  5450.       vpx=right vpy=top vpcx=50% vpcy=100%
  5451.  
  5452.  In the example, a window is displayed within the primary window indicated by 
  5453.  the heading tag (:h2.) and its attributes. The contents of the window are 
  5454.  controlled by the communication object, My_Routine, in the dynamic-link 
  5455.  module, My_DLL. 
  5456.  
  5457.  When the user selects the primary window and :acviewport. tag is encountered, 
  5458.  IPF calls the communication object in the dynamic-link module and sizes the 
  5459.  child window. 
  5460.  
  5461.  
  5462. ΓòÉΓòÉΓòÉ 9.7. :artlink.  (Art Link) ΓòÉΓòÉΓòÉ
  5463.  
  5464. Purpose 
  5465.  
  5466. Identifies link definitions for hypergraphic areas of a bit map, metafiles are 
  5467. not supported. 
  5468.  
  5469. Syntax 
  5470.  
  5471. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5472. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  5473. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5474. Γöé:artlink.      Γöé               Γöé               Γöé:eartlink.     Γöé
  5475. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5476.  
  5477. Attributes 
  5478.  
  5479. None 
  5480.  
  5481. Description 
  5482.  
  5483. Use :artlink. in conjunction with the artwork tag (:artwork.) to indicate links 
  5484. to a bit map or segments of a bit map.  The link definitions are specified by 
  5485. link tags (:link.) and follow :artlink., as in Example 1. 
  5486.  
  5487. Example 1 
  5488.  
  5489. :artlink..
  5490. :link reftype=hd res=001 x=0 y=0 cx=16 cy=8.
  5491. :link reftype=fn refid=afnr x=16 y=8 cx=16 cy=8.
  5492. :link reftype=inform res=0345 x=0 y=8 cx=16 cy=8.
  5493. :eartlink.
  5494.  
  5495. (For more information, see :link.  (Link).) 
  5496.  
  5497. All of the above could be in a separate file, which would be identified by the 
  5498. linkfile. attribute of the artwork tag, as in Example 2. 
  5499.  
  5500. Example 2 
  5501.  
  5502. :artwork name='mybitmap.bmp' linkfile='mylinks'.
  5503.  
  5504. In this example, MYBITMAP.BMP is the name of the file containing the bit map, 
  5505. and MYLINKS is the file consisting of the entries shown in Example 1. 
  5506.  
  5507. If the artwork tag does not specify the attribute linkfile=, IPF looks for 
  5508. :artlink. on the line immediately following :artwork., as shown in Example 3. 
  5509.  
  5510. Example 3 
  5511.  
  5512. :artwork name='mybitmap.bmp'.
  5513. :artlink.
  5514. :link reftype=hd res=001.
  5515. :eartlink.
  5516.  
  5517. In this example, if the user clicks on the bit map associated with this art 
  5518. link, the window with the identifier, 001 is displayed. 
  5519.  
  5520. If no :artlink. tag is found, no hypergraphic areas for the bit map are 
  5521. defined. 
  5522.  
  5523. You can divide a bit map into rectangular segments, each of which is selectable 
  5524. and links to different information. For each segment, you need to define values 
  5525. for x, y, cx, and cy, which represent pixel values on the x and y axes. The x 
  5526. axis is always horizontal, and the y axis is always vertical; x and y define 
  5527. the origin of the segment, while cx and cy identify the changes in x and y. The 
  5528. value 0,0 indicates the origin of the bit map and is always the bottom-left 
  5529. corner. 
  5530.  
  5531. Following is an example of a segmented bit map. 
  5532.  
  5533.     0,16                                32,16
  5534.     | ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5535.     | Γöé                Γöé                  Γöé
  5536.     | Γöé                Γöé                  Γöé
  5537.     y Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5538.     | Γöé                Γöé                  Γöé
  5539.     | Γöé                Γöé                  Γöé
  5540.     | ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5541.      0,0  --------------x--------------- 32,0
  5542.  
  5543. Example 4 shows the tagging when the link is from a segmented bit map. The name 
  5544. of the segmented bit-map file is show2.bmp; the name of the file with the link 
  5545. information is link.dat. 
  5546.  
  5547. Example 4 
  5548.  
  5549. :artwork name='show2.bmp' linkfile='link.dat'.
  5550.  
  5551. The following information could be placed into LINK.DAT. 
  5552.  
  5553. :artlink.
  5554. :link reftype=hd res=001 x=0 y=0 cx=16 cy=8.
  5555. :link reftype=fn refid=afnr x=16 y=8 cx=16 cy=8.
  5556. :link reftype=inform res=0345 x=0 y=8 cx=16 cy=8.
  5557. :link reftype=launch object='c:\os2\e.exe'
  5558.         data='c:\appsdir\tutor.dat' x=16 y=0 cx=16 cy=8.
  5559. :eartlink.
  5560.  
  5561.  
  5562. ΓòÉΓòÉΓòÉ 9.8. :artwork. (Artwork) ΓòÉΓòÉΓòÉ
  5563.  
  5564. Purpose 
  5565.  
  5566. Identifies a bit map to be placed into the user's file. 
  5567.  
  5568. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5569. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  5570. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5571. Γöé:artwork.      ΓöéArtwork        Γöéname=' '       Γöé               Γöé
  5572. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5573. Γöé               Γöé               Γöéalign=         Γöé               Γöé
  5574. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5575. Γöé               Γöé               Γöélinkfile=' '   Γöé               Γöé
  5576. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5577. Γöé               Γöé               Γöérunin          Γöé               Γöé
  5578. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5579. Γöé               Γöé               Γöéfit            Γöé               Γöé
  5580. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5581.  
  5582. Attributes 
  5583.  
  5584.  name='filename.ext' 
  5585.     Identifies the file containing the bit map (artwork). This attribute is 
  5586.     required and must specify a complete file name. 
  5587.  
  5588.  align=leftΓöérightΓöécenter 
  5589.     Specifies how the artwork is to align with the current margins. It can be 
  5590.     to the left, to the right, or centered. 
  5591.  
  5592.  linkfile='filename.ext' 
  5593.     Identifies the file with the link definitions. This file begins with 
  5594.     :artlink. and ends with :eartlink.. The linkfile= attribute enables you to 
  5595.     link from whole or segmented bit maps. It can be omitted if the artwork 
  5596.     file does not require links, or if the links are enclosed by :artlink. and 
  5597.     :eartlink. immediately following the artwork tag. 
  5598.  
  5599.  runin 
  5600.     Specifies that the artwork is to be placed within the line of text.  You 
  5601.     enter :artwork. and its attributes in the line of text where you want the 
  5602.     artwork to appear. 
  5603.  
  5604.  fit 
  5605.     Causes the artwork to fill the window in which it is displayed. If the user 
  5606.     resizes the window, IPF redisplays the graphic so that it fits the new 
  5607.     window size. 
  5608.  
  5609.     When the initial size of the window is specified, the ratio between its 
  5610.     width and height should be approximately the same as that of the graphic; 
  5611.     otherwise, the artwork may appear distorted. 
  5612.  
  5613.     The fit attribute is most often used when artwork is to be displayed in a 
  5614.     split window, where one window contains a bit map, and another contains 
  5615.     text that is displayed beside the graphic. 
  5616.  
  5617.     If the artwork tag has fit, and you include text in the same window, the 
  5618.     text will be displayed briefly, but will then be covered by the painting of 
  5619.     the bit map in the window. 
  5620.  
  5621.  Description 
  5622.  
  5623.  Use :artwork. to include bit maps such as vectors and scanned images, in the 
  5624.  text file. The artwork tag and its attributes enable you to merge whole or 
  5625.  segmented bit maps and position them in the window. A bit map can be created 
  5626.  by an application or by a bit-map editing tool, such as the Presentation 
  5627.  Manager Icon Editor. A metafile can be created using a GPI function. 
  5628.  
  5629.  Conditions 
  5630.  
  5631.      If a path name is not specified for either name= or linkfile=, IPF looks 
  5632.       for the file in the current directory. 
  5633.  
  5634.      If linkfile= is not specified, IPF looks for the artlink tag on the line 
  5635.       immediately following the artwork tag. 
  5636.  
  5637.      The artwork tag requires the name= attribute. 
  5638.  
  5639.  Example 1 
  5640.  
  5641.  This example shows how to include artwork that does not require a hypergraphic 
  5642.  link.  The artwork is to be placed within the line of text that contains the 
  5643.  artwork tag. 
  5644.  
  5645.   Click on the :artwork name='gopi.art' runin. symbol to close the file.
  5646.  
  5647.  Example 2 
  5648.  
  5649.  This example shows how to include artwork that fills the window in which it is 
  5650.  displayed. 
  5651.  
  5652.   :artwork name='c:\main\world.bmp' fit.
  5653.  
  5654.  
  5655. ΓòÉΓòÉΓòÉ 9.9. :caution.  (Caution) ΓòÉΓòÉΓòÉ
  5656.  
  5657. Purpose 
  5658.  
  5659. Alerts the user to a risk. 
  5660.  
  5661. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5662. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  5663. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5664. Γöé:caution.      ΓöéCaution        Γöétext=' '       Γöé:ecaution.     Γöé
  5665. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5666.  
  5667. Attributes 
  5668.  
  5669.  text=' ' 
  5670.     Enables you to change CAUTION to different text. 
  5671.  
  5672.  Description 
  5673.  
  5674.  A caution message notifies the user of possible risks.  It should precede the 
  5675.  text to which it pertains so the user will see it first. 
  5676.  
  5677.  When :caution. is encountered, CAUTION appears on the screen, and the caution 
  5678.  text is displayed on the next line.  A blank line is inserted before the 
  5679.  caution message. 
  5680.  
  5681.  Conditions 
  5682.  
  5683.  None 
  5684.  
  5685.  Example 1 
  5686.  
  5687.   :caution.
  5688.   These berries are wild.  Do not eat.
  5689.   :ecaution.
  5690.  
  5691.  Output 
  5692.  
  5693.   CAUTION:
  5694.   These berries are wild.  Do not eat.
  5695.  
  5696.  Example 2 
  5697.  
  5698.   :caution text='Wild Berries:'.
  5699.   These berries are wild.  Do not eat.
  5700.   :ecaution.
  5701.  
  5702.  Output 
  5703.  
  5704.   Wild Berries:
  5705.   These berries are wild.  Do not eat.
  5706.  
  5707.  
  5708. ΓòÉΓòÉΓòÉ 9.10. :cgraphic. (Character Graphic) ΓòÉΓòÉΓòÉ
  5709.  
  5710. Purpose 
  5711. Defines a character graphic. 
  5712.  
  5713. Syntax 
  5714.  
  5715. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5716. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  5717. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5718. Γöé:cgraphic.     ΓöéCharacter      Γöé               Γöé:ecgraphic.    Γöé
  5719. Γöé               Γöégraphic        Γöé               Γöé               Γöé
  5720. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5721.  
  5722. Attributes 
  5723.  
  5724. None 
  5725.  
  5726. Description 
  5727.  
  5728. Character graphics are those you create with an ASCII editor. The :cgraphic. 
  5729. tag indicates that a character graphic is to follow. Everything after the tag 
  5730. and before :ecgraphic. will be in a monospace font. A blank line is inserted 
  5731. before and after the graphic. 
  5732.  
  5733. Conditions 
  5734. Text that does not fit in the display area of a window is clipped. 
  5735.  
  5736. Example 
  5737.  
  5738. :cgraphic.
  5739. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÉ       ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5740. Γöé     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉΓö£Γö¼Γöñ       Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ           Γöé
  5741. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÉ ΓöéΓöéΓöéΓö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÉ    Γöé           Γöé
  5742. Γöé     Γöé    Γöé ΓööΓöÿΓöéΓöé         Γöé    ΓööΓöÇΓöÇ One ΓöÇΓöÇΓöÇΓöÇΓöñ
  5743. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓö┤Γöÿ         ΓööΓöÇΓöÇΓöÇΓöÇ :hp4.Two:ehp4. ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5744. :ecgraphic.
  5745.  
  5746. Output 
  5747.  
  5748. The following output is provided. 
  5749.  
  5750. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÉ       ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5751. Γöé     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉΓö£Γö¼Γöñ       Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ           Γöé
  5752. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÉ ΓöéΓöéΓöéΓö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÉ    Γöé           Γöé
  5753. Γöé     Γöé    Γöé ΓööΓöÿΓöéΓöé         Γöé    ΓööΓöÇΓöÇ One ΓöÇΓöÇΓöÇΓöÇΓöñ
  5754. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓö┤Γöÿ         ΓööΓöÇΓöÇΓöÇΓöÇ Two ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5755.  
  5756.  
  5757. ΓòÉΓòÉΓòÉ 9.11. :color.  (Color) ΓòÉΓòÉΓòÉ
  5758.  
  5759. Purpose 
  5760.  
  5761. Changes the colors of the text and text background. 
  5762.  
  5763. Syntax 
  5764.  
  5765. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5766. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  5767. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5768. Γöé:color.        ΓöéColor          Γöéfc=            Γöé               Γöé
  5769. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5770. Γöé               Γöé               Γöébc=            Γöé               Γöé
  5771. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5772.  
  5773. Attributes 
  5774.  
  5775.  fc= 
  5776.     Enables you to change the color of the text. Text following this attribute 
  5777.     appears in the color specified. The values that can be specified are: 
  5778.          default 
  5779.          black 
  5780.          blue 
  5781.          red 
  5782.          pink 
  5783.          green 
  5784.          cyan 
  5785.          yellow 
  5786.          neutral 
  5787.          brown 
  5788.          darkgray 
  5789.          darkblue 
  5790.          darkred 
  5791.          darkpink 
  5792.          darkgreen 
  5793.          darkcyan 
  5794.          palegray 
  5795.  
  5796.  
  5797.  bc= 
  5798.     Enables you to change the background color of the text.  The screen colors 
  5799.     remain the same. The values that can be specified are the same as those for 
  5800.     fc=. 
  5801.  
  5802.  Description 
  5803.  
  5804.  :color. and its attributes enable you to change the color of the text and the 
  5805.  color of the text background. Colors set with this tag remain in effect until 
  5806.  another color is specified or a heading definition is encountered. 
  5807.  
  5808.  To return to the system colors, use fc=default and bc=default. 
  5809.  
  5810.  Conditions 
  5811.  
  5812.  None 
  5813.  
  5814.  Example 
  5815.  
  5816.   :sl.
  5817.   :color fc=green bc=blue.
  5818.   :li.Color the foreground green; color the background blue.
  5819.   .*
  5820.   :color fc=blue bc=red.
  5821.   :li.Color the foreground blue; color the background red.
  5822.   .*
  5823.   :color fc=cyan bc=yellow.
  5824.   :li.Color the foreground cyan; color the background yellow.
  5825.   .*
  5826.   :color fc=default bc=default.
  5827.   :li.Return to the system colors.
  5828.   :esl.
  5829.  
  5830.  Output 
  5831.  
  5832.       Color the foreground green; color the background blue. 
  5833.  
  5834.       Color the foreground blue; color the background red. 
  5835.  
  5836.       Color the foreground cyan; color the background yellow. 
  5837.  
  5838.       Return to the system colors. 
  5839.  
  5840.  
  5841. ΓòÉΓòÉΓòÉ 9.12. :ctrl.  (Control Area) ΓòÉΓòÉΓòÉ
  5842.  
  5843. Purpose 
  5844.  
  5845. Defines the contents of the control area. 
  5846.  
  5847. Syntax 
  5848.  
  5849. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5850. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  5851. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5852. Γöé:ctrl          ΓöéControl area   Γöéctrlid=        Γöé               Γöé
  5853. Γöé               Γöé               Γöécontrols=' '   Γöé               Γöé
  5854. Γöé               Γöé               Γöépage           Γöé               Γöé
  5855. Γöé               Γöé               Γöécoverpage      Γöé               Γöé
  5856. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5857.  
  5858. Attributes 
  5859.  
  5860.  ctrlid= 
  5861.     Specifies the identification value for the control area.  The 
  5862.     identification value can be either alpha or alphanumeric, and is referenced 
  5863.     by the heading tag. 
  5864.  
  5865.  controls=' ' 
  5866.     Specifies the identification values of the push buttons that you want 
  5867.     included in the control area of a window.  Push buttons are displayed in 
  5868.     the order in which they are defined. The values that can be specified are: 
  5869.  
  5870.     Search              Specifies the Search push button.  This push button 
  5871.                         displays a window that lets the user search for a word 
  5872.                         or phrase. 
  5873.  
  5874.     Print               Specifies the Print push button.  This push button 
  5875.                         displays a window that lets the user print one or more 
  5876.                         topics. 
  5877.  
  5878.     Index               Specifies the Index push button.  This push button 
  5879.                         displays an alphabetic list to the topics in the 
  5880.                         document. 
  5881.  
  5882.     Contents            Specifies the Contents push button.  This push button 
  5883.                         displays the Contents window. 
  5884.  
  5885.     Esc                 Specifies the Previous push button.  This push button 
  5886.                         lets the user see information from an earlier request. 
  5887.  
  5888.     Back                Specifies the Back push button.  This push button 
  5889.                         displays the previous page in the table of contents 
  5890.                         hierarchy. 
  5891.  
  5892.     Forward             Specifies the Forward push button.  This push button 
  5893.                         displays the next page in the table of contents 
  5894.                         hierarchy. 
  5895.  
  5896.     Note:  An identification value for the Tutorial push button is not provided 
  5897.            because it is displayed automatically if a tutorial exists. 
  5898.  
  5899.     If you are defining your own push buttons, use id= attribute of the push 
  5900.     button tag (:pbutton.). See :pbutton. (Push Button). 
  5901.  
  5902.     The identification values for the predefined push buttons are defined in 
  5903.     the PMHELP.H file. 
  5904.  
  5905.  page 
  5906.     Specifies that a set of push buttons is displayed in the control area of an 
  5907.     IPF text window . You can use this attribute to override the default set of 
  5908.     push buttons that is displayed in the control area of an IPF text window. 
  5909.  
  5910.  coverpage 
  5911.     Specifies the set of push buttons that is displayed in the control area of 
  5912.     the coverpage window . The control area in the coverpage window is at the 
  5913.     very bottom of a window.  You can use this attribute to override the 
  5914.     default set of push buttons that is displayed in the coverpage window. 
  5915.  
  5916.  Example:  The following tagging specifies the Previous, Forward, and Back push 
  5917.  buttons display in the coverpage window: 
  5918.  
  5919.   :ctrl ctrlid=new1 controls='ESC FORWARD BACK' coverpage.
  5920.  
  5921.  Description 
  5922.  
  5923.  The control area tag (:ctrl.) specifies where push buttons are displayed, and 
  5924.  which push buttons you want displayed. You can display push buttons in the 
  5925.  control areas of coverpage window or an IPF text window. 
  5926.  
  5927.  The default control area for online documents and Help windows is the coverage 
  5928.  page window, and the default push buttons that display are: 
  5929.  
  5930.  Online documents 
  5931.  
  5932.         Previous 
  5933.         Search 
  5934.         Print 
  5935.         Index 
  5936.         Contents 
  5937.         Back 
  5938.         Forward 
  5939.         Tutorial (only if a tutorial is available). 
  5940.  
  5941.  Help windows 
  5942.  
  5943.         Previous 
  5944.         Search 
  5945.         Print 
  5946.         Index 
  5947.         Tutorial (only if a tutorial is available). 
  5948.  
  5949.  You can define more than one control area with different sets of push button 
  5950.  for an IPF text window; however, only one set of push buttons can be defined 
  5951.  for the coverpage window. 
  5952.  
  5953.  The default set of push buttons for an IPF text window can be overridden by 
  5954.  defining a new default or by referring to the control area definition with the 
  5955.  heading tag (see :h1. through :h6.  (Headings)).  For more information about 
  5956.  push buttons, see Push Buttons. 
  5957.  
  5958.  Conditions 
  5959.  
  5960.      The control area tag (:ctrl.) must be enclosed within the control area 
  5961.       definition tag (:ctrldef.) and associated end tag (:ectrldef.) (see 
  5962.       :ctrldef  (Control Area Definition)). 
  5963.  
  5964.      The :ctrl. tag must follow all push button tags (:pbutton.) (see 
  5965.       :pbutton. (Push Button)). 
  5966.  
  5967.  
  5968. ΓòÉΓòÉΓòÉ 9.13. :ctrldef  (Control Area Definition) ΓòÉΓòÉΓòÉ
  5969.  
  5970. Purpose 
  5971.  
  5972. Defines a control area. 
  5973.  
  5974. Syntax 
  5975.  
  5976. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5977. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  5978. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5979. Γöé:ctrldef.      ΓöéControl area   ΓöéNONE           Γöé:ectrldef.     Γöé
  5980. Γöé               Γöédefinition     Γöé               Γöé               Γöé
  5981. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5982.  
  5983. Attributes 
  5984.  
  5985. None 
  5986.  
  5987. Description 
  5988.  
  5989. Use the :ctrldef. tag to define a control area and the contents of the control 
  5990. area.  For tagging information about the control area of a window, see :ctrl. 
  5991. (Control Area). 
  5992.  
  5993. Conditions 
  5994.  
  5995.      This tag should follow the :docprof. tag. 
  5996.      The following tags are embedded within the :ctrldef. and :ectrldef. tags. 
  5997.         -  :pbutton. 
  5998.         -  :ctrl. 
  5999.  
  6000.  
  6001. ΓòÉΓòÉΓòÉ 9.14. :ddf. (Dynamic Data Formatting) ΓòÉΓòÉΓòÉ
  6002.  
  6003. Purpose 
  6004.  
  6005. Display dynamically formatted text in an application-controlled window. 
  6006.  
  6007. Syntax 
  6008.  
  6009. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6010. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  6011. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6012. Γöé:ddf.          ΓöéDynamic data   Γöéres=           Γöé               Γöé
  6013. Γöé               Γöéformatting     Γöé               Γöé               Γöé
  6014. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6015.  
  6016. Attributes 
  6017.  
  6018.  res= 
  6019.     Associates a location in a window with a request for specific information. 
  6020.     The value is an integer from 1 to 64 000. 
  6021.  
  6022.  Description 
  6023.  
  6024.  :ddf. indicates that the application will provide dynamically formatted data. 
  6025.  
  6026.  When IPF encounters :ddf., it sends the message HM_QUERY_DDF_DATA to the 
  6027.  OBJCOM window,  and specifies the res= value. (The application identified the 
  6028.  OBJCOM window by sending HM_SET_OBJCOM_WINDOW to IPF.) The OBJCOM code 
  6029.  responds by initializing for dynamic data formatting and proceeding with a 
  6030.  dynamic data-formatting routine, using dynamic data-formatting functions. For 
  6031.  more information, see Changing Help Information at Run Time (DDF). 
  6032.  
  6033.  
  6034. ΓòÉΓòÉΓòÉ 9.15. :dl. (Definition List) ΓòÉΓòÉΓòÉ
  6035.  
  6036. Purpose 
  6037.  
  6038. Identifies a list of terms and definitions. 
  6039.  
  6040. Syntax 
  6041.  
  6042. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6043. ΓöéTag          ΓöéElement                    ΓöéAttributes     ΓöéEnd            Γöé
  6044. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6045. Γöé:dl.         ΓöéDefinition list            Γöécompact        Γöé:edl.          Γöé
  6046. Γöé             Γöé                           Γöétsize=         Γöé               Γöé
  6047. Γöé             Γöé                           Γöébreak=         Γöé               Γöé
  6048. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6049. Γöé:dthd.       ΓöéDefinition-term heading    Γöé               Γöé               Γöé
  6050. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6051. Γöé:ddhd.       ΓöéDefinition-description     Γöé               Γöé               Γöé
  6052. Γöé             Γöéheading                    Γöé               Γöé               Γöé
  6053. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6054. Γöé:dt.         ΓöéDefinition term            Γöé               Γöé               Γöé
  6055. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6056. Γöé:dd.         ΓöéDefinition description     Γöé               Γöé               Γöé
  6057. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6058.  
  6059. Attributes 
  6060.  
  6061.  compact 
  6062.     Causes the list to be formatted without a blank line between each term and 
  6063.     description. If you omit this attribute, a blank line is inserted. 
  6064.  
  6065.  tsize=10 | n 
  6066.     Defines the amount of space to allot for the terms and term headings. The 
  6067.     default is 10 character units. If the value of tsize= exceeds the current 
  6068.     size of the formatting area (the space between the current margins), the 
  6069.     current formatting area size is assigned, and a warning message is issued. 
  6070.  
  6071.  break=none | fit | all 
  6072.     Controls the formatting of the terms and descriptions: 
  6073.  
  6074.     none         The description is on the same line as the term. If the length 
  6075.                  of the term exceeds the value specified by tsize=, the term 
  6076.                  extends into the description column, and the description 
  6077.                  starts one space after the term. 
  6078.  
  6079.     fit          The description is placed on the line below the term if the 
  6080.                  term is longer than the value specified by tsize=. 
  6081.  
  6082.     all          All descriptions are placed on the line below the term. 
  6083.  
  6084.  Conditions 
  6085.  
  6086.      The term-heading tag (:dthd.) is paired with the description-heading tag 
  6087.       (:ddhd.) and precedes the term and description tags (:dt. and :dd.). 
  6088.  
  6089.      The term tag requires a description tag. 
  6090.  
  6091.  Example 
  6092.  
  6093.   :dl compact tsize=20.
  6094.   :dthd.:hp2.Mammal:ehp2.
  6095.   :ddhd.:hp2.Description:ehp2.
  6096.   :dt.Florida Panther
  6097.   :dd.Relative of the mountain lion or puma.
  6098.   :dt.Key Deer
  6099.   :dd.&odq.Toy&cdq. member of the whitetail deer family.
  6100.   :dt.Manatee
  6101.   :dd.Gentle giant sea cow.
  6102.   :edl.
  6103.  
  6104.  Output 
  6105.  
  6106.  Mammal              Description 
  6107.  Florida Panther     Relative of the mountain lion or puma. 
  6108.  Key Deer            "Toy" member of the whitetail deer family. 
  6109.  Manatee             Gentle giant sea cow. 
  6110.  
  6111.  
  6112. ΓòÉΓòÉΓòÉ 9.16. :docprof.  (Document Profile) ΓòÉΓòÉΓòÉ
  6113.  
  6114. Purpose 
  6115.  
  6116. Specifies the heading-level entries to be displayed in the Contents window. 
  6117.  
  6118. Syntax 
  6119.  
  6120. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6121. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  6122. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6123. Γöé:docprof.      ΓöéContents windowΓöétoc=           Γöé               Γöé
  6124. Γöé               Γöéentries        Γöé               Γöé               Γöé
  6125. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6126. Γöé               ΓöéGlobal         Γöédll=' '        Γöé               Γöé
  6127. Γöé               Γöécommunications Γöéobjectname=' ' Γöé               Γöé
  6128. Γöé               Γöédynamic-link   Γöéobjectinfo=' ' Γöé               Γöé
  6129. Γöé               Γöélibrary        Γöé               Γöé               Γöé
  6130. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6131. Γöé               ΓöéPush button    Γöéctrlarea=      Γöé               Γöé
  6132. Γöé               Γöésupport        Γöé               Γöé               Γöé
  6133. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6134.  
  6135. Attributes 
  6136.  
  6137.  toc= 
  6138.     Enables you to control the heading levels displayed in the table of 
  6139.     contents. For example, if you want only heading levels 1 and 2 to appear, 
  6140.     the tagging is: 
  6141.  
  6142.         :docprof toc=12.
  6143.  
  6144.     If no toc= value is specified, heading levels 1 through 3 appear in the 
  6145.     Contents window. Heading levels 4 through 6 appear as part of the text when 
  6146.     the window is displayed. 
  6147.  
  6148.     If a heading tag also specifies a value for toc=, the heading-tag value 
  6149.     overrides the :docprof. value until either the end of the file is reached, 
  6150.     or another heading toc= value is encountered. 
  6151.  
  6152.  dll=' ' 
  6153.     Specifies the communication dynamic-link library that IPF loads so that a 
  6154.     communication object in the library can be used to alter the behavior of 
  6155.     IPF. For author-defined push buttons, this is the communication object that 
  6156.     will receive the HM_NOTIFY message.  For a Tutorial push button, this is 
  6157.     the communication object that will receive the HM_TUTORIAL message. 
  6158.  
  6159.  objectname=' ' 
  6160.     Identifies the entry point of the communication object in the dynamic-link 
  6161.     library.  The value for this attribute is case sensitive. 
  6162.  
  6163.  objectinfo=' ' 
  6164.     Identifies parameters to be passed to the object. 
  6165.  
  6166.  ctrlarea= 
  6167.     Defines the control areas in a window where you want to display push 
  6168.     buttons. For more information on control areas in a window, see Push 
  6169.     Buttons. 
  6170.  
  6171.     Possible values are: 
  6172.  
  6173.     page               Identifies the control area within the IPF text window. 
  6174.  
  6175.     coverpage          Identifies the control area as the bottom of the 
  6176.                        coverpage window.  This is the default value. 
  6177.  
  6178.     both               Specifies that you want a control area in both the IPF 
  6179.                        text window, and the coverpage window. 
  6180.  
  6181.     none               Specifies that you do not want a control area (that is, 
  6182.                        you do not want push buttons). 
  6183.  
  6184.  Description 
  6185.  
  6186.  :docprof. is placed at the beginning of the file. It follows the title tag 
  6187.  (:title.), if a title is specified; otherwise, it follows the user-document 
  6188.  tag (:userdoc.). 
  6189.  
  6190.  The :docprof. tag also provides the ability to alter the behavior of IPF by 
  6191.  loading any dynamic-link modules specified in the dll= attribute. It is 
  6192.  possible to have multiple windows and multiple entry points within a 
  6193.  dynamic-link module.  There is no guarantee that the ACVP structure that is 
  6194.  passed into the object will be maintained across multiple calls. 
  6195.  
  6196.  You also can use this tag to change the size and function of the coverpage and 
  6197.  its client and control windows. 
  6198.  
  6199.  The :docprof. tag can be used to define the control area in a window where you 
  6200.  want to display push buttons. 
  6201.  
  6202.  Conditions 
  6203.  
  6204.  None 
  6205.  
  6206.  Example 
  6207.  
  6208.   :userdoc.
  6209.   :title.
  6210.   :docprof toc=123 ctrlarea=none.
  6211.   :euserdoc.
  6212.  
  6213.  Output 
  6214.  
  6215.  When the user selects the "+" icon in the Contents window, heading levels 1 
  6216.  through 4 are displayed in a tree-structured format.  There are no push 
  6217.  buttons because of ctrlarea=none. 
  6218.  
  6219.  
  6220. ΓòÉΓòÉΓòÉ 9.17. :fig. (Figure) ΓòÉΓòÉΓòÉ
  6221.  
  6222. Purpose 
  6223.  
  6224. Identifies a figure. 
  6225.  
  6226. Syntax 
  6227.  
  6228. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6229. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  6230. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6231. Γöé:fig.          ΓöéAny text       Γöé               Γöé:efig.         Γöé
  6232. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6233.  
  6234. Attributes 
  6235.  
  6236. None 
  6237.  
  6238. Description 
  6239.  
  6240. :fig. indicates that what follows is to be formatted exactly as it is entered. 
  6241. Text that exceeds the window area will be clipped. 
  6242.  
  6243. The figure is displayed in proportional font, with a blank line preceding the 
  6244. text. Because proportional font is used, words will align, but letters and 
  6245. numbers may not. 
  6246.  
  6247. Conditions 
  6248.  
  6249. None 
  6250.  
  6251. Example 
  6252.  
  6253. :fig.
  6254.  Area   Number  Classification         Code
  6255. ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  6256.  JOB1
  6257.  
  6258.           2      Full-time exempt        1A
  6259.           4      Part-time exempt        1B
  6260.           4      Full-time nonexempt     2A
  6261.           1      Part-time nonexempt     2B
  6262.           2      Supplemental            3A
  6263.  
  6264. ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  6265. :efig.
  6266.  
  6267. Output 
  6268.  
  6269.  Area   Number  Classification         Code
  6270. ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  6271.  JOB1
  6272.  
  6273.           2      Full-time exempt        1A
  6274.           4      Part-time exempt        1B
  6275.           4      Full-time nonexempt     2A
  6276.           1      Part-time nonexempt     2B
  6277.           2      Supplemental            3A
  6278.  
  6279. ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  6280.  
  6281.  
  6282. ΓòÉΓòÉΓòÉ 9.18. :figcap.  (Figure Caption) ΓòÉΓòÉΓòÉ
  6283.  
  6284. Purpose 
  6285.  
  6286. Specifies a figure title. 
  6287.  
  6288. Syntax 
  6289.  
  6290. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6291. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  6292. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6293. Γöé:figcap.       ΓöéAny text       Γöé               Γöé               Γöé
  6294. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6295.  
  6296. Attributes 
  6297.  
  6298. None 
  6299.  
  6300. Description 
  6301.  
  6302. :figcap. is placed between :fig. and :efig.. The text of the caption goes on 
  6303. the same line as the tag, or on the next line. 
  6304.  
  6305. Conditions 
  6306.  
  6307.      Use :figcap. either immediately after :fig. or immediately before :efig.. 
  6308.      The text of the figure caption cannot contain tags or semicolons. 
  6309.  
  6310.  Example 
  6311.  
  6312.   :fig.
  6313.    Area   Number  Classification         Code
  6314.   ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  6315.    JOB2
  6316.  
  6317.            5      Full-time exempt        1A
  6318.            1      Part-time exempt        1B
  6319.            3      Full-time non-exempt    2A
  6320.            1      Part-time non-exempt    2B
  6321.            1      Supplemental            3A
  6322.  
  6323.   ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  6324.   :figcap.Payroll Codes for Area JOB2
  6325.   :efig.
  6326.  
  6327.  Output 
  6328.  
  6329.    Area   Number  Classification         Code
  6330.   ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  6331.    JOB2
  6332.  
  6333.            5      Full-time exempt        1A
  6334.            1      Part-time exempt        1B
  6335.            3      Full-time non-exempt    2A
  6336.            1      Part-time non-exempt    2B
  6337.            1      Supplemental            3A
  6338.  
  6339.   ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  6340.  
  6341.  Payroll Codes for Area JOB2 
  6342.  
  6343.  
  6344. ΓòÉΓòÉΓòÉ 9.19. :font. (Font) ΓòÉΓòÉΓòÉ
  6345.  
  6346. Purpose 
  6347.  
  6348. Changes the font to the specified typeface, size, and code page. 
  6349.  
  6350. Syntax 
  6351.  
  6352. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6353. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  6354. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6355. Γöé:font.         ΓöéFonts          Γöéfacename=      ΓöéNone           Γöé
  6356. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6357. Γöé               Γöé               Γöésize=          Γöé               Γöé
  6358. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6359. Γöé               Γöé               Γöécodepage=      Γöé               Γöé
  6360. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6361.  
  6362. Attributes 
  6363.  
  6364.  facename= 
  6365.     Defines the typeface name of the font. You can use any bit map font in the 
  6366.     system. 
  6367.  
  6368.     This attribute is required. If default is specified, the font is reset to 
  6369.     the default system font. 
  6370.  
  6371.     Notice that facename= values have initial capitals. These are required; 
  6372.     otherwise, the IPF compiler will not recognize them as valid values. No 
  6373.     error message is returned when an invalid value for facename= is 
  6374.     encountered. 
  6375.  
  6376.  
  6377.  size=hxw 
  6378.     Defines the average character height and width, in points, of the 
  6379.     Presentation Manager image font. (A point is a typesetting measure that is 
  6380.     equal to approximately 1/72 of an inch.) 
  6381.  
  6382.  
  6383.     Following are the Presentation Manager image fonts available on all 
  6384.     system-supported display adapters: 
  6385.  
  6386.         ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6387.         ΓöéFace           Γöé
  6388.         Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6389.         ΓöéCourier        Γöé
  6390.         Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6391.         ΓöéHelv           Γöé
  6392.         Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6393.         ΓöéTms Rmn        Γöé
  6394.         Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6395.         ΓöéSystem         Γöé
  6396.         ΓöéMonospaced     Γöé
  6397.         Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6398.         ΓöéSystem         Γöé
  6399.         ΓöéProportional   Γöé
  6400.         ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6401.  
  6402.     The size= attribute is required. If the value is set to 0x0, the font is 
  6403.     reset to the default system font. 
  6404.  
  6405.  
  6406.  codepage= 
  6407.     Specifies the code page to be used.  This is a three-digit number. Possible 
  6408.     values are: 
  6409.          437 - U.S. IBM PC 
  6410.          850 - Multilingual 
  6411.          860 - Portuguese 
  6412.          863 - Canadian French 
  6413.          865 - Nordic 
  6414.  
  6415.     See Country Code, Code Pages, and Language Parameters for a list of 
  6416.     countries and their code pages. 
  6417.  
  6418.     The codepage= attribute is optional.  If no code-page value is specified, 
  6419.     the code page of the active system process is used. 
  6420.  
  6421.  Description 
  6422.  
  6423.  :font changes the current font for the text within the current window. When a 
  6424.  heading tag defining a new window is encountered, the font resets to the 
  6425.  default system font. 
  6426.  
  6427.  You can make as many font changes within a window as you want. If you define 
  6428.  highlighted phrases while a font tag is in effect, the highlighted text will 
  6429.  be displayed in the font style corresponding to the specified typeface. 
  6430.  
  6431.  When you specify height and width values for a valid font name, you do not 
  6432.  have to know the exact point values.  If no match is found for a specified 
  6433.  font size, IPF uses a "best fit" method to select the font.  For example, 
  6434.  suppose you specify: 
  6435.  
  6436.   :font facename=Helv size=20x12.
  6437.  
  6438.  IPF selects "Helv 18x10" because it is the closest match. 
  6439.  
  6440.  
  6441. ΓòÉΓòÉΓòÉ 9.20. :fn. (Footnote) ΓòÉΓòÉΓòÉ
  6442.  
  6443. Purpose 
  6444.  
  6445. Identifies a pop-up window. 
  6446.  
  6447. Syntax 
  6448.  
  6449. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6450. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  6451. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6452. Γöé:fn.           ΓöéPop-up         Γöéid=            Γöé:efn.          Γöé
  6453. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6454.  
  6455. Attributes 
  6456.  
  6457.  id= 
  6458.     Specifies the ID of the footnote.  It is used in conjunction with the link 
  6459.     tag (see :link.  (Link)). 
  6460.  
  6461.  Description 
  6462.  
  6463.  The footnote tag encloses information that will be displayed in a pop-up 
  6464.  window when the user selects a hypertext link to the information. Footnotes 
  6465.  can appear within paragraphs, lists, highlighted phrases, and artwork. 
  6466.  
  6467.  Conditions 
  6468.  
  6469.      Index entries are not valid within a footnote. 
  6470.      The id= attribute is required. 
  6471.      One footnote must end before another begins. 
  6472.      A footnote cannot be linked from a child window. 
  6473.      Information in a footnote cannot be returned as the result of a search. 
  6474.  
  6475.  Example 
  6476.  
  6477.  The following shows how to enter the footnote ID (here "ddrive") and provide a 
  6478.  link to the footnote. 
  6479.  
  6480.   :fn id=ddrive.
  6481.   The information you place here appears in the pop-up window as a
  6482.   footnote.  For example, you could enter additional information
  6483.   about the disk drive in a footnote.
  6484.   :efn.
  6485.  
  6486.  To provide the link that allows the user to view the footnote pop-up, you 
  6487.  could enter: 
  6488.  
  6489.   :p.Additional information about
  6490.   :link refid=ddrive reftype=fn.disk drives:elink.
  6491.   is available.
  6492.  
  6493.  Output 
  6494.  
  6495.  When the information is displayed, disk drives is highlighted and clicking on 
  6496.  disk drives pops up the footnote window. 
  6497.  
  6498.  
  6499. ΓòÉΓòÉΓòÉ 9.21. :h1. through :h6.  (Headings) ΓòÉΓòÉΓòÉ
  6500.  
  6501. Purpose 
  6502.  
  6503. Define window characteristics. 
  6504.  
  6505. Syntax 
  6506.  
  6507. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6508. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  6509. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6510. Γöé:h1.-:h6.      ΓöéDefine cross   Γöéres=           Γöé               Γöé
  6511. Γöé               Γöéreferences to  Γöéid=            Γöé               Γöé
  6512. Γöé               Γöéinternal and   Γöéname=          Γöé               Γöé
  6513. Γöé               Γöéexternal       Γöéglobal         Γöé               Γöé
  6514. Γöé               Γöésources.       Γöétutorial=' '   Γöé               Γöé
  6515. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6516. Γöé               ΓöéDefine origin  Γöéx=             Γöé               Γöé
  6517. Γöé               Γöéand size of    Γöéy=             Γöé               Γöé
  6518. Γöé               Γöéwindows with   Γöéwidth=         Γöé               Γöé
  6519. Γöé               Γöérelation the   Γöéheight=        Γöé               Γöé
  6520. Γöé               Γöéprimary window.Γöé               Γöé               Γöé
  6521. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6522. Γöé               ΓöéManage the     Γöégroup=         Γöé               Γöé
  6523. Γöé               Γöédisplay of     Γöéviewport       Γöé               Γöé
  6524. Γöé               Γöéinformation in Γöéclear          Γöé               Γöé
  6525. Γöé               Γöémultiple       Γöé               Γöé               Γöé
  6526. Γöé               Γöéwindows.       Γöé               Γöé               Γöé
  6527. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6528. Γöé               ΓöéDefine the     Γöétitlebar=      Γöé               Γöé
  6529. Γöé               Γöéuser's control Γöéscroll=        Γöé               Γöé
  6530. Γöé               Γöéover the       Γöérules=         Γöé               Γöé
  6531. Γöé               Γöéwindow.        Γöé               Γöé               Γöé
  6532. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6533. Γöé               ΓöéRestrict user  Γöénosearch       Γöé               Γöé
  6534. Γöé               Γöéretrieval of   Γöénoprint        Γöé               Γöé
  6535. Γöé               Γöéinformation.   Γöéhide           Γöé               Γöé
  6536. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6537. Γöé               ΓöéChange heading Γöétoc=           Γöé               Γöé
  6538. Γöé               Γöélevels that    Γöé               Γöé               Γöé
  6539. Γöé               Γöéappear in the  Γöé               Γöé               Γöé
  6540. Γöé               ΓöéContents       Γöé               Γöé               Γöé
  6541. Γöé               Γöéwindow.        Γöé               Γöé               Γöé
  6542. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6543. Γöé               ΓöéDefine the     Γöéctrlarea=      Γöé               Γöé
  6544. Γöé               Γöécontrol area ofΓöéctrlrefid=     Γöé               Γöé
  6545. Γöé               Γöéa window for   Γöé               Γöé               Γöé
  6546. Γöé               Γöédisplaying pushΓöé               Γöé               Γöé
  6547. Γöé               Γöébuttons.       Γöé               Γöé               Γöé
  6548. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6549.  
  6550. Attributes 
  6551.  
  6552.   res=
  6553.   id=
  6554.   name=
  6555.     Specify window identifiers. 
  6556.  
  6557.     If you are creating an .HLP file, res= is required and can be any integer 
  6558.     from 1 through 64 000. However, if you are creating an .INF file (compiled 
  6559.     by specifying the /INF parameter with the IPFC command), you can use res=, 
  6560.     name= or id=. With name= and id=, you can include alphabetic characters. 
  6561.     You cannot use these attributes if you plan to concatenate .INF files. 
  6562.     Instead, you must use res=. For more information see Concatenating .INF 
  6563.     Files. 
  6564.  
  6565.  global 
  6566.     Indicates to IPF that the window can be a reference in an external database 
  6567.     (another IPF .HLP or .INF file). A reference from one IPF database to 
  6568.     another is made by specifying reftype=hd and database='filename' with the 
  6569.     link tag. 
  6570.  
  6571.  tutorial=' ' 
  6572.     Specifies the file name of the tutorial and causes the tutorial choice to 
  6573.     be added to the help pull-down when the window is displayed.  When the user 
  6574.     selects Tutorial, the HM_TUTORIAL message specifying the file name of the 
  6575.     tutorial is sent to the application. An example of the tagging follows: 
  6576.  
  6577.         :h1 tutorial='example.exe'.Test Window
  6578.  
  6579.   x=
  6580.   y=
  6581.   width=
  6582.   height=
  6583.     Define the size and position of a window. The x= and y= attributes are 
  6584.     values along the x and y axes; they define the origin of the window. The x 
  6585.     axis runs horizontally from left to right, and the y axis runs vertically 
  6586.     from bottom to top. The position where the values specified for x= and y= 
  6587.     intersect is the the origin of the window. (The 0,0 intersection is the 
  6588.     bottom left corner of the parent window.) From this location, width and 
  6589.     height are measured. For more information about window coordinates, see 
  6590.     Defining Window Origin and Size. 
  6591.  
  6592.     Size and position attributes can be given in absolute, dynamic, or relative 
  6593.     values: 
  6594.  
  6595.     Absolute value: 
  6596.             A number followed by a letter, which indicates the unit of measure: 
  6597.  
  6598.             c           (Characters):  Average character width of the default 
  6599.                         system font. 
  6600.             x           (Pixels):  Dependent on the display adapter in use. 
  6601.             p           ( Points):  Typesetting measure; equal to approximately 
  6602.                         1/72 inch. 
  6603.  
  6604.     Relative value: 
  6605.             A number followed by the percent sign (%), indicating a percentage 
  6606.             of the parent-window width or height. 
  6607.  
  6608.     Dynamic value: 
  6609.             A term indicating a window coordinate location that is dependent on 
  6610.             the current size and position of the primary window: 
  6611.  
  6612.             center | left | right 
  6613.                      For x= values:  In the center of, flush left in, or flush 
  6614.                      right in the parent window. 
  6615.  
  6616.             center | top | bottom 
  6617.                      For y= values:  In the center of, at the top of, or at the 
  6618.                      bottom of the parent window. 
  6619.  
  6620.     Restrictions: 
  6621.             When defining window position and size, you cannot mix absolute 
  6622.             values with dynamic or relative values for either of the following 
  6623.             combinations of attributes: 
  6624.  
  6625.                 The x coordinate and the width 
  6626.                 The y coordinate and the height. 
  6627.  
  6628.             If no values for x= and y= are specified, the origin of the window 
  6629.             is 0,0. If you specify values other than 0,0, you also must specify 
  6630.             width and height values.  Negative values for these attributes are 
  6631.             not allowed. 
  6632.  
  6633.   group=
  6634.   viewport
  6635.   clear
  6636.     The group= attribute enables you to assign the window a number from 1 
  6637.     through 64 000. This associates the window with a heading definition and 
  6638.     the IPFC information that follows it. If you do not provide a number with 
  6639.     group=, IPF assigns the number 0. 
  6640.  
  6641.     A group number can be assigned to a viewport by a heading or link 
  6642.     definition. For example, suppose you have a group number specified in a 
  6643.     link definition, and another in the heading that the link refers to. If a 
  6644.     user action causes the link definition to be selected, the link group 
  6645.     number overrides the heading group number.  However, if the user selects 
  6646.     the heading from either the Contents window or the Index window, the 
  6647.     heading group number takes effect. 
  6648.  
  6649.     IPF searches among the open windows to find one with a number matching the 
  6650.     one specified with group=. If no match is found, IPF opens a new window. If 
  6651.     a match is found, the information associated with the group number is 
  6652.     swapped with the information in the matched window. 
  6653.  
  6654.     The viewport attribute always opens a window.  If you specify both viewport 
  6655.     and group=, and a window with the specified group number is already open, 
  6656.     IPF opens another window with the same group number. Thus, it is better 
  6657.     that you do not specify the viewport attribute in a heading that will 
  6658.     appear in the Contents window, unless you want your contents entries to 
  6659.     always open separate windows. 
  6660.  
  6661.     The clear attribute causes IPF to close any open windows before opening a 
  6662.     window to display the current window. 
  6663.  
  6664.   titlebar=yes | sysmenu | minmax | both | none
  6665.   rules=border | sizeborder | none
  6666.   scroll=horizontal | vertical | both | none
  6667.     These attributes define Presentation Manager window controls and are used 
  6668.     primarily when defining secondary windows. If none of these attributes are 
  6669.     specified, the default is to open a window that has a title bar with title 
  6670.     bar icon, hide button, maximize button; a sizing border; and vertical and 
  6671.     horizontal scroll bars. 
  6672.  
  6673.   nosearch
  6674.   noprint
  6675.   hide
  6676.     These attributes restrict information retrieval and are most often used in 
  6677.     heading definitions for secondary windows. 
  6678.  
  6679.     The nosearch attribute in a secondary heading definition prevents the 
  6680.     heading from being returned as an entry in the search-results window. This 
  6681.     does not mean the secondary window is not searched.  It is, however, only 
  6682.     the primary heading definition that is returned. When the user selects the 
  6683.     primary heading definition, the contents of the second window are displayed 
  6684.     as part of the primary-window composition. 
  6685.  
  6686.     The noprint attribute in a secondary heading definition prevents the 
  6687.     contents of a secondary window from being printed as a separate entity. 
  6688.     Instead, secondary windows are printed as part of their primary window. The 
  6689.     contents of secondary windows are printed in the order in which the link 
  6690.     definitions are listed in the primary window. 
  6691.  
  6692.     When used in secondary heading definitions, nosearch and noprint merely 
  6693.     prevent duplication of output (search results or printed copy). When used 
  6694.     in regular heading definitions, they prevent retrieval of the information 
  6695.     by the user.  The only exception to this condition is if the user selects 
  6696.     This section for either printing or searching. 
  6697.  
  6698.     The hide attribute prevents a heading level from appearing in the Contents 
  6699.     window; however, there must be at least one heading level that is not 
  6700.     hidden. 
  6701.  
  6702.  toc= 
  6703.     Specifies heading levels that are to be entries in the Contents window. 
  6704.     When this attribute is encountered in a heading tag, the specified heading 
  6705.     levels override any levels specified by toc= of the document-profile tag 
  6706.     (:docprof.) until either the end-of-file is reached or another toc= 
  6707.     attribute is encountered in a heading tag.  If no document-profile tag 
  6708.     exists, the heading levels that appear in the Contents window are levels 1, 
  6709.     2, and 3. The toc= attribute must be greater than zero. 
  6710.  
  6711.  ctrlarea= 
  6712.     Specifies which control area in a window you want to display push buttons. 
  6713.     When this attribute is encountered in a heading tag, it overrides the 
  6714.     ctrlarea attribute specified by :docprof..  Possible values are: 
  6715.  
  6716.     page         Identifies the control area as the IPF text window. 
  6717.     none         Specifies that you do not want a control area. 
  6718.  
  6719.     For example, if your document consisted of 100 windows, and you wanted only 
  6720.     one window to display push buttons in the IPF text window, you would tag 
  6721.     your source file as follows: 
  6722.  
  6723.         :docprof ctrlarea=none.
  6724.         .
  6725.         .
  6726.         .
  6727.         :h1 ctrlarea=page.One Window
  6728.  
  6729.  ctrlrefid= 
  6730.     Refers to the identification value (id=) specified by the control area tag 
  6731.     (:ctrl.).  This attribute specifies which control area you want to display 
  6732.     for this heading.  This attribute is used to override the default control 
  6733.     area (the coverpage window). 
  6734.  
  6735.  Note:  Be careful when using heading tags to define a control area for split 
  6736.         windows. A control area cannot be defined in the secondary window 
  6737.         heading tag of a split window. You must define the control area (the 
  6738.         coverpage window) in the primary window heading tag. 
  6739.  
  6740.  
  6741. ΓòÉΓòÉΓòÉ 9.22. :hdref. (Heading Reference) ΓòÉΓòÉΓòÉ
  6742.  
  6743. Purpose 
  6744.  
  6745. Places a hypertext link to a heading.  The text displayed within the link is 
  6746. the word "Reference". 
  6747.  
  6748. Syntax 
  6749.  
  6750. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6751. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  6752. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6753. Γöé:hdref.        ΓöéHeading        Γöéres=           Γöé               Γöé
  6754. Γöé               ΓöéReference      Γöé               Γöé               Γöé
  6755. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6756. Γöé               Γöé               Γöérefid=         Γöé               Γöé
  6757. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6758.  
  6759. Attributes 
  6760.  
  6761.  res= 
  6762.     Resource identification number of the heading to link to. 
  6763.  
  6764.  
  6765.  refid= 
  6766.     ID of the heading to link to. 
  6767.  
  6768.  
  6769. ΓòÉΓòÉΓòÉ 9.23. :hide.  (Hide) ΓòÉΓòÉΓòÉ
  6770.  
  6771. Purpose 
  6772.  
  6773. Controls display of IPF text and graphics to meet conditions set by the 
  6774. IPF_KEYS= environment variable. 
  6775.  
  6776. Syntax 
  6777.  
  6778. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6779. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  6780. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6781. Γöé:hide.         ΓöéHide           Γöékey=           Γöé:ehide.        Γöé
  6782. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6783.  
  6784. Attributes 
  6785.  
  6786.  key=' ' 
  6787.     Defines the key that enables a user to view hidden information. You can 
  6788.     specify one or more key names.  Enclose each key name within apostrophes. 
  6789.     When specifying more than one key name, insert a plus (+) sign after each 
  6790.     name. 
  6791.  
  6792.     Text entered between the :hide. and :ehide. tags is only displayed when the 
  6793.     key='' attribute matches the entry specified by the user.  Use the OS/2 
  6794.     environment variable SET IPF_KEYS= to specify the key name identified for 
  6795.     the hidden information.                          set in 
  6796.  
  6797.     If this attribute is not specified, the information identified by the hide 
  6798.     tag is displayed. 
  6799.  
  6800.  
  6801.  Description 
  6802.  
  6803.  :hide. enables you to determine what text and graphics will be displayed 
  6804.  within a window. This function is useful when you want to tailor the 
  6805.  information you give to users; for example, if you want to display levels of 
  6806.  information on the basis of a user's system configuration, you assign each 
  6807.  level a value with the key= attribute. When a topic containing hide tags is 
  6808.  selected for viewing, IPF will look for an environment variable called 
  6809.  IPF_KEYS= to determine what level of information to show the user. If a match 
  6810.  is found, the information within the hide tags is displayed; otherwise, the 
  6811.  information is hidden from view. 
  6812.  
  6813.  The hide tag affects the display of compiled information. You can hide lines 
  6814.  of text within the window, a word or a phrase within a line, or you can hide 
  6815.  an instruction to display a bit map, as in the following example. 
  6816.  
  6817.   :hide key='level1'.
  6818.   :artwork name='mybitmap.bmp'.
  6819.   :ehide.
  6820.  
  6821.  If the user's environment does not contain the key to display the hidden 
  6822.  information, IPF wraps the text from the last character or formatting 
  6823.  instruction on the line preceding :hide. to the line following :ehide.. 
  6824.  
  6825.  In some situations, the same user may need to view more than one level of 
  6826.  hidden information.  This can be accomplished by setting the IPF_KEYS= to 
  6827.  concatenated values; for example: 
  6828.  
  6829.   SET IPF_KEYS=LEVEL1+LEVEL2
  6830.  
  6831.  Take care that a window view does not contain an orphan tag. For example, you 
  6832.  do not want to hide the information following a list item, unless you have 
  6833.  alternate information to display, based on the setting of a key. In the case 
  6834.  of an ordered list, which generates sequential numbers, you would not include 
  6835.  a list item in the hidden information, unless it is the last item in the list. 
  6836.  
  6837.  Conditions 
  6838.  
  6839.      You cannot nest one set of hide tags within another. 
  6840.      You cannot include a heading tag that has a res= attribute within a set 
  6841.       of hide tags. 
  6842.      You cannot set IPF_KEYS= on a session basis. 
  6843.  
  6844.  Example 
  6845.  
  6846.  Suppose the following source has been compiled as part of a help library file: 
  6847.  
  6848.   :h1 res=001.Installation Procedure
  6849.   :ol.
  6850.   :li.
  6851.   :hide key='usera'.
  6852.   Instruction for User A.
  6853.   :ehide.
  6854.   :hide key='userb'.
  6855.   Instruction for User B.
  6856.   :ehide.
  6857.   :li.
  6858.   Shut down the system from the Desktop.
  6859.   :li.
  6860.   Press Ctl+Alt+Del to restart the system.
  6861.   :eol.
  6862.  
  6863.  If the user's environment includes the setting, IPF_KEYS=USERA, the following 
  6864.  is displayed: 
  6865.  
  6866.    1. Instruction for User A. 
  6867.  
  6868.    2. Shut down the system from the desk top. 
  6869.  
  6870.    3. Press Ctl+Alt+Del to restart the system. 
  6871.  
  6872.  
  6873. ΓòÉΓòÉΓòÉ 9.24. :hp1. through :hp9.  (Highlighted Phrase) ΓòÉΓòÉΓòÉ
  6874.  
  6875. Purpose 
  6876.  
  6877. Emphasize text by changing the font style or foreground color. 
  6878.  
  6879. Syntax 
  6880.  
  6881. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6882. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  6883. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6884. Γöé:hpn.          ΓöéHighlighting   ΓöéNone           Γöé:ehpn.         Γöé
  6885. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6886.  
  6887. Description 
  6888.  
  6889. Highlighted-phrase tags are useful for emphasizing words and phrases within 
  6890. text. 
  6891.  
  6892. Font styles that are displayed for highlighted phrases correspond to the 
  6893. typeface currently being used by IPF.  To change from the default system 
  6894. typeface to other typefaces, use :font. When you use either the example tag 
  6895. (:xmp.), the character-graphics tag (:cgraphic.) or the table tag (:table.), 
  6896. the system monospace typeface is displayed. 
  6897.  
  6898. Input 
  6899.  
  6900. :sl compact.
  6901. :li.:hp1.Highlighted phrase 1 looks like this.:ehp1.
  6902. :li.:hp2.Highlighted phrase 2 looks like this.:ehp2.
  6903. :li.:hp3.Highlighted phrase 3 looks like this.:ehp3.
  6904. :li.:hp4.Highlighted phrase 4 looks like BLUE.:ehp4.
  6905. :li.:hp5.Highlighted phrase 5 looks like this.:ehp5.
  6906. :li.:hp6.Highlighted phrase 6 looks like this.:ehp6.
  6907. :li.:hp7.Highlighted phrase 7 looks like this.:ehp7.
  6908. :li.:hp8.Highlighted phrase 8 looks like RED.:ehp8.
  6909. :li.:hp9.Highlighted phrase 9 looks like PINK.:ehp9.
  6910. :esl.
  6911.  
  6912. System Default Font Output 
  6913.  
  6914.       Highlighted phrase 1 looks like this. 
  6915.       Highlighted phrase 2 looks like this. 
  6916.       Highlighted phrase 3 looks like this. 
  6917.       Highlighted phrase 4 looks like this. 
  6918.       Highlighted phrase 5 looks like this. 
  6919.       Highlighted phrase 6 looks like this. 
  6920.       Highlighted phrase 7 looks like this. 
  6921.       Highlighted phrase 8 looks like this. 
  6922.       Highlighted phrase 9 looks like this. 
  6923.  
  6924.  Conditions 
  6925.  
  6926.  You cannot nest highlighted-phrase tags. 
  6927.  
  6928.  
  6929. ΓòÉΓòÉΓòÉ 9.25. :i1. and :i2.  (Index) ΓòÉΓòÉΓòÉ
  6930.  
  6931. Purpose 
  6932.  
  6933. Place topics into the index. 
  6934.  
  6935. Syntax 
  6936.  
  6937. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6938. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  6939. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6940. Γöé:i1.           ΓöéPrimary entry  Γöéid=            Γöé               Γöé
  6941. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6942. Γöé               Γöé               Γöéglobal         Γöé               Γöé
  6943. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6944. Γöé               Γöé               Γöéroots=' '      Γöé               Γöé
  6945. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6946. Γöé               Γöé               Γöésortkey=' '    Γöé               Γöé
  6947. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6948. Γöé:i2.           ΓöéSecondary entryΓöérefid=         Γöé               Γöé
  6949. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6950. Γöé               Γöé               Γöéglobal         Γöé               Γöé
  6951. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6952. Γöé               Γöé               Γöésortkey=' '    Γöé               Γöé
  6953. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6954.  
  6955. Attributes 
  6956.  
  6957.  id= 
  6958.     Provides a cross-reference identifier for the secondary index tag (:i2.). 
  6959.     This attribute is optional and only valid when used with the primary index 
  6960.     tag (:i1.). 
  6961.  
  6962.  global 
  6963.     Specifies that the index entry can appear in any MIndex Object depending on 
  6964.     where you install the file and how each MIndex Object is set up.  Entries 
  6965.     also appear in the component index. This attribute is only used in Help 
  6966.     windows.  Online document cannot use this attribute. 
  6967.  
  6968.  roots='root words' 
  6969.     Specifies a list of root words that act as index entries to specified 
  6970.     topics. These root words are associated with words defined with the 
  6971.     index-synonym tag (:isyn.). Root words can contain alphabetic and numeric 
  6972.     characters, which can be entered in uppercase or lowercase. When entering a 
  6973.     string of words, insert a blank space between each word, and enclose the 
  6974.     string within apostrophes. 
  6975.  
  6976.     Root words do not appear in the index, so are not viewed by the user, and 
  6977.     need not be translated. They are used to create a link between the primary 
  6978.     index tag and the index-synonym tag. To enable the user to search for an 
  6979.     index entry, use the index-synonym tag to map the root words associated 
  6980.     with the entry to synonyms. 
  6981.  
  6982.  sortkey='sortkey-text'.index-text 
  6983.     Specifies a character string that is used for sorting the entry in the 
  6984.     index, and another character string that is displayed for the index entry. 
  6985.  
  6986.     The sortkey-text character string determines where this entry is placed in 
  6987.     the index. The index-text character string is displayed for the index 
  6988.     entry. 
  6989.  
  6990.  refid= 
  6991.     Provides a reference to the text associated with the primary index tag. 
  6992.  
  6993.  Description 
  6994.  
  6995.  You use the primary and secondary index tags to provide index entries to the 
  6996.  information. The attributes associated with each index tag enable you to 
  6997.  define related information.  Index entries can be used throughout the file, 
  6998.  but cannot be placed within a footnote. 
  6999.  
  7000.  The text of the index entry must be on the same line as the tag, and cannot 
  7001.  contain other tags.  The entry for each primary index entry within the window 
  7002.  must be unique.  That is, you cannot provide duplicate index entries within 
  7003.  the same window. Secondary index entries must refer to an identifier specified 
  7004.  for a primary index entry. 
  7005.  
  7006.  When the user selects Help index from the Help menu, an Index window is 
  7007.  displayed for the help interface. When the user selects Index from the Options 
  7008.  menu, an Index window is displayed for the online information interface. If 
  7009.  the user enters a synonym that matches a root word, the index topics listed 
  7010.  for the root word are displayed. When the user selects the Master Help Index 
  7011.  object from the Desktop, it opens to display an alphabetic list of entries 
  7012.  within a spiral bound notebook.  For more information, see Master Help Index 
  7013.  and Glossary 
  7014.  
  7015.  Conditions 
  7016.  
  7017.      Index entries cannot appear in a footnote. 
  7018.      When referencing the :i1. tag, use the global attribute on both the :i1. 
  7019.       and :i2. tag. 
  7020.  
  7021.  Example 1 
  7022.  
  7023.  This example shows how to tag your file to include primary and secondary index 
  7024.  entries. 
  7025.  
  7026.   :i1 id=del.delete
  7027.   :i2 refid=del.directories
  7028.   :i2 refid=del.files
  7029.  
  7030.  Output 
  7031.  
  7032.  The index will include the following entry: 
  7033.  
  7034.    delete
  7035.      directories
  7036.      files
  7037.  
  7038.  Example 2 
  7039.  
  7040.  This example shows a file with the index-synonym tag (:isyn.) and the roots= 
  7041.  attribute. 
  7042.  
  7043.   :h1 id=copy03.Help for Copying
  7044.   :isyn root=copy.copy copying duplicate duplicating
  7045.   :isyn root=book.book manual draft manuscript
  7046.   :isyn root=folder.folder folders document documents
  7047.   :i1 roots='copy folder'.Copying a document
  7048.   :i1 roots='book folder'.Test procedures
  7049.   :p.When copying a file from the current directory to a new
  7050.   directory, specify the following:
  7051.   :ul.
  7052.   :li.The file name
  7053.   :li.The target directory
  7054.   :li.The new file name and extension.
  7055.   :eul.
  7056.  
  7057.  Output 
  7058.  
  7059.  The index-synonym tag creates the following synonym table: 
  7060.  
  7061.  Root word     Synonym words 
  7062.  
  7063.  copy          copy copying duplicate duplicating 
  7064.  
  7065.  book          book manual draft manuscript 
  7066.  
  7067.  folder        folder folders document documents 
  7068.  
  7069.  The roots= attribute points to the root words, "copy" and "folder," and the 
  7070.  list of associated synonyms.  For example, if the user searches for "copy" or 
  7071.  "folder," the "Copying a document" entry appears because "copy" and "folder," 
  7072.  identified by the index roots= attribute, match the entries listed for the 
  7073.  index synonym root= attribute. 
  7074.  
  7075.  A search for the synonym "duplicate" lists "Copying a document" as one of the 
  7076.  index choices. A search for the synonym "manual" lists "Test procedures" as an 
  7077.  index choice, and a search for "document" lists both "Copying a document" and 
  7078.  "Test procedures." 
  7079.  
  7080.  Example 3 
  7081.  
  7082.  This example shows how to specify a sort key to change the location of the 
  7083.  entry in the index. 
  7084.  
  7085.   :i1 sortkey='point sizes'.changing fonts
  7086.   :i1.program header
  7087.   :i1.parameter list
  7088.   :i1.preface
  7089.  
  7090.  Output 
  7091.  
  7092.  The index will include the entry "changing fonts" at the location where the 
  7093.  term "point sizes" would appear in the sorting sequence of the index, as 
  7094.  follows: 
  7095.  
  7096.   parameter list
  7097.   changing fonts
  7098.   preface
  7099.   program header
  7100.  
  7101.  Example 4 
  7102.  
  7103.  This example is for a simple Master Help Index object entry for conceptual 
  7104.  information about batch files. 
  7105.  
  7106.       :i1 global.batch files, creating 
  7107.  When referring to an :i1. tag, use the global attribute in both the :i1. and 
  7108.  :i2. tags.  For example: 
  7109.  
  7110.             :i1 id=copy global.copying
  7111.  
  7112.             :i2 refid=copy global.help topics
  7113.  
  7114.             :i2 refid=copy global.document topics
  7115.  
  7116.  When the IPF compiler encounters global attributes, it creates an alphabetic 
  7117.  list, which can then be accessed by selecting Master Help Index object from 
  7118.  the Desktop. 
  7119.  
  7120.  
  7121. ΓòÉΓòÉΓòÉ 9.26. :icmd.  (Index Command) ΓòÉΓòÉΓòÉ
  7122.  
  7123. Purpose 
  7124.  
  7125. Identifies the help window that describes a command. 
  7126.  
  7127. Syntax 
  7128.  
  7129. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7130. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  7131. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7132. Γöé:icmd.         ΓöéIndex command  Γöéexternal       Γöé               Γöé
  7133. Γöé               Γöé               Γöécommand string Γöé               Γöé
  7134. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7135.  
  7136. Attributes 
  7137.  
  7138.  external-command-string 
  7139.     Specifies the command for which help is being defined. The text can contain 
  7140.     no other tags. 
  7141.  
  7142.  Description 
  7143.  
  7144.  The help information for a command is assumed to be in the help window in 
  7145.  which the index-command tag (:icmd.) is defined.  If the help window provides 
  7146.  help for more than one command, an index-command tag should be defined within 
  7147.  the heading tag for each command. 
  7148.  
  7149.  The same external command string cannot be specified in more than one 
  7150.  index-command tag of an index file; that is, only one help window can be 
  7151.  designated as describing a command. 
  7152.  
  7153.  If the compiler finds the same external command string more than once (either 
  7154.  from the same or different help windows), the duplicate occurrences are 
  7155.  discarded, and a warning message is issued. 
  7156.  
  7157.  Note:  The association with entry field and command names is a programming 
  7158.         task.  In addition, the application developer must define the field 
  7159.         with which command windows are to be associated as a command entry 
  7160.         field.  For more information about programming a command entry field, 
  7161.         see Command Entry Field. 
  7162.  
  7163.  Conditions 
  7164.  
  7165.  :icmd. must follow a heading tag or another index tag. 
  7166.  
  7167.  Example 
  7168.  
  7169.   :h1 id=xhlp.Help for Copying
  7170.   :icmd.Copying
  7171.   :h1 res=129.Deleting Files
  7172.   :icmd.Delete
  7173.  
  7174.  Output 
  7175.  
  7176.  At execution time, the index entries enable the compiler to process command 
  7177.  helps, create a list of commands for which help is available, and display the 
  7178.  help window defined for any of those commands. 
  7179.  
  7180.  
  7181. ΓòÉΓòÉΓòÉ 9.27. :isyn.  (Index Synonym) ΓòÉΓòÉΓòÉ
  7182.  
  7183. Purpose 
  7184.  
  7185. Identifies synonyms and word variations for the help keywords. 
  7186.  
  7187. Syntax 
  7188.  
  7189. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7190. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  7191. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7192. Γöé:isyn.         ΓöéIndex synonyms Γöéroot=          Γöé               Γöé
  7193. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7194.  
  7195. Attributes 
  7196.  
  7197.  root= 
  7198.     Links synonyms and variations of words specified in a primary index tag. 
  7199.  
  7200.     To establish a link, specify the same word as specified in the roots= 
  7201.     attribute of the primary index tag.  Then add a period, repeat the root 
  7202.     word, and add the list of synonyms and variations, separated by blanks. 
  7203.     For example, assume that the value specified for the roots= attribute of 
  7204.     the primary index tag is "copy."  The entry for the index-synonym tag could 
  7205.     be: 
  7206.  
  7207.         :isyn root=copy.copy copying duplicate duplicating
  7208.  
  7209.     The words entered in the synonym list enable the user to search for terms 
  7210.     that may not be in the Index list, and still receive the appropriate help. 
  7211.     Lowercase and uppercase characters are treated the same. 
  7212.  
  7213.  Description 
  7214.  
  7215.  :isyn. begins a list of synonyms or variations of a word specified by a 
  7216.  primary index tag. The compiler uses this list to build a table that serves as 
  7217.  a link to the primary index tags. Synonyms determine the topic entries 
  7218.  displayed when the user enters words for a search of the index. The compiler 
  7219.  matches the entered words with words in the table and links to the topics to 
  7220.  be displayed. 
  7221.  
  7222.  The index-synonym tag can be placed within any window that contains related 
  7223.  index entries identified by the index tag. The synonyms defined in a window 
  7224.  can relate to many topics, and thus to many windows. 
  7225.  
  7226.  Synonyms defined with this tag do not appear in the index. 
  7227.  
  7228.  Conditions 
  7229.  
  7230.  A root word can contain only alphabetic and numeric characters. 
  7231.  
  7232.  Example 
  7233.  
  7234.   :h1 id=copy03.Help for Copying
  7235.   :isyn root=copy.copy copying duplicate duplicating
  7236.   :isyn root=folder.folder folders document documents
  7237.   :i1 roots='copy folder'.Copying a document
  7238.   :p.When copying a file from the current directory to a new
  7239.   directory, specify the following:
  7240.   :ul.
  7241.   :li.The file name
  7242.   :li.The target directory
  7243.   :li.The new file name and extension
  7244.   :eul.
  7245.  
  7246.  Output 
  7247.  
  7248.  The index-synonym tag creates the following synonym table: 
  7249.  
  7250.  Root word      Synonym words 
  7251.  
  7252.  copy           copy copying duplicate duplicating 
  7253.  
  7254.  folder         folder folders document documents 
  7255.  
  7256.  The roots= attribute points to the root words, "copy" and "folder," and the 
  7257.  list of associated synonyms.  If the user searches for "copy" or "folder," the 
  7258.  words will be displayed because of the matches between the roots= attribute of 
  7259.  the primary index tag and the root= attribute of the index-synonym tag. 
  7260.  However, a search for the synonym "duplicate" returns "Copying a document" as 
  7261.  an index choice. 
  7262.  
  7263.  
  7264. ΓòÉΓòÉΓòÉ 9.28. :li.  (List Item) ΓòÉΓòÉΓòÉ
  7265.  
  7266. Purpose 
  7267.  
  7268. Identifies an item within a list. 
  7269.  
  7270. Syntax 
  7271.  
  7272. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7273. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  7274. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7275. Γöé:li.           ΓöéList item      Γöé               Γöé               Γöé
  7276. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7277.  
  7278. Attributes 
  7279.  
  7280. None 
  7281.  
  7282. Description 
  7283.  
  7284. The format of the list items depends on the type of list:  ordered, unordered, 
  7285. or simple.  For example, if the list is an ordered list, a number precedes each 
  7286. list item.  If the list is an unordered list, a bullet precedes each item. See 
  7287. :ol.  (Ordered List), :sl.  (Simple List), and :ul.  (Unordered List) for more 
  7288. information. 
  7289.  
  7290. Conditions 
  7291.  
  7292. None 
  7293.  
  7294. Example 
  7295.  
  7296. :p.To remove a diskette&colon.
  7297. :ol.
  7298. :li.Open the drive door.
  7299. :li.Remove the diskette.
  7300. :li.Put the diskette in a safe place.
  7301. :eol.
  7302.  
  7303. Output 
  7304.  
  7305. To remove a diskette: 
  7306.  
  7307.    1. Open the drive door. 
  7308.  
  7309.    2. Remove the diskette. 
  7310.  
  7311.    3. Put the diskette in a safe place. 
  7312.  
  7313.  
  7314. ΓòÉΓòÉΓòÉ 9.29. :lines.  (Lines) ΓòÉΓòÉΓòÉ
  7315.  
  7316. Purpose 
  7317.  
  7318. Turns formatting off. 
  7319.  
  7320. Syntax 
  7321.  
  7322. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7323. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  7324. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7325. Γöé:lines.        ΓöéLines          Γöéalign=         Γöé:elines.       Γöé
  7326. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7327.  
  7328. Attributes 
  7329.  
  7330.  align=leftΓöérightΓöécenter 
  7331.     Places the entered lines to the left in the window, to the right, or in the 
  7332.     center. 
  7333.  
  7334.  Description 
  7335.  
  7336.  :lines. specifies that the following text is to be formatted exactly as it is 
  7337.  entered. The attributes enable you to align the text within the window. Text 
  7338.  that is too long for the window is clipped. 
  7339.  
  7340.  Proportional fonts are used for formatting, so the text may not be displayed 
  7341.  exactly as entered. 
  7342.  
  7343.  Conditions 
  7344.  
  7345.  None 
  7346.  
  7347.  Example 1 
  7348.  
  7349.  This example aligns text to the left. 
  7350.  
  7351.   :lines align=left.
  7352.   The warehouse contained:
  7353.     12  desks
  7354.     28  chairs
  7355.     15  lamps
  7356.     39  typewriters
  7357.     11  pictures
  7358.   :elines.
  7359.  
  7360.  Example 2 
  7361.  
  7362.  This example aligns text to the right. 
  7363.  
  7364.   :lines align=right.
  7365.   The warehouse contained:
  7366.     12  desks
  7367.     28  chairs
  7368.     15  lamps
  7369.     39  typewriters
  7370.     11  pictures
  7371.   :elines.
  7372.  
  7373.  Output 
  7374.  
  7375.  The following output is provided. 
  7376.  
  7377.  Example 1 
  7378.  
  7379.   The warehouse contained:
  7380.    12  desks
  7381.    28  chairs
  7382.    15  lamps
  7383.    39  typewriters
  7384.    11  pictures
  7385.  
  7386.  Example 2 
  7387.  
  7388.                                                         The warehouse contained:
  7389.                                                                        12  desks
  7390.                                                                       28  chairs
  7391.                                                                        15  lamps
  7392.                                                                  39  typewriters
  7393.                                                                     11  pictures
  7394.  
  7395.  
  7396. ΓòÉΓòÉΓòÉ 9.30. :link.  (Link) ΓòÉΓòÉΓòÉ
  7397.  
  7398. Purpose 
  7399.  
  7400. Activates a link to additional information. 
  7401.  
  7402. Syntax 
  7403.  
  7404. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7405. ΓöéTag            ΓöéElements       ΓöéAttributes     ΓöéEnd            Γöé
  7406. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7407. Γöé:link.         ΓöéLink to more   Γöéreftype=       Γöé:elink.        Γöé
  7408. Γöé               Γöéinformation    Γöéres=           Γöé               Γöé
  7409. Γöé               Γöé               Γöérefid=         Γöé               Γöé
  7410. Γöé               Γöé               Γöédatabase=' '   Γöé               Γöé
  7411. Γöé               Γöé               Γöéobject=' '     Γöé               Γöé
  7412. Γöé               Γöé               Γöédata=' '       Γöé               Γöé
  7413. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7414. Γöé               ΓöéAutomatic      Γöéauto           Γöé               Γöé
  7415. Γöé               Γöélinking        Γöéviewport       Γöé               Γöé
  7416. Γöé               Γöé               Γöédependent      Γöé               Γöé
  7417. Γöé               Γöé               Γöésplit          Γöé               Γöé
  7418. Γöé               Γöé               Γöéchild          Γöé               Γöé
  7419. Γöé               Γöé               Γöégroup=         Γöé               Γöé
  7420. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7421. Γöé               ΓöéDefine window  Γöévpx=           Γöé               Γöé
  7422. Γöé               Γöéposition and   Γöévpy=           Γöé               Γöé
  7423. Γöé               Γöésize           Γöévpcx=          Γöé               Γöé
  7424. Γöé               Γöé               Γöévpcy=          Γöé               Γöé
  7425. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7426. Γöé               ΓöéDefine window  Γöétitlebar=      Γöé               Γöé
  7427. Γöé               Γöécontrols       Γöéscroll=        Γöé               Γöé
  7428. Γöé               Γöé               Γöérules=         Γöé               Γöé
  7429. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7430.  
  7431. Attributes 
  7432.  
  7433.  reftype= 
  7434.     Defines the type of link.  Possible values are hd, fn, launch, and inform. 
  7435.     reftype=hd 
  7436.             Links to a heading.  The heading definition (or an overriding 
  7437.             definition in the link) causes its information to be displayed in 
  7438.             the current window or another window. The integer value of refid= 
  7439.             identifies the ID of the heading. If the heading is in an external 
  7440.             IPF database, its file name is specified with the database= 
  7441.             attribute. 
  7442.  
  7443.             In the following example, selection of the hypertext link causes 
  7444.             the external database, EDITOR.HLP, to be loaded, and the heading 
  7445.             with the ID of 001 to be displayed. 
  7446.  
  7447.                         :link reftype=hd refid=001.
  7448.                               database='editor.hlp'.
  7449.                         Editing Functions
  7450.                         :elink.
  7451.  
  7452.             The heading definition in the external database must contain the 
  7453.             global attribute.  If the link to the file cannot be resolved, the 
  7454.             hypertext phrase in the link will not be highlighted. 
  7455.  
  7456.     reftype=fn 
  7457.             Links to a footnote. Its contents are displayed in a pop-up window 
  7458.             in the current window.  The refid= attribute specifies the ID of 
  7459.             the footnote. 
  7460.  
  7461.             Restriction: A split window cannot contain a link to a footnote. 
  7462.  
  7463.     reftype=launch 
  7464.             Starts a Presentation Manager program.  The file name of the 
  7465.             program is specified with the object= attribute.  Any parameters to 
  7466.             the program are specified with data=.  In the following example, 
  7467.             the hypertext link starts the System Editor and opens the file, 
  7468.             MYFILE, for editing. 
  7469.  
  7470.                         :link reftype=launch
  7471.                               object='c:\os2\e.exe'
  7472.                               data='myfile'.
  7473.                         Start Editor
  7474.                         :elink.
  7475.  
  7476.             Restriction: You can only use alpha-numeric characters in the data= 
  7477.             field when using the reftype=launch attribute. 
  7478.  
  7479.     reftype=inform 
  7480.             Causes a message to be sent to the application. The res= attribute 
  7481.             is required and is an integer value that directs the application to 
  7482.             perform some application-specific function. When using this 
  7483.             attribute, do not use :elink..  For example: 
  7484.  
  7485.                         :link reftype=inform res=1000 auto.
  7486.  
  7487.   auto
  7488.   viewport
  7489.   dependent
  7490.   split
  7491.   child
  7492.   group=
  7493.     With the auto attribute, you can define any of the link types described 
  7494.     above, with the exception of a footnote link, as an automatic link. 
  7495.  
  7496.     The automatic-link definition follows a heading definition and is activated 
  7497.     as soon as a reference to the heading definition is made.  The reference 
  7498.     can be made by the user selecting an IPF window entry (for example, the 
  7499.     Contents window), or by a hypertext or hypergraphic link. 
  7500.  
  7501.     Restriction: Linking automatically to an external database is not possible. 
  7502.  
  7503.     Following are the automatic-link actions that can be specified, and the 
  7504.     attributes used: 
  7505.         Open a secondary window when the heading that contains the link is 
  7506.          referred to: 
  7507.  
  7508.                   auto reftype=hd viewport dependent res=
  7509.  
  7510.          Note the inclusion of the dependent attribute. Usually, the 
  7511.          information in an automatic window is dependent on the information in 
  7512.          its secondary window.  Specifying dependent causes an automatic window 
  7513.          to close when the user closes the window of the secondary that 
  7514.          contains the automatic link. 
  7515.  
  7516.         Open secondary windows when the heading of the primary window that 
  7517.          contains the links is referred to: 
  7518.  
  7519.                   auto reftype=hd split res=
  7520.  
  7521.          Restriction: The primary heading cannot contain text or graphics; only 
  7522.          links to its secondary headings.  For more information, see Split 
  7523.          Windows. 
  7524.  
  7525.         Start a Presentation Manager program when the heading that contains 
  7526.          the link is referred to: 
  7527.  
  7528.                   auto reftype=launch object= data=
  7529.  
  7530.         Send the application a message when the heading that contains the link 
  7531.          is referred to: 
  7532.  
  7533.                   auto reftype=inform res=
  7534.  
  7535.     To display more than one window on the screen, you must assign a unique 
  7536.     group number to each window with the group= attribute. This attribute can 
  7537.     be specified with :link. or the heading tag.  For more information about 
  7538.     group numbers, see Displaying Multiple Windows. 
  7539.  
  7540.     The child attribute opens the panel being linked to as a child of the panel 
  7541.     in which th elink is located.  This means: 
  7542.         The child panel is clipped to fit inside the parent paanel and cannot 
  7543.          be moved outside the parent panel. 
  7544.  
  7545.         The child panel is always "on top" of the parent panel and the parent 
  7546.          cannot be moved on top of the child (the parent can still receive 
  7547.          mouse clicks and keystrokes). 
  7548.  
  7549.         The child panel is closed when the parent panel is closed. 
  7550.  
  7551.         The child panel is minimized when the parent panel is minimized and 
  7552.          restored when the parent is restored. 
  7553.  
  7554.         When the child panel is minimized by itself, its minimized icon is 
  7555.          displayed inside the parent panel instead of on the coverpage. 
  7556.  
  7557.     The child attribute opens the help panel as a child. 
  7558.  
  7559.   vpx=
  7560.   vpy=
  7561.   vpcx=
  7562.   vpcy=
  7563.     Define the size and position of the window.  Any values specified by these 
  7564.     attributes override size and position values specified by the attributes in 
  7565.     a heading tag. (See :h1. through :h6.  (Headings) for details about these 
  7566.     attributes.) 
  7567.  
  7568.     Restriction: These attributes are not valid for positioning or sizing a 
  7569.     footnote (:fn) window. 
  7570.  
  7571.   titlebar=yes | sysmenu | minmax | both | none
  7572.   scroll=horizontal | vertical | both | none
  7573.   rules=border | sizeborder | none
  7574.     Define window controls.  Any values specified by these attributes override 
  7575.     window-control values specified by the attributes in a heading tag. (See 
  7576.     :h1. through :h6.  (Headings) for details about these attributes.) 
  7577.  
  7578.  When titlebar=yes is specified, the window displays a titlebar without the 
  7579.  system menu symbol, the hide button, and the maximize button. 
  7580.  
  7581.  
  7582. ΓòÉΓòÉΓòÉ 9.31. :lm.  (Left Margin) ΓòÉΓòÉΓòÉ
  7583.  
  7584. Purpose 
  7585.  
  7586. Sets the left margin of the text. 
  7587.  
  7588. Syntax 
  7589.  
  7590. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7591. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  7592. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7593. Γöé:lm.           ΓöéLeft margin    Γöémargin=        Γöé               Γöé
  7594. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7595.  
  7596. Attributes 
  7597.  
  7598.  margin= 
  7599.     Specifies where the left margin of the text is to begin. To set the margin 
  7600.     for the current line, specify a number greater than the position of the 
  7601.     cursor. For example, to set the left margin to 15, begin the left margin 
  7602.     tag before space 15. Otherwise, the margin becomes effective on the next 
  7603.     line. 
  7604.  
  7605.  Note:  When counting character spaces, you are actually counting average 
  7606.  character widths. 
  7607.  
  7608.  Description 
  7609.  
  7610.  Use the left-margin tag and the right-margin tag (:rm.) to specify the 
  7611.  boundaries of the text in the window. 
  7612.  
  7613.  When the text window is sized, the text area adjusts from the right to fit 
  7614.  within the specified margin boundaries; that is, the right margin adjusts to 
  7615.  the new window size. The left margin remains constant. If the window is sized 
  7616.  smaller than the specified margins, the margins remain the same, and the text 
  7617.  area is reduced to one character space. 
  7618.  
  7619.  You can place multiple margin tags in your file. The margins specified remain 
  7620.  effective until they are reset. If no margin value is specified, the default 
  7621.  is 1. 
  7622.  
  7623.  Conditions 
  7624.  
  7625.  None 
  7626.  
  7627.  Example 
  7628.  
  7629.  This example shows the use of both margin tags. 
  7630.  
  7631.   :p.
  7632.   :rm margin=10.
  7633.   :lm margin=20.This text begins 20 spaces to the
  7634.   right of the left window border and ends 10 spaces to the
  7635.   left of the right window border.
  7636.   All text is aligned as specified
  7637.   by the margin values. :lm margin=5.Here the left margin
  7638.   is changed to 5.  Because this margin tag begins
  7639.   more than 5 spaces on the line, the margin specified
  7640.   becomes effective on the following line, and the text
  7641.   begins 5 spaces from the left window border.
  7642.   The right margin remains unchanged.
  7643.  
  7644.  Output 
  7645.                     This text begins 20 spaces to the right of the left window 
  7646.                     border and ends 10 spaces to the left of the right window 
  7647.                     border. All text is aligned as specified by the margin 
  7648.                     values. Here the left margin is changed to 5.  Because this 
  7649.      margin tag begins more than 5 spaces on the line, the margin specified 
  7650.      becomes effective on the following line, and the text begins 5 spaces from 
  7651.      the left window border. The right margin remains unchanged. 
  7652.  
  7653.  
  7654. ΓòÉΓòÉΓòÉ 9.32. :lp.  (List Part) ΓòÉΓòÉΓòÉ
  7655.  
  7656. Purpose 
  7657.  
  7658. Identifies an explanation within a list. 
  7659.  
  7660. Syntax 
  7661.  
  7662. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7663. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  7664. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7665. Γöé:lp.           ΓöéList part      Γöé               Γöé               Γöé
  7666. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7667.  
  7668. Attributes 
  7669.  
  7670. None 
  7671.  
  7672. Description 
  7673.  
  7674. :lp. can be entered anywhere within the list.  The text following the tag 
  7675. starts at the left margin of the current list item.  It is not numbered or 
  7676. lettered.  Using the list-part tag does not interrupt the sequence of the list. 
  7677.  
  7678. Conditions 
  7679.  
  7680. None 
  7681.  
  7682. Example 
  7683.  
  7684. :p.To remove a diskette:
  7685. :ol.
  7686. :li.Open the drive door.
  7687. :lp.Before removing the diskette, make sure all drive activity
  7688. has stopped.
  7689. :li.Remove the diskette.
  7690. :li.Put the diskette in a safe place.
  7691. :eol.
  7692.  
  7693. Output 
  7694.  
  7695. To remove a diskette: 
  7696.  
  7697.    1. Open the drive door. 
  7698.  
  7699.  Before removing the diskette, make sure all drive activity has stopped. 
  7700.  
  7701.    2. Remove the diskette. 
  7702.  
  7703.    3. Put the diskette in a safe place. 
  7704.  
  7705.  
  7706. ΓòÉΓòÉΓòÉ 9.33. :note.  (Note) ΓòÉΓòÉΓòÉ
  7707.  
  7708. Purpose 
  7709.  
  7710. Starts a note. 
  7711.  
  7712. Syntax 
  7713.  
  7714. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7715. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  7716. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7717. Γöé:note.         ΓöéNote           Γöétext=' '       Γöé               Γöé
  7718. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7719.  
  7720. Attributes 
  7721.  
  7722.  text=' ' 
  7723.     Enables you to change the name of the note. 
  7724.  
  7725.  Description 
  7726.  
  7727.  :note. identifies a single-paragraph note. When the tag is encountered, a 
  7728.  blank line is inserted, and the note starts at the left margin with Note: 
  7729.  followed by two blank spaces. The start of another tag ends the note, so no 
  7730.  end tag is needed. 
  7731.  
  7732.  When the tag is used within a list, the note aligns with the text of the items 
  7733.  within the list. 
  7734.  
  7735.  Use the text=' ' attribute to give the note a specific name. 
  7736.  
  7737.  Conditions 
  7738.  
  7739.  None 
  7740.  
  7741.  Example 1 
  7742.  
  7743.   :note.
  7744.   This text appears within a note.
  7745.   The word :hp2.Note:ehp2. aligns
  7746.   with the text that precedes it.
  7747.  
  7748.  Output 
  7749.  
  7750.  The following output is provided. 
  7751.  
  7752.  Note:  This text appears within a note. The word Note aligns with the text 
  7753.  that precedes it. 
  7754.  
  7755.  Example 2 
  7756.  
  7757.   :note text='Text note:'.
  7758.   The name of this note is :hp2.Text note:ehp2..
  7759.   The name of the note replaces
  7760.   the word :hp2.Note:ehp2..  The name of the note
  7761.   aligns with the text that precedes it.
  7762.  
  7763.  Output 
  7764.  
  7765.  Text note:  The name of this note is Text note. The text for the note replaces 
  7766.  the word Note.  The name of the note aligns with the text that precedes it. 
  7767.  
  7768.  
  7769. ΓòÉΓòÉΓòÉ 9.34. :nt.  (Note) ΓòÉΓòÉΓòÉ
  7770.  
  7771. Purpose 
  7772.  
  7773. Starts a note that can have multiple paragraphs. 
  7774.  
  7775. Syntax 
  7776.  
  7777. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7778. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  7779. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7780. Γöé:nt.           ΓöéNote           Γöétext=' '       Γöé:ent.          Γöé
  7781. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7782.  
  7783. Attributes 
  7784.  
  7785.  text=' ' 
  7786.     Enables you to change the name of the note. 
  7787.  
  7788.  Description 
  7789.  
  7790.  :nt. starts a new paragraph with Note: followed by two blank spaces and the 
  7791.  first line of the text.  The second and succeeding lines of text align with 
  7792.  the first line, to the right of Note:. 
  7793.  
  7794.  Notes can be placed within lists and paragraphs; however, unlike the :note. 
  7795.  tag, :nt. requires an end tag. 
  7796.  
  7797.  You can use the text=' ' attribute to assign a specific name to the note. 
  7798.  
  7799.  Conditions 
  7800.  
  7801.  None 
  7802.  
  7803.  Example 
  7804.  
  7805.   :nt.
  7806.   Use this tag to include paragraphs in a note.
  7807.   You also can use it within paragraphs and lists.
  7808.   :p.End this tag before you begin another
  7809.   note tag.
  7810.   :ent.
  7811.  
  7812.  Output 
  7813.  
  7814.  Note:  Use this tag to include paragraphs in a note. You also can use it 
  7815.         within paragraphs and lists. 
  7816.  
  7817.  End this tag before you begin another note tag. 
  7818.  
  7819.  
  7820. ΓòÉΓòÉΓòÉ 9.35. :ol.  (Ordered List) ΓòÉΓòÉΓòÉ
  7821.  
  7822. Purpose 
  7823.  
  7824. Starts a sequential list of items or steps. 
  7825.  
  7826. Syntax 
  7827.  
  7828. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7829. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  7830. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7831. Γöé:ol.           ΓöéOrdered list   Γöécompact        Γöé:eol.          Γöé
  7832. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7833.  
  7834. Attributes 
  7835.  
  7836.  compact 
  7837.     Causes the list to be formatted without a blank line between each list 
  7838.     item. If you omit compact, a blank line appears between each list item. 
  7839.  
  7840.  Description 
  7841.  
  7842.  :ol. indicates the start of an ordered list. Items in the list are entered 
  7843.  with the list-item tag (:li.). The output is an indented list with each item 
  7844.  numbered. Use the list-part tag (:lp.) for paragraphs within the list. 
  7845.  
  7846.  Ordered lists can be nested or imbedded within other lists. When this is done, 
  7847.  the first list has sequential numbers at the left margin, and the nested list 
  7848.  has sequential letters indented two spaces. After the second list, the 
  7849.  number-letter sequence repeats for each successive ordered list. 
  7850.  
  7851.  Be sure to end each list with the end-list tag. 
  7852.  
  7853.  Example 
  7854.  
  7855.   :p.To remove a diskette:
  7856.   :ol.
  7857.   :li.Open the drive door:
  7858.   :ol compact.
  7859.   :li.Remove two screws.
  7860.   :li.Lift the door.
  7861.   :eol.
  7862.   :li.Remove the diskette.
  7863.   :li.Put the diskette in a safe place.
  7864.   :eol.
  7865.  
  7866.  Output 
  7867.  
  7868.  To remove a diskette: 
  7869.  
  7870.    1. Open the drive door: 
  7871.  
  7872.         a. Remove two screws. 
  7873.         b. Lift the door. 
  7874.  
  7875.    2. Remove the diskette. 
  7876.  
  7877.    3. Put the diskette in a safe place. 
  7878.  
  7879.  
  7880. ΓòÉΓòÉΓòÉ 9.36. :p.  (Paragraph) ΓòÉΓòÉΓòÉ
  7881.  
  7882. Purpose 
  7883.  
  7884. Starts a new paragraph. 
  7885.  
  7886. Syntax 
  7887.  
  7888. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7889. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  7890. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7891. Γöé:p.            ΓöéParagraph      Γöé               Γöé               Γöé
  7892. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7893.  
  7894. Attributes 
  7895.  
  7896. None 
  7897.  
  7898. Description 
  7899.  
  7900. Each paragraph identified by a paragraph tag formats as an unindented block of 
  7901. text. Paragraphs placed within a list align with the text of the list.  When 
  7902. paragraphs are placed within a note, the text of the paragraph aligns with the 
  7903. text of the note. 
  7904.  
  7905. Conditions 
  7906.  
  7907. None 
  7908.  
  7909. Example 
  7910.  
  7911. :p.Paragraph tags cause a blank line before the text.
  7912. When placed within a list or note, the text of the paragraph
  7913. aligns with the text of the list or note.
  7914. :ul.
  7915. :li.Paragraph tags
  7916. :p.Paragraph tags are flexible and can be used
  7917. with most tags.
  7918. :li.Note tags
  7919. :p.Note tags can include paragraphs.
  7920. :eul.
  7921.  
  7922. Output 
  7923.  
  7924. Paragraph tags cause a blank line before the text. When placed within a list or 
  7925. note, the text of the paragraph aligns with the text of the list or note. 
  7926.  
  7927.      Paragraph tags 
  7928.  
  7929.       Paragraph tags are flexible and can be used with most tags. 
  7930.  
  7931.      Note tags 
  7932.  
  7933.       Note tags can include paragraphs. 
  7934.  
  7935.  
  7936. ΓòÉΓòÉΓòÉ 9.37. :parml.  (Parameter List) ΓòÉΓòÉΓòÉ
  7937.  
  7938. Purpose 
  7939.  
  7940. Starts a two-column list of parameter terms and descriptions. 
  7941.  
  7942. Syntax 
  7943.  
  7944. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7945. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  7946. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7947. Γöé:parml.        ΓöéParameter list Γöétsize=         Γöé:eparml.       Γöé
  7948. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7949. Γöé               Γöé               Γöébreak=         Γöé               Γöé
  7950. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7951. Γöé               Γöé               Γöécompact        Γöé               Γöé
  7952. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7953. Γöé:pt.           ΓöéParameter term Γöé               Γöé               Γöé
  7954. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7955. Γöé:pd.           ΓöéParameter      Γöé               Γöé               Γöé
  7956. Γöé               Γöédefinition     Γöé               Γöé               Γöé
  7957. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7958.  
  7959. Attributes 
  7960.  
  7961.  tsize= 
  7962.            Specifies the space allocated for the parameter term. The default is 
  7963.            10 character units. 
  7964.  
  7965.  break=all | fit | none 
  7966.            Controls the formatting of the parameter terms and descriptions: 
  7967.  
  7968.            break=all 
  7969.                    Causes the description to begin on the line below the 
  7970.                    parameter term, next to the space allocated by tsize=. This 
  7971.                    is the default. 
  7972.  
  7973.            break=fit 
  7974.                    Causes the parameter description to begin on the same line 
  7975.                    as the term, if the term has fewer characters than specified 
  7976.                    by tsize=.  If the term has more characters, the description 
  7977.                    begins on the line below the term. 
  7978.  
  7979.            break=none 
  7980.                    Causes the description to begin on the same line as the 
  7981.                    term.  If the term has more characters than specified by 
  7982.                    tsize=, it continues into the description area.  The 
  7983.                    description starts one space after the end of the term. 
  7984.  
  7985.  compact 
  7986.            Causes the list to be formatted without a blank line between each 
  7987.            list item.  If you omit compact, a blank line appears between each 
  7988.            item. 
  7989.  
  7990.  Description 
  7991.  
  7992.  Parameter lists are similar to definition lists; they define terms and 
  7993.  descriptions that format in two columns. The elements of the parameter-list 
  7994.  tag are the parameter-term tag (:pt.) and the parameter-description tag 
  7995.  (:pd.).  The term tag identifies the term, and the definition tag identifies 
  7996.  the description. 
  7997.  
  7998.  Parameter lists can occur anywhere in text; you can nest them within other 
  7999.  lists, and you can nest other lists within parameter lists. 
  8000.  
  8001.  Conditions 
  8002.  
  8003.      Each parameter-term tag requires a parameter-description tag. 
  8004.      Each parameter list requires an end-parameter-list tag. 
  8005.  
  8006.  Example 
  8007.  
  8008.   :parml compact tsize=10 break=none.
  8009.   :pt.Tree
  8010.   :pd.Plant life in forest
  8011.   :pt.Orange
  8012.   :pd.Fruit on tree
  8013.   :pt.Cow
  8014.   :pd.Animal on farm
  8015.   :eparml.
  8016.  
  8017.  Output 
  8018.  
  8019.  Tree      Plant life in forest 
  8020.  Orange    Fruit on tree 
  8021.  Cow       Animal on farm 
  8022.  
  8023.  
  8024. ΓòÉΓòÉΓòÉ 9.38. :pbutton. (Push Button) ΓòÉΓòÉΓòÉ
  8025.  
  8026. Purpose 
  8027.  
  8028. Defines author-defined push buttons. 
  8029.  
  8030. Syntax 
  8031.  
  8032. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8033. ΓöéTags           ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  8034. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8035. Γöé:pbutton.      ΓöéAuthor-defined Γöéid=            Γöé               Γöé
  8036. Γöé               Γöépush buttons   Γöéres=           Γöé               Γöé
  8037. Γöé               Γöé               Γöétext=' '       Γöé               Γöé
  8038. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8039.  
  8040. Attributes 
  8041.  
  8042.  id= 
  8043.     Specifies the identification value for a push button that you define.  The 
  8044.     identification value can be alpha or alphanumeric.  This identification 
  8045.     value is referenced by the control area tag (:ctrl.). 
  8046.  
  8047.  res= 
  8048.     Specifies the resource identification value for a push button that you 
  8049.     define.  This value is returned with the HM_NOTIFY and HM_CONTROL messages 
  8050.     and can be any integer greater than 256 (0 to 256 are reserved for use by 
  8051.     IPF). 
  8052.  
  8053.  text= ' ' 
  8054.     Specifies the text for the push button that you define. Define the mnemonic 
  8055.     for the push button by placing the tilde (~) character before the mnemonic 
  8056.     character.  For example: 
  8057.  
  8058.          :pbutton id=xmp res=300 text='~Example'.
  8059.  
  8060.     Note:  Make sure the mnemonic you specify for author-defined push buttons 
  8061.     does not conflict with the mnemonics of the predefined set of push buttons, 
  8062.     or with any of IPF's shortcut keys. See :ctrl.  (Control Area) for a 
  8063.     description of the control area tag (:ctrl.) and a list of the predefined 
  8064.     push buttons and their associated mnemonics. 
  8065.  
  8066.  Description 
  8067.  
  8068.  Use the push button tag (:pbutton.) to define author-defined push buttons. 
  8069.  For more information, see Author-Defined Push Buttons. 
  8070.  
  8071.  
  8072. ΓòÉΓòÉΓòÉ 9.39. :pd.  (Parameter Description) ΓòÉΓòÉΓòÉ
  8073.  
  8074. Purpose 
  8075.  
  8076. Starts the description for a parameter term in a parameter list. 
  8077.  
  8078. Syntax 
  8079.  
  8080. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8081. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  8082. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8083. Γöé:pd.           ΓöéParameter      Γöé               Γöé               Γöé
  8084. Γöé               Γöédescription    Γöé               Γöé               Γöé
  8085. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8086.  
  8087. Attributes 
  8088.  
  8089. None 
  8090.  
  8091. Description 
  8092.  
  8093. The text that follows :pd. describes the term identified by :pt..  The 
  8094. description formats in the right column, as defined by the values of tsize= and 
  8095. break=. For a description of :parml., see :parml.  (Parameter List). 
  8096.  
  8097. A parameter list can have multiple parameter-term and parameter-description 
  8098. tags; however, each term tag requires a description tag. 
  8099.  
  8100. Conditions 
  8101.  
  8102.      The parameter-description tag follows the parameter-term tag. 
  8103.      The parameter-description tag is valid only within a parameter list. 
  8104.  
  8105.  Example 
  8106.  
  8107.   :parml compact tsize=15 break=all.
  8108.   :pt.Tree
  8109.   :pd.Plant life in forest
  8110.   :pt.Orange
  8111.   :pd.Fruit on tree
  8112.   :pt.Cow
  8113.   :pd.Animal on farm
  8114.   :eparml.
  8115.  
  8116.  Output 
  8117.  
  8118.  Tree 
  8119.                 Plant life in forest 
  8120.  Orange 
  8121.                 Fruit on tree 
  8122.  Cow 
  8123.                 Animal on farm 
  8124.  
  8125.  
  8126. ΓòÉΓòÉΓòÉ 9.40. :pt.  (Parameter Term) ΓòÉΓòÉΓòÉ
  8127.  
  8128. Purpose 
  8129.  
  8130. Identifies a term in a parameter list. 
  8131.  
  8132. Syntax 
  8133.  
  8134. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8135. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  8136. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8137. Γöé:pt.           ΓöéParameter      Γöé               Γöé               Γöé
  8138. Γöé               Γöédescription    Γöé               Γöé               Γöé
  8139. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8140.  
  8141. Attributes 
  8142.  
  8143. None 
  8144.  
  8145. Description 
  8146.  
  8147. The term identified by :pt. formats in the left column.  The :pt. tag requires 
  8148. a parameter-description tag (:pd.); the description formats in the right 
  8149. column. 
  8150.  
  8151. Conditions 
  8152.  
  8153.      The parameter-term tag requires a parameter-description tag. 
  8154.      The parameter-term tag precedes the parameter-description tag. 
  8155.      The parameter-term tag is valid only within a parameter list (for a 
  8156.       description of :parml., see :parml.  (Parameter List)). 
  8157.  
  8158.  Example 
  8159.  
  8160.   :parml compact tsize=15 break=all.
  8161.   :pt.Tree
  8162.   :pd.Plant life in forest
  8163.   :pt.Orange
  8164.   :pd.Fruit on tree
  8165.   :pt.Cow
  8166.   :pd.Animal on farm
  8167.   :eparml.
  8168.  
  8169.  Output 
  8170.  
  8171.  Tree 
  8172.                 Plant life in forest 
  8173.  Orange 
  8174.                 Fruit on tree 
  8175.  Cow 
  8176.                 Animal on farm 
  8177.  
  8178.  
  8179. ΓòÉΓòÉΓòÉ 9.41. :rm.  (Right Margin) ΓòÉΓòÉΓòÉ
  8180.  
  8181. Purpose 
  8182.  
  8183. Sets the right margin of the text. 
  8184.  
  8185. Syntax 
  8186.  
  8187. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8188. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  8189. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8190. Γöé:rm.           ΓöéRight margin   Γöémargin=        Γöé               Γöé
  8191. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8192.  
  8193. Attributes 
  8194.  
  8195.  margin= 
  8196.     Enables you to indicate the number of character spaces from the right 
  8197.     border of the window the text is to end. For example, margin=60 means that 
  8198.     the text is to end 60 spaces from the right border. 
  8199.  
  8200.     Note:  When counting character spaces, you are actually counting average 
  8201.     character widths. 
  8202.  
  8203.  Description 
  8204.  
  8205.  Use :rm. with the left-margin tag (:lm.) to specify the boundaries of the text 
  8206.  in the window. The left-margin tag specifies where the text is to start, and 
  8207.  the right-margin tag specifies where it is to end. 
  8208.  
  8209.  You can enter margin tags at the beginning of the line of text or while you 
  8210.  are entering the text. Margin tags that begin the line of text cause text on 
  8211.  that line and the following lines to align with the values specified. Margins 
  8212.  set while you enter text become effective on the current line or on the next 
  8213.  line, depending on where the margin tag begins. For example, to set the right 
  8214.  margin to 60 (that is, 60 spaces before the right border of the window), begin 
  8215.  the right-margin tag at least 60 spaces to the left of the right border. When 
  8216.  the file is displayed, the text entered after the margin tag aligns to the 
  8217.  value specified on that line. 
  8218.  
  8219.  If the margin tag is started after the specified boundary, the margin becomes 
  8220.  effective on the next line. 
  8221.  
  8222.  When the text window is sized, the text area adjusts from the right to fit 
  8223.  within the specified margin boundaries; that is, the right margin adjusts to 
  8224.  the window size. The left margin stays the same. If the window is sized 
  8225.  smaller than the specified margins, the margins remain the same, and the text 
  8226.  area is reduced to one character space. If no value is specified for margin=, 
  8227.  the default for the right margin is 1. 
  8228.  
  8229.  You can place multiple margin tags in your file. The specified margins remain 
  8230.  effective until they are reset. 
  8231.  
  8232.  Example 
  8233.  
  8234.   :lm margin=1.
  8235.   :rm margin=44.
  8236.   :p.In this example, the left margin is 1.  The right
  8237.   margin is 44.  The margins are set before the text;
  8238.   therefore, when the file is displayed, the text
  8239.   formats according to the margins set.
  8240.   The text begins at space 2 and ends 44 spaces before
  8241.   the right window border.  If the margin specified is
  8242.   less than the current cursor position on the screen,
  8243.   the margins set become effective on the following
  8244.   line.  For example, if the current cursor position is
  8245.   60 spaces to the left of the right window border and
  8246.   you set the right margin to 50, the margin is
  8247.   effective on the current line.  However, if the right
  8248.   margin is set to 65, the margin becomes effective
  8249.   on the next line.
  8250.   :p.
  8251.   :lm margin=5.
  8252.   :rm margin=60.Here the left margin is set to 5
  8253.   and the right margin is set to 60.  This means that
  8254.   the left margin begins 5 spaces to the right of the
  8255.   left border.  The right margin ends 60 spaces to the
  8256.   left of the right border.
  8257.  
  8258.  Output 
  8259.  
  8260.   In this example, the left margin is 1.  The right
  8261.   margin is 44.  The margins are set before the
  8262.   text; therefore, when the file is displayed, the text
  8263.   formats according to the margins set.  The text
  8264.   begins at space 2 and ends 44 spaces before the
  8265.   right window border.  If the margin specified is
  8266.   less than the current cursor position on the
  8267.   screen, the margins set become effective on the
  8268.   following line.  For example, if the current cursor
  8269.   position is 60 spaces to the left of the right
  8270.   window border and you set the right margin to 50,
  8271.   the margin is effective on the current line.
  8272.   However, if the right margin is set to 65, the
  8273.   margin becomes effective on the next line.
  8274.  
  8275.  
  8276.      Here the left margin is set to 5
  8277.      and the right margin is set to
  8278.      60.  This means that the left
  8279.      margin begins 5 spaces to the
  8280.      right of the left border.  The
  8281.      right margin ends 60 spaces to
  8282.      the left of the right border.
  8283.  
  8284.  
  8285. ΓòÉΓòÉΓòÉ 9.42. :sl.   (Simple List) ΓòÉΓòÉΓòÉ
  8286.  
  8287. Purpose 
  8288.  
  8289. Starts a nonsequential list of items. 
  8290.  
  8291. Syntax 
  8292.  
  8293. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8294. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  8295. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8296. Γöé:sl.           ΓöéSimple list    Γöécompact        Γöé:esl.          Γöé
  8297. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8298.  
  8299. Attributes 
  8300.  
  8301.  compact 
  8302.     Causes the list to be formatted without a blank line between each list 
  8303.     item. If you omit compact, a blank line appears between each item. 
  8304.  
  8305.  Description 
  8306.  
  8307.  :sl. identifies items that do not require a sequential listing.  Items in a 
  8308.  simple list are not indented and do not have bullets, hyphens, or dashes 
  8309.  preceding them.  Simple lists can be nested within other lists.  When nested, 
  8310.  a simple list is indented four spaces to the right of the left margin of the 
  8311.  list that contains it.  Each list requires an end-list tag. 
  8312.  
  8313.  The simple-list tag requires the list-item tag (:li.) to identify items in the 
  8314.  list. You can use the list-part tag (:lp.) to include paragraphs in the list. 
  8315.  
  8316.  Conditions 
  8317.  
  8318.  None 
  8319.  
  8320.  Example 
  8321.  
  8322.   :p.Bring the following for lunch:
  8323.   :sl.
  8324.   :li.Fruit, for example:
  8325.   :sl compact.
  8326.   :li.An apple
  8327.   :li.An orange
  8328.   :li.A pear
  8329.   :li.A banana
  8330.   :esl.
  8331.   :li.Sandwich
  8332.   :li.A drink, for example:
  8333.   :sl compact.
  8334.   :li.A soda
  8335.   :li.Juice
  8336.   :li.Milk.
  8337.   :esl.
  8338.   :esl.
  8339.  
  8340.  Output 
  8341.  
  8342.  Bring the following for lunch: 
  8343.  
  8344.       Fruit, for example: 
  8345.  
  8346.            An apple 
  8347.            An orange 
  8348.            A pear 
  8349.            A banana 
  8350.  
  8351.       Sandwich 
  8352.  
  8353.       A drink, for example: 
  8354.  
  8355.            A soda 
  8356.            Juice 
  8357.            Milk. 
  8358.  
  8359.  
  8360. ΓòÉΓòÉΓòÉ 9.43. :table.  (Table) ΓòÉΓòÉΓòÉ
  8361.  
  8362. Purpose 
  8363.  
  8364. Formats information as a table. 
  8365.  
  8366. Syntax 
  8367.  
  8368. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8369. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  8370. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8371. Γöé:table.        ΓöéTables         Γöécols=' '       Γöé:etable.       Γöé
  8372. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8373. Γöé               Γöé               Γöérules=         Γöé               Γöé
  8374. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8375. Γöé               Γöé               Γöéframe=         Γöé               Γöé
  8376. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8377. Γöé:row.          ΓöéRows           ΓöéNone           ΓöéNone           Γöé
  8378. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8379. Γöé:c.            ΓöéColumns        ΓöéNone           ΓöéNone           Γöé
  8380. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8381.  
  8382. Attributes 
  8383.  
  8384.  cols=' ' 
  8385.     Specifies the width, in character spaces, of each column; for example: 
  8386.     cols='10 15 20'. 
  8387.  
  8388.  rules= 
  8389.     Specifies whether the table will have horizontal and vertical rules. 
  8390.     Following are the possible values and meanings: 
  8391.  
  8392.     both           Horizontal and vertical rules 
  8393.     horiz          Horizontal rules only 
  8394.     vert           Vertical rules only 
  8395.     none           No rules 
  8396.  
  8397.     Note:  The default is both. 
  8398.  
  8399.  frame= 
  8400.     Specifies whether the table will have borders. Following are the possible 
  8401.     values and meanings: 
  8402.  
  8403.     rules          A horizontal line at the top and bottom of the table 
  8404.     box            A box around the table 
  8405.     none           No borders. 
  8406.  
  8407.     Note:  The default is box. 
  8408.  
  8409.  The :row. tag specifies the start of each row in the table. The :c. tag 
  8410.  specifies the text for each column entry in the table. The text provided with 
  8411.  the :c. tag is formatted within the column.  However, if a single word is 
  8412.  longer than the specified width of the column, the word will be clipped. 
  8413.  
  8414.  Example 
  8415.  
  8416.  The following defines a table with three columns and two rows. The width of 
  8417.  each column is 15, 20, and 25 character spaces. 
  8418.  
  8419.   :table cols='15 20 25' rules=both frame=box.
  8420.   :row.
  8421.   :c.Row 1 Col 1
  8422.   :c.Row 1 Col 2
  8423.   :c.Row 1 Col 3
  8424.   :row.
  8425.   :c.Row 2 Col 1
  8426.   :c.Row 2 Col 2
  8427.   :c.Row 2 Col 3
  8428.   :etable.
  8429.  
  8430.  Output 
  8431.  
  8432.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8433.   ΓöéRow 1 Col 1    ΓöéRow 1 Col 2         ΓöéRow 1 Col 3              Γöé
  8434.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8435.   ΓöéRow 2 Col 1    ΓöéRow 2 Col 2         ΓöéRow 2 Col 3              Γöé
  8436.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8437.  
  8438.  
  8439. ΓòÉΓòÉΓòÉ 9.44. :title.  (Title) ΓòÉΓòÉΓòÉ
  8440.  
  8441. Purpose 
  8442.  
  8443. Provides a name for the online document. 
  8444.  
  8445. Syntax 
  8446.  
  8447. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8448. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  8449. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8450. Γöé:title.        ΓöéTitle          Γöé               Γöé               Γöé
  8451. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8452.  
  8453. Attributes 
  8454.  
  8455. None 
  8456.  
  8457. Description 
  8458.  
  8459. The text that follows :title. provides a name for the online document. The 
  8460. title of an online document can contain up to 47 characters, including spaces 
  8461. and blanks. If the title exceeds 47 characters, the IPF Compiler displays an 
  8462. error message. 
  8463.  
  8464. When you display the online document, the title appears on the title line of 
  8465. the main window. The title is limited to one line. Word wrapping does not occur 
  8466. in the title of an online document. 
  8467.  
  8468. Conditions 
  8469.  
  8470. Use the :title. tag only for the title of an online document.  Do not use it 
  8471. for online help windows. 
  8472.  
  8473. Example 
  8474.  
  8475. :userdoc.
  8476. :title.Using the Information Presentation Facility
  8477. :h1 res=100.Creating an Index
  8478. :p.This section shows you how to create index entries.
  8479. :euserdoc.
  8480.  
  8481. Output 
  8482.  
  8483. When you compile this file, "Using the Information Presentation Facility" is 
  8484. displayed on the title line of the main window of the online document. 
  8485.  
  8486. "Creating an Index" is listed as an entry in the contents window. If you select 
  8487. "Creating an Index," the window with this heading and the accompanying text is 
  8488. displayed in the text information area, overlaying the contents window. 
  8489.  
  8490.  
  8491. ΓòÉΓòÉΓòÉ 9.45. :ul.  (Unordered List) ΓòÉΓòÉΓòÉ
  8492.  
  8493. Purpose 
  8494.  
  8495. Starts a list of nonsequential items. 
  8496.  
  8497. Syntax 
  8498.  
  8499. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8500. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  8501. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8502. Γöé:ul.           ΓöéUnordered list ΓöéCompact        Γöé:eul.          Γöé
  8503. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8504.  
  8505. Attributes 
  8506.  
  8507.  compact 
  8508.     Causes the list to be formatted without a blank line between each list 
  8509.     item. If you omit compact, a blank line appears between each item. 
  8510.  
  8511.  Description 
  8512.  
  8513.  :ul. indicates the start of a list of items that do not require sequential 
  8514.  listing. The list-item tag (:li.) identifies the items within the list. The 
  8515.  list-part tag (:lp.) is used to include paragraphs within the list. 
  8516.  
  8517.  Unordered list items are indented, and a bullet (lowercase "o") precedes each 
  8518.  item. Unordered lists can be nested within other lists. If placed within an 
  8519.  ordered list or a simple list, the nested list will be indented four spaces, 
  8520.  and each item will be preceded by a bullet. If placed within another unordered 
  8521.  list, the nested list will be indented four spaces, and each item will be 
  8522.  preceded by a dash. 
  8523.  
  8524.  Conditions 
  8525.  
  8526.  None 
  8527.  
  8528.  Example 
  8529.  
  8530.   :p.Before leaving for the day, remember to:
  8531.   :ul.
  8532.   :li.Turn off the computer.
  8533.   :li.Turn off the lights:
  8534.   :ul compact.
  8535.   :li.Ceiling
  8536.   :li.Desk
  8537.   :eul.
  8538.   :li.Secure all equipment.
  8539.   :eul.
  8540.  
  8541.  Output 
  8542.  
  8543.  Before leaving for the day, remember to: 
  8544.  
  8545.      Turn off the computer. 
  8546.  
  8547.      Turn off the lights: 
  8548.  
  8549.         -  Ceiling 
  8550.         -  Desk 
  8551.  
  8552.      Secure all equipment. 
  8553.  
  8554.  
  8555. ΓòÉΓòÉΓòÉ 9.46. :userdoc.  (User Document) ΓòÉΓòÉΓòÉ
  8556.  
  8557. Purpose 
  8558.  
  8559. Identifies the source file that is to be compiled. 
  8560.  
  8561. Syntax 
  8562.  
  8563. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8564. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  8565. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8566. Γöé:userdoc.      ΓöéUser document  Γöé               Γöé:euserdoc.     Γöé
  8567. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8568.  
  8569. Attributes 
  8570.  
  8571. None 
  8572.  
  8573. Description 
  8574.  
  8575. :userdoc. must be the first tag in the source file. It signals the compiler to 
  8576. begin compiling the tagged text that follows. All other tags that define how 
  8577. the text is to be formatted follow this tag. 
  8578.  
  8579. The end-user-document tag (:euserdoc.) identifies the end of the tagged text 
  8580. and the end of the source file. It must be the last tag in the source file. 
  8581.  
  8582. Conditions 
  8583.  
  8584. None 
  8585.  
  8586. Example 
  8587.  
  8588. :userdoc.
  8589. .
  8590. .
  8591. .
  8592. :euserdoc.
  8593.  
  8594.  
  8595. ΓòÉΓòÉΓòÉ 9.47. :warning.  (Warning) ΓòÉΓòÉΓòÉ
  8596.  
  8597. Purpose 
  8598.  
  8599. Alerts the user of a risk or possible error condition. 
  8600.  
  8601. Syntax 
  8602.  
  8603. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8604. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  8605. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8606. Γöé:warning.      ΓöéWarning        Γöétext=' '       Γöé:ewarning.     Γöé
  8607. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8608.  
  8609. Attributes 
  8610.  
  8611.  text=' ' 
  8612.     Enables you to give a specific name to the warning notice. 
  8613.  
  8614.  Description 
  8615.  
  8616.  A warning notice alerts the user to a possible risk, such as an error 
  8617.  condition in the system. It should appear before the text that it discusses. 
  8618.  Use the text=' ' attribute to provide a specific name for the warning notice. 
  8619.  
  8620.  Conditions 
  8621.  
  8622.  None 
  8623.  
  8624.  Example 1 
  8625.  
  8626.   :warning.
  8627.   The disk contains bad sectors.
  8628.   :ewarning.
  8629.  
  8630.  Output 
  8631.  
  8632.  The following output is provided. 
  8633.  
  8634.  Warning: The disk contains bad sectors. 
  8635.  
  8636.  Example 2 
  8637.  
  8638.   :warning text='Bad disk:'.
  8639.   The disk contains bad sectors.
  8640.   :ewarning.
  8641.  
  8642.  Output 
  8643.  
  8644.  Bad disk  The disk contains bad sectors. 
  8645.  
  8646.  
  8647. ΓòÉΓòÉΓòÉ 9.48. :xmp. (Example) ΓòÉΓòÉΓòÉ
  8648.  
  8649. Purpose 
  8650.  
  8651. Turns formatting off. 
  8652.  
  8653. Syntax 
  8654.  
  8655. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8656. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  8657. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8658. Γöé:xmp.          ΓöéExample        Γöé               Γöé:exmp.         Γöé
  8659. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8660.  
  8661. Attributes 
  8662.  
  8663. None 
  8664.  
  8665. Description 
  8666.  
  8667. Text entered between :xmp. and :exmp. is formatted as entered, in a monospace 
  8668. font. The text is indented two spaces from the left margin of the window. Lines 
  8669. that are too long to fit within the window are clipped. 
  8670.  
  8671. Conditions 
  8672.  
  8673.      An example cannot be placed within another example. 
  8674.      An end-example tag is required. 
  8675.  
  8676.  Example 
  8677.  
  8678.   :xmp.
  8679.    #define INCL_WIN
  8680.    #include <os2.h>
  8681.  
  8682.    MRESULT EXPENTRY MyObject(PACVP pACVP, PCH ObjectInfo)
  8683.    {
  8684.  
  8685.    HWND hwndMyACVP;            /* Handle to the application-controlled */
  8686.                                /* window that this procedure creates   */
  8687.         .
  8688.         .
  8689.         .
  8690.    }
  8691.   :exmp.
  8692.  
  8693.  Output 
  8694.  
  8695.    #define INCL_WIN
  8696.    #include <os2.h>
  8697.  
  8698.    MRESULT EXPENTRY MyObject(PACVP pACVP, PCH ObjectInfo)
  8699.    {
  8700.  
  8701.    HWND hwndMyACVP;            /* Handle to the application-controlled */
  8702.                                /* window that this procedure creates   */
  8703.         .
  8704.         .
  8705.         .
  8706.    }
  8707.  
  8708.  
  8709. ΓòÉΓòÉΓòÉ 10. Symbols ΓòÉΓòÉΓòÉ
  8710.  
  8711. This chapter discusses the symbols you can use to display special characters 
  8712. that you may want to include in your file.  Symbols can be used to specify 
  8713. characters that are not on the keyboard.  Each symbol represents a single 
  8714. character. When tagging your file to include symbols, begin each symbol with an 
  8715. ampersand (&) and end the symbol with a period (.). For example, to place a 
  8716. square bullet (Γûá) in a file, you would enter: 
  8717.  
  8718. &sqbul.
  8719.  
  8720. Symbols are case sensitive; that is, uppercase characters produce different 
  8721. symbols than lowercase characters.  Therefore, when tagging the file to include 
  8722. a symbol, enter the tag for the symbol exactly as it is shown in the symbols 
  8723. table. 
  8724.  
  8725. Note:  All symbols in the following table are also in the APSYMBOL.APS file. 
  8726. This file is in the \TOOLKIT\IPFC directory and can be edited with any text 
  8727. editor; however, some National Language code pages require a different symbols 
  8728. file. See National Language Support (NLS), for a list of these files. 
  8729.  
  8730. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8731. ΓöéSymbol              ΓöéSymbol Name         ΓöéCharacter           Γöé
  8732. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8733. Γöé&aa.                Γöéa acute             Γöé╨░                   Γöé
  8734. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8735. Γöé&ac.                Γöéa circumflex        Γöé╨ô                   Γöé
  8736. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8737. Γöé&ae.                Γöéa umlaut            Γöé╨ö                   Γöé
  8738. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8739. Γöé&Ae.                ΓöéA umlaut            Γöé╨₧                   Γöé
  8740. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8741. Γöé&ag.                Γöéa grave             Γöé╨ò                   Γöé
  8742. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8743. Γöéæ.             Γöéae ligature         Γöé╨í                   Γöé
  8744. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8745. ΓöéÆ.             ΓöéAE ligature         Γöé╨ó                   Γöé
  8746. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8747. Γöé&Alpha.             ΓöéAlpha               ΓöéA                   Γöé
  8748. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8749. Γöé&.               Γöéampersand           Γöé&                   Γöé
  8750. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8751. Γöé&and.               Γöéand                 Γöé^                   Γöé
  8752. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8753. Γöé&angstrom.          Γöéangstrom            Γöé╨ƒ                   Γöé
  8754. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8755. Γöé&ao.                Γöéa overcircle        Γöé╨û                   Γöé
  8756. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8757. Γöé&Ao.                ΓöéA overcircle        Γöé╨ƒ                   Γöé
  8758. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8759. Γöé&apos.              Γöéapostrophe          Γöé'                   Γöé
  8760. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8761. Γöé&bx2022.            ΓöéASCII code 185      ΓöéΓòú                   Γöé
  8762. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8763. Γöé&bx2020.            ΓöéASCII code 186      ΓöéΓòæ                   Γöé
  8764. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8765. Γöé&bx0022.            ΓöéASCII code 187      ΓöéΓòù                   Γöé
  8766. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8767. Γöé&bx2002.            ΓöéASCII code 188      ΓöéΓò¥                   Γöé
  8768. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8769. Γöé&bx2200.            ΓöéASCII code 200      ΓöéΓòÜ                   Γöé
  8770. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8771. Γöé&bx0220.            ΓöéASCII code 201      ΓöéΓòö                   Γöé
  8772. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8773. Γöé&bx2202.            ΓöéASCII code 202      ΓöéΓò⌐                   Γöé
  8774. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8775. Γöé&bx0222.            ΓöéASCII code 203      ΓöéΓòª                   Γöé
  8776. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8777. Γöé&bx2220.            ΓöéASCII code 204      ΓöéΓòá                   Γöé
  8778. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8779. Γöé&bx0202.            ΓöéASCII code 205      ΓöéΓòÉ                   Γöé
  8780. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8781. Γöé&bx2222.            ΓöéASCII code 206      ΓöéΓò¼                   Γöé
  8782. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8783. Γöé&asterisk.          Γöéasterisk            Γöé*                   Γöé
  8784. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8785. Γöé&atsign.            Γöéat sign             Γöé@                   Γöé
  8786. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8787. Γöé&bslash., &bsl.     Γöéback slash          Γöé\                   Γöé
  8788. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8789. Γöé&Beta.              ΓöéBeta                Γöé╤ü                   Γöé
  8790. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8791. Γöé&bxas., &bxbj.      Γöébox ascender        ΓöéΓö┤                   Γöé
  8792. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8793. Γöé&bxcr., &bxcj.      Γöébox cross           ΓöéΓö╝                   Γöé
  8794. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8795. Γöé&bxde., &bxtj.      Γöébox descender       ΓöéΓö¼                   Γöé
  8796. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8797. Γöé&bxh.               Γöébox horizontal      ΓöéΓöÇ                   Γöé
  8798. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8799. Γöé&bxle., &bxlj.      Γöébox left junction   ΓöéΓö£                   Γöé
  8800. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8801. Γöé&bxll.              Γöébox lower-left      ΓöéΓöö                   Γöé
  8802. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8803. Γöé&bxlr.              Γöébox lower-right     ΓöéΓöÿ                   Γöé
  8804. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8805. Γöé&bxri., &bxrj.      Γöébox right junction  ΓöéΓöñ                   Γöé
  8806. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8807. Γöé&bxul.              Γöébox upper-left      ΓöéΓöî                   Γöé
  8808. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8809. Γöé&bxur.              Γöébox upper-right     ΓöéΓöÉ                   Γöé
  8810. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8811. Γöé&bxv.               Γöébox vertical        ΓöéΓöé                   Γöé
  8812. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8813. Γöé&cc.                Γöéc cedilla           Γöé╨ù                   Γöé
  8814. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8815. Γöé&Cc.                ΓöéC cedilla           Γöé╨É                   Γöé
  8816. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8817. Γöé&caret.             Γöécaret symbol        Γöé^                   Γöé
  8818. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8819. Γöé&cdq.               Γöéclose double quote  Γöé"                   Γöé
  8820. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8821. Γöé&cdqf.              Γöéclose French double Γöé╨┐                   Γöé
  8822. Γöé                    Γöéquote               Γöé                    Γöé
  8823. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8824. Γöé&csq.               Γöéclose single quote  Γöé'                   Γöé
  8825. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8826. Γöé&comma.             Γöécomma               Γöé,                   Γöé
  8827. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8828. Γöé&colon.             Γöécolon               Γöé:                   Γöé
  8829. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8830. Γöé&dash.              Γöédash                Γöé-                   Γöé
  8831. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8832. Γöé°ree., °.     Γöédegree              Γöé┬░                   Γöé
  8833. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8834. Γöé÷             Γöédivide              Γöé╨Ä                   Γöé
  8835. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8836. Γöé&dollar.            Γöédollar sign         Γöé$                   Γöé
  8837. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8838. Γöé&dot.               Γöédot                 Γöé┬╖                   Γöé
  8839. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8840. Γöé&darrow.            Γöédown arrow          Γöé                   Γöé
  8841. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8842. Γöé&ea.                Γöée acute             Γöé╨Æ                   Γöé
  8843. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8844. Γöé&Ea                 ΓöéE acute             Γöé╨á                   Γöé
  8845. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8846. Γöé&ec.                Γöée circumflex        Γöé╨ÿ                   Γöé
  8847. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8848. Γöé&ee.                Γöée umlaut            Γöé╨Ö                   Γöé
  8849. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8850. Γöé&eg.                Γöée grave             Γöé╨Ü                   Γöé
  8851. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8852. Γöé&emdash.            Γöéem dash             Γöé-                   Γöé
  8853. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8854. Γöé&endash.            Γöéen dash             Γöé-                   Γöé
  8855. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8856. Γöé&eq., &equals.,     Γöéequal sign          Γöé=                   Γöé
  8857. Γöé&eqsym.             Γöé                    Γöé                    Γöé
  8858. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8859. Γöé&xclm., &xclam.     Γöéexclamation point   Γöé!                   Γöé
  8860. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8861. Γöé&fnof.              Γöéfunction of         Γöé╨»                   Γöé
  8862. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8863. Γöé>sym., >.       Γöégreater than        Γöé>                   Γöé
  8864. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8865. Γöé&house.             Γöéhouse               Γöé                   Γöé
  8866. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8867. Γöé&hyphen.            Γöéhyphen              Γöé-                   Γöé
  8868. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8869. Γöé&ia.                Γöéi acute             Γöé╨▒                   Γöé
  8870. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8871. Γöé&ic.                Γöéi circumflex        Γöé╨£                   Γöé
  8872. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8873. Γöé&ie.                Γöéi umlaut            Γöé╨¢                   Γöé
  8874. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8875. Γöé&ig.                Γöéi grave             Γöé╨¥                   Γöé
  8876. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8877. Γöé&inve.              Γöéinverted exclamationΓöé╨╜                   Γöé
  8878. Γöé                    Γöémark                Γöé                    Γöé
  8879. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8880. Γöé&invq.              Γöéinverted question   Γöé╨╕                   Γöé
  8881. Γöé                    Γöémark                Γöé                    Γöé
  8882. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8883. Γöé&larrow.            Γöéleft arrow          Γöé                   Γöé
  8884. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8885. Γöé&lahead.            Γöéleft arrowhead      Γöé                   Γöé
  8886. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8887. Γöé&lbrace., &lbrc.    Γöéleft brace          Γöé{                   Γöé
  8888. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8889. Γöé&lbracket. &lbrk.   Γöéleft bracket        Γöé[                   Γöé
  8890. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8891. Γöé&lpar. , &lparen.   Γöéleft parenthesis    Γöé(                   Γöé
  8892. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8893. Γöé&lnot.              Γöélogical not         Γöé╨║                   Γöé
  8894. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8895. Γöé&mdash.             Γöéem dash             Γöé-                   Γöé
  8896. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8897. Γöé&minus.             Γöéminus sign          Γöé-                   Γöé
  8898. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8899. Γöé&mu.                Γöému                  Γöé╤å                   Γöé
  8900. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8901. Γöé&ndash.             Γöéen dash             Γöé-                   Γöé
  8902. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8903. Γöé&nt.                Γöén tilde             Γöé╨┤                   Γöé
  8904. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8905. Γöé&Nt.                ΓöéN tilde             Γöé╨╡                   Γöé
  8906. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8907. Γöé&lnot., ¬sym.    Γöénot symbol          Γöé╨║                   Γöé
  8908. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8909. Γöé&numsign.           Γöénumber sign         Γöé#                   Γöé
  8910. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8911. Γöé&oa.                Γöéo acute             Γöé╨▓                   Γöé
  8912. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8913. Γöé&oc.                Γöéo circumflex        Γöé╨ú                   Γöé
  8914. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8915. Γöé&og.                Γöéo grave             Γöé╨Ñ                   Γöé
  8916. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8917. Γöé&oe.                Γöéo umlaut            Γöé╨ñ                   Γöé
  8918. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8919. Γöé&Oe.                ΓöéO umlaut            Γöé╨⌐                   Γöé
  8920. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8921. Γöé¼.            Γöéone fourth          Γöé╨╝                   Γöé
  8922. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8923. Γöé½.            Γöéone half            Γöé╨╗                   Γöé
  8924. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8925. Γöé&odq.               Γöéopen double quote   Γöé"                   Γöé
  8926. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8927. Γöé&odqf.              Γöéopen French double  Γöé╨╛                   Γöé
  8928. Γöé                    Γöéquote               Γöé                    Γöé
  8929. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8930. Γöé&osq.               Γöéopen single quote   Γöé`                   Γöé
  8931. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8932. Γöé&percent.           Γöépercent             Γöé%                   Γöé
  8933. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8934. Γöé&per.               Γöéperiod              Γöé.                   Γöé
  8935. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8936. Γöé&plus.              Γöéplus sign           Γöé+                   Γöé
  8937. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8938. Γöé&plusmin., &pm.     Γöéplusminus           Γöé╤æ                   Γöé
  8939. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8940. Γöé&Lsterling.         Γöépound sterling      Γöé╨¼                   Γöé
  8941. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8942. Γöé&rbl.               Γöérequired blank      Γöé                    Γöé
  8943. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8944. Γöé&rarrow.            Γöéright arrow         Γöé"                   Γöé
  8945. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8946. Γöé&rahead.            Γöéright arrowhead     Γöé"                   Γöé
  8947. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8948. Γöé&rbrace., &rbrc.    Γöéright brace         Γöé}                   Γöé
  8949. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8950. Γöé&rbracket., &rbrk.  Γöéright bracket       Γöé]                   Γöé
  8951. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8952. Γöé&rpar., &rparen.    Γöéright parenthesis   Γöé)                   Γöé
  8953. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8954. Γöé&semi.              Γöésemicolon           Γöé;                   Γöé
  8955. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8956. Γöé&box14.             Γöéshaded box 1/4 dots ΓöéΓûæ                   Γöé
  8957. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8958. Γöé&box12.             Γöéshaded box 1/2 dots ΓöéΓûÆ                   Γöé
  8959. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8960. Γöé&box34.             Γöéshaded box 3/4 dots ΓöéΓûô                   Γöé
  8961. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8962. Γöé&slash., &slr.      Γöéslash               Γöé/                   Γöé
  8963. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8964. Γöé&BOX.               Γöésolid box           ΓöéΓûê                   Γöé
  8965. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8966. Γöé&BOXBOT.            Γöésolid box bottom    ΓöéΓûä                   Γöé
  8967. Γöé                    Γöéhalf                Γöé                    Γöé
  8968. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8969. Γöé&splitvbar.         Γöésplit vertical bar  Γöé|                   Γöé
  8970. Γöé                    Γöé(piping symbol)     Γöé                    Γöé
  8971. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8972. Γöé&sqbul.             Γöésquare bullet       ΓöéΓûá                   Γöé
  8973. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8974. Γöé².              Γöésuperscript 2       Γöé┬ñ                   Γöé
  8975. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8976. Γöé&tilde.             Γöétilde               Γöé~                   Γöé
  8977. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8978. Γöé&ua.                Γöéu acute             Γöé╨│                   Γöé
  8979. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8980. Γöé&uc.                Γöéu circumflex        Γöé╨ª                   Γöé
  8981. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8982. Γöé&ug.                Γöéu grave             Γöé╨º                   Γöé
  8983. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8984. Γöé&ue.                Γöéu umlaut            Γöé╨æ                   Γöé
  8985. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8986. Γöé&Ue.                ΓöéU umlaut            Γöé╨¬                   Γöé
  8987. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8988. Γöé&us.                Γöéunderscore          Γöé_                   Γöé
  8989. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8990. Γöé&aus.               Γöéunderscored a       Γöé╨╢                   Γöé
  8991. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8992. Γöé&ous.               Γöéunderscored o       Γöé╨╖                   Γöé
  8993. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8994. Γöé&ye.                Γöéy umlaut            Γöé╨¿                   Γöé
  8995. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8996.  
  8997. Note:  The left and right arrows appear as left and right arrowheads. The ASCII 
  8998. escape sequences do not permit true left and right arrows. 
  8999.  
  9000.  
  9001. ΓòÉΓòÉΓòÉ 11. Compiler Error Messages ΓòÉΓòÉΓòÉ
  9002.  
  9003. This chapter lists the error messages sent by the IPF compiler. 
  9004.  
  9005.  
  9006. ΓòÉΓòÉΓòÉ 11.1. Description and Format of Error Messages ΓòÉΓòÉΓòÉ
  9007.  
  9008. There are three types of error messages: 
  9009.  
  9010.      Warning Level 1.  They are the most severe. 
  9011.  
  9012.      Warning Level 2.  They are moderately severe. 
  9013.  
  9014.      Warning Level 3.  They are the least severe. 
  9015.  
  9016.  These error messages have the following format. 
  9017.  
  9018.  
  9019.   <C:\IPFC\YOURFILE.IPF:999> 124: Invalid tag in footnote [ ]
  9020.    ΓööΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÿΓööΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ ΓööΓö¼Γöÿ  ΓööΓö¼Γöÿ  ΓööΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ ΓööΓö¼Γöÿ
  9021.       Γöé         Γöé        Γöé    Γöé      Γöé                     Γöé
  9022.       Γöé         Γöé        Γöé    Γöé      Γöé              Optional error
  9023.       Γöé         Γöé        Γöé    Γöé      Γöé                information.
  9024.       Γöé         Γöé        Γöé    Γöé      Γöé              Tag, filename, etc.
  9025.       Γöé         Γöé        Γöé    Γöé      Γöé
  9026.       Γöé         Γöé        Γöé    Γöé      ΓööΓöÇΓöÇ Error message
  9027.       Γöé         Γöé        Γöé    Γöé
  9028.       Γöé         Γöé        Γöé    ΓööΓöÇΓöÇ Error code
  9029.       Γöé         Γöé        Γöé
  9030.       Γöé         Γöé        ΓööΓöÇΓöÇ Line number in source file
  9031.       Γöé         Γöé                where error occurred
  9032.       Γöé         Γöé
  9033.       Γöé         ΓööΓöÇΓöÇ Filename of source file
  9034.       Γöé
  9035.       ΓööΓöÇΓöÇ Drive and path of source file
  9036.  
  9037.  
  9038. ΓòÉΓòÉΓòÉ 11.1.1. Warning Level 1 Messages ΓòÉΓòÉΓòÉ
  9039.  
  9040.  101       Invalid document body 
  9041.  
  9042.             Explanation:  No :userdoc./:euserdoc. match. 
  9043.  
  9044.            This is a fatal error that will cause the compiler to stop 
  9045.            executing. 
  9046.  
  9047.  
  9048.  102       Invalid tag syntax 
  9049.  103       Missing hypertext information 
  9050.  104       Cannot hide parent head level 
  9051.  
  9052.            Explanation:  Preceding head level must be hidden. 
  9053.  
  9054.  
  9055.  105       Illegal context for tag 
  9056.  
  9057.            Explanation:  Tags are not properly matched, a tag is used 
  9058.            incorrectly, or a tag is placed incorrectly. 
  9059.  
  9060.  
  9061.  106       List start tag missing-tag ignored 
  9062.  107       List end tag not matched-tag ignored 
  9063.  108       Ignoring unmatched tag 
  9064.  109       Cannot open file 
  9065.  
  9066.            Explanation:  SYSTEM ERROR.  Filename or path is incorrect, file 
  9067.            doesn't exist, or other system problem. 
  9068.  
  9069.  
  9070.  110       No id for this reference 
  9071.  112       No id for this footnote 
  9072.  113       No text found in tag 
  9073.  114       Page is too big 
  9074.  
  9075.            Explanation:  Panel is too big.  Maximum size is 16 000 words and 
  9076.            punctuation marks. (Note maximum size is language dependent.) 
  9077.  
  9078.  
  9079.  116       Cannot create panel(s) 
  9080.  
  9081.            This is a fatal error that will cause the compiler to stop 
  9082.            executing. 
  9083.  
  9084.  
  9085.  117       Duplicate text in tag 
  9086.  118       Duplicate root word 
  9087.  119       Duplicate tag in tag file 
  9088.  120       Ignoring text before :h1. tag 
  9089.  121       Invalid head level 
  9090.  
  9091.            Explanation:  Head levels are not in consecutive order. 
  9092.  
  9093.            Example:  If :h1. and :h3. are used and :h2. is missing, this error 
  9094.            will occur. 
  9095.  
  9096.  
  9097.  122       Definition term or header not matched 
  9098.  123       Unexpected end of file 
  9099.  
  9100.            Explanation:  This may be caused by an ending tag not being found, a 
  9101.            corrupted or truncated source file, or a control-Z character found 
  9102.            before the true end of file. 
  9103.  
  9104.            This is a fatal error that will cause the compiler to stop 
  9105.            executing. 
  9106.  
  9107.  
  9108.  124       Invalid tag in footnote 
  9109.  125       Not enough memory 
  9110.  
  9111.            Explanation:  SYSTEM ERROR.  Close some applications to free some 
  9112.            memory. 
  9113.  
  9114.            This is a fatal error that will cause the compiler to stop 
  9115.            executing. 
  9116.  
  9117.  
  9118.  126       Cannot free memory 
  9119.  
  9120.            Explanation:  SYSTEM ERROR.  System could not free memory. 
  9121.  
  9122.            This is a fatal error that will cause the compiler to stop 
  9123.            executing. 
  9124.  
  9125.  
  9126.  127       Cannot read file 
  9127.  
  9128.            Explanation:  SYSTEM ERROR.  Source file may be corrupted. 
  9129.  
  9130.            This is a fatal error that will cause the compiler to stop 
  9131.            executing. 
  9132.  
  9133.  
  9134.  129       Document is too big - unique words exceed 16 000 
  9135.  
  9136.            This is a fatal error that will cause the compiler to stop 
  9137.            executing. 
  9138.  
  9139.  
  9140.  130       A DT tag is not defined 
  9141.  131       A PT tag is not defined 
  9142.  132       Cannot write to a file 
  9143.  
  9144.            Explanation:  SYSTEM ERROR.  File system is full, out of disk space, 
  9145.            diskette is write protected, etc. 
  9146.  
  9147.            This is a fatal error that will cause the compiler to stop 
  9148.            executing. 
  9149.  
  9150.  
  9151.  133       Attribute not defined 
  9152.  134       Tag not defined 
  9153.  135       Invalid bitmap format 
  9154.  
  9155.            Explanation:  File is not a valid PM format bitmap file. 
  9156.  
  9157.  
  9158.  140       Invalid country code, or codepage 
  9159.  
  9160.            This is a fatal error that will cause the compiler to stop 
  9161.            executing. 
  9162.  
  9163.  
  9164.  141       Invalid language code 
  9165.  
  9166.            This is a fatal error that will cause the compiler to stop 
  9167.            executing. 
  9168.  
  9169.  
  9170.  143       No valid COLS specification was given 
  9171.  144       Ignoring invalid tag in table cell 
  9172.  145       Ignoring text before :c. tag 
  9173.  146       Extra cells will be placed in next table row 
  9174.  147       Missing ELINK tag inserted at end of table cell 
  9175.  148       Total table width exceeds limit of 250 characters 
  9176.  149       Cannot reopen. File is already opened 
  9177.  
  9178.            Explanation:  SYSTEM ERROR. 
  9179.  
  9180.  
  9181.  150       Document has no vocabulary 
  9182.  
  9183.            This is a fatal error that will cause the compiler to stop 
  9184.            executing. 
  9185.  
  9186.  
  9187.  151       No res for this reference 
  9188.  152       Duplicate tag in source file 
  9189.  153       Document has no visible table of contents entry 
  9190.  
  9191.            This is a fatal error that will cause the compiler to stop 
  9192.            executing. 
  9193.  
  9194.  
  9195.  154       Truncating table entry 
  9196.  
  9197.            This is a warning to tell the user when the text for a table cell is 
  9198.            too long for the size of the cell. 
  9199.  
  9200.  
  9201. ΓòÉΓòÉΓòÉ 11.1.2. Warning Level 2 Messages ΓòÉΓòÉΓòÉ
  9202.  
  9203.  201       Invalid tag 
  9204.  202       Invalid attribute 
  9205.  203       Invalid symbol 
  9206.  
  9207.            Explanation:  Invalid APS symbol; period missing after the APS 
  9208.            symbol, symbol specified is not in the APSYMBOL.APS file, invalid 
  9209.            APSYMBOL.APS file. 
  9210.  
  9211.  
  9212.  204       Invalid macro 
  9213.  205       Text too long in tag 
  9214.  
  9215.            Explanation:  Heading and index tags have a maximum of 150 
  9216.            characters. 
  9217.  
  9218.  
  9219.  206       Token is bigger than expected. 
  9220.  
  9221.            Explanation:  Maximum length of token is 255 characters.  This error 
  9222.            could be caused by a missing end period or quote character. 
  9223.  
  9224.  
  9225.  207       Invalid attribute value 
  9226.  208       Missing tag 
  9227.  209       Attribute not matched 
  9228.  210       Text too long in macro expansion 
  9229.  
  9230.            Explanation:  Maximum 255 characters. 
  9231.  
  9232.  
  9233.  211       Total number of fonts exceeds the limit of 14 
  9234.  212       Sub index cannot be global without global main index 
  9235.  213       Invalid nest 
  9236.  
  9237.  
  9238. ΓòÉΓòÉΓòÉ 11.1.3. Warning Level 3 Messages ΓòÉΓòÉΓòÉ
  9239.  
  9240.  301       Ignoring attribute 
  9241.  302       Duplicate ID 
  9242.  
  9243.            Explanation:  Cannot specify the same ID in the same panel or index. 
  9244.  
  9245.  
  9246.  303       Duplicate symbol in symbol file 
  9247.  304       Duplicate res number 
  9248.  305       Parent panel cannot have its own text 
  9249.  306       Missing panel text in head level tag 
  9250.  307       Missing footnote text in :fn. tag 
  9251.  
  9252.  
  9253. ΓòÉΓòÉΓòÉ 12. Enabling Help for Applications ΓòÉΓòÉΓòÉ
  9254.  
  9255. While running an application the user sometimes requires help.  For example, 
  9256. the user may need assistance in making a choice, recalling the name of an 
  9257. application command or the use of a function key, or locating information. 
  9258.  
  9259. Using IPF, you can develop a user interface that provides general help for 
  9260. application windows, and contextual help for fields within windows. 
  9261.  
  9262. Implementing the IPF user interface when creating helps for an application 
  9263. requires two different development efforts: 
  9264.  
  9265.      Developing the programming code that communicates with IPF and the 
  9266.       Presentation Manager to display help windows. 
  9267.  
  9268.      Developing a library of help information that IPF refers to in response 
  9269.       to a user request. 
  9270.  
  9271.  This section will concentrate on the first development effort:  writing the 
  9272.  programming code that enables communication between IPF and the Presentation 
  9273.  Manager. 
  9274.  
  9275.  
  9276. ΓòÉΓòÉΓòÉ 12.1. Developing the Application Code ΓòÉΓòÉΓòÉ
  9277.  
  9278. Use the following steps to develop the application code that adds help to your 
  9279. application. 
  9280.  
  9281.    1. Set up the help table and help subtable, and include the help constants 
  9282.       defined in PMHELP.H. 
  9283.  
  9284.    2. Initialize the HELPINIT structure with a call to DosLoadModule. 
  9285.  
  9286.    3. Create a help instance. 
  9287.  
  9288.    4. Associate the help instance with the application window chain. 
  9289.  
  9290.    5. Respond to messages for menu bar choices. 
  9291.  
  9292.    6. End the help instance. 
  9293.  
  9294.  The following sections describe how to implement each of these steps. 
  9295.  
  9296.  
  9297. ΓòÉΓòÉΓòÉ 12.1.1. Setting Up the IPF Help Tables ΓòÉΓòÉΓòÉ
  9298.  
  9299. Two table structures in application memory or in resource files (.RC file-name 
  9300. extension), identify window resources in the IPF library.  The help table 
  9301. associates each application window with its corresponding help subtable and the 
  9302. window identifier of its extended help window.  The help subtable associates 
  9303. each entry field, menu item and push button within an application window with 
  9304. the window identifier (ID) of its help window.  The address of the help table 
  9305. is passed to the application during initialization of the IPF initializing 
  9306. structure (HELPINIT). 
  9307.  
  9308. When the user requests help on a field, menu bar, or push button in the 
  9309. application window, IPF uses the help subtable associated with the field to 
  9310. find the window ID of the contextual help window for the field.  The help 
  9311. subtable also can store optional entries relating to application-specific 
  9312. information. 
  9313.  
  9314. The maximum size of the help table is 64KB. The number of help subtables is 
  9315. limited to 16 000. 
  9316.  
  9317. IPF supports two methods of defining help tables and help subtables. They can 
  9318. be allocated in memory, or they can be defined as resources. In either case, 
  9319. the information passed to IPF is identical. 
  9320.  
  9321.  
  9322. ΓòÉΓòÉΓòÉ 12.1.1.1. Defining Help Tables in Memory ΓòÉΓòÉΓòÉ
  9323.  
  9324. By defining help tables and subtables in memory, you can dynamically change a 
  9325. single entry in the help table. You can add a new window ID to be associated 
  9326. with a field, or add fields that are to be associated with existing windows. 
  9327.  
  9328. After the help table structure is initialized, the application can pass IPF the 
  9329. address in memory of the new help table, either by sending the 
  9330. HM_CREATE_HELP_TABLE message from its window procedure, or by calling 
  9331. WinCreateHelpTable. 
  9332.  
  9333. When defining help tables in memory, the data structures in PMHELP.H are used. 
  9334. The help table contains the structure for each application window. This 
  9335. structure holds the following information: 
  9336.  
  9337.      Application window ID 
  9338.      Address of the window's subtable 
  9339.      Window ID of the window's extended help window 
  9340.  
  9341.  These entries are integers.  The last entry in the list contains a NULL for 
  9342.  each entry type, to indicate the end of the list.  The following is an example 
  9343.  of a help table for an application. 
  9344.  
  9345.   HELPSUBTABLE        table1, table2, table3,
  9346.                       table4, table5;
  9347.  
  9348.   HELPTABLE     helpTableEntry [] =
  9349.   {
  9350.     APP_WIND_1,  &table1, idExtHelp1,
  9351.     APP_WIND_2,  &table2, idExtHelp2,
  9352.     APP_WIND_3,  &table3, idExtHelp3,
  9353.     APP_WIND_4,  &table4, idExtHelp4,
  9354.     APP_WIND_5,  &table5, idExtHelp5,
  9355.     0,           NULL,    NULL
  9356.   };
  9357.  
  9358.  The help subtable contains the structure defined in the PMHELP.H file for each 
  9359.  application window. This structure holds the following information for each 
  9360.  field in the application window: 
  9361.  
  9362.      Field ID from which user requests help 
  9363.      Window ID of the contextual help window associated with the field 
  9364.      Optional, application-specific integers. 
  9365.  
  9366.  The last entry in the structure contains the word length for each field entry. 
  9367.  The minimum number of words is two, which is the default.  The following is an 
  9368.  example of a help subtable for an application window that has six fields. 
  9369.  
  9370.   HELPSUBTABLE        HelpSubTable [] =
  9371.   {
  9372.     2,
  9373.     FIELD_ID_1, IDRES_HELP1,
  9374.     FIELD_ID_2, IDRES_HELP2,
  9375.     FIELD_ID_3, IDRES_HELP3,
  9376.     FIELD_ID_4, IDRES_HELP4,
  9377.     FIELD_ID_5, IDRES_HELP5,
  9378.     FIELD_ID_6, IDRES_HELP6,
  9379.     0,          0
  9380.   };
  9381.  
  9382.  
  9383. ΓòÉΓòÉΓòÉ 12.1.1.2. Defining Help Tables as Resources ΓòÉΓòÉΓòÉ
  9384.  
  9385. If help tables are defined as resources, they can be bound to the application's 
  9386. executable file, or they can reside in a dynamic link library (DLL). 
  9387.  
  9388. If help tables are defined as resources in a dynamic link library, the 
  9389. application must call DosLoadModule to load the DLL before it calls 
  9390. WinCreateHelpInstance. When the application calls WinCreateHelpInstance, it 
  9391. passes the handle to the DLL and the resource ID of the help table in the 
  9392. HELPINIT structure. 
  9393.  
  9394. The application can load a new help table residing in the DLL by either sending 
  9395. the HM_LOAD_HELP_TABLE message from its window procedure, or by calling 
  9396. WinLoadHelpTable. The application passes the handle to the DLL and the resource 
  9397. ID of the new help table. 
  9398.  
  9399. A HELPTABLE resource contains a HELPITEM entry for each application window, 
  9400. dialog, and message box for which help is provided. 
  9401.  
  9402. Each entry of a HELPTABLE resource contains: 
  9403.  
  9404.      HELPITEM keyword 
  9405.      Application window ID 
  9406.      ID of the HELPSUBTABLE resource 
  9407.      Window ID of the extended help window. 
  9408.  
  9409.  A HELPSUBTABLE resource contains an entry for each item that can be selected 
  9410.  in an application window. Each of these items is assumed to be a child window 
  9411.  of the application window identified in the HELPTABLE resource. The 
  9412.  HELPSUBTABLE should contain a single SUBITEMSIZE and a HELPSUBITEM for each 
  9413.  control, child window, and menu item. 
  9414.  
  9415.  Each entry of a HELPSUBTABLE resource contains: 
  9416.  
  9417.      HELPSUBITEM keyword 
  9418.      Field ID 
  9419.      Window ID of the field's help window (corresponds to the resource number 
  9420.       specified in the heading tag of the help-text window) 
  9421.      Optional, application-defined integers. 
  9422.  
  9423.  The integer ID of the field can be a control, menu item, or message box ID. 
  9424.  The ID specified must be unique within the table. An ID of hex FFFF is 
  9425.  reserved for use by IPF. 
  9426.  
  9427.  The optional integers value allows the writer of the resource script file to 
  9428.  append additional integers to the end of each HELPSUBITEM for 
  9429.  application-specific use. 
  9430.  
  9431.  The SUBITEMSIZE keyword is used to identify the size in words of each 
  9432.  HELPSUBITEM.  All entries must be the same length. If this value is specified, 
  9433.  it must be greater than or equal to 2. If this value is not specified, it 
  9434.  defaults to 2. 
  9435.  
  9436.  All referenced HELPSUBTABLE resources must reside in the same .RES file as the 
  9437.  HELPTABLE resource. 
  9438.  
  9439.  Following is an example of .RC source file for defining a HELPTABLE and its 
  9440.  related HELPSUBTABLE resources. 
  9441.  
  9442.   HELPTABLE TABLE_1
  9443.   BEGIN
  9444.   HELPITEM parentwindow1, SUBTABLE_1,
  9445.     extendedhelppanel1
  9446.   HELPITEM parentwindow2, SUBTABLE_2,
  9447.     extendedhelppanel2
  9448.   END
  9449.  
  9450.   HELPSUBTABLE SUBTABLE_1
  9451.   [SUBITEMSIZE subitemsize1]
  9452.   BEGIN
  9453.     HELPSUBITEM FIELD_ID1, helppanel1 [,
  9454.       integer1, ...n]
  9455.     HELPSUBITEM FIELD_ID2, helppanel2 [,
  9456.       integer1, ...n]
  9457.   END
  9458.  
  9459.   HELPSUBTABLE SUBTABLE_2
  9460.   [SUBITEMSIZE subitemsize2]
  9461.   BEGIN
  9462.     HELPSUBITEM FIELD_ID3, helppanel3 [,
  9463.       integer1, ...n]
  9464.     HELPSUBITEM FIELD_ID4, helppanel4 [,
  9465.       integer1, ...n]
  9466.   END
  9467.  
  9468.  
  9469. ΓòÉΓòÉΓòÉ 12.1.2. Initializing the HELPINIT Structure ΓòÉΓòÉΓòÉ
  9470.  
  9471. Before you call WinCreateHelpInstance, you must allocate memory for and 
  9472. initialize the HELPINIT structure.  This structure defines values that IPF 
  9473. needs to create the help instance.  Some of the values can be changed by your 
  9474. application after initialization. 
  9475.  
  9476. The HELPINIT structure and the help table structures referred to by IPF during 
  9477. help processing are contained in the PMHELP.H file. The PMHELP.H file also 
  9478. contains the error codes returned in the event of an unsuccessful call. You 
  9479. include this file in your source code by using the INCL_WINHELP define 
  9480. statement. The following shows the HELPINIT structure. 
  9481.  
  9482. typedef struct _HELPINIT /* hinit */
  9483. {
  9484.  
  9485. ULONG          cb;
  9486. ULONG          ulReturnCode;
  9487. PSZ            pszTutorialName;
  9488. PHELPTABLE     phtHelpTable;
  9489. HMODULE        hmodHelpTableModule;
  9490. HMODULE        hmodAccelActionBarModule;
  9491. ULONG          idAccelTable;
  9492. ULONG          idActionBar;
  9493. PSZ            pszHelpWindowTitle;
  9494. ULONG          fShowPanelId;
  9495. PSZ            pszHelpLibraryName;
  9496. } HELPINIT;
  9497.  
  9498. Following are descriptions of the HELPINIT structure fields. 
  9499.  
  9500.  Field Name          Description 
  9501.  
  9502.  cb                  The length of the initialization structure.  This value 
  9503.                      can be use to identify the version of IPF being used. 
  9504.  
  9505.  ulReturnCode        The IPF return code 
  9506.  
  9507.  pszTutorialName     A pointer to a tutorial name, if one exists.  If this 
  9508.                      value is NULL, either the application help interface does 
  9509.                      not include a tutorial, or the tutorial is referenced from 
  9510.                      a help window.  If this value is not NULL, IPF provides a 
  9511.                      Tutorial choice in the help pull-down and adds a push 
  9512.                      button to the control area. 
  9513.  
  9514.                      If the user selects the Tutorial choice in the pull-down, 
  9515.                      IPF sends the HM_TUTORIAL message to the application so 
  9516.                      that it can start the tutorial. 
  9517.  
  9518.  phtHelpTable        If the help table is in memory this ia a pointer to the 
  9519.                      help table. If the help table is a resource, this is the 
  9520.                      resource ID ORed with 0xFFFF0000. 
  9521.  
  9522.  hmodHelpTableModule The name of the resource file that indexes the dynamic 
  9523.                      link library that contains the help table and its 
  9524.                      corresponding subtables.  If the help table is not being 
  9525.                      accessed through a dynamic link library, this value is 0. 
  9526.  
  9527.  hmodAccelActionBarModule The name of the dynamic link library that contains 
  9528.                      the modified menu bar. If you do not have a modified menu 
  9529.                      bar, this value is 0. 
  9530.  
  9531.  idAccelTable        The name of the accelerator table if you are using a 
  9532.                      modified menu bar; otherwise, this value is 0. 
  9533.  
  9534.  idActionBar         The identity of the menu bar (action bar) template.  If 
  9535.                      you are not modifying the menu bar, this value is 0. 
  9536.  
  9537.  pszHelpWindowTitle  A pointer to the name of the title for the main help 
  9538.                      window.  This name can be changed after initialization by 
  9539.                      sending the message HM_SET_HELP_WINDOW_TITLE. 
  9540.  
  9541.  fShowPanelId        A flag used to append the window ID to the beginning of 
  9542.                      the help window title in the title bar of the help window. 
  9543.                      If this flag is set to CMIC_SHOW_PANEL_ID, the window IDs 
  9544.                      are displayed. If this flag is set to CMIC_HIDE_PANEL_ID 
  9545.                      or to 0, the window IDs are not displayed. 
  9546.  
  9547.                      This flag is useful during the development stages of the 
  9548.                      help interface. 
  9549.  
  9550.                      After initialization, this flag can be toggled with the 
  9551.                      HM_SET_SHOW_PANEL_ID message. 
  9552.  
  9553.  pszHelpLibraryName  The help library names of the .HLP files containing the 
  9554.                      help windows. These .HLP files are created by the IPF 
  9555.                      compiler.  When IPF needs to search for a help window, it 
  9556.                      looks for these library names in the path set by the HELP 
  9557.                      environment variable.  If IPF cannot find a library name 
  9558.                      in this path, it then searches the current directory. 
  9559.  
  9560.                      After initialization, help library names can be specified 
  9561.                      with the HM_SET_HELP_LIBRARY_NAME message.  If multiple 
  9562.                      libraries are specified, library names must be separated 
  9563.                      by a blank space. 
  9564.  
  9565.  The following example shows a help facility being initialized.  Notice that 
  9566.  hmodAccelActionBarModule, idAccelTabl      e, and idActionBar have values set 
  9567.  to 0; this is because this example uses a standard menu bar. 
  9568.  
  9569.   VOID HelpInit (VOID)
  9570.   {
  9571.      HELPINIT hini;
  9572.  
  9573.      /* if we return because of an error, Help will be disabled */
  9574.      fHelpEnabled = FALSE;
  9575.  
  9576.      /* initialize help init structure */
  9577.      hini.cb = sizeof (HELPINIT)
  9578.      hini.ulReturnCode = 0L;
  9579.  
  9580.      hini.pszTutorialName = (PSZ)NULL /*if tutorial added, add name here*/
  9581.  
  9582.      hini.phtHelpTable = (PHELPTABLE)MAKELONG(JIGSAW_HELP_TABLE, 0xFFFF);
  9583.      hini.hmodHelpTableModule = (HMODULE)0;
  9584.      hini.hmodAccelActionBarModule = (HMODULE)0;
  9585.      hini.idAccelTable = 0;
  9586.      hini.idActionBar = 0;
  9587.  
  9588.      if (!WinLoadString (habMain,
  9589.               (HMODULE)0,
  9590.               IDS_HELPWINDOWTITLE,
  9591.               HELPLIBRARYNAMELEN,
  9592.               (PSZ)szWindowTitle))
  9593.  
  9594.      {
  9595.        MessageBox (habMain, IDS_CANNOTLOADSTRING, MB_OK | MB_ERROR, FALSE);
  9596.        return;
  9597.      }
  9598.  
  9599.      hini.pszHelpWindowTitle = (PSZ)szWindowTitle;
  9600.  
  9601.      /*  if debugging, show panel ids; else, don't   */
  9602.   #ifdef DEBUG
  9603.      hini.fShowPanelId = CMIC_SHOW_PANEL_ID;
  9604.   #else
  9605.      hini.fShowPanelId = CMIC_HIDE_PANEL_ID;
  9606.   #endif
  9607.  
  9608.      if (!WinLoadString (habMain,
  9609.               (HMODULE)0,
  9610.               IDS_HELPLIBRARYNAME,
  9611.               HELPLIBRARYNAMELEN,
  9612.               (PSZ)szLibName))
  9613.      {
  9614.      MessageBox (habMain, IDS_CANNOTLOADSTRING, MB_OK | MB_ERROR, FALSE);
  9615.      return;
  9616.      }
  9617.  
  9618.      hini.pszHelpLibraryName = (PSZ)szLibName;
  9619.  
  9620.  
  9621. ΓòÉΓòÉΓòÉ 12.1.3. Creating the Help Instance ΓòÉΓòÉΓòÉ
  9622.  
  9623. The WinCreateHelpInstance call passes the HELPINIT structure defined in the 
  9624. PMHELP.H include file to the Presentation Manager. WinCreateHelpInstance 
  9625. returns a handle to the help instance, which you must store in a HWND variable 
  9626. for use with the rest of the application programming interface (API) function 
  9627. calls associated with IPF. 
  9628.  
  9629. IPF responds to the WinCreateHelpInstance call by installing its help hook and 
  9630. initializing for help processing. 
  9631.  
  9632. The following shows how a help instance is created. 
  9633.  
  9634.    /*  Creating help instance */
  9635.    hwndHelpInstance = WinCreateHelpInstance (habMain, &hini);
  9636.  
  9637.    if (!hwndHelpInstance || hini.ulReturnCode)
  9638.    {
  9639.    MessageBox (hwndFrame,
  9640.          IDS_HELPLOADERROR,
  9641.          MB_OK | MB_ERROR,
  9642.          TRUE);
  9643.    return;
  9644.    }
  9645.  
  9646.  
  9647. ΓòÉΓòÉΓòÉ 12.1.4. Associating the Instance with the Window Chain ΓòÉΓòÉΓòÉ
  9648.  
  9649. After an application creates a help instance, it must associate the instance 
  9650. with the application window chain by calling WinAssociateHelpInstance. IPF uses 
  9651. the active window handle passed by this call to index into the help table to 
  9652. find the help window that should be displayed for the application window. 
  9653.  
  9654. An IPF instance can be associated with any application window that has a frame. 
  9655. Once the association of an IPF instance with the application window chain is 
  9656. made, help can be requested for any application window in the chain. 
  9657.  
  9658. The following shows how a help instance is associated with the application 
  9659. window chain. 
  9660.  
  9661.    /*  associate the help instance with the main frame  */
  9662.    if (!WinAssociateHelpInstance (hwndHelpInstance, hwndFrame))
  9663.    {
  9664.    MessageBox (hwndFrame,
  9665.          IDS_HELPLOADERROR,
  9666.          MB_OK | MB_ERROR,
  9667.          TRUE);
  9668.    return;
  9669.    }
  9670.  
  9671.    /*  IPF is successfully initialized; set flag to TRUE  */
  9672.    fHelpEnabled = TRUE;
  9673.  
  9674.  
  9675. ΓòÉΓòÉΓòÉ 12.1.5. Ending the Help Instance ΓòÉΓòÉΓòÉ
  9676.  
  9677. To end the current help instance, the application calls WinDestroyHelpInstance, 
  9678. passing the handle of the help instance that is to be ended. 
  9679.  
  9680. The parameter hwndHelpInstance is the handle to the IPF instance returned from 
  9681. the WinCreateHelpInstance call. 
  9682.  
  9683. The following shows how a help instance is terminated. 
  9684.  
  9685. VOID DestroyHelpInstance (VOID)
  9686. {
  9687.    if (hwndHelpInstance)
  9688.    {
  9689.      WinDestroyHelpInstance (hwndHelpInstance);
  9690.    }
  9691. }
  9692.  
  9693.  
  9694. ΓòÉΓòÉΓòÉ 12.2. Responding to Messages for Menu Bar Choices ΓòÉΓòÉΓòÉ
  9695.  
  9696. IPF communicates with the active window.  This communication is accomplished 
  9697. with messages.  The application may need to do some of its own processing in 
  9698. response to these messages. 
  9699.  
  9700.  
  9701. ΓòÉΓòÉΓòÉ 12.2.1. Processing "Using help" Requests ΓòÉΓòÉΓòÉ
  9702.  
  9703. When the user selects "Using help" from the help pull-down menu, a WM_COMMAND 
  9704. is sent to the application's window procedure. 
  9705.  
  9706. If the application has created its own "Using help" window, it responds by 
  9707. sending the HM_REPLACE_USING_HELP message with the help-window ID.  If the 
  9708. application chooses to use the "Using help" window provided by IPF, it responds 
  9709. by sending the HM_DISPLAY_HELP with NULL in both parameters. 
  9710.  
  9711. Current CUA guidelines recommend applications use "Using help"; however, IPF 
  9712. continues to support the "Help for help" window. 
  9713.  
  9714.  
  9715. ΓòÉΓòÉΓòÉ 12.2.2. Processing a "Keys Help" Request ΓòÉΓòÉΓòÉ
  9716.  
  9717. When the user selects "Keys help" from the help pull-down, an HM_KEYS_HELP 
  9718. message is sent by the application to IPF. In response, IPF sends an 
  9719. HM_QUERY_KEYS_HELP message to the application.  The application returns the 
  9720. window ID of the keys help window. 
  9721.  
  9722.  
  9723. ΓòÉΓòÉΓòÉ 12.2.3. Processing Help Requests for a Child Window ΓòÉΓòÉΓòÉ
  9724.  
  9725. In the Presentation Manager, parent and child windows are active at the same 
  9726. time.  Therefore, when a help instance is associated with a window, its 
  9727. descendants are included in the association.  However, only the parent window 
  9728. is the active help window. 
  9729.  
  9730. Note:  Do not confuse child windows with dialog, message boxes, and other 
  9731.        windows which the application may own but are actually children of the 
  9732.        desktop. 
  9733.  
  9734.  For IPF to process help requests for a child window, an application must send 
  9735.  IPF HM_SET_ACTIVE_WINDOW messages to set the active help window.  Until this 
  9736.  happens, IPF continues to satisfy help requests for the child window from the 
  9737.  help subtable for the parent window. 
  9738.  
  9739.  The HM_SET_ACTIVE_WINDOW message should be sent by ALL windows in response to 
  9740.  the WM_ACTIVATE and WM_INITMENU messages as shown in the following example. 
  9741.  
  9742.      switch( usMsg )
  9743.      {
  9744.                                  ┬╖
  9745.                                  ┬╖
  9746.                                  ┬╖
  9747.      case WM_ACTIVATE:
  9748.         if( SHORT1FROMMP( mp1 ) )
  9749.         {
  9750.            /*
  9751.             * Set active help window to this window's parent when
  9752.             * activated
  9753.             */
  9754.            WinSendMsg( WinQueryHelpInstance( hWnd ),
  9755.                        HM_SET_ACTIVE_WINDOW,
  9756.                        WinQueryWindow( hWnd, QW_PARENT ),
  9757.                        WinQueryWindow( hWnd, QW_PARENT ) );
  9758.         }
  9759.         else
  9760.         {
  9761.            /*
  9762.             * Clear active help window when this window is
  9763.             * deactivated - necessary for message box help, etc.
  9764.             * to work properly.
  9765.             */
  9766.            WinSendMsg( WinQueryHelpInstance( hWnd ),
  9767.                        HM_SET_ACTIVE_WINDOW,
  9768.                        NULL,
  9769.                        NULL );
  9770.         }
  9771.         break;
  9772.  
  9773.      case WM_INITMENU:
  9774.         /*
  9775.          * Set active window to this window's parent here so that
  9776.          * the menu id will be found in the proper subtable.
  9777.          * Activation and deactivation of the help window will
  9778.          * take care of setting the help window back to the
  9779.          * active window.
  9780.          */
  9781.         WinSendMsg( WinQueryHelpInstance( hWnd ),
  9782.                     HM_SET_ACTIVE_WINDOW,
  9783.                     WinQueryWindow( hWnd, QW_PARENT ),
  9784.                     WinQueryWindow( hWnd, QW_PARENT ) );
  9785.         break;
  9786.  
  9787.                                   ┬╖
  9788.                                   ┬╖
  9789.                                   ┬╖
  9790.      }
  9791.  
  9792.  
  9793. ΓòÉΓòÉΓòÉ 12.2.4. When No Help Is Available ΓòÉΓòÉΓòÉ
  9794.  
  9795. A user may request help by pressing F1 when the cursor is positioned on an item 
  9796. for which no field-level help is available. In such a case, IPF sends the 
  9797. HM_HELPSUBITEM_NOT_FOUND message to the application.  To display the extended 
  9798. help window, the application then can either return FALSE or ignore the 
  9799. message.  If the application returns TRUE, there is no response to the user 
  9800. request. 
  9801.  
  9802.  
  9803. ΓòÉΓòÉΓòÉ 12.2.5. Help Window Resources ΓòÉΓòÉΓòÉ
  9804.  
  9805. You can define the following window resources for the help interface: 
  9806.  
  9807.      Help pull-down 
  9808.  
  9809.      Help push button 
  9810.  
  9811.      Command entry field 
  9812.  
  9813.      Customized menu bar. 
  9814.  
  9815.  
  9816. ΓòÉΓòÉΓòÉ 12.2.6. Help Pull-Down ΓòÉΓòÉΓòÉ
  9817.  
  9818. CUA guidelines recommend that all application windows with menu bars include a 
  9819. help pull-down menu. The help application menu bar choice and corresponding 
  9820. pull-down menu is defined in your resource file. The following example shows 
  9821. how to define the help pulldown. 
  9822.  
  9823. MENU IDR_MAIN PRELOAD
  9824. BEGIN
  9825.     SUBMENU "~File",                           IDM_FILE
  9826.     BEGIN
  9827.         MENUITEM "~Open...",                   IDM_LOAD
  9828.     END
  9829.  
  9830.     SUBMENU "~Options",                        IDM_OPTIONS
  9831.     BEGIN
  9832.         SUBMENU "Size",                        IDM_SIZE_MENU
  9833.         BEGIN
  9834.             MENUITEM "Small",                  IDM_SIZE_SMALL,   0, MIS_TEXT
  9835.             MENUITEM "Medium",                 IDM_SIZE_MEDIUM,  0, MIS_TEXT
  9836.             MENUITEM "Large",                  IDM_SIZE_LARGE,   0, MIS_TEXT
  9837.             MENUITEM "Full Size",              IDM_SIZE_FULL,    0, MIA_CHECKED
  9838.         END
  9839.  
  9840.         MENUITEM "~Jumble!",                   IDM_JUMBLE
  9841.     END
  9842.  
  9843.     SUBMENU "~Help",                           IDM_HELP,            MIS_TEXT
  9844.     BEGIN
  9845.         MENUITEM "Help ~index",                IDM_HELPINDEX,       MIS_TEXT
  9846.         MENUITEM "~General help",              IDM_HELPEXTENDED,    MIS_TEXT
  9847.         MENUITEM "~Using help",                IDM_HELPHELPFORHELP, MIS_TEXT
  9848.         MENUITEM     SEPARATOR
  9849.         MENUITEM "~Product information",       IDM_HELPABOUT,       MIS_TEXT
  9850.     END
  9851. END
  9852.  
  9853.  
  9854. ΓòÉΓòÉΓòÉ 12.2.7. Help Push Button ΓòÉΓòÉΓòÉ
  9855.  
  9856. If your application has a dialog or message area, you may want to include the 
  9857. Help push button in the bottom area of the secondary application window (dialog 
  9858. box). To define the Help push button, use the Presentation Manager button style 
  9859. BS_HELP and BS_NOPOINTERFOCUS. 
  9860.  
  9861. The BS_HELP style causes the Presentation Manager to call IPF when the user 
  9862. selects this Help push button. The BS_NOPOINTERFOCUS style enables the 
  9863. Presentation Manager to determine the field for which the user requested help. 
  9864.  
  9865.  
  9866. ΓòÉΓòÉΓòÉ 12.2.8. Command Entry Field ΓòÉΓòÉΓòÉ
  9867.  
  9868. An entry field is a control window that enables users to enter text. A command 
  9869. entry field is used for typing commands, and may be programmed to accept 
  9870. entries recognized by the application. 
  9871.  
  9872. For example, a command entry field might be used in an interpreter with a 
  9873. Presentation Manager interface.  The field would accept a request from the user 
  9874. and execute it.  Similarly, a command entry field might be used in an editor in 
  9875. a "command mode" to accept advanced instructions not associated with any 
  9876. editing keys.  Any time the user has a limited number of correct responses, a 
  9877. command entry field may be appropriate. 
  9878.  
  9879. Help windows for application commands can be associated with a command entry 
  9880. field by imbedding the index command tag (:icmd.) with a command name in the 
  9881. window that describes the command. 
  9882.  
  9883. When the cursor is positioned in the associated entry field and the user 
  9884. presses F1 or selects the Help push button, titles of windows that contain 
  9885. these tags are displayed in alphabetic order in a list box window. 
  9886.  
  9887.  
  9888. ΓòÉΓòÉΓòÉ 12.2.9. A Customized Menu Bar ΓòÉΓòÉΓòÉ
  9889.  
  9890. A Help menu bar template is shipped with the IBM Developer. The template is in 
  9891. the HMTAILOR.RC file.  Included in the template is the Help menu pull-down. 
  9892. You can customize the menu bar by adding pull-downs and choices to the Help 
  9893. menu bar template. 
  9894.  
  9895. When a menu bar or pull-down choice you have added is selected by the 
  9896. application user, IPF sends the HM_ACTIONBAR_COMMAND message to the currently 
  9897. active application window.  The low-order word of param1 contains the command 
  9898. value of the selected item. The command values of the actions added by the 
  9899. application must be between hex 7F00 and hex 7FFF for its commands. 
  9900.  
  9901. The accelerator table maps function keys to commands on help windows.  This 
  9902. table is also contained in the HMTAILOR.RC file. If you add a choice to the 
  9903. menu bar that maps to a key on the keyboard, you must also add an entry to the 
  9904. accelerator table for that choice. IPF functions depend on the entries that 
  9905. already exist in the system accelerator table.  They must not be altered. The 
  9906. command value specified in the accelerator table entry must be the same command 
  9907. value that was specified for the associated action in the menu bar template. 
  9908.  
  9909. If the HMTAILOR.RC file is changed, you must compile it using the resource 
  9910. compiler and attach it to the executable file. If the executable file is a DLL, 
  9911. you must call DosLoadModule to load it before calling WinCreateHelpInstance. 
  9912. Identify the handle to IPF in the hmodAccelActionBarModule field in the 
  9913. initialization structure. When this field is 0, IPF uses the default menu bar. 
  9914.  
  9915. The HMTAILOR.RC file includes the HMTAILOR.H file. 
  9916.  
  9917. Note:  When modifying the menu bar, define IDM_HM_MENU and 
  9918.        IDD_COVERPAGE_HM_ACCEL in your help header (.H) file. Also, add the IDs 
  9919.        in the idActionBar and idAccelTable fields in the HELPINIT structure. 
  9920.  
  9921.  
  9922. ΓòÉΓòÉΓòÉ 13. Customizing IPF with Communication Objects ΓòÉΓòÉΓòÉ
  9923.  
  9924. The IPF online help interface and specific help information can be customized 
  9925. by hooking a piece of Presentation Manager code into the IPF help facility. 
  9926. This code, which is actually an entry point in a DLL file, is called a 
  9927. communication object. 
  9928.  
  9929.  
  9930. ΓòÉΓòÉΓòÉ 13.1. Useful Communication Object Terminology ΓòÉΓòÉΓòÉ
  9931.  
  9932. Before you begin reading about how to create IPF communication objects and 
  9933. related topics (such as application-controlled windows), you need to be 
  9934. familiar with the terms which will be used to describe them. 
  9935.  
  9936.  acviewport 
  9937.       The :acviewport. tag, which enables an application to control what is 
  9938.       displayed in an IPF window (see :acviewport. (Application-Controlled 
  9939.       Window)). 
  9940.  
  9941.  application-controlled window 
  9942.       The window that you create using a communication object that is loaded by 
  9943.       an :acviewport. tag. 
  9944.  
  9945.  communication object 
  9946.       A child window of the object window; this child window can handle and 
  9947.       respond to messages (particularly HM_ messages). 
  9948.  
  9949.  DLL 
  9950.       A dynamic link library (DLL) is a collection of executable programming 
  9951.       code and data that is bound to an application at load time or run time, 
  9952.       rather than during linking. The programming code and data in a DLL can be 
  9953.       shared by several applications simultaneously. 
  9954.  
  9955.  entry point 
  9956.       A function called in the DLL that contains your communication object. 
  9957.       Specified in the :acviewport. tag with the objectname option. 
  9958.  
  9959.  object 
  9960.       For the purposes of this discussion, synonymous with entry point. 
  9961.  
  9962.  window procedure 
  9963.       Code that is activated in response to a message. The window procedure 
  9964.       controls the behavior and appearance of its associated windows. 
  9965.  
  9966.  
  9967. ΓòÉΓòÉΓòÉ 13.2. Two Kinds of Communication Objects ΓòÉΓòÉΓòÉ
  9968.  
  9969. How the communication object is loaded into memory is an indication of the 
  9970. purpose of the communication object. A DLL containing a communication object 
  9971. can be loaded into memory in two ways: 
  9972.  
  9973.    1. Through use of the :docprof. tag's dll attribute (see :docprof. 
  9974.       (Document Profile)). A communication object loaded through the :docprof. 
  9975.       tag is considered a "global" communication object because it affects the 
  9976.       IPF coverpage window and all of its children IPF windows. Essentially, a 
  9977.       :docprof.-loaded communication object can alter the overall behavior and 
  9978.       appearance of IPF, such as providing author-defined buttons in the 
  9979.       control area or special message handling. You can load only one 
  9980.       communication object in this manner. 
  9981.  
  9982.    2. Through use of the :acviewport. tags (see :acviewport. 
  9983.       (Application-Controlled Window)). A communication object loaded in this 
  9984.       way will only affect the specific application-controlled window and only 
  9985.       when that window is open. Therefore, a communication object loaded 
  9986.       through an :acviewport. tag is useful for tasks such as displaying video 
  9987.       clips or bit maps associated with a given help panel. However, if you 
  9988.       want a communication object to affect the overall appearance or behavior 
  9989.       of the IPF interface for a given help session, you will want to use a 
  9990.       "global" communication object (one that is loaded through the :docprof. 
  9991.       tag). Unlike a global communication object, you can load multiple 
  9992.       :acviewport. communication objects or refer to the same communication 
  9993.       object from multiple :acviewport. tags. 
  9994.  
  9995.  An acviewport communication object is called each time a window is opened.  A 
  9996.  global communication object is called only once. 
  9997.  
  9998.  
  9999. ΓòÉΓòÉΓòÉ 13.3. Purpose of Communication Objects ΓòÉΓòÉΓòÉ
  10000.  
  10001. Communication objects can provide several powerful capabilities: 
  10002.  
  10003.      You can write PM code that handles and responds to help-related messages. 
  10004.       For this, you would use a :docprof.-loaded "global" communication object. 
  10005.  
  10006.      You can write PM code to override the default appearance of the IPF help 
  10007.       interface.  For example, you can provide custom push buttons in the 
  10008.       control area. For this, you would use a :docprof.-loaded "global" 
  10009.       communication object. 
  10010.  
  10011.      You can write PM code that allows help information to include function 
  10012.       simulation, user interaction, and audio and video presentations (see 
  10013.       Controlling Windows with Applications (ACVIEWPORTS)). For this, you would 
  10014.       use an :acviewport.-loaded communication object. 
  10015.  
  10016.      You can write PM code that changes help information (including .INF 
  10017.       files) dynamically, with help window contents generated and formatted at 
  10018.       the time when the information is displayed to the user. For this, you 
  10019.       would use a :docprof.-loaded or "global" communication object. For more 
  10020.       information about changing help information dynamically, see Changing 
  10021.       Help Information at Run Time (DDF). 
  10022.  
  10023.  Essentially, a communication object is intended to provide message processing 
  10024.  when no application is present to handle this message processing. In other 
  10025.  words, your stand-alone PM applications can provide the same functionality 
  10026.  that is supported by communication objects. 
  10027.  
  10028.  However, unlike a stand-alone application, a communication object that 
  10029.  properly handles message passing can be used by any stand-alone application 
  10030.  and can interact with other communication objects. For example, a 
  10031.  communication object that provides system call support (such as querying 
  10032.  specific details about the user's system) might be useful to a broad range of 
  10033.  applications in their online information. 
  10034.  
  10035.  
  10036. ΓòÉΓòÉΓòÉ 13.4. Understanding Communication Objects ΓòÉΓòÉΓòÉ
  10037.  
  10038. Before you begin coding, you should understand the general steps involved in 
  10039. the creation and function of a communication object. The steps are as follows: 
  10040.  
  10041.    1. IPF encounters a :docprof. or :acviewport. tag. 
  10042.  
  10043.    2. Based on the content of the tag, IPF loads a DLL and calls a function 
  10044.       that corresponds to a communication object. 
  10045.  
  10046.    3. IPF passes 2 items to the communication object: 
  10047.  
  10048.         a. A pointer to an ACVP data structure. This data structure includes 
  10049.            the following elements: 
  10050.  
  10051.  
  10052.                       ULONG  cb;         /* length of data structure              */
  10053.                       HAB    hAB;        /* anchor block handle                   */
  10054.                       HMQ    hmq;        /* handle to message queue               */
  10055.                       ULONG  ObjectID;   /* ObjectID attribute as specified in    */
  10056.                                          /* an acviewport tag                     */
  10057.                       HWND   hWndParent; /* handle to acviewport parent window    */
  10058.                       HWND   hWndOwner;  /* handle to acviewport owner window     */
  10059.                       HWND   hWndACVP;   /* handle to acviewport                  */
  10060.  
  10061.            IPF supplies all but the last piece of information in this data 
  10062.            structure for the communication object. If the communication object 
  10063.            creates an application-controlled window, it must place the handle 
  10064.            to that window in the last element of the data structure before 
  10065.            returning to IPF.  IPF uses the handle to size and position the 
  10066.            window. 
  10067.  
  10068.            If the communication object is global (loaded by means of a 
  10069.            :docprof. tag), the last 3 items are not needed and are set to null 
  10070.            by IPF. 
  10071.  
  10072.         b. A string identified in the :docprof. or :acviewport. tag as 
  10073.            objectinfo. This is simply a generic parameter passed to the 
  10074.            communication object. Your communication object may or may not use 
  10075.            this parameter, but it should process it. 
  10076.  
  10077.    4. The communication object begins execution. It must complete the following 
  10078.       three steps, sequentially: 
  10079.  
  10080.         a. Register a window class. 
  10081.  
  10082.         b. Create a window. 
  10083.  
  10084.         c. Insert the window in the communication chain (see The Communication 
  10085.            Chain). 
  10086.  
  10087.    5. The next step depends on whether or not the communication object DLL was 
  10088.       loaded through a :docprof. tag or an :acviewport. tag. 
  10089.  
  10090.           If the communication object DLL was loaded through a :docprof. tag, 
  10091.            it simply returns. 
  10092.  
  10093.           If the communication object DLL was loaded through an :acviewport. 
  10094.            tag, the communication object passes the window handle of the window 
  10095.            it created to IPF. 
  10096.  
  10097.    6. The communication object begins message processing: 
  10098.  
  10099.           If the communication object DLL was loaded through :docprof. tag, it 
  10100.            must process HM_ messages and the WM_CLOSE message. 
  10101.  
  10102.           If the communication object DLL was loaded through an :acviewport. 
  10103.            tag, it must process: 
  10104.  
  10105.              -  HM_ messages 
  10106.              -  Various WM_ messages 
  10107.              -  Optionally, other messages, dependent on the particular design 
  10108.                 of the communication object. 
  10109.  
  10110.  
  10111. ΓòÉΓòÉΓòÉ 13.4.1. Messages between IPF and the Communication Object ΓòÉΓòÉΓòÉ
  10112.  
  10113. IPF and its communication objects communicate through window and help manager 
  10114. messages. IPF communication objects, and windows that they create, can send 
  10115. messages to IPF and IPF windows for which the communication objects can get a 
  10116. handle.  Similarly, IPF can send messages to any window that a communication 
  10117. object creates. 
  10118.  
  10119. Any message that an application can send to IPF also can be sent by IPF 
  10120. communication objects. As a programmer working with communication objects, you 
  10121. will need to understand the following important help manager messages: 
  10122.  
  10123.      HM_CONTROL 
  10124.      HM_INFORM 
  10125.      HM_INVALIDATE_DDF_DATA 
  10126.      HM_NOTIFY 
  10127.      HM_QUERY 
  10128.      HM_QUERY_DDF_DATA 
  10129.      HM_SET_COVERPAGE_SIZE 
  10130.      HM_SET_OBJCOM_WINDOW 
  10131.      HM_SET_USERDATA 
  10132.      HM_UPDATE_OBJCOM_WINDOW_CHAIN 
  10133.  
  10134.  For a detailed description of these messages and other IPF messages, see Help 
  10135.  Manager Messages. 
  10136.  
  10137.  
  10138. ΓòÉΓòÉΓòÉ 13.4.2. The Communication Chain ΓòÉΓòÉΓòÉ
  10139.  
  10140. Communication objects, whether they are loaded by means of a :docprof. tag or 
  10141. an :acviewport. tag, function in a "communication chain." The chain is 
  10142. maintained through the passing of HM_ messages unidirectionally through the 
  10143. chain. 
  10144.  
  10145. IPF passes all messages to the active communication object (including, but not 
  10146. limited to, HM_ messages) as they are generated by the user's actions. The 
  10147. active communication object is then responsible for passing on any HM_ messages 
  10148. it receives through the chain to a neighboring communication object. The handle 
  10149. of the neighboring communication object window is returned by the 
  10150. HM_SET_OBJCOM_WINDOW (see Adding Your Communication Object to the Communication 
  10151. Chain). 
  10152.  
  10153. Even if you are certain that your communication object will not be used in 
  10154. combination with other communication objects, it is your responsibility to code 
  10155. your communication object contingent on the possibility that other 
  10156. communication objects may be present in the chain. Therefore, it is important 
  10157. for you to create communication objects that keep the communication chain 
  10158. intact through message passing. 
  10159.  
  10160.  
  10161. ΓòÉΓòÉΓòÉ 13.4.2.1. Making Your Communication Objects Function in the Chain ΓòÉΓòÉΓòÉ
  10162.  
  10163. As a programmer creating communication objects, you need to be certain that 
  10164. your communication object can successfully complete the following communication 
  10165. chain tasks: 
  10166.  
  10167.    1. Your communication object must add itself to the communication chain. 
  10168.  
  10169.    2. If a communication object that was added to the chain before your 
  10170.       communication object was added removes itself from the chain, your 
  10171.       communication object must respond to keep the chain intact. 
  10172.  
  10173.    3. Your communication object must be able to remove itself from the chain 
  10174.       and keep the chain intact. 
  10175.  
  10176.  
  10177. ΓòÉΓòÉΓòÉ 13.4.2.1.1. Adding Your Communication Object to the Communication Chain ΓòÉΓòÉΓòÉ
  10178.  
  10179. Even if your communication object is the only one in use, your communication 
  10180. object is still part of the communication chain. To add itself to the chain, 
  10181. your communication object must: 
  10182.  
  10183.    1. Send the help manager message HM_SET_OBJCOM_WINDOW to the window 
  10184.       PACVP->hWnd Parent. 
  10185.  
  10186.       Your communication object must pass its frame handle as the first 
  10187.       parameter. 
  10188.  
  10189.    2. Your communication object must receive and store the window handle it 
  10190.       receives in return. 
  10191.  
  10192.    3. Your communication object should pass all HM_ help manager messages to 
  10193.       that window handle. 
  10194.  
  10195.  The following code fragment illustrates this process. 
  10196.  
  10197.   #define INCL_WIN
  10198.   #define INCL_WINHELP
  10199.   #include <os2.h>
  10200.  
  10201.   #define HM_MSG_MAX (HM_MSG_BASE+0x0024)
  10202.  
  10203.   USHORT   IPFClassRegistered = 0;         /* IPF class registered flag        */
  10204.  
  10205.   /* Main Entry point */
  10206.   MRESULT EXPENTRY IPFMain (PACVP pACVP, PCH Parameter);
  10207.  
  10208.   /* Pop up error box */
  10209.   VOID Error (PCH str);
  10210.  
  10211.  
  10212.   MRESULT EXPENTRY IPFMain (PACVP pACVP, PCH Parameter)
  10213.   /* pACVP contains the following structure:
  10214.  
  10215.      typedef struct_ACVP
  10216.      {
  10217.         ULONG  cb;                   length
  10218.         HAB    hAB;                  anchor block handle
  10219.         HMQ    hmq;                  messge queue handle
  10220.         ULONG  ObjectID;             object identifier
  10221.         HWND   hWndParent;           IPF viewport client handle
  10222.         HWND   hWndOwner;            IPF viewport client handle
  10223.         HWND   hWndACVP;             applications frame window hwnd
  10224.      } ACVP, *PACVP;
  10225.  
  10226.   This structure is prefilled in except for hWndACVP.  You must put your
  10227.   window handle there if you are creating an application-controlled viewport.
  10228.   If this is just a generic communication object, you do not need to fill it in.
  10229.  
  10230.   Parameter is the information passed in with the objectinfo tag.
  10231.  
  10232.   Note: You can use ObjectID to have multiple acviewports and comm objects
  10233.   use the same entry point.  Check the ObjectID to find out where you were
  10234.   called from in the IPF file. */
  10235.  
  10236.   {
  10237.       HWND  hwndFrame, hwndPrevious, hwndLatest, hwndClient;
  10238.       ULONG CtrlData = 0;
  10239.  
  10240.       Error ( Parameter );
  10241.       /* Check global to see if our window class has been registered. */
  10242.       /* if not, register it.                                         */
  10243.       if (!IPFClassRegistered)
  10244.       {
  10245.           /* We will register our class with 4 extra bytes of information
  10246.              so that we can place the previous object comm window handle there.
  10247.              You might want to create a structure store here instead. */
  10248.           if (!WinRegisterClass( pACVP->hAB,
  10249.                                  "CLASS_IPF",
  10250.                                  (PFNWP) IPF_WinProc,
  10251.                                  CS_SYNCPAINT | CS_SIZEREDRAW | CS_MOVENOTIFY,
  10252.                                  4))
  10253.           {
  10254.               Error ("Can not register class");
  10255.               exit (TRUE);
  10256.           }
  10257.           IPFClassRegistered = 1;
  10258.       }
  10259.  
  10260.       /* Create window.  Visibility does not matter, as IPF will take care
  10261.          of it. */
  10262.       if (!(hwndFrame = WinCreateStdWindow (pACVP->hWndParent,
  10263.                                             WS_VISIBLE,
  10264.                                             &CtrlData,
  10265.                                             "CLASS_IPF",
  10266.                                             "IPF",
  10267.                                             0L,
  10268.                                             0L,
  10269.                                             0L,
  10270.                                             &hwndClient
  10271.                                             )))
  10272.       {
  10273.           Error ("Can not create window");
  10274.           return (MRESULT) TRUE;
  10275.       }
  10276.  
  10277.       /* Setup our window in the ACVP structure.  This is only necessary if
  10278.          you are creating an acviewport. */
  10279.       pACVP->hWndACVP = hwndFrame;
  10280.  
  10281.       /* Set the current comm object window to us */
  10282.       hwndPrevious = (HWND) WinSendMsg (pACVP->hWndParent,
  10283.                                         HM_SET_OBJCOM_WINDOW,
  10284.                                         (MPARAM) hwndFrame,
  10285.                                         (MPARAM)NULL);
  10286.  
  10287.       /* Query back the comm obj window */
  10288.       hwndLatest = (HWND) WinSendMsg (pACVP->hWndParent,
  10289.                                       HM_QUERY,
  10290.                                       MPFROM2SHORT ((USHORT)0, HMQW_OBJCOM_WINDOW),
  10291.                                       (MPARAM)NULL);
  10292.  
  10293.       /* double check to make sure we are in the comm chain */
  10294.       if (hwndFrame != hwndLatest)
  10295.       {
  10296.           Error ("Can not set object communication window");
  10297.           return (MRESULT) TRUE;
  10298.       }
  10299.  
  10300.       /* Store the previous commobj handle in window words */
  10301.       if (!WinSetWindowULong (hwndClient, QWL_USER, (ULONG) hwndPrevious))
  10302.       {
  10303.           Error ("Can not save handle into reserved memory");
  10304.           return (MRESULT) TRUE;
  10305.       }
  10306.       return (MRESULT) FALSE;
  10307.   }
  10308.  
  10309.   VOID Error (PCH str)
  10310.  
  10311.   {
  10312.       WinMessageBox (HWND_DESKTOP,
  10313.                      HWND_DESKTOP,
  10314.                      (PCH)str,
  10315.                      (PCH)"IPF Sample Error Message",
  10316.                      1,
  10317.                      MB_OK | MB_APPLMODAL |
  10318.                      MB_MOVEABLE | MB_ICONASTERISK);
  10319.   }
  10320.  
  10321.  
  10322. ΓòÉΓòÉΓòÉ 13.4.2.1.2. Responding to the Removal of Another Object in the Chain ΓòÉΓòÉΓòÉ
  10323.  
  10324. If a communication object that was added to the chain before your communication 
  10325. object removes itself from the chain, your communication object must respond to 
  10326. keep the chain intact. 
  10327.  
  10328. This involves several steps: 
  10329.  
  10330.    1. Your communication object must process the HM_UPDATE_OBJCOM_WINDOW_CHAIN 
  10331.       help manager message. This message provides your communication object 
  10332.       with: 
  10333.  
  10334.         a. The handle of the communication object that is removing itself from 
  10335.            the chain. 
  10336.  
  10337.         b. The window handle for the object to serve as a replacement in the 
  10338.            chain. 
  10339.  
  10340.       Your communication object does not need to respond unless the first 
  10341.       parameter, the handle of the communication object removing itself, is 
  10342.       identical to the handle returned to your communication object when it 
  10343.       initially sent a HM_SET_OBJCOM_WINDOW message to add itself to the chain 
  10344.       (see Adding Your Communication Object to the Communication Chain). Your 
  10345.       communication object should have stored this handle. 
  10346.  
  10347.    2. If the second parameter returned by HM_UPDATE_OBJCOM_WINDOW_CHAIN does 
  10348.       not match the handle previously returned by HM_SET_OBJCOM_WINDOW, your 
  10349.       communication object is not affected by the modification to the chain and 
  10350.       does not need to respond other than to pass on the message to the next 
  10351.       communication object in the chain. 
  10352.  
  10353.       However, if these handles are identical, your communication object has a 
  10354.       new "neighbor" in the chain, and should begin passing all HM_ help 
  10355.       manager messages to the object identified by the handle returned as the 
  10356.       first parameter of HM_UPDATE_OBJCOM_WINDOW_CHAIN. 
  10357.  
  10358.  The following code fragment illustrates this process. 
  10359.  
  10360.   #define INCL_WIN
  10361.   #define INCL_WINHELP
  10362.   #include <os2.h>
  10363.  
  10364.   #define HM_MSG_MAX (HM_MSG_BASE+0x0024)
  10365.  
  10366.   USHORT   IPFClassRegistered = 0;         /* IPF class registered flag        */
  10367.  
  10368.   /* Window procedure */
  10369.   MRESULT EXPENTRY IPFWinProc (HWND hwnd, USHORT msg, MPARAM mp1, MPARAM mp2);
  10370.  
  10371.  
  10372.   MRESULT EXPENTRY IPFWinProc (HWND hwnd, USHORT msg, MPARAM mp1, MPARAM mp2)
  10373.   /* The window procedure will handle deleting ourselves from the chain
  10374.      as well as forwarding all standard IPF message on the the next window in
  10375.      the chain */
  10376.   {
  10377.      HWND hwndPrevious, hwndLatest;
  10378.  
  10379.      /* Get previous comm obj */
  10380.      hwndPrevious = (HWND) WinQueryWindowULong (hwnd, QWL_USER);
  10381.      /* Handle the messages you want here, but do not return unless you
  10382.         now the message will not need to be handled by another comm obj.
  10383.         Let the the message be forwarded on to the next comm obj.  The
  10384.         only exception to this is if you change the cover page size.  You
  10385.         need to return TRUE to prevent the coverpage from being resized. */
  10386.      switch (msg)
  10387.      {
  10388.         case HM_UPDATE_OBJCOM_WINDOW_CHAIN:
  10389.            /* If another window is being inserted, replace previous with it */
  10390.            if (hwndPrevious == (HWND)mp1) {
  10391.               hwndPrevious = (HWND)mp2;
  10392.               if (!WinSetWindowULong (hwnd, QWL_USER, (ULONG) hwndPrevious)) {
  10393.                  /* Put up error message */
  10394.                  WinMessageBox (HWND_DESKTOP,
  10395.                                 HWND_DESKTOP,
  10396.                                 (PCH)"Can not save handle into reserved memory",
  10397.                                 (PCH)"IPF Sample Error Message",
  10398.                                 1,
  10399.                                 MB_OK | MB_APPLMODAL |
  10400.                                 MB_MOVEABLE | MB_ICONASTERISK);
  10401.                  break;
  10402.               }
  10403.  
  10404.            } else {
  10405.               /* Otherwise simply forward the message on */
  10406.               if (hwndPrevious != 0L) {
  10407.                  WinSendMsg (hwndPrevious, HM_UPDATE_BJCOM_WINDOW_CHAIN,
  10408.                              (MPARAM) mp1, (MPARAM) mp2);
  10409.               }
  10410.            }
  10411.            return (MPARAM) NULL;
  10412.            break;
  10413.         case WM_CLOSE:
  10414.            WinDestroyWindow (WinQueryWindow (hwnd, QW_PARENT));
  10415.            return (MPARAM) NULL;
  10416.            break;
  10417.         case WM_DESTROY:
  10418.            /* Take ourselves out of the chain */
  10419.            hwndLatest = (HWND)WinSendMsg (hwnd, HM_QUERY,
  10420.                                           MPFROM2SHORT (0, HMQW_OBJCOM_WINDOW),
  10421.                                           (MPARAM)NULL);
  10422.            WinSendMsg (hwndLatest, HM_UPDATE_OBJCOM_WINDOW_CHAIN,
  10423.                        (MPARAM) WinQueryWindow (hwnd, QW_PARENT),
  10424.                        (MPARAM) hwndPrevious );
  10425.            return (MPARAM) NULL;
  10426.            break;
  10427.      }
  10428.      if ((msg > HM_MSG_BASE) && (msg <= HM_MSG_MAX)) {
  10429.         return WinSendMsg( hwndPrevious, msg, mp1, mp2);
  10430.      } else {
  10431.         return WinDefWindowProc (hwnd, msg, mp1, mp2);
  10432.      } /* endif */
  10433.   }
  10434.  
  10435.  
  10436. ΓòÉΓòÉΓòÉ 13.4.2.1.3. Removing Your Communication Object from the Chain ΓòÉΓòÉΓòÉ
  10437.  
  10438. Your communication object must be able to remove itself from the chain and keep 
  10439. the chain intact. When the communication object does remove itself, it is no 
  10440. longer the active object. This can be carried out as follows: 
  10441.  
  10442.    1. Your communication object must process the WM_DESTROY message sent by IPF 
  10443.       that corresponds to the closure of a window with which your communication 
  10444.       object is associated. 
  10445.  
  10446.    2. Your communication object must query the current object window using 
  10447.       HM_QUERY. This returns the handle of the current object window. 
  10448.  
  10449.    3. Your communication object can then send the HM_UPDATE_OBJCOM_WINDOW_CHAIN 
  10450.       message to the handle of the current object window including the handle 
  10451.       of your communication object, which was returned when you added your 
  10452.       communication object to the chain (see Adding Your Communication Object 
  10453.       to the Communication Chain). 
  10454.  
  10455.  The following code fragment illustrates this process: 
  10456.  
  10457.  
  10458.           case WM_DESTROY:
  10459.  
  10460.               hwndPrevious = (HWND) WinQueryWindowULong (hwnd, COM_HWND);
  10461.  
  10462.               hwndLatest = (HWND) WinSendMsg (hwnd,
  10463.                                        HM_QUERY,
  10464.                                        MPFROM2SHORT ((USHORT)0, HMQW_OBJCOM_WINDOW),
  10465.                                        NULL);
  10466.  
  10467.               WinMessageBox (HWND_DESKTOP,
  10468.                              HWND_DESKTOP,
  10469.                              (PCH)str,
  10470.                              (PCH)"IPF Sample Error Message",
  10471.                              1,
  10472.                              MB_OK | MB_APPLMODAL |
  10473.                              MB_MOVEABLE | MB_ICONASTERISK);
  10474.               WinSendMsg (hwndLatest,
  10475.                           HM_UPDATE_OBJCOM_WINDOW_CHAIN,
  10476.                           (MPARAM) hwndPrevious,
  10477.                           (MPARAM) WinQueryWindow (hwnd, QW_PARENT));
  10478.  
  10479.               rValue = FALSE;
  10480.               break;
  10481.  
  10482.           default:
  10483.  
  10484.               rValue = TRUE;
  10485.               break;
  10486.  
  10487.       }
  10488.   }
  10489.  
  10490.  
  10491. ΓòÉΓòÉΓòÉ 13.5. Changing the Coverpage Window ΓòÉΓòÉΓòÉ
  10492.  
  10493. One of the IPF customizations you can do with your communication object is 
  10494. manipulating the IPF coverpage window. 
  10495.  
  10496. When an online book is opened or when an application requests that IPF create a 
  10497. help instance, IPF creates a coverpage frame window. The coverpage window is 
  10498. the window in which all other information is displayed. IPF-controlled windows 
  10499. are children of the coverpage window, as are application-controlled windows. 
  10500.  
  10501. IPF communication objects can change the look and functionality of the 
  10502. coverpage window. For example, a communication object can change the size or 
  10503. location of the coverpage, or remove its menu bar. 
  10504.  
  10505. For HLP files, applications can change only the size of a help window. The 
  10506. application would do this by sending HM_SET_COVERPAGE_SIZE to the help instance 
  10507. created with WinCreateHelpInstance. Note that applications must not move the 
  10508. help window. 
  10509.  
  10510. For INF files, the communication object must handle the OPEN_COVERPAGE event of 
  10511. the HM_NOTIFY message, then use WinSetWindowPos to set the size and position of 
  10512. the coverpage. The coverpage window's handle is in mp2. 
  10513.  
  10514. When using WinSetWindowPos to change the position and size of the coverpage 
  10515. window, you must OR SWP_SHOW with SWP_MOVE or SWP_SIZE, or both. 
  10516.  
  10517. You must return directly from your code when you handle this event. Do not pass 
  10518. the HM_NOTIFY message on to the default window procedure. 
  10519.  
  10520. In addition to the techniques specified here for resizing and positioning the 
  10521. coverpage, once you have the handle to the coverpage you can use any of the 
  10522. other PM window manipulation techniques, such as manipulating the frame 
  10523. controls or menus. For example, to remove the coverpage's menu bar, you would 
  10524. call WinDestroyWindow in response to an OPEN_COVERPAGE event, as in the 
  10525. following example: 
  10526.  
  10527. WinDestroyWindow(WinWindowFromID((HWND) mp2, FID_MENU));
  10528.  
  10529. Use other FID_* IDs to work with other parts of the coverpage window. 
  10530.  
  10531. The code fragment in the following figure illustrates these techniques by 
  10532. changing the size and location of the coverpage and removing the menu bar. 
  10533.  
  10534. HWND hwndCoverPage;
  10535.    .
  10536.    .
  10537.    .
  10538.    /* Inside the main switch statement in your window procedure... */
  10539.    case HM_NOTIFY:
  10540.  
  10541.       switch (SHORT1FROMMP(mp1)) {
  10542.  
  10543.          case OPEN_COVERPAGE:
  10544.             hwndCoverPage = (HWND) mp2;   /* Handle to coverpage is in mp2 */
  10545.  
  10546.             /* Remove the menu */
  10547.             WinDestroyWindow(WinWindowFromID(hwndCoverPage, FID_MENU));
  10548.  
  10549.             /* Change the size and location of coverpage */
  10550.             WinSetWindowPos(hwndCoverPage, 0, 10, 10, 200, 200,
  10551.                             SWP_SIZE | SWP_MOVE | SWP_SHOW);
  10552.  
  10553.             return TRUE;
  10554.  
  10555.       } /* endswitch */
  10556.  
  10557.       break;
  10558.  
  10559.  
  10560. ΓòÉΓòÉΓòÉ 14. Controlling Windows with Applications (ACVIEWPORTS) ΓòÉΓòÉΓòÉ
  10561.  
  10562. IPF handles the formatting and display of text and graphic information within 
  10563. its windows. IPF-controlled windows are defined in the tagged source file with 
  10564. a heading tag or :link.. These windows are IPF-controlled because IPF provides 
  10565. the window procedures that control them. The content and presentation of 
  10566. information in an IPF-controlled window is limited by the functions of a 
  10567. standard OS/2 window. 
  10568.  
  10569. To create IPF-controlled windows, an author requires only tagging skills; 
  10570. however, to create application-controlled windows, an author requires both 
  10571. tagging and programming skills. 
  10572.  
  10573. Application-controlled windows are defined in the tagged source file with the 
  10574. application-controlled window tag (:acviewport.). With this tag, a window is 
  10575. controlled by a communication object (see Customizing IPF with Communication 
  10576. Objects) that has been written and compiled into the form of a dynamic link 
  10577. library (DLL). When an IPF window is displayed at execution time and 
  10578. :acviewport. is encountered, IPF passes control to the entry point in the DLL 
  10579. specified by the objectname=' ' attribute of :acviewport.. This entry point is, 
  10580. in fact, a communication object. 
  10581.  
  10582. At this point, the communication object takes control and executes the 
  10583. instructions specified in the source file. When the call returns to IPF, IPF 
  10584. sizes and positions the window on the screen as defined in the heading tag or 
  10585. :link. (see Customizing Windows). 
  10586.  
  10587. The :acviewport tag can share a panel with text and, for that matter, you can 
  10588. have more than one :acviewport tag in the same panel. 
  10589.  
  10590. In addition, an acviewport communication object can be called from more than 
  10591. one panel. The objectid= attribute enables the communication object to 
  10592. determine which help panel called it. 
  10593.  
  10594. The following figure shows the tagging to produce a split window.  In this 
  10595. example, the contents of the left window are IPF-controlled.  The contents of 
  10596. the right window are defined and controlled by the IPF communication object 
  10597. IPFMain which resides in IPF.DLL. 
  10598.  
  10599. :userdoc.
  10600. :title.Information Presentation Facility
  10601. :docprof ctrlarea=none.
  10602. :h1 res=016 scroll=none clear.Using a Mouse
  10603. .*
  10604. :link reftype=hd res=017 auto split
  10605.       vpx=left vpy=top vpcx=50% vpcy=100%
  10606.       rules=border scroll=none titlebar=none.
  10607. .*
  10608. :acviewport dll='ipf'
  10609.             objectname='IPFMain' objectid=1
  10610.             vpx=right vpy=top vpcx=50% vpcy=100%.
  10611. .*
  10612. :h2 res=017.Using a Mouse
  10613. .*
  10614. :p.You move the pointer (usually an arrow) so that it
  10615. points at the objects and actions you want to select.
  10616. :p.If you run out of room to slide the mouse, lift it up, put it
  10617. back down, and slide it again.
  10618. :p.The left-hand mouse button (or mouse button 1) is
  10619. usually used to select objects on the screen.
  10620. :p.The right-hand mouse button (or mouse button 2) is
  10621. usually used to :hp1.drag:ehp1. or move
  10622. objects around the screen.
  10623. :euserdoc.
  10624.  
  10625. The following figure shows the compiled version of the tagging shown in the 
  10626. previous figure. 
  10627.  
  10628. The left window is IPF-controlled. The right window displays an animated mouse 
  10629. whose activity is controlled by a routine in a DLL. 
  10630.  
  10631. In the previous example, IPF processes :acviewport. as follows: 
  10632.  
  10633.    1. It loads IPF.DLL and calls the procedure IPFMain.  This object name is 
  10634.       case sensitive. 
  10635.  
  10636.    2. IPFMain creates a window and registers it with IPF as an object 
  10637.       communication window. 
  10638.  
  10639.    3. When the call to IPFMain returns to IPF, IPF gives instructions to 
  10640.       display the animated mouse. 
  10641.  
  10642.  IPFMain, IPF.DLL, and the bit maps used for the animated mouse are provided in 
  10643.  the IPF sample program available with the Toolkit. 
  10644.  
  10645.  
  10646. ΓòÉΓòÉΓòÉ 14.1. Writing the Communication Object Code ΓòÉΓòÉΓòÉ
  10647.  
  10648. An IPF communication object can be structured in many ways.  Its content 
  10649. depends on the function being implemented. Application-controlled windows 
  10650. typically simulate activity that might or might not require user interaction. 
  10651.  
  10652. An example of a communication object is provided in the IPF sample program 
  10653. (available in the Toolkit), and is shown in the previous IPF-controlled window 
  10654. example. The program contains two procedures: 
  10655.  
  10656. IPFMain registers a window class for the application-controlled window, creates 
  10657. an instance of the class, and registers it with IPF as a communication object. 
  10658.  
  10659. IPFWinProc provides the animation in the application-controlled window. 
  10660. IPFWinProc is called by IPFMain procedure. 
  10661.  
  10662. #define INCL_WIN
  10663. #define INCL_GPI
  10664. #define INCL_DOS
  10665. #define INCL_DOSMODULEMGR
  10666. #define LINT_ARGS
  10667. #define DINCL_32
  10668.  
  10669. #include <OS2.H>
  10670. #include "IPF.H"
  10671.  
  10672. #define COM_HWND             4  /* Used in WinSetWindowULong              */
  10673. #define FRAMES               5  /* Number of frames in animation sequence */
  10674. #define BEEP_WARN_FREQ      60  /* Frequency of warning beep              */
  10675. #define BEEP_WARN_DUR      100  /* Duration of warning beep               */
  10676.  
  10677. USHORT   IPFClassRegistered = 0;         /* IPF class registered flag     */
  10678. HWND     hwndClient;                     /* Handle to the client window   */
  10679. HWND     hwndPrevious;                   /* Handle to the previous active */
  10680.                                          /* object communication window   */
  10681. HWND     hwndLatest;                     /* Handle to the latest active   */
  10682.                                          /* object communication window   */
  10683.  
  10684. MRESULT EXPENTRY IPFMain (PACVP pACVP, PCH Parameter);
  10685. MRESULT EXPENTRY IPFWinProc (HWND hwnd, USHORT msg, MPARAM mp1, MPARAM mp2);
  10686. VOID Error (PCH str);
  10687.  
  10688. MRESULT EXPENTRY IPFMain (PACVP pACVP, PCH Parameter)
  10689. {
  10690.  
  10691.     HWND  hwndParent;         /* Handle of parent window in IPF             */
  10692.     HWND  hwndFrame;          /* Handle to the frame                        */
  10693.     ULONG WinStyle;           /* window style for creating frame            */
  10694.     ULONG CtrlData;           /* control data for creating frame            */
  10695.  
  10696.     Parameter; /* Warning Level 3 Avoidance */
  10697.  
  10698. /** 1) Initialize **/
  10699.     if (!IPFClassRegistered)
  10700.     {
  10701.         if (!WinRegisterClass (pACVP->hAB,
  10702.                                "CLASS_IPF",
  10703.                                (PFNWP) IPFWinProc,
  10704.                                CS_SYNCPAINT | CS_SIZEREDRAW | CS_MOVENOTIFY,
  10705.                                8))
  10706.         {
  10707.             DosBeep (BEEP_WARN_FREQ, BEEP_WARN_DUR);
  10708.             exit (TRUE);
  10709.         }
  10710.         IPFClassRegistered = 1;
  10711.     }
  10712.     WinStyle = 0L;
  10713.     CtrlData = 0L;
  10714.  
  10715.     if (!(hwndFrame = WinCreateStdWindow (pACVP->hWndParent,
  10716.                                           WinStyle,
  10717.                                           &CtrlData,
  10718.                                           "CLASS_IPF",
  10719.                                           "IPF",
  10720.                                           0L,
  10721.                                           0L,
  10722.                                           0L,
  10723.                                           &hwndClient
  10724.                                           )))
  10725.     {
  10726.         Error ("Cannot create window");
  10727.         return (MRESULT) TRUE;
  10728.     }
  10729.  
  10730. /** 2) Process **/
  10731.  
  10732.     pACVP->hWndACVP = hwndFrame;
  10733.  
  10734.     hwndParent = pACVP->hWndParent;
  10735.  
  10736.     hwndPrevious = WinSendMsg (pACVP->hWndParent,
  10737.                                HM_SET_OBJCOM_WINDOW,
  10738.                                (MPARAM) hwndFrame,
  10739.                                NULL);
  10740.  
  10741.     hwndLatest = WinSendMsg (pACVP->hWndParent,
  10742.                              HM_QUERY,
  10743.                              MPFROM2SHORT (NULL, HMQW_OBJCOM_WINDOW),
  10744.                              NULL);
  10745.  
  10746.     if (hwndFrame != hwndLatest)
  10747.     {
  10748.         Error ("Cannot set object communication window");
  10749.         return (MRESULT) TRUE;
  10750.     }
  10751.  
  10752. /** 3) Finish **/
  10753.  
  10754.     if (!WinSetWindowULong (hwndClient, COM_HWND, (ULONG) hwndPrevious))
  10755.     {
  10756.         Error ("Cannot save handle into reserved memory");
  10757.         return (MRESULT) TRUE;
  10758.     }
  10759.     return (MRESULT) FALSE;
  10760. }
  10761.  
  10762. MRESULT EXPENTRY IPFWinProc (HWND hwnd, USHORT msg, MPARAM mp1, MPARAM mp2)
  10763. {
  10764.  
  10765.     static HAB      Hhab;         /* anchor block handle                    */
  10766.     static HBITMAP  hbm [5];      /* array of bitmap handles                */
  10767.     static HPS      hps;          /* presentation space                     */
  10768.     static POINTL   ptl;          /* pointl                                 */
  10769.     static HMODULE  hModule;      /* to get bitmaps from DLL resource       */
  10770.     static SHORT    index;        /* index to current bitmap to display     */
  10771.     static LONG     cxClient,
  10772.                     cyClient;     /* window size                            */
  10773.            BOOL     rValue=TRUE;  /* FALSE if the message was acted         */
  10774.                                   /* upon successfully                      */
  10775.  
  10776. /** 1) Initialize **/
  10777.  
  10778.     switch (msg)
  10779.     {
  10780.         case HM_UPDATE_OBJCOM_WINDOW_CHAIN:
  10781.  
  10782.             hwndPrevious = (HWND) WinQueryWindowULong (hwnd, COM_HWND);
  10783.  
  10784.             if (hwndPrevious == mp2)
  10785.             {
  10786.                  hwndPrevious = mp1;
  10787.  
  10788.                if (!WinSetWindowULong (hwndClient,
  10789.                                         COM_HWND,
  10790.                                         (ULONG) hwndPrevious))
  10791.                 {
  10792.                     Error ("Cannot save handle into reserved memory");
  10793.                     break;
  10794.                 }
  10795.             }
  10796.             else
  10797.             {
  10798.                 if (hwndPrevious != NULL)
  10799.                 {
  10800.                     WinSendMsg (hwndPrevious,
  10801.                                 HM_UPDATE_OBJCOM_WINDOW_CHAIN,
  10802.                                 (MPARAM) mp1,
  10803.                                 (MPARAM) mp2);
  10804.                 }
  10805.             }
  10806.  
  10807.             rValue = FALSE;
  10808.             break;
  10809.  
  10810.         case WM_CREATE:
  10811.  
  10812.             if (DosLoadModule (NULL, 0L, "IPF", &hModule))
  10813.             {
  10814.                 Error ("Cannot load module");
  10815.                 break;
  10816.             }
  10817.  
  10818.             if (!(hps = WinGetPS(hwnd)))
  10819.             {
  10820.                 Error ("Cannot get presentation space");
  10821.                 break;
  10822.             }
  10823.  
  10824.             for (index = 0; index < FRAMES; index++)
  10825.             {
  10826.                 if (!(hbm [index] = GpiLoadBitmap (hps,
  10827.                                                    hModule,
  10828.                                                    (USHORT)(IDB_FRAME1+index),
  10829.                                                    cxClient,
  10830.                                                    cyClient)))
  10831.                 {
  10832.                     Error ("Cannot load bitmap");
  10833.                     return (MRESULT) rValue;
  10834.                 }
  10835.             }
  10836.  
  10837.             WinReleasePS (hps);
  10838.  
  10839.             index = 0;
  10840.  
  10841.             if (!(Hhab = WinQueryAnchorBlock (hwnd)))
  10842.             {
  10843.                 Error ("Cannot retrieve anchor block handle");
  10844.                 break;
  10845.             }
  10846.  
  10847.             if (!WinStartTimer (Hhab, hwnd, ID_TIMER, 150))
  10848.             {
  10849.                 Error ("Cannot start timer");
  10850.                 break;
  10851.             }
  10852.  
  10853.             rValue = FALSE;
  10854.             break;
  10855.  
  10856.         case WM_TIMER:
  10857.  
  10858.             if (index++ == FRAMES-1)
  10859.             {
  10860.                 index = 0;
  10861.             }
  10862.  
  10863.             WinInvalidateRect (hwnd, NULL, FALSE);
  10864.  
  10865.             rValue = FALSE;
  10866.             break;
  10867.  
  10868. /** 2) Process **/
  10869.  
  10870.         case WM_PAINT:
  10871.  
  10872.             if (!(hps = WinBeginPaint (hwnd, NULL, NULL)))
  10873.             {
  10874.                 Error ("Cannot set presentation space for drawing");
  10875.                 break;
  10876.             }
  10877.  
  10878.             if (!WinDrawBitmap (hps,
  10879.                                 hbm [index],
  10880.                                 NULL,
  10881.                                 &ptl,
  10882.                                 CLR_NEUTRAL,
  10883.                                 CLR_BACKGROUND,
  10884.                                 DBM_NORMAL))
  10885.             {
  10886.                 Error ("Cannot draw bitmap");
  10887.                 break;
  10888.             }
  10889.  
  10890.             WinEndPaint (hps);
  10891.  
  10892.             rValue = FALSE;
  10893.             break;
  10894.  
  10895.         case WM_SIZE:
  10896.  
  10897.             cxClient = SHORT1FROMMP (mp2);
  10898.             cyClient = SHORT2FROMMP (mp2);
  10899.  
  10900.             rValue = FALSE;
  10901.             break;
  10902.  
  10903. /** 3) Finish **/
  10904.  
  10905.         case WM_CLOSE:
  10906.  
  10907.             WinDestroyWindow (WinQueryWindow (hwnd, QW_PARENT));
  10908.  
  10909.             rValue = FALSE;
  10910.             break;
  10911.  
  10912.         case WM_DESTROY:
  10913.  
  10914.             WinStopTimer (Hhab, hwnd, ID_TIMER);
  10915.  
  10916.             for (index = 0; index < 8; index++)
  10917.             {
  10918.                 GpiDeleteBitmap (hbm [index]);
  10919.             }
  10920.  
  10921.             hwndPrevious = (HWND) WinQueryWindowULong (hwnd, COM_HWND);
  10922.  
  10923.             hwndLatest = WinSendMsg (hwnd,
  10924.                                      HM_QUERY,
  10925.                                      MPFROM2SHORT (NULL, HMQW_OBJCOM_WINDOW),
  10926.                                      NULL);
  10927.  
  10928.             WinSendMsg (hwndLatest,
  10929.                         HM_UPDATE_OBJCOM_WINDOW_CHAIN,
  10930.                         (MPARAM) hwndPrevious,
  10931.                         (MPARAM) WinQueryWindow (hwnd, QW_PARENT));
  10932.  
  10933.             DosFreeModule (hModule);
  10934.  
  10935.             rValue = FALSE;
  10936.             break;
  10937.  
  10938.         default:
  10939.  
  10940.             rValue = TRUE;
  10941.             break;
  10942.  
  10943.     }
  10944.  
  10945.     return (rValue ? WinDefWindowProc (hwnd, msg, mp1, mp2) : 0L);
  10946.  
  10947. }
  10948.  
  10949.  
  10950. ΓòÉΓòÉΓòÉ 14.1.1. Using Communication Windows ΓòÉΓòÉΓòÉ
  10951.  
  10952. To position windows or graphics within an application-controlled window, the 
  10953. IPF communication object requires a communication object window. For example, 
  10954. an application-controlled window can be used to represent the workplace, with 
  10955. an interactive, simulated application window positioned on the workplace. 
  10956. However, because IPF sizes and positions the application-controlled window 
  10957. after returning from the call to a communication object, the communication 
  10958. object cannot size and position the simulated application window until after it 
  10959. has created the window and returned control to IPF. 
  10960.  
  10961. The dilemma is resolved because the communication object can receive HM_INFORM 
  10962. messages after :acviewport. has been processed by IPF and the communication 
  10963. object has created an active communication object window. Upon receiving the 
  10964. HM_INFORM message from IPF, the window procedure can then create the simulated 
  10965. application window and position it within the application-controlled window. 
  10966.  
  10967. The following C-language source code contains the communication object 
  10968. ComWindow that creates a communication window and processes messages from IPF. 
  10969.  
  10970. #define INCL_WIN
  10971. #define INCL_DOS
  10972.  
  10973. #include <os2.h>
  10974.  
  10975. /* Define ID used with reftype = inform attribute in the link tag */
  10976. /* in tagged source for help information */
  10977.  
  10978. #define SIMULATE_APPWINDOW 1000
  10979.  
  10980. MRESULT EXPENTRY ComWindowProc (HWND hwnd, USHORT msg, MPARAM mp1, MPARAM mp2);
  10981. MRESULT EXPENTRY SimWindowProc (HWND hwnd, USHORT msg, MPARAM mp1, MPARAM mp2);
  10982.  
  10983. HWND hComWindow = NULL;
  10984. HWND hSimWindow = NULL;
  10985. HWND hComClientWindow;
  10986. HWND hSimClientWindow;
  10987. HWND PreviousComWindow;
  10988. HWND PreviousHwnd;
  10989.  
  10990. USHORT EXPENTRY ComWindow (pACVP, ObjectInfo)
  10991.  
  10992. PACVP pACVP;
  10993. PCH   ObjectInfo;
  10994. {
  10995.  
  10996. ULONG FrameFlags=0L;
  10997.  
  10998. /* Register class for communication window */
  10999.  
  11000.    WinRegisterClass (pACVP->hAB,
  11001.                      "CLASS_COMM",
  11002.                      (PFNWP)ComWindowProc,
  11003.                      CS_SYNCPAINT | CS_SIZEREDRAW | CS_MOVENOTIFY, 8);
  11004.  
  11005. /* Register class for simulated application window */
  11006.  
  11007.    WinRegisterClass (pACVP->hAB,
  11008.                      "CLASS_APPSIM",
  11009.                      (PFNWP)SimWindowProc,
  11010.                      CS_SYNCPAINT | CS_SIZEREDRAW | CS_MOVENOTIFY, 4);
  11011.  
  11012. /* Create the communication window */
  11013.  
  11014. hComWindow = WinCreateStdWindow (pACVP->hWndParent,
  11015.                                  0L,
  11016.                                  &FrameFlags,
  11017.                                  (PSZ)"CLASS_COMM",
  11018.                                  NULL,
  11019.                                  0L,
  11020.                                  (HMODULE)NULL,
  11021.                                  0L,
  11022.                                  (PHWND)&hComClientWindow);
  11023.  
  11024. /* Return handle of Communication frame window to IPF */
  11025.  
  11026. pACVP->hWndACVP=hComWindow;
  11027.  
  11028. /* Send a message to IPF indicating that it should talk to our */
  11029. /* communication window */
  11030.  
  11031. PreviousComWindow = WinSendMsg (pACVP->hWndParent,
  11032.                                 HM_SET_OBJCOM_WINDOW,
  11033.                                 (MPARAM)hComWindow,
  11034.                                 (MPARAM)hComWindow);
  11035.  
  11036. /* Save handle of IPF's communication window in window word of the */
  11037. /* communication window */
  11038.  
  11039. WinSetWindowULong (hComClientWindow, 0L, (ULONG)PreviousComWindow);
  11040.  
  11041. return FALSE;
  11042. }
  11043. MRESULT EXPENTRY ComWindowProc (HWND hwnd, USHORT msg, MPARAM mp1, MPARAM mp2)
  11044. {
  11045.     HPS      hps;
  11046.     RECTL    Rect;
  11047.  
  11048.     ULONG FrameFlags = FCF_TITLEBAR   | FCF_SYSMENU |
  11049.                        FCF_SIZEBORDER | FCF_MINMAX  ;
  11050.     switch (msg)
  11051.     {
  11052.  
  11053.         case HM_INFORM:
  11054.  
  11055.             switch ((USHORT)mp1)
  11056.             {
  11057.  
  11058.                 case SIMULATE_APPWINDOW:
  11059.  
  11060.                     /* create the application window */
  11061.  
  11062.                     hSimWindow = WinCreateStdWindow (hwnd,
  11063.                                                      WS_VISIBLE,
  11064.                                                      &FrameFlags,
  11065.                                                      (PSZ)"CLASS_APPSIM",
  11066.                                                      NULL,
  11067.                                                      0L,
  11068.                                                      (HMODULE)NULL,
  11069.                                                      0L,
  11070.                                                      (PHWND)&hSimClientWindow);
  11071.  
  11072.                     WinSetWindowText (hSimWindow, "Application X");
  11073.  
  11074.                     WinSendMsg (hSimWindow,
  11075.                                 WM_SETICON,
  11076.                                 WinQuerySysPointer (HWND_DESKTOP, SPTR_APPICON,
  11077.                                 FALSE),  NULL);
  11078.  
  11079.                     /* get the size of the communication client window */
  11080.  
  11081.                     WinQueryWindowRect (hwnd, &Rect);
  11082.  
  11083.                     /* adjust the size of the application window within the  */
  11084.                     /* communication client window                           */
  11085.  
  11086.                     Rect.xLeft = Rect.xRight / 12;
  11087.                     Rect.yBottom = Rect.yTop / 5;
  11088.                     Rect.xRight = Rect.xLeft * 10;
  11089.                     Rect.yTop = Rect.yBottom * 3;
  11090.  
  11091.                     /* position the application window within the */
  11092.                     /* communication client window                */
  11093.  
  11094.                     WinSetWindowPos (hSimWindow, HWND_TOP,
  11095.                                      (SHORT)Rect.xLeft,
  11096.                                      (SHORT)Rect.yBottom,
  11097.                                      (SHORT)Rect.xRight,
  11098.                                      (SHORT)Rect.yTop,
  11099.                                      (SWP_SHOW | SWP_SIZE |
  11100.                                       SWP_MOVE | SWP_ACTIVATE));
  11101.  
  11102.                     return (MRESULT)TRUE;
  11103.             }
  11104.  
  11105.         case WM_PAINT:
  11106.  
  11107.             hps = WinBeginPaint (hwnd, (HPS)NULL, (PRECTL)NULL);
  11108.             WinQueryWindowRect (hwnd, &Rect);
  11109.             WinFillRect (hps, &Rect, CLR_RED);
  11110.             WinEndPaint (hps);
  11111.             break;
  11112.  
  11113.         case WM_CLOSE:
  11114.  
  11115.             WinDestroyWindow (WinQueryWindow (hwnd, QW_PARENT));
  11116.             return (MRESULT)TRUE;
  11117.  
  11118.         case WM_DESTROY:
  11119.  
  11120.             PreviousHwnd = (HWND)WinQueryWindowULong (hwnd, 0L);
  11121.             WinSendMsg (WinQueryWindow (hwnd, QW_PARENT),
  11122.                         HM_SET_OBJCOM_WINDOW,
  11123.                         PreviousHwnd,
  11124.                         NULL);
  11125.             break;
  11126.     }
  11127.  
  11128.     return (WinDefWindowProc (hwnd, msg, mp1, mp2));
  11129. }
  11130.  
  11131. /* Create the simulated frame window */
  11132.  
  11133. MRESULT EXPENTRY SimWindowProc(HWND hwnd, USHORT msg, MPARAM mp1, MPARAM mp2)
  11134. {
  11135.     HPS      hps;
  11136.     RECTL    Rect;
  11137.  
  11138.     switch (msg)
  11139.     {
  11140.  
  11141.         case WM_PAINT:
  11142.  
  11143.             hps = WinBeginPaint (hwnd, (HPS)NULL, (PRECTL)NULL);
  11144.             WinQueryWindowRect (hwnd, &Rect);
  11145.             WinFillRect (hps, &Rect, CLR_WHITE);
  11146.             WinEndPaint (hps);
  11147.             break;
  11148.  
  11149.         case WM_CLOSE:
  11150.  
  11151.             WinDestroyWindow (WinQueryWindow (hwnd, QW_PARENT));
  11152.             return (MRESULT)TRUE;
  11153.  
  11154.         case WM_DESTROY:
  11155.  
  11156.             PreviousHwnd = (HWND)WinQueryWindowULong (hwnd, 0L);
  11157.             WinSendMsg (WinQueryWindow (hwnd, QW_PARENT),
  11158.                         HM_SET_OBJCOM_WINDOW,
  11159.                         PreviousHwnd,
  11160.                         NULL);
  11161.             break;
  11162.     }
  11163.  
  11164.     return (WinDefWindowProc (hwnd, msg, mp1, mp2));
  11165. }
  11166.  
  11167. The following shows the tagging that communicates with the communication object 
  11168. through the reftype=inform attribute of :link.. The contents of the right 
  11169. window are defined by IPF.  The contents of the left window are defined and 
  11170. controlled by the communication object ComWindow and resides in INFORM.DLL. 
  11171.  
  11172. :userdoc.
  11173. :docprof ctrlarea=none.
  11174. :h1 id=examp5 scroll=none
  11175.     x=left y=bottom width=100% height=100%.
  11176. Interacting with Application Windows on the Workplace
  11177. .*
  11178. :link reftype=hd refid=mytxt5
  11179.       vpx=left vpy=bottom vpcx=50% vpcy=100%
  11180.       titlebar=none scroll=none auto split.
  11181. .*
  11182. :acviewport dll='inform'
  11183.             objectname='ComWindow'
  11184.             objectid=1
  11185.             objectinfo='optional'
  11186.             vpx=right vpy=bottom
  11187.             vpcx=50% vpcy=100%.
  11188. .*
  11189. .*
  11190. :link reftype=inform res=1000 auto.
  11191. :h1 hide id=mytxt5.My text
  11192. :p.
  11193. This window could contain an explanation of how to interact with
  11194. the application-controlled window displayed on the right.
  11195. :euserdoc.
  11196.  
  11197. In the previous example, IPF processes :acviewport. as follows: 
  11198.  
  11199.    1. It loads INFORM.DLL and calls the procedure ComWindow. 
  11200.    2. ComWindow passes the value of objectid= and objectinfo=.  These 
  11201.       attributes are place holders for this example. 
  11202.    3. ComWindow creates a communication window that will receive the HM_INFORM 
  11203.       messages from IPF when it processes the reftype=inform attribute of 
  11204.       :link.. 
  11205.  
  11206.       When the HM_INFORM message is sent to IPF, IPF creates and displays the 
  11207.       simulated application window. 
  11208.  
  11209.  The following figure displays the windows from the previous tagging example. 
  11210.  
  11211.  An Application-Controlled Window.  The communication object window is a 
  11212.  functioning frame window. 
  11213.  
  11214.  Communication windows also are useful when the same communication object is 
  11215.  used to support multiple application-controlled windows in help information. 
  11216.  For example, you can use the same IPF communication object to represent 
  11217.  different simulated application windows from one window to another.  Using the 
  11218.  previous examples, this is accomplished in two steps. 
  11219.  
  11220.      Add another :h1. window definition to the tagged source for the help 
  11221.       information.  A different number is specified in the res= attribute for 
  11222.       the :link. tag that has the reftype=inform attribute 
  11223.  
  11224.      Add the corresponding res= number as another possible value of the 
  11225.       parameter to the HM_INFORM message. It is processed accordingly by the 
  11226.       communication object window procedure 
  11227.  
  11228.  
  11229. ΓòÉΓòÉΓòÉ 15. Changing Help Information at Run Time (DDF) ΓòÉΓòÉΓòÉ
  11230.  
  11231. Dynamic data formatting (DDF) allows you to incorporate text, bit maps, or 
  11232. metafiles in an IPF window at execution time. You can use the dynamic data 
  11233. formatting facility in conjunction with the dynamic data format tag (:ddf.). 
  11234. The :ddf. tag functions as a request by IPF to the application for the DDF 
  11235. data, and a set of DDF application programming interface calls that provide 
  11236. primitives for formatting text. The DDF calls also allow you to incorporate bit 
  11237. maps and metafiles dynamically, and to specify a hypertext or inform link from 
  11238. DDF data to non-DDF data. 
  11239.  
  11240. IPF has no knowledge of the DDF data it displays, other than that a block of 
  11241. data has been provided to it by the application program. Therefore, DDF data 
  11242. cannot be searched or printed. In effect, DDF is a specific extension of 
  11243. application-controlled windows. When the :ddf. tag is encountered at execution 
  11244. time, IPF sends the HM_QUERY_DDF_DATA message to the application window 
  11245. procedure with which the current instance of help is associated.  IPF sends the 
  11246. message either by a WinAssociateHelpInstance request or a HM_SET_OBJCOM_WINDOW 
  11247. message. 
  11248.  
  11249.  
  11250. ΓòÉΓòÉΓòÉ 15.1. DDF and Online Help ΓòÉΓòÉΓòÉ
  11251.  
  11252. DDF data is treated differently for a help and an online document. In the case 
  11253. of a help facility, the HM_QUERY_DDF_DATA message must be processed in the 
  11254. application's window procedure. Within the processing for this message, you can 
  11255. turn on the number specified in the res= attribute of the :ddf. tag to allow 
  11256. for different processing based on which IPF window with a :ddf. tag is 
  11257. currently being displayed. 
  11258.  
  11259. Therefore, in the case of dynamic data formatting within help, it is not 
  11260. necessary to specify an application-controlled window or a separate DLL. 
  11261. However, this would also work if the application-controlled window used the 
  11262. HM_SET_OBJCOM_WINDOW message to explicitly identify the entry point specified 
  11263. in the dll=' ' and objectname=' ' attributes of the :acviewport. tag as the 
  11264. proper window procedure where the HM_QUERY_DDF_DATA message is processed. 
  11265.  
  11266.  
  11267. ΓòÉΓòÉΓòÉ 15.2. DDF and Online Documents ΓòÉΓòÉΓòÉ
  11268.  
  11269. The situation is different with an online document (as in, filetype INF). To 
  11270. display DDF data in an online document, the :ddf. tag must be specified within 
  11271. an application-controlled window. The window that actually specifies the :ddf. 
  11272. tag must be defined as a LINK AUTO SPLIT of the application-controlled window's 
  11273. parent window that is specified with a heading tag. The reason is based on the 
  11274. serialization sequence when IPF reads an .INF source file. For example, suppose 
  11275. the file is tagged as follows: 
  11276.  
  11277. :h1 res=100 x=0 y=0 width=50% height=50%.DDF Parent
  11278. :acviewport dll='test.dll' objectname='someobject' objectid='1'.
  11279. :ddf res=100.
  11280.  
  11281. The HM_QUERY_DDF_DATA message will be sent to the window procedure of VIEW, 
  11282. which does not process it, and it will be lost. However, suppose the tagging 
  11283. sequence is as follows: 
  11284.  
  11285. :h1 res=100 x=left y=top width=100% height=100% titlebar=both clear.Look here first
  11286. :acviewport dll='flight' objectname='GetName' objectid='2'.
  11287. :link reftype=hd refid=ddf1 auto split.
  11288. :h1 id=ddf1 x=50% y=top width=50% height=100% hide.ddf1
  11289. :ddf res=100.
  11290.  
  11291. The HM_QUERY_DDF_DATA message will be sent to the "GetName" window procedure, 
  11292. which can initialize and process the DDF data. Therefore, to incorporate DDF 
  11293. data in an online document, you must write a DLL to handle the processing. This 
  11294. DLL must be a global communication object. (That is, docproof-loaded) 
  11295.  
  11296. The other DDF message is the HM_INVALIDATE_DDF_DATA.  This message is sent by 
  11297. the application and informs IPF that previous dynamic data formatting (DDF) 
  11298. information is no longer valid. 
  11299.  
  11300. For information about the DDF calls, see Dynamic Data Formatting Functions. 
  11301.  
  11302.  
  11303. ΓòÉΓòÉΓòÉ 15.3. Example using DDF ΓòÉΓòÉΓòÉ
  11304.  
  11305. /* DDF Sample */
  11306.  
  11307. #define INCL_GPIPRIMITIVES
  11308. #define INCL_WINHELP
  11309. #define INCL_WIN
  11310. #define INCL_DDF
  11311. #include <os2.h>
  11312. #include "ddf.h"
  11313.  
  11314. MRESULT EXPENTRY ClientWndProc( HWND, USHORT, MPARAM, MPARAM );
  11315. VOID HelpInit( HAB hab );
  11316.  
  11317. HWND hwndHelpInstance;
  11318.  
  11319. HELPSUBTABLE helpSubTableMAIN[ ] =
  11320. {
  11321.    2, 0, 0
  11322. };
  11323.  
  11324. HELPTABLE helpTableMAIN[ ] =
  11325. {
  11326.       ID_PRIMWIN, helpSubTableMAIN, EXT_HELP_PANEL,
  11327. };
  11328.  
  11329. VOID main()
  11330. {
  11331.    static ULONG flFrameFlags = FCF_TITLEBAR | FCF_SYSMENU | FCF_TASKLIST |
  11332.                                FCF_SIZEBORDER  | FCF_SHELLPOSITION |
  11333.                                FCF_MINBUTTON | FCF_MAXBUTTON;
  11334.  
  11335.  
  11336.    HAB hab;
  11337.    HMQ hmq;
  11338.    QMSG qmsg;
  11339.    HWND hwndFrame, hwndClient;
  11340.    BOOL bReturnCode;
  11341.  
  11342.    hab = WinInitialize( 0 );             /* Get anchor block */
  11343.    hmq = WinCreateMsgQueue( hab, 0 );    /* Create message queue */
  11344.  
  11345.    bReturnCode = WinRegisterClass( hab,                   /* Anchor Block */
  11346.                                    "ClientWindow",        /* Class name   */
  11347.                                    (PFNWP) ClientWndProc, /* Window Proc  */
  11348.                                    CS_SIZEREDRAW,         /* Classstyles  */
  11349.                                    0 );                   /* Extra data   */
  11350.    hwndFrame = WinCreateStdWindow( HWND_DESKTOP,           /* parent */
  11351.                                    WS_VISIBLE,             /* window styles */
  11352.                                    &flFrameFlags,         /* FCF values */
  11353.                                    "ClientWindow",        /* class */
  11354.                                    "Press F1 for a DDF Sample", /* titlebar text */
  11355.                                    0L,                    /* client styles */
  11356.                                    NULLHANDLE,            /* resource handle */
  11357.                                    ID_PRIMWIN,            /* ID */
  11358.                                    &hwndClient );         /* return client */
  11359.  
  11360.    /* Initialize Help */
  11361.    HelpInit( hab );
  11362.    /* Associate the help instance with the window */
  11363.    WinAssociateHelpInstance( hwndHelpInstance, hwndFrame );
  11364.  
  11365.    while ( WinGetMsg( hab, &qmsg, NULLHANDLE, 0, 0 ) )    /* message loop */
  11366.        WinDispatchMsg( hab, &qmsg );
  11367.  
  11368.    /* Destroy the help instance */
  11369.    WinDestroyHelpInstance( hwndHelpInstance );
  11370.  
  11371.    WinDestroyWindow( hwndFrame );      /* destroy window        */
  11372.    WinDestroyMsgQueue( hmq );          /* destroy message queue */
  11373.    WinTerminate( hab );                /* return anchor block   */
  11374. }
  11375.  
  11376. MRESULT EXPENTRY ClientWndProc( HWND hwnd, USHORT msg, MPARAM mp1, MPARAM mp2)
  11377. {
  11378.    HPS hps;
  11379.    ULONG ulResID;
  11380.    HDDF hDDF;
  11381.    HBITMAP hbm;
  11382.    APIRET returncode;
  11383.    ERRORID errcode;
  11384.  
  11385.    switch ( msg ) {
  11386.       case HM_INFORM:
  11387.          switch (SHORT1FROMMP(mp1)) {
  11388.          case 1:
  11389.             WinMessageBox( HWND_DESKTOP, HWND_DESKTOP, "You clicked on the link",
  11390.                           "DDF Sample", 0, MB_OK);
  11391.             break;
  11392.          default:
  11393.             WinMessageBox( HWND_DESKTOP, HWND_DESKTOP, "Unknown Inform link",
  11394.                           "DDF Sample", 0, MB_OK);
  11395.            break;
  11396.          } /* endswitch */
  11397.       break;
  11398.       case HM_QUERY_DDF_DATA:
  11399.          ulResID = LONGFROMMP( mp2 );
  11400.          /* Initialize DDF */
  11401.          hDDF = DdfInitialize( hwndHelpInstance, 0L, 0L);
  11402.          /* Check res id to see which DDF line */
  11403.          switch (ulResID) {
  11404.             case 1:
  11405.                DdfPara( hDDF);
  11406.                DdfText( hDDF, "This text was placed by DDF");
  11407.                DdfPara( hDDF);
  11408.                DdfText( hDDF, "You can use ");
  11409.                DdfSetFontStyle( hDDF, FM_SEL_ITALIC);
  11410.                DdfText( hDDF, "italic, ");
  11411.                DdfSetFontStyle( hDDF, FM_SEL_BOLD);
  11412.                DdfText( hDDF, "bold, ");
  11413.                DdfSetFontStyle( hDDF, FM_SEL_UNDERSCORE);
  11414.                DdfText( hDDF, "underscore, ");
  11415.                DdfSetFontStyle( hDDF, FM_SEL_UNDERSCORE | FM_SEL_ITALIC | FM_SEL_BOLD );
  11416.                DdfText( hDDF, "or all three!");
  11417.                DdfSetFontStyle( hDDF, 0);
  11418.                DdfPara( hDDF);
  11419.                DdfText( hDDF, "How about some color?");
  11420.                DdfPara( hDDF);
  11421.                DdfSetColor( hDDF, CLR_BLUE, CLR_RED);
  11422.                DdfText( hDDF, "Red on Blue\n");
  11423.                DdfSetColor( hDDF, CLR_BLACK, CLR_PALEGRAY);
  11424.                DdfText( hDDF, "Pale Gray on Black\n");
  11425.                DdfSetColor( hDDF, CLR_DEFAULT, CLR_DEFAULT);
  11426.                DdfPara( hDDF);
  11427.                DdfSetFont( hDDF, "Courier", 100, 100);
  11428.                DdfText( hDDF, "Or a font change?");
  11429.                DdfSetFont( hDDF, NULL, 1, 1);
  11430.                DdfPara( hDDF);
  11431.                DdfSetTextAlign( hDDF, TA_CENTER);
  11432.                DdfSetFormat( hDDF, FALSE);
  11433.                DdfText( hDDF, "We can\ncenter text");
  11434.                DdfSetFormat( hDDF, TRUE);
  11435.                DdfSetTextAlign( hDDF, TA_LEFT);
  11436.                hbm = WinGetSysBitmap( HWND_DESKTOP, SBMP_FOLDER);
  11437.                DdfPara( hDDF);
  11438.                DdfBitmap( hDDF, hbm, ART_RUNIN );
  11439.                DdfText( hDDF, "Perhaps a bitmap?" );
  11440.                DdfPara( hDDF);
  11441.                DdfText( hDDF, "Or a list?");
  11442.                DdfBeginList(hDDF, 15, HMBT_FIT, HMLS7us.SINGLELINE);
  11443.                DdfListItem( hDDF, "Item 1", "Item 1 Description");
  11444.                DdfListItem( hDDF, "Item 2", "Item 2 Description");
  11445.                DdfEndList( hDDF);
  11446.                DdfPara( hDDF);
  11447.                DdfText( hDDF, "You can even create a " );
  11448.                DdfHyperText( hDDF, "link to a panel ", "2", REFERENCE_BY_RES );
  11449.                DdfText( hDDF, "or an " );
  11450.                DdfInform( hDDF, "inform link", 1 );
  11451.                /* Return the DDF handle you just created */
  11452.                return (MRESULT) hDDF;
  11453.                break;
  11454.          } /* endswitch */
  11455.          break;
  11456.       case WM_PAINT:
  11457.          hps = WinBeginPaint( hwnd, NULLHANDLE, NULL );
  11458.          GpiErase( hps );
  11459.          WinEndPaint( hps );
  11460.          return 0;
  11461.          break;
  11462.    } /* endswitch */
  11463.    return WinDefWindowProc( hwnd, msg, mp1, mp2 );
  11464. }
  11465.  
  11466. VOID HelpInit( HAB hab )
  11467. {
  11468.    HELPINIT helpinit;
  11469.  
  11470.    helpinit.cb = sizeof( HELPINIT );
  11471.    helpinit.ulReturnCode = 0L;
  11472.    helpinit.pszTutorialName = NULL;
  11473.    helpinit.phtHelpTable = (PVOID) helpTableMAIN;
  11474.    helpinit.hmodHelpTableModule = 0;
  11475.    helpinit.hmodAccelActionBarModule = 0;
  11476.    helpinit.idAccelTable = 0;
  11477.    helpinit.idActionBar = 0;
  11478.    helpinit.pszHelpWindowTitle = "Help for DDF Sample\0";
  11479.    helpinit.fShowPanelId = CMIC_HIDE_PANEL_ID;
  11480.    helpinit.pszHelpLibraryName = "DDF.HLP";
  11481.  
  11482.    hwndHelpInstance = WinCreateHelpInstance( hab, &helpinit );
  11483.    if (!hwndHelpInstance)
  11484.       WinMessageBox( HWND_DESKTOP, HWND_DESKTOP, "Help could not be initialized",
  11485.                     "DDF Sample", 0, MB_OK | MB_ERROR);
  11486.    return;
  11487. }
  11488.  
  11489.  
  11490. ΓòÉΓòÉΓòÉ 16. Creating Master Indexes and Glossaries with Applications ΓòÉΓòÉΓòÉ
  11491.  
  11492. The Workplace Shell "Mindex" software object class exploits IPF's 
  11493. functionality, providing a user object interface from which users can link to 
  11494. online helps. Your applications can instantiate these software object classes 
  11495. at run-time. 
  11496.  
  11497.  
  11498. ΓòÉΓòÉΓòÉ 16.1. Master Help Index Objects and Glossary Objects ΓòÉΓòÉΓòÉ
  11499.  
  11500. The OS/2 operating system's online documentation includes two Workplace Shell 
  11501. user objects that correspond to a single Workplace Shell software class object. 
  11502. The "Master Help Index" user object and the "Glossary" user object are 
  11503. instances of the "Mindex" object class. With the Master Help Index and the 
  11504. Glossary, users can access online help panels which include the global 
  11505. attribute in their index tagging (for more information, see Customizing Master 
  11506. Help Index and Glossary Objects). Note that this object class only works with 
  11507. online help (.HLP files), not online information (.INF files). 
  11508.  
  11509. The Mindex class is a member of the WPAbstract class, which is, in turn, a 
  11510. member of the root WPObject class. All of the WPObject classes are easily 
  11511. accessed and instantiated through the "WP Class List", provided as one of the 
  11512. PM Development Tools in the IBM Developer's Toolkit for OS/2. For additional 
  11513. information about manipulating Mindex class user objects in the Workplace Shell 
  11514. (such as copying and shadowing) see Customizing Master Help Index and Glossary 
  11515. Objects. 
  11516.  
  11517. There are three task scenarios involving Mindex class objects of particular 
  11518. interest to a programmer: 
  11519.  
  11520.    1. Adding index entries to the Master Help Index user object at installation 
  11521.       time. 
  11522.  
  11523.    2. Adding index entries to the Glossary user object at installation time. 
  11524.  
  11525.    3. Instantiating a new Mindex class object with an application. For example, 
  11526.       creating a product-specific master index user object during the 
  11527.       installation of your application. 
  11528.  
  11529.  These tasks can be done with minimal programming effort. 
  11530.  
  11531.  
  11532. ΓòÉΓòÉΓòÉ 16.1.1. Adding Entries to the Master Help Index at Installation ΓòÉΓòÉΓòÉ
  11533.  
  11534. Mindex class objects such as the Master Help Index and Glossary user objects 
  11535. display index entries that have been tagged with the global attribute (see :i1. 
  11536. and :i2.  (Index)). These index entries can be placed in any .HLP file. The 
  11537. .HLP files available to a given Mindex class user object are identified in the 
  11538. object's Settings Notebook. 
  11539.  
  11540. For example, the Master Help Index user object that is installed with the OS/2 
  11541. operating system has a default "Files/Environment name(s)" setting of "HELP". 
  11542. This refers to the HELP environment variable identified in the CONFIG.SYS file. 
  11543. Therefore, if you wanted the global index entries in your .HLP files to appear 
  11544. in the Master Help Index user object, you could simply copy your .HLP files to 
  11545. directories or files specified by the HELP environment variable. 
  11546.  
  11547. The default value of HELP is: 
  11548.  
  11549. HELP=C:\OS2\HELP;C:\OS2\HELP\TUTORIAL;
  11550. Alternatively, you could modify the value of the "HELP" environment variable by 
  11551. updating CONFIG.SYS. 
  11552.  
  11553.  
  11554. ΓòÉΓòÉΓòÉ 16.1.2. Adding Entries to the Glossary at Installation ΓòÉΓòÉΓòÉ
  11555.  
  11556. Because both the Glossary and the Master Help Index user objects are simply 
  11557. Mindex class software objects, the manner in which you add entries to the 
  11558. Glossary is identical to the manner in which you add entries to the Master Help 
  11559. Index (see Adding Entries to the Master Help Index at Installation). However, 
  11560. if you check the default Settings Notebook for the Glossary user object, you 
  11561. will notice that the Glossary installed with the OS/2 operating has a default 
  11562. "Files/Environment name(s)" that is not set to the "HELP" environment variable. 
  11563. Rather, it is set to the "GLOSSARY" environment variable. Therefore, you can 
  11564. update the value of this variable in CONFIG.SYS to reflect the location of your 
  11565. .HLP files that contain global tagged index entries. Alternatively, you can 
  11566. simply copy your .HLP files to the path defined by the GLOBAL environment 
  11567. variable. The default value is: 
  11568.  
  11569. GLOSSARY=C:\OS2\HELP\GLOSS;
  11570.  
  11571.  
  11572. ΓòÉΓòÉΓòÉ 16.1.3. Creating New Mindex Class Objects ΓòÉΓòÉΓòÉ
  11573.  
  11574. To instantiate a Mindex class object (such as a product-specific index or 
  11575. glossary), you need to create the new instance of the object and pass it 
  11576. necessary setup strings. This can be done with the WinCreateObject PM function. 
  11577.  
  11578. If you need to create an instance of a Mindex class object for use by your 
  11579. application, you will probably want to do so during installation. 
  11580.  
  11581.  
  11582. ΓòÉΓòÉΓòÉ 16.1.3.1. Example- Instantiating a Mindex Class Object Using REXX ΓòÉΓòÉΓòÉ
  11583.  
  11584. Many applications are installed using the REXX procedural language. Rather than 
  11585. use the WinCreateObject function, you can use REXX's SysCreateObject function. 
  11586.  
  11587. A sample REXX implementation might resemble the following: 
  11588.  
  11589. /* Register and load the Rexx Utility Functions                  */
  11590.  
  11591. call RxFuncAdd 'SysLoadFuncs', 'RexxUtil', 'SysLoadFuncs'
  11592. call SysLoadFuncs
  11593.  
  11594. /* Create a new Mindex class object                              */
  11595. /*                                                               */
  11596. /* Call SysCreateObject Rexx Utility function, and pass it       */
  11597. /*          a class name (Mindex);                               */
  11598. /*                                                               */
  11599. /* then pass it the icon title ('My Product Index');             */
  11600. /*                                                               */
  11601. /* then pass it the folder I want the object in (<WP_DESKTOP>;   */
  11602. /*                                                               */
  11603. /* then pass it the setup string with INDEX= set to the names    */
  11604. /*          of the help files that I want to be in my index      */
  11605. /*          (in this case C:\myprod\myhelp\myprod.hlp); the */
  11606. /*          default value of INDEX is equal to the HELP          */
  11607. /*          environment variable;                                */
  11608. /*                                                               */
  11609. /* then pass it a unique object id (MYINDEX);                    */
  11610. /*                                                               */
  11611. /* then tell me if the installation was successful.              */
  11612. if SysCreateObject("Mindex", "My Product Index", "<WP_DESKTOP>",,
  11613.            "INDEX=C:\MYPROD\HELP\MYPROD.HLP; OBJECTID=<MYINDEX>")
  11614. then Say 'Installation of My Product Index was successful!'
  11615. else Say 'Installation of My Product Index failed!'
  11616.  
  11617.  
  11618. ΓòÉΓòÉΓòÉ 17. Window Functions ΓòÉΓòÉΓòÉ
  11619.  
  11620. Following is a summary of the window function calls that you would use to 
  11621. interface with IPF. 
  11622.  
  11623.  WinAssociateHelpInstance 
  11624.      Associates the help instance with the application window chain. 
  11625.  
  11626.  WinCreateHelpInstance 
  11627.      Calls the IPF help hook so that IPF can handle help requests. 
  11628.  
  11629.  WinCreateHelpTable 
  11630.      Identifies or changes the pointer to the help table in application memory. 
  11631.  
  11632.  WinDestroyHelpInstance 
  11633.      Ends the window chain's association with the help instance. 
  11634.  
  11635.  WinLoadHelpTable 
  11636.      Identifies or changes the handle of the module that contains the help 
  11637.      table resource. 
  11638.  
  11639.  WinQueryHelpInstance 
  11640.      Identifies the help instance associated with a particular application 
  11641.      window chain. 
  11642.  
  11643.  
  11644. ΓòÉΓòÉΓòÉ 17.1. WinAssociateHelpInstance ΓòÉΓòÉΓòÉ
  11645.  
  11646.  
  11647. ΓòÉΓòÉΓòÉ <hidden> WinAssociateHelpInstance - Syntax ΓòÉΓòÉΓòÉ
  11648.  
  11649. This function associates the specified instance of the Help Manager with the 
  11650. window chain of the specified application window. 
  11651.  
  11652.  
  11653. #define INCL_WINHELP /* Or use INCL_WIN, INCL_PM, */
  11654. #include <os2.h>
  11655.  
  11656. HWND    hwndHelpInstance;  /*  Handle of an instance of the Help Manager. */
  11657. HWND    hwndApp;           /*  Handle of an application window. */
  11658. BOOL    rc;                /*  Success indicator. */
  11659.  
  11660. rc = WinAssociateHelpInstance(hwndHelpInstance,
  11661.        hwndApp);
  11662.  
  11663.  
  11664. ΓòÉΓòÉΓòÉ <hidden> WinAssociateHelpInstance Parameter - hwndHelpInstance ΓòÉΓòÉΓòÉ
  11665.  
  11666.  hwndHelpInstance (HWND) - input 
  11667.     Handle of an instance of the Help Manager. 
  11668.  
  11669.     This is the handle returned by the WinCreateHelpInstance call. 
  11670.  
  11671.     NULLHANDLE 
  11672.             Disassociates an instance of the Help Manager from a window chain 
  11673.             when the instance has been destroyed. 
  11674.  
  11675.     Other 
  11676.             The handle of an instance of the Help Manager to be associated with 
  11677.             the application window chain. 
  11678.  
  11679.  
  11680. ΓòÉΓòÉΓòÉ <hidden> WinAssociateHelpInstance Parameter - hwndApp ΓòÉΓòÉΓòÉ
  11681.  
  11682.  hwndApp (HWND) - input 
  11683.     Handle of an application window. 
  11684.  
  11685.     The handle of the application window with which the instance of the Help 
  11686.     Manager will be associated. The instance of the Help Manager is associated 
  11687.     with the application window and any of its children or owned windows. 
  11688.  
  11689.  
  11690. ΓòÉΓòÉΓòÉ <hidden> WinAssociateHelpInstance Return Value - rc ΓòÉΓòÉΓòÉ
  11691.  
  11692.  rc (BOOL) - returns 
  11693.     Success indicator. 
  11694.  
  11695.     TRUE 
  11696.             Successful completion 
  11697.     FALSE 
  11698.             Error occurred. 
  11699.  
  11700.  
  11701. ΓòÉΓòÉΓòÉ <hidden> WinAssociateHelpInstance - Parameters ΓòÉΓòÉΓòÉ
  11702.  
  11703.  hwndHelpInstance (HWND) - input 
  11704.     Handle of an instance of the Help Manager. 
  11705.  
  11706.     This is the handle returned by the WinCreateHelpInstance call. 
  11707.  
  11708.     NULLHANDLE 
  11709.             Disassociates an instance of the Help Manager from a window chain 
  11710.             when the instance has been destroyed. 
  11711.  
  11712.     Other 
  11713.             The handle of an instance of the Help Manager to be associated with 
  11714.             the application window chain. 
  11715.  
  11716.  hwndApp (HWND) - input 
  11717.     Handle of an application window. 
  11718.  
  11719.     The handle of the application window with which the instance of the Help 
  11720.     Manager will be associated. The instance of the Help Manager is associated 
  11721.     with the application window and any of its children or owned windows. 
  11722.  
  11723.  rc (BOOL) - returns 
  11724.     Success indicator. 
  11725.  
  11726.     TRUE 
  11727.             Successful completion 
  11728.     FALSE 
  11729.             Error occurred. 
  11730.  
  11731.  
  11732. ΓòÉΓòÉΓòÉ <hidden> WinAssociateHelpInstance - Remarks ΓòÉΓòÉΓòÉ
  11733.  
  11734. In order to provide help, the application must associate an instance of the 
  11735. Help Manager with a chain of application windows. This association lets the 
  11736. Help Manager know which instance should provide the help function. 
  11737.  
  11738. The Help Manager traces the window chain, starting from the window where help 
  11739. is requested. The application window in the chain with the associated help 
  11740. instance will be the one with which the Help Manager communicates and next to 
  11741. which the help window is positioned, unless a HM_SET_ACTIVE_WINDOW message is 
  11742. sent to the Help Manager. If the HM_SET_ACTIVE_WINDOW message is sent to the 
  11743. Help Manager, the active window parameter is the window with which the Help 
  11744. Manager communicates. The Help Manager positions the help window next to the 
  11745. window specified as the relative window. 
  11746.  
  11747.  
  11748. ΓòÉΓòÉΓòÉ <hidden> WinAssociateHelpInstance - Related Functions ΓòÉΓòÉΓòÉ
  11749.  
  11750.      WinAssociateHelpInstance 
  11751.      WinCreateHelpInstance 
  11752.      WinCreateHelpTable 
  11753.      WinDestroyHelpInstance 
  11754.      WinLoadHelpTable 
  11755.      WinQueryHelpInstance 
  11756.  
  11757.  
  11758. ΓòÉΓòÉΓòÉ <hidden> WinAssociateHelpInstance - Related Messages ΓòÉΓòÉΓòÉ
  11759.  
  11760.      HM_SET_ACTIVE_WINDOW 
  11761.  
  11762.  
  11763. ΓòÉΓòÉΓòÉ <hidden> WinAssociateHelpInstance - Example Code ΓòÉΓòÉΓòÉ
  11764.  
  11765. This example shows a typical main function for an application which uses help. 
  11766. Following creation of the main application window the Help Manager is 
  11767. initialized and associated with the window.  The help table is defined in the 
  11768. application's resources. When the window is destroyed, terminating the 
  11769. application, the help instance is also destroyed. 
  11770.  
  11771. #define INCL=_WIN
  11772. #include <os2.h>
  11773.  
  11774. #define IDHT_APPLICATION        100     /* id of HELP TABLE in resource file */
  11775.  
  11776. main( int argc, char *argv[], char *envp[] )
  11777. {
  11778.    HAB  hab = WinInitialize( 0 );
  11779.    HMQ  hmq = WinCreateMsgQueue( hab, 0 );
  11780.    HWND hwnd;
  11781.    HWND hwndClient;
  11782.    HWND hwndHelp;
  11783.    QMSG qmsg;
  11784.    ULONG flStyle;
  11785.    HELPINIT helpinit;
  11786.  
  11787.    /* Setup the help initialization structure */
  11788.    helpinit.cb = sizeof( HELPINIT );
  11789.    helpinit.ulReturnCode =  0L;
  11790.    helpinit.pszTutorialName =  (PSZ)NULL;
  11791.    /* Help table in application resource */
  11792.    helpinit.phtHelpTable = (PHELPTABLE)MAKEULONG( IDHT_APPLICATION, 0xffff );
  11793.    helpinit.hmodHelpTableModule = NULLHANDLE;
  11794.    /* Default action bar and accelerators */
  11795.    helpinit.hmodAccelActionBarModule = NULLHANDLE;
  11796.    helpinit.idAccelTable = 0;
  11797.    helpinit.idActionBar = 0;
  11798.    helpinit.pszHelpWindowTitle = "APPNAME HELP";
  11799.    helpinit.fShowPanelId = CMIC_SHOW_PANEL_ID;
  11800.    helpinit.pszHelpLibraryName = "APPNAME.HLP";
  11801.  
  11802.    /* Register the class */
  11803.    if( WinRegisterClass( ... ) )
  11804.    {
  11805.       /* create the main window */
  11806.       flStyle = FCF_STANDARD;
  11807.       hwnd = WinCreateStdWindow( ... );
  11808.  
  11809.       if( hwnd )
  11810.       {
  11811.          /* Create and associate the help instance */
  11812.          hwndHelp = WinCreateHelpInstance( hab, &helpinit );
  11813.  
  11814.          if( hwndHelp && WinAssociateHelpInstance( hwndHelp, hwnd ) )
  11815.          {
  11816.             /* Process messages */
  11817.             while( WinGetMsg( hab, &qmsg, NULLHANDLE, 0, 0 ) )
  11818.             {
  11819.                WinDispatchMsg( hab, &qmsg );
  11820.             } /* endwhile */
  11821.          }
  11822.  
  11823.          /* Remove help instance - note: add                    */
  11824.          /*     WinAssociateHelpInstance( NULLHANDLE, hwnd );      */
  11825.          /* to WM_DESTROY processing to remove the association. */
  11826.          WinDestroyHelpInstance( hwndHelp );
  11827.       }
  11828.    }
  11829.  
  11830.    /* finish the cleanup and exit */
  11831.    WinDestroyMsgQueue( hmq );
  11832.    WinTerminate( hab );
  11833. }
  11834.  
  11835.  
  11836. ΓòÉΓòÉΓòÉ <hidden> WinAssociateHelpInstance - Topics ΓòÉΓòÉΓòÉ
  11837.  
  11838. Select an item: 
  11839.  
  11840. Syntax
  11841. Parameters
  11842. Returns
  11843. Remarks
  11844. Example Code
  11845. Related Functions
  11846. Related Messages
  11847. Glossary
  11848.  
  11849.  
  11850. ΓòÉΓòÉΓòÉ 17.2. WinCreateHelpInstance ΓòÉΓòÉΓòÉ
  11851.  
  11852.  
  11853. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpInstance - Syntax ΓòÉΓòÉΓòÉ
  11854.  
  11855. This function creates an instance of the Help Manager with which to request 
  11856. Help Manager functions. 
  11857.  
  11858.  
  11859. #define INCL_WINHELP /* Or use INCL_WIN, INCL_PM, */
  11860. #include <os2.h>
  11861.  
  11862. HAB          hab;                    /*  Anchor-block handle. */
  11863. PHELPINIT    phinitHMInitStructure;  /*  Help Manager initialization structure. */
  11864. HWND         hwndhelp;               /*  Help Manager handle. */
  11865.  
  11866. hwndhelp = WinCreateHelpInstance(hab, phinitHMInitStructure);
  11867.  
  11868.  
  11869. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpInstance Parameter - hab ΓòÉΓòÉΓòÉ
  11870.  
  11871.  hab (HAB) - input 
  11872.     Anchor-block handle. 
  11873.  
  11874.     The handle of the application anchor block returned from the WinInitialize 
  11875.     function. 
  11876.  
  11877.  
  11878. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpInstance Parameter - phinitHMInitStructure ΓòÉΓòÉΓòÉ
  11879.  
  11880.  phinitHMInitStructure (PHELPINIT) - in/out 
  11881.     Help Manager initialization structure. 
  11882.  
  11883.  
  11884. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpInstance Return Value - hwndhelp ΓòÉΓòÉΓòÉ
  11885.  
  11886.  hwndhelp (HWND) - returns 
  11887.     Help Manager handle. 
  11888.  
  11889.     NULLHANDLE 
  11890.             Error occurred 
  11891.     Other 
  11892.             Help Manager handle. 
  11893.  
  11894.  
  11895. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpInstance - Parameters ΓòÉΓòÉΓòÉ
  11896.  
  11897.  hab (HAB) - input 
  11898.     Anchor-block handle. 
  11899.  
  11900.     The handle of the application anchor block returned from the WinInitialize 
  11901.     function. 
  11902.  
  11903.  phinitHMInitStructure (PHELPINIT) - in/out 
  11904.     Help Manager initialization structure. 
  11905.  
  11906.  hwndhelp (HWND) - returns 
  11907.     Help Manager handle. 
  11908.  
  11909.     NULLHANDLE 
  11910.             Error occurred 
  11911.     Other 
  11912.             Help Manager handle. 
  11913.  
  11914.  
  11915. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpInstance - Remarks ΓòÉΓòÉΓòÉ
  11916.  
  11917. If an error occurs, it is in the ulReturnCode parameter of the HELPINIT 
  11918. structure. 
  11919.  
  11920.  
  11921. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpInstance - Related Functions ΓòÉΓòÉΓòÉ
  11922.  
  11923.      WinAssociateHelpInstance 
  11924.      WinCreateHelpInstance 
  11925.      WinCreateHelpTable 
  11926.      WinDestroyHelpInstance 
  11927.      WinLoadHelpTable 
  11928.      WinQueryHelpInstance 
  11929.  
  11930.  
  11931. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpInstance - Example Code ΓòÉΓòÉΓòÉ
  11932.  
  11933. This example shows a typical main function for an application which uses help. 
  11934. Following creation of the main application window the Help Manager is 
  11935. initialized and associated with the window.  The help table is defined in the 
  11936. application's resources. When the window is destroyed, terminating the 
  11937. application, the help instance is also destroyed. 
  11938.  
  11939. #define INCL=_WIN
  11940. #include <os2.h>
  11941.  
  11942. #define IDHT_APPLICATION        100     /* id of HELP TABLE in resource file
  11943. */
  11944.  
  11945. main( int argc, char *argv[], char *envp[] )
  11946. {
  11947.    HAB  hab = WinInitialize( 0 );
  11948.    HMQ  hmq = WinCreateMsgQueue( hab, 0 );
  11949.    HWND hwnd;
  11950.    HWND hwndClient;
  11951.    HWND hwndHelp;
  11952.    QMSG qmsg;
  11953.    ULONG flStyle;
  11954.    HELPINIT helpinit;
  11955.  
  11956.    /* Setup the help initialization structure */
  11957.    helpinit.cb = sizeof( HELPINIT );
  11958.    helpinit.ulReturnCode =  0L;
  11959.    helpinit.pszTutorialName =  (PSZ)NULL;
  11960.    /* Help table in application resource */
  11961.    helpinit.phtHelpTable = (PHELPTABLE)MAKEULONG( IDHT_APPLICATION, 0xffff );
  11962.    helpinit.hmodHelpTableModule = NULLHANDLE;
  11963.    /* Default action bar and accelerators */
  11964.    helpinit.hmodAccelActionBarModule = NULLHANDLE;
  11965.    helpinit.idAccelTable = 0;
  11966.    helpinit.idActionBar = 0;
  11967.    helpinit.pszHelpWindowTitle = "APPNAME HELP";
  11968.    helpinit.fShowPanelId = CMIC_SHOW_PANEL_ID;
  11969.    helpinit.pszHelpLibraryName = "APPNAME.HLP";
  11970.  
  11971.    /* Register the class */
  11972.    if( WinRegisterClass( ... ) )
  11973.    {
  11974.       /* create the main window */
  11975.       flStyle = FCF_STANDARD;
  11976.       hwnd = WinCreateStdWindow( ... );
  11977.  
  11978.       if( hwnd )
  11979.       {
  11980.          /* Create and associate the help instance */
  11981.          hwndHelp = WinCreateHelpInstance( hab, &helpinit );
  11982.  
  11983.          if( hwndHelp && WinAssociateHelpInstance( hwndHelp, hwnd ) )
  11984.          {
  11985.             /* Process messages */
  11986.             while( WinGetMsg( hab, &qmsg, NULLHANDLE, 0, 0 ) )
  11987.             {
  11988.                WinDispatchMsg( hab, &qmsg );
  11989.             } /* endwhile */
  11990.          }
  11991.  
  11992.          /* Remove help instance - note: add                    */
  11993.          /*     WinAssociateHelpInstance( NULLHANDLE, hwnd );      */
  11994.          /* to WM_DESTROY processing to remove the association. */
  11995.          WinDestroyHelpInstance( hwndHelp );
  11996.       }
  11997.    }
  11998.  
  11999.    /* finish the cleanup and exit */
  12000.    WinDestroyMsgQueue( hmq );
  12001.    WinTerminate( hab );
  12002. }
  12003.  
  12004.  
  12005. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpInstance - Topics ΓòÉΓòÉΓòÉ
  12006.  
  12007. Select an item: 
  12008.  
  12009. Syntax
  12010. Parameters
  12011. Returns
  12012. Remarks
  12013. Example Code
  12014. Related Functions
  12015. Glossary
  12016.  
  12017.  
  12018. ΓòÉΓòÉΓòÉ 17.3. WinCreateHelpTable ΓòÉΓòÉΓòÉ
  12019.  
  12020.  
  12021. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpTable - Syntax ΓòÉΓòÉΓòÉ
  12022.  
  12023. This function is used to identify or change the help table. 
  12024.  
  12025.  
  12026. #define INCL_WINHELP /* Or use INCL_WIN, INCL_PM, */
  12027. #include <os2.h>
  12028.  
  12029. HWND          hwndHelpInstance;  /*  Handle of an instance of the Help Manager. */
  12030. PHELPTABLE    phtHelpTable;      /*  Help table allocated by the application. */
  12031. BOOL          rc;                /*  Success indicator. */
  12032.  
  12033. rc = WinCreateHelpTable(hwndHelpInstance,
  12034.        phtHelpTable);
  12035.  
  12036.  
  12037. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpTable Parameter - hwndHelpInstance ΓòÉΓòÉΓòÉ
  12038.  
  12039.  hwndHelpInstance (HWND) - input 
  12040.     Handle of an instance of the Help Manager. 
  12041.  
  12042.     This is the handle returned by the WinCreateHelpInstance call. 
  12043.  
  12044.  
  12045. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpTable Parameter - phtHelpTable ΓòÉΓòÉΓòÉ
  12046.  
  12047.  phtHelpTable (PHELPTABLE) - input 
  12048.     Help table allocated by the application. 
  12049.  
  12050.  
  12051. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpTable Return Value - rc ΓòÉΓòÉΓòÉ
  12052.  
  12053.  rc (BOOL) - returns 
  12054.     Success indicator. 
  12055.  
  12056.     TRUE 
  12057.             Successful completion 
  12058.     FALSE 
  12059.             Error occurred. 
  12060.  
  12061.  
  12062. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpTable - Parameters ΓòÉΓòÉΓòÉ
  12063.  
  12064.  hwndHelpInstance (HWND) - input 
  12065.     Handle of an instance of the Help Manager. 
  12066.  
  12067.     This is the handle returned by the WinCreateHelpInstance call. 
  12068.  
  12069.  phtHelpTable (PHELPTABLE) - input 
  12070.     Help table allocated by the application. 
  12071.  
  12072.  rc (BOOL) - returns 
  12073.     Success indicator. 
  12074.  
  12075.     TRUE 
  12076.             Successful completion 
  12077.     FALSE 
  12078.             Error occurred. 
  12079.  
  12080.  
  12081. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpTable - Remarks ΓòÉΓòÉΓòÉ
  12082.  
  12083. This function corresponds to the HM_CREATE_HELP_TABLE message that identifies a 
  12084. help table that is in memory. 
  12085.  
  12086.  
  12087. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpTable - Related Functions ΓòÉΓòÉΓòÉ
  12088.  
  12089.      WinAssociateHelpInstance 
  12090.      WinCreateHelpInstance 
  12091.      WinCreateHelpTable 
  12092.      WinDestroyHelpInstance 
  12093.      WinLoadHelpTable 
  12094.      WinQueryHelpInstance 
  12095.  
  12096.  
  12097. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpTable - Related Messages ΓòÉΓòÉΓòÉ
  12098.  
  12099.      HM_CREATE_HELP_TABLE 
  12100.  
  12101.  
  12102. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpTable - Example Code ΓòÉΓòÉΓòÉ
  12103.  
  12104. This example creates a help table in memory and passes the table to the Help 
  12105. Manager via WinCreateHelpTable.  The help instance must have been created by 
  12106. WinCreateHelpInstance. 
  12107.  
  12108. #define INCL_WINHELP
  12109. #include <os2.h>
  12110.  
  12111. /* DEFINEs for window id's, menu items, controls, panels, etc. should */
  12112. /* be inserted here or in additional include files.                   */
  12113.  
  12114. /* Subtable for the main window's help */
  12115. HELPSUBTABLE phtMainTable[] = { 2,              /* Length of each entry */
  12116.                                  /* Fill in one line for each menu item   */
  12117.                                  IDM_FILE,       PANELID_FILEMENU,
  12118.                                  IDM_FILENEW,    PANELID_FILENEW,
  12119.                                  IDM_FILEOPEN,   PANELID_FILEOPEN,
  12120.                                  IDM_FILESAVE,   PANELID_FILESAVE,
  12121.                                  IDM_FILESAVEAS, PANELID_FILESAVEAS,
  12122.                                  IDM_FILEEXIT,   PANELID_FILEEXIT };
  12123.  
  12124. /* Subtable for the dialog window's help */
  12125. HELPSUBTABLE phtDlgTable[] = { 2,             /* Length of each entry */
  12126.                                 /* Fill in one line for each control */
  12127.                                 IDC_EDITFLD,    PANELID_DLGEDITFLD,
  12128.                                 IDC_OK,         PANELID_DLGOK,
  12129.                                 IDC_CANCEL,     PANELID_DLGCANCEL,
  12130.                                 IDC_HELP,       PANELID_HELP };
  12131.  
  12132. /* Help table for the applications context sensitive help */
  12133. HELPTABLE phtHelpTable[]= { WINDOWID_MAIN, phtMainTable,
  12134. PANELID_MAINEXT,
  12135.                               WINDOWID_DLG,  phtDlgTable,  PANELID_DLGEXT,
  12136.                               0,             NULL,           0 };
  12137.  
  12138. BOOL CreateHelpTable( HWND hWnd )
  12139. {
  12140.     BOOL bSuccess = FALSE;
  12141.     HWND hwndHelp;
  12142.  
  12143.     /* Get the associated help instance */
  12144.     hwndHelp = WinQueryHelpInstance( hWnd );
  12145.  
  12146.     if( hwndHelp )
  12147.     {
  12148.         /* Pass address of help table to the Help Manager */
  12149.         bSuccess = WinCreateHelpTable( hwndHelp, phtHelpTable );
  12150.     }
  12151.  
  12152.     /* return success indicator */
  12153.     return bSuccess;
  12154. }
  12155.  
  12156.  
  12157. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpTable - Topics ΓòÉΓòÉΓòÉ
  12158.  
  12159. Select an item: 
  12160.  
  12161. Syntax
  12162. Parameters
  12163. Returns
  12164. Remarks
  12165. Example Code
  12166. Related Functions
  12167. Related Messages
  12168. Glossary
  12169.  
  12170.  
  12171. ΓòÉΓòÉΓòÉ 17.4. WinDestroyHelpInstance ΓòÉΓòÉΓòÉ
  12172.  
  12173.  
  12174. ΓòÉΓòÉΓòÉ <hidden> WinDestroyHelpInstance - Syntax ΓòÉΓòÉΓòÉ
  12175.  
  12176. This function destroys the specified instance of the Help Manager. 
  12177.  
  12178.  
  12179. #define INCL_WINHELP /* Or use INCL_WIN, INCL_PM, */
  12180. #include <os2.h>
  12181.  
  12182. HWND    hwndHelpInstance;  /*  Handle of the instance of the Help Manager to be destroyed. */
  12183. BOOL    rc;                /*  Success indicator. */
  12184.  
  12185. rc = WinDestroyHelpInstance(hwndHelpInstance);
  12186.  
  12187.  
  12188. ΓòÉΓòÉΓòÉ <hidden> WinDestroyHelpInstance Parameter - hwndHelpInstance ΓòÉΓòÉΓòÉ
  12189.  
  12190.  hwndHelpInstance (HWND) - input 
  12191.     Handle of the instance of the Help Manager to be destroyed. 
  12192.  
  12193.     This is the handle returned by the WinCreateHelpInstance call. 
  12194.  
  12195.  
  12196. ΓòÉΓòÉΓòÉ <hidden> WinDestroyHelpInstance Return Value - rc ΓòÉΓòÉΓòÉ
  12197.  
  12198.  rc (BOOL) - returns 
  12199.     Success indicator. 
  12200.  
  12201.     TRUE 
  12202.             Successful completion 
  12203.     FALSE 
  12204.             Error occurred. 
  12205.  
  12206.  
  12207. ΓòÉΓòÉΓòÉ <hidden> WinDestroyHelpInstance - Parameters ΓòÉΓòÉΓòÉ
  12208.  
  12209.  hwndHelpInstance (HWND) - input 
  12210.     Handle of the instance of the Help Manager to be destroyed. 
  12211.  
  12212.     This is the handle returned by the WinCreateHelpInstance call. 
  12213.  
  12214.  rc (BOOL) - returns 
  12215.     Success indicator. 
  12216.  
  12217.     TRUE 
  12218.             Successful completion 
  12219.     FALSE 
  12220.             Error occurred. 
  12221.  
  12222.  
  12223. ΓòÉΓòÉΓòÉ <hidden> WinDestroyHelpInstance - Related Functions ΓòÉΓòÉΓòÉ
  12224.  
  12225.      WinAssociateHelpInstance 
  12226.      WinCreateHelpInstance 
  12227.      WinCreateHelpTable 
  12228.      WinDestroyHelpInstance 
  12229.      WinLoadHelpTable 
  12230.      WinQueryHelpInstance 
  12231.  
  12232.  
  12233. ΓòÉΓòÉΓòÉ <hidden> WinDestroyHelpInstance - Example Code ΓòÉΓòÉΓòÉ
  12234.  
  12235. This example shows a typical main function for an application which uses help. 
  12236. Following creation of the main application window the Help Manager is 
  12237. initialized and associated with the window.  The help table is defined in the 
  12238. application's resources. When the window is destroyed, terminating the 
  12239. application, the help instance is also destroyed. 
  12240.  
  12241. #define INCL=_WIN
  12242. #include <os2.h>
  12243.  
  12244. #define IDHT_APPLICATION        100     /* id of HELP TABLE in resource file
  12245. */
  12246.  
  12247. main( int argc, char *argv[], char *envp[] )
  12248. {
  12249.    HAB  hab = WinInitialize( 0 );
  12250.    HMQ  hmq = WinCreateMsgQueue( hab, 0 );
  12251.    HWND hwnd;
  12252.    HWND hwndClient;
  12253.    HWND hwndHelp;
  12254.    QMSG qmsg;
  12255.    ULONG flStyle;
  12256.    HELPINIT helpinit;
  12257.  
  12258.    /* Setup the help initialization structure */
  12259.    helpinit.cb = sizeof( HELPINIT );
  12260.    helpinit.ulReturnCode =  0L;
  12261.    helpinit.pszTutorialName =  (PSZ)NULL;
  12262.    /* Help table in application resource */
  12263.    helpinit.phtHelpTable = (PHELPTABLE)MAKEULONG( IDHT_APPLICATION, 0xffff );
  12264.    helpinit.hmodHelpTableModule = NULLHANDLE;
  12265.    /* Default action bar and accelerators */
  12266.    helpinit.hmodAccelActionBarModule = NULLHANDLE;
  12267.    helpinit.idAccelTable = 0;
  12268.    helpinit.idActionBar = 0;
  12269.    helpinit.pszHelpWindowTitle = "APPNAME HELP";
  12270.    helpinit.fShowPanelId = CMIC_SHOW_PANEL_ID;
  12271.    helpinit.pszHelpLibraryName = "APPNAME.HLP";
  12272.  
  12273.    /* Register the class */
  12274.    if( WinRegisterClass( ... ) )
  12275.    {
  12276.       /* create the main window */
  12277.       flStyle = FCF_STANDARD;
  12278.       hwnd = WinCreateStdWindow( ... );
  12279.  
  12280.       if( hwnd )
  12281.       {
  12282.          /* Create and associate the help instance */
  12283.          hwndHelp = WinCreateHelpInstance( hab, &helpinit );
  12284.  
  12285.          if( hwndHelp && WinAssociateHelpInstance( hwndHelp, hwnd ) )
  12286.          {
  12287.             /* Process messages */
  12288.             while( WinGetMsg( hab, &qmsg, NULLHANDLE, 0, 0 ) )
  12289.             {
  12290.                WinDispatchMsg( hab, &qmsg );
  12291.             } /* endwhile */
  12292.          }
  12293.  
  12294.          /* Remove help instance - note: add                    */
  12295.          /*     WinAssociateHelpInstance( NULLHANDLE, hwnd );      */
  12296.          /* to WM_DESTROY processing to remove the association. */
  12297.          WinDestroyHelpInstance( hwndHelp );
  12298.       }
  12299.    }
  12300.  
  12301.    /* finish the cleanup and exit */
  12302.    WinDestroyMsgQueue( hmq );
  12303.    WinTerminate( hab );
  12304. }
  12305.  
  12306.  
  12307. ΓòÉΓòÉΓòÉ <hidden> WinDestroyHelpInstance - Topics ΓòÉΓòÉΓòÉ
  12308.  
  12309. Select an item: 
  12310.  
  12311. Syntax
  12312. Parameters
  12313. Returns
  12314. Example Code
  12315. Related Functions
  12316. Glossary
  12317.  
  12318.  
  12319. ΓòÉΓòÉΓòÉ 17.5. WinLoadHelpTable ΓòÉΓòÉΓòÉ
  12320.  
  12321.  
  12322. ΓòÉΓòÉΓòÉ <hidden> WinLoadHelpTable - Syntax ΓòÉΓòÉΓòÉ
  12323.  
  12324. This function identifies the module handle and identity of the help table to 
  12325. the instance of the Help Manager. 
  12326.  
  12327.  
  12328. #define INCL_WINHELP /* Or use INCL_WIN, INCL_PM, */
  12329. #include <os2.h>
  12330.  
  12331. HWND       hwndHelpInstance;  /*  Handle of an instance of the Help Manager. */
  12332. ULONG      idHelpTable;       /*  Identity of the help table. */
  12333. HMODULE    Module;            /*  Handle of the module which contains the help table and help subtable resources. */
  12334. BOOL       rc;                /*  Success indicator. */
  12335.  
  12336. rc = WinLoadHelpTable(hwndHelpInstance, idHelpTable,
  12337.        Module);
  12338.  
  12339.  
  12340. ΓòÉΓòÉΓòÉ <hidden> WinLoadHelpTable Parameter - hwndHelpInstance ΓòÉΓòÉΓòÉ
  12341.  
  12342.  hwndHelpInstance (HWND) - input 
  12343.     Handle of an instance of the Help Manager. 
  12344.  
  12345.     This is the handle returned by the WinCreateHelpInstance call. 
  12346.  
  12347.  
  12348. ΓòÉΓòÉΓòÉ <hidden> WinLoadHelpTable Parameter - idHelpTable ΓòÉΓòÉΓòÉ
  12349.  
  12350.  idHelpTable (ULONG) - input 
  12351.     Identity of the help table. 
  12352.  
  12353.     It must be greater or equal to 0 and less or equal to 0xFFFF. 
  12354.  
  12355.  
  12356. ΓòÉΓòÉΓòÉ <hidden> WinLoadHelpTable Parameter - Module ΓòÉΓòÉΓòÉ
  12357.  
  12358.  Module (HMODULE) - input 
  12359.     Handle of the module which contains the help table and help subtable 
  12360.     resources. 
  12361.  
  12362.     NULLHANDLE 
  12363.             Use the resources file for the application. 
  12364.     Other 
  12365.             The module handle returned by the DosLoadModule or 
  12366.             DosQueryModuleHandle call referencing a dynamic-link library 
  12367.             containing the help resources. 
  12368.  
  12369.  
  12370. ΓòÉΓòÉΓòÉ <hidden> WinLoadHelpTable Return Value - rc ΓòÉΓòÉΓòÉ
  12371.  
  12372.  rc (BOOL) - returns 
  12373.     Success indicator. 
  12374.  
  12375.     TRUE 
  12376.             Successful completion 
  12377.     FALSE 
  12378.             Error occurred. 
  12379.  
  12380.  
  12381. ΓòÉΓòÉΓòÉ <hidden> WinLoadHelpTable - Parameters ΓòÉΓòÉΓòÉ
  12382.  
  12383.  hwndHelpInstance (HWND) - input 
  12384.     Handle of an instance of the Help Manager. 
  12385.  
  12386.     This is the handle returned by the WinCreateHelpInstance call. 
  12387.  
  12388.  idHelpTable (ULONG) - input 
  12389.     Identity of the help table. 
  12390.  
  12391.     It must be greater or equal to 0 and less or equal to 0xFFFF. 
  12392.  
  12393.  Module (HMODULE) - input 
  12394.     Handle of the module which contains the help table and help subtable 
  12395.     resources. 
  12396.  
  12397.     NULLHANDLE 
  12398.             Use the resources file for the application. 
  12399.     Other 
  12400.             The module handle returned by the DosLoadModule or 
  12401.             DosQueryModuleHandle call referencing a dynamic-link library 
  12402.             containing the help resources. 
  12403.  
  12404.  rc (BOOL) - returns 
  12405.     Success indicator. 
  12406.  
  12407.     TRUE 
  12408.             Successful completion 
  12409.     FALSE 
  12410.             Error occurred. 
  12411.  
  12412.  
  12413. ΓòÉΓòÉΓòÉ <hidden> WinLoadHelpTable - Remarks ΓòÉΓòÉΓòÉ
  12414.  
  12415. An application specifies or changes the handle of the module which contains the 
  12416. help table or the identity of the help table. 
  12417.  
  12418. This function corresponds to the HM_LOAD_HELP_TABLE message that identifies the 
  12419. identifier of a help table and the handle of the module which contains the help 
  12420. table and its associated help subtables. 
  12421.  
  12422.  
  12423. ΓòÉΓòÉΓòÉ <hidden> WinLoadHelpTable - Related Functions ΓòÉΓòÉΓòÉ
  12424.  
  12425.      WinAssociateHelpInstance 
  12426.      WinCreateHelpInstance 
  12427.      WinCreateHelpTable 
  12428.      WinDestroyHelpInstance 
  12429.      WinLoadHelpTable 
  12430.      WinQueryHelpInstance 
  12431.  
  12432.  
  12433. ΓòÉΓòÉΓòÉ <hidden> WinLoadHelpTable - Related Messages ΓòÉΓòÉΓòÉ
  12434.  
  12435.      HM_LOAD_HELP_TABLE 
  12436.  
  12437.  
  12438. ΓòÉΓòÉΓòÉ <hidden> WinLoadHelpTable - Example Code ΓòÉΓòÉΓòÉ
  12439.  
  12440. BOOL LoadHelpTable( HWND hWnd, USHORT usResource, PSZ pszModuleName )
  12441. {
  12442.     BOOL bSuccess = FALSE;
  12443.     HMODULE hmodule;
  12444.     HWND hwndHelp;
  12445.     PSZ  pszObjNameBuf[ 80 ];
  12446.  
  12447.     /* Get the DLL loaded */
  12448.     if( !DosLoadModule( pszObjNameBuf, sizeof( pszObjNameBuf ),
  12449.                    pszModuleName, &hmodule ) )
  12450.     {
  12451.         /* Get the associated help instance */
  12452.         hwndHelp = WinQueryHelpInstance( hWnd );
  12453.  
  12454.         if( hwndHelp )
  12455.         {
  12456.             /* Pass address of help table to the Help Manager */
  12457.             bSuccess = WinLoadHelpTable( hwndHelp, usResource, hmodule );
  12458.         }
  12459.     }
  12460.  
  12461.     /* Return success indicator */
  12462.     return bSuccess;
  12463. }
  12464.  
  12465.  
  12466. ΓòÉΓòÉΓòÉ <hidden> WinLoadHelpTable - Topics ΓòÉΓòÉΓòÉ
  12467.  
  12468. Select an item: 
  12469.  
  12470. Syntax
  12471. Parameters
  12472. Returns
  12473. Remarks
  12474. Example Code
  12475. Related Functions
  12476. Related Messages
  12477. Glossary
  12478.  
  12479.  
  12480. ΓòÉΓòÉΓòÉ 17.6. WinQueryHelpInstance ΓòÉΓòÉΓòÉ
  12481.  
  12482.  
  12483. ΓòÉΓòÉΓòÉ <hidden> WinQueryHelpInstance - Syntax ΓòÉΓòÉΓòÉ
  12484.  
  12485. This function enables the application to query the instance of the Help Manager 
  12486. associated with the application-supplied window handle. 
  12487.  
  12488.  
  12489. #define INCL_WINHELP /* Or use INCL_WIN, INCL_PM, */
  12490. #include <os2.h>
  12491.  
  12492. HWND    hwndApp;   /*  Handle of the application window. */
  12493. HWND    hwndHelp;  /*  Help Manager window handle. */
  12494.  
  12495. hwndHelp = WinQueryHelpInstance(hwndApp);
  12496.  
  12497.  
  12498. ΓòÉΓòÉΓòÉ <hidden> WinQueryHelpInstance Parameter - hwndApp ΓòÉΓòÉΓòÉ
  12499.  
  12500.  hwndApp (HWND) - input 
  12501.     Handle of the application window. 
  12502.  
  12503.  
  12504. ΓòÉΓòÉΓòÉ <hidden> WinQueryHelpInstance Return Value - hwndHelp ΓòÉΓòÉΓòÉ
  12505.  
  12506.  hwndHelp (HWND) - returns 
  12507.     Help Manager window handle. 
  12508.  
  12509.     NULLHANDLE 
  12510.             No Help Manager instance is associated with the application window. 
  12511.     Other 
  12512.             Help Manager window handle. 
  12513.  
  12514.  
  12515. ΓòÉΓòÉΓòÉ <hidden> WinQueryHelpInstance - Parameters ΓòÉΓòÉΓòÉ
  12516.  
  12517.  hwndApp (HWND) - input 
  12518.     Handle of the application window. 
  12519.  
  12520.  hwndHelp (HWND) - returns 
  12521.     Help Manager window handle. 
  12522.  
  12523.     NULLHANDLE 
  12524.             No Help Manager instance is associated with the application window. 
  12525.     Other 
  12526.             Help Manager window handle. 
  12527.  
  12528.  
  12529. ΓòÉΓòÉΓòÉ <hidden> WinQueryHelpInstance - Remarks ΓòÉΓòÉΓòÉ
  12530.  
  12531. The Help Manager first traces the parent window chain until it is NULLHANDLE or 
  12532. HWND_DESKTOP. Then Help Manager traces the owner chain. If a parent of the 
  12533. owner window exists, the trace begins again with the parent chain. 
  12534.  
  12535. The window chain will be traced until the Help Manager finds an instance of the 
  12536. Help Manager or until both the parent and owner windows are NULLHANDLE or 
  12537. HWND_DESKTOP. 
  12538.  
  12539.  
  12540. ΓòÉΓòÉΓòÉ <hidden> WinQueryHelpInstance - Related Functions ΓòÉΓòÉΓòÉ
  12541.  
  12542.      WinAssociateHelpInstance 
  12543.      WinCreateHelpInstance 
  12544.      WinCreateHelpTable 
  12545.      WinDestroyHelpInstance 
  12546.      WinLoadHelpTable 
  12547.      WinQueryHelpInstance 
  12548.  
  12549.  
  12550. ΓòÉΓòÉΓòÉ <hidden> WinQueryHelpInstance - Example Code ΓòÉΓòÉΓòÉ
  12551.  
  12552. This example shows the use of the WinQueryHelpInstance call during the 
  12553. processing of a WM_INITMENU message in order to obtain the handle for sending 
  12554. an HM_SET_ACTIVE_WINDOW message. 
  12555.  
  12556. #define INCL_WIN
  12557. #include <os2.h>
  12558.  
  12559. MRESULT wm_initmenu( HWND hWnd, ULONG ulMsg, MPARAM mp1, MPARAM mp2 )
  12560. {
  12561.    /* Send message to establish the current window's parent      */
  12562.    /* as the active help window.                                 */
  12563.    WinSendMsg( WinQueryHelpInstance( hWnd ),
  12564.                HM_SET_ACTIVE_WINDOW,
  12565.                (MPARAM)WinQueryWindow( hWnd, QW_PARENT ),
  12566.                (MPARAM)WinQueryWindow( hWnd, QW_PARENT ) );
  12567.  
  12568.    /* Pass message on for default processing                     */
  12569.    return WinDefWindowProc( hWnd, ulMsg, mp1, mp2 );
  12570. }
  12571.  
  12572.  
  12573. ΓòÉΓòÉΓòÉ <hidden> WinQueryHelpInstance - Topics ΓòÉΓòÉΓòÉ
  12574.  
  12575. Select an item: 
  12576.  
  12577. Syntax
  12578. Parameters
  12579. Returns
  12580. Remarks
  12581. Example Code
  12582. Related Functions
  12583. Glossary
  12584.  
  12585.  
  12586. ΓòÉΓòÉΓòÉ 18. Dynamic Data Formatting Functions ΓòÉΓòÉΓòÉ
  12587.  
  12588. The application can also use the window to establish a dialog with the user, 
  12589. and format text responses in the window by calling dynamic data formatting 
  12590. (DDF) routines. The DDF functions provide limited formatting of text at run 
  12591. time. 
  12592.  
  12593. Warning: Users can not print or search DDF data. 
  12594.  
  12595. Following is a summary of the DDF calls that you can use in your Presentation 
  12596. Manager application. 
  12597.  
  12598.  DdfBeginList 
  12599.      Begins a definition list in the DDF buffer. 
  12600.  
  12601.  DdfBitmap 
  12602.      Places a reference to a bit map in the DDF buffer. 
  12603.  
  12604.  DdfEndList 
  12605.      Terminates the definition list initialized by DdfBeginList. 
  12606.  
  12607.  DdfHyperText 
  12608.      Defines a hypertext link to another window. 
  12609.  
  12610.  DdfInform 
  12611.      Defines a hypertext inform link. 
  12612.  
  12613.  DdfInitialize 
  12614.      Initializes the IPF internal structures for a DDF facility and returns a 
  12615.      DDF handle. 
  12616.  
  12617.  DdfListItem 
  12618.      Inserts a definition list entry item in the DDF buffer. 
  12619.  
  12620.  DdfMetafile 
  12621.      Places a reference to a metafile into the DDF buffer. 
  12622.  
  12623.  DdfPara 
  12624.      Creates a paragraph within the DDF buffer. 
  12625.  
  12626.  DdfSetColor 
  12627.      Sets the background and foreground colors of the displayed text. 
  12628.  
  12629.  DdfSetFont 
  12630.      Specifies a text font (Courier) in the DDF buffer. 
  12631.  
  12632.  DdfSetFontStyle 
  12633.      Specifies a text font (bold face) in the DDF buffer. 
  12634.  
  12635.  DdfSetFormat 
  12636.      Turns formatting off or on. 
  12637.  
  12638.  DdfSetTextAlign 
  12639.      Defines whether left, center, or right text justification is to be used 
  12640.      when text formatting is off. 
  12641.  
  12642.  DdfText 
  12643.      Adds text to the DDF buffer. 
  12644.  
  12645.  
  12646. ΓòÉΓòÉΓòÉ 18.1. DdfBeginList ΓòÉΓòÉΓòÉ
  12647.  
  12648.  
  12649. ΓòÉΓòÉΓòÉ <hidden> DdfBeginList - Syntax ΓòÉΓòÉΓòÉ
  12650.  
  12651. This function begins a definition list in the DDF buffer; it corresponds to the 
  12652. :dl. (definition list) tag. 
  12653.  
  12654.  
  12655. #define INCL_DDF
  12656. #include <os2.h>
  12657.  
  12658. HDDF     hddf;        /*  Handle to DDF returned by DdfInitialize. */
  12659. ULONG    ulWidthDT;   /*  Width of the definition term. */
  12660. ULONG    fBreakType;  /*  Type of line break to use. */
  12661. ULONG    fSpacing;    /*  Spacing between definitions. */
  12662. BOOL     rc;          /*  Success indicator. */
  12663.  
  12664. rc = DdfBeginList(hddf, ulWidthDT, fBreakType,
  12665.        fSpacing);
  12666.  
  12667.  
  12668. ΓòÉΓòÉΓòÉ <hidden> DdfBeginList Parameter - hddf ΓòÉΓòÉΓòÉ
  12669.  
  12670.  hddf (HDDF) - input 
  12671.     Handle to DDF returned by DdfInitialize. 
  12672.  
  12673.  
  12674. ΓòÉΓòÉΓòÉ <hidden> DdfBeginList Parameter - ulWidthDT ΓòÉΓòÉΓòÉ
  12675.  
  12676.  ulWidthDT (ULONG) - input 
  12677.     Width of the definition term. 
  12678.  
  12679.  
  12680. ΓòÉΓòÉΓòÉ <hidden> DdfBeginList Parameter - fBreakType ΓòÉΓòÉΓòÉ
  12681.  
  12682.  fBreakType (ULONG) - input 
  12683.     Type of line break to use. 
  12684.  
  12685.     The following constants may be specified: 
  12686.  
  12687.     HMBT_ALL 
  12688.             Start all definition descriptions on the next line, regardless of 
  12689.             the actual lengths of definition terms. 
  12690.  
  12691.     HMBT_FIT 
  12692.             Start definition description on the next line only when the 
  12693.             definition term is longer than the width specified. 
  12694.  
  12695.     HMBT_NONE 
  12696.             Do not start the definition description on the next line, even when 
  12697.             the definition term is longer than the width specified. 
  12698.  
  12699.  
  12700. ΓòÉΓòÉΓòÉ <hidden> DdfBeginList Parameter - fSpacing ΓòÉΓòÉΓòÉ
  12701.  
  12702.  fSpacing (ULONG) - input 
  12703.     Spacing between definitions. 
  12704.  
  12705.     Only the following constants may be specified: 
  12706.  
  12707.     HMLS_SINGLELINE 
  12708.             Do not insert a blank line between each definition description and 
  12709.             the next definition term. 
  12710.  
  12711.     HMLS_DOUBLELINE 
  12712.             Insert a blank line between each definition description and the 
  12713.             next definition term. 
  12714.  
  12715.  
  12716. ΓòÉΓòÉΓòÉ <hidden> DdfBeginList Return Value - rc ΓòÉΓòÉΓòÉ
  12717.  
  12718.  rc (BOOL) - returns 
  12719.     Success indicator. 
  12720.  
  12721.     TRUE 
  12722.             Successful completion 
  12723.     FALSE 
  12724.             Error occurred. 
  12725.  
  12726.  
  12727. ΓòÉΓòÉΓòÉ <hidden> DdfBeginList - Parameters ΓòÉΓòÉΓòÉ
  12728.  
  12729.  hddf (HDDF) - input 
  12730.     Handle to DDF returned by DdfInitialize. 
  12731.  
  12732.  ulWidthDT (ULONG) - input 
  12733.     Width of the definition term. 
  12734.  
  12735.  fBreakType (ULONG) - input 
  12736.     Type of line break to use. 
  12737.  
  12738.     The following constants may be specified: 
  12739.  
  12740.     HMBT_ALL 
  12741.             Start all definition descriptions on the next line, regardless of 
  12742.             the actual lengths of definition terms. 
  12743.  
  12744.     HMBT_FIT 
  12745.             Start definition description on the next line only when the 
  12746.             definition term is longer than the width specified. 
  12747.  
  12748.     HMBT_NONE 
  12749.             Do not start the definition description on the next line, even when 
  12750.             the definition term is longer than the width specified. 
  12751.  
  12752.  fSpacing (ULONG) - input 
  12753.     Spacing between definitions. 
  12754.  
  12755.     Only the following constants may be specified: 
  12756.  
  12757.     HMLS_SINGLELINE 
  12758.             Do not insert a blank line between each definition description and 
  12759.             the next definition term. 
  12760.  
  12761.     HMLS_DOUBLELINE 
  12762.             Insert a blank line between each definition description and the 
  12763.             next definition term. 
  12764.  
  12765.  rc (BOOL) - returns 
  12766.     Success indicator. 
  12767.  
  12768.     TRUE 
  12769.             Successful completion 
  12770.     FALSE 
  12771.             Error occurred. 
  12772.  
  12773.  
  12774. ΓòÉΓòÉΓòÉ <hidden> DdfBeginList - Remarks ΓòÉΓòÉΓòÉ
  12775.  
  12776. Once this function has been called, use of any DDF function other than 
  12777. DdfListItem, DdfSetColor, and DdfEndList may produce unpredictable results. 
  12778.  
  12779.  
  12780. ΓòÉΓòÉΓòÉ <hidden> DdfBeginList - Errors ΓòÉΓòÉΓòÉ
  12781.  
  12782. Possible returns from WinGetLastError 
  12783.  
  12784.  HMERR_DDF_MEMORY (0x3001) 
  12785.     Not enough memory is available. 
  12786.  
  12787.  HMERR_DDF_LIST_UNCLOSED (0x3007) 
  12788.     An attempt was made to nest a list. 
  12789.  
  12790.  HMERR_DDF_LIST_BREAKTYPE (0x3009) 
  12791.     The value of BreakType is not valid. 
  12792.  
  12793.  HMERR_DDF_LIST_SPACING (0x300A) 
  12794.     The value for Spacing is not valid. 
  12795.  
  12796.  
  12797. ΓòÉΓòÉΓòÉ <hidden> DdfBeginList - Related Functions ΓòÉΓòÉΓòÉ
  12798.  
  12799.      DdfBeginList 
  12800.      DdfBitmap 
  12801.      DdfEndList 
  12802.      DdfHyperText 
  12803.      DdfInform 
  12804.      DdfInitialize 
  12805.      DdfListItem 
  12806.      DdfMetafile 
  12807.      DdfPara 
  12808.      DdfSetColor 
  12809.      DdfSetFont 
  12810.      DdfSetFontStyle 
  12811.      DdfSetFormat 
  12812.      DdfSetTextAlign 
  12813.      DdfText 
  12814.  
  12815.  
  12816. ΓòÉΓòÉΓòÉ <hidden> DdfBeginList - Example Code ΓòÉΓòÉΓòÉ
  12817.  
  12818. After initializing a DDF buffer with DdfInitialize, the example uses 
  12819. DdfBeginList to indicate the beginning of a definition list in the DDF buffer 
  12820. (this corresponds to the IPF dl tag). For a more detailed example and 
  12821. discussion of initializing DDF, see the DdfInitialize sample. 
  12822.  
  12823. #define INCL_WINWINDOWMGR       /* General window management    */
  12824. #define INCL_WINMESSAGEMGR      /* Message management           */
  12825. #define INCL_DDF                /* Dynamic Data Facility        */
  12826. #include <os2.h>
  12827. #include <pmhelp.h>
  12828.  
  12829. struct _LISTITEM        /* definition list                      */
  12830. {
  12831.     PSZ Term;
  12832.     PSZ Desc;
  12833. } Definition[2] = {{"MVS", "Multiple Virtual System"},
  12834.                    {"VM",  "Virtual Machine"}};
  12835.  
  12836. MRESULT WindowProc( HWND hwnd, ULONG ulMsg, MPARAM mp1, MPARAM mp2)
  12837. {
  12838.  
  12839.     HWND   hwndParent;
  12840.     HWND   hwndInstance;
  12841.     HDDF   hDdf;            /* DDF handle                           */
  12842.     SHORT  i;               /* loop index                           */
  12843.  
  12844.     switch( ulMsg )
  12845.     {
  12846.     case HM_QUERY_DDF_DATA:
  12847.         /* get the help instance */
  12848.         hwndParent = WinQueryWindow( hwnd, QW_PARENT );
  12849.         hwndParent = WinQueryWindow( hwndParent, QW_PARENT );
  12850.         hwndInstance = (HWND)WinSendMsg( hwndParent, HM_QUERY,
  12851.                                  MPFROMSHORT( HMQW_INSTANCE ), NULL );
  12852.  
  12853.         /* Allocate 1K Buffer (default)  */
  12854.         hDdf = DdfInitialize(
  12855.                    hwndInstance,  /* Handle of help instance */
  12856.                    0L,            /* Default buffer size     */
  12857.                    0L             /* Default increment       */
  12858.                    );
  12859.  
  12860.         if (hDdf == NULLHANDLE)       /* Check return code       */
  12861.         {
  12862.             return (MRESULT)FALSE;
  12863.         }
  12864.  
  12865.         /* begin definition list */
  12866.         if (!DdfBeginList(hDdf, 3L, HMBT_ALL, HMLS_SINGLELINE))
  12867.         {
  12868.             return (MRESULT)FALSE;
  12869.         }
  12870.  
  12871.         /* insert 2 entries into definition list */
  12872.         for (i=0; i < 2; i++)
  12873.         {
  12874.             if (!DdfListItem(hDdf, Definition[i].Term,
  12875.                                    Definition[i].Desc))
  12876.             {
  12877.                return (MRESULT)FALSE;
  12878.             }
  12879.         }
  12880.  
  12881.         /* terminate definition list */
  12882.         if (!DdfEndList(hDdf))
  12883.         {
  12884.             return (MRESULT)FALSE;
  12885.         }
  12886.  
  12887.         return (MRESULT)hDdf;
  12888.     }
  12889. }
  12890.  
  12891.  
  12892. ΓòÉΓòÉΓòÉ <hidden> DdfBeginList - Topics ΓòÉΓòÉΓòÉ
  12893.  
  12894. Select an item: 
  12895.  
  12896. Syntax
  12897. Parameters
  12898. Returns
  12899. Errors
  12900. Remarks
  12901. Example Code
  12902. Related Functions
  12903. Glossary
  12904.  
  12905.  
  12906. ΓòÉΓòÉΓòÉ 18.2. DdfBitmap ΓòÉΓòÉΓòÉ
  12907.  
  12908.  
  12909. ΓòÉΓòÉΓòÉ <hidden> DdfBitmap - Syntax ΓòÉΓòÉΓòÉ
  12910.  
  12911. This function places a reference to a bit map in the DDF buffer. 
  12912.  
  12913.  
  12914. #define INCL_DDF
  12915. #include <os2.h>
  12916.  
  12917. HDDF       hddf;    /*  Handle to DDF returned by DdfInitialize. */
  12918. HBITMAP    hbm;     /*  Standard Presentation Manager bit map handle. */
  12919. ULONG      fAlign;  /*  Text justification flag. */
  12920. BOOL       rc;      /*  Success indicator. */
  12921.  
  12922. rc = DdfBitmap(hddf, hbm, fAlign);
  12923.  
  12924.  
  12925. ΓòÉΓòÉΓòÉ <hidden> DdfBitmap Parameter - hddf ΓòÉΓòÉΓòÉ
  12926.  
  12927.  hddf (HDDF) - input 
  12928.     Handle to DDF returned by DdfInitialize. 
  12929.  
  12930.  
  12931. ΓòÉΓòÉΓòÉ <hidden> DdfBitmap Parameter - hbm ΓòÉΓòÉΓòÉ
  12932.  
  12933.  hbm (HBITMAP) - input 
  12934.     Standard Presentation Manager bit map handle. 
  12935.  
  12936.  
  12937. ΓòÉΓòÉΓòÉ <hidden> DdfBitmap Parameter - fAlign ΓòÉΓòÉΓòÉ
  12938.  
  12939.  fAlign (ULONG) - input 
  12940.     Text justification flag. 
  12941.  
  12942.     Any of the following values can be specified: 
  12943.  
  12944.     ART_LEFT 
  12945.             Left-justify the bit map. 
  12946.     ART_RIGHT 
  12947.             Right-justify the bit map. 
  12948.     ART_CENTER 
  12949.             Center the bit map. 
  12950.     ART_RUNIN 
  12951.             Allow the bit map to be reflowed with text. 
  12952.  
  12953.  
  12954. ΓòÉΓòÉΓòÉ <hidden> DdfBitmap Return Value - rc ΓòÉΓòÉΓòÉ
  12955.  
  12956.  rc (BOOL) - returns 
  12957.     Success indicator. 
  12958.  
  12959.     TRUE 
  12960.             Successful completion 
  12961.     FALSE 
  12962.             Error occurred. 
  12963.  
  12964.  
  12965. ΓòÉΓòÉΓòÉ <hidden> DdfBitmap - Parameters ΓòÉΓòÉΓòÉ
  12966.  
  12967.  hddf (HDDF) - input 
  12968.     Handle to DDF returned by DdfInitialize. 
  12969.  
  12970.  hbm (HBITMAP) - input 
  12971.     Standard Presentation Manager bit map handle. 
  12972.  
  12973.  fAlign (ULONG) - input 
  12974.     Text justification flag. 
  12975.  
  12976.     Any of the following values can be specified: 
  12977.  
  12978.     ART_LEFT 
  12979.             Left-justify the bit map. 
  12980.     ART_RIGHT 
  12981.             Right-justify the bit map. 
  12982.     ART_CENTER 
  12983.             Center the bit map. 
  12984.     ART_RUNIN 
  12985.             Allow the bit map to be reflowed with text. 
  12986.  
  12987.  rc (BOOL) - returns 
  12988.     Success indicator. 
  12989.  
  12990.     TRUE 
  12991.             Successful completion 
  12992.     FALSE 
  12993.             Error occurred. 
  12994.  
  12995.  
  12996. ΓòÉΓòÉΓòÉ <hidden> DdfBitmap - Remarks ΓòÉΓòÉΓòÉ
  12997.  
  12998. The handle to the presentation space in which the bit map was created cannot be 
  12999. freed by the application while the panel is displayed. 
  13000.  
  13001. Note:  There is a (3-byte + size of HBITMAP structure). ESC code overhead in 
  13002.        the DDF internal buffer for this function. There is a 1-byte ESC code 
  13003.        overhead required for the fAlign flag. 
  13004.  
  13005.  
  13006. ΓòÉΓòÉΓòÉ <hidden> DdfBitmap - Errors ΓòÉΓòÉΓòÉ
  13007.  
  13008. Possible returns from WinGetLastError 
  13009.  
  13010.  HMERR_DDF_MEMORY (0x3001) 
  13011.     Not enough memory is available. 
  13012.  
  13013.  HMERR_DDF_ALIGN_TYPE (0x3002) 
  13014.     The alignment type is not valid. 
  13015.  
  13016.  
  13017. ΓòÉΓòÉΓòÉ <hidden> DdfBitmap - Related Functions ΓòÉΓòÉΓòÉ
  13018.  
  13019.      DdfBeginList 
  13020.      DdfBitmap 
  13021.      DdfEndList 
  13022.      DdfHyperText 
  13023.      DdfInform 
  13024.      DdfInitialize 
  13025.      DdfListItem 
  13026.      DdfMetafile 
  13027.      DdfPara 
  13028.      DdfSetColor 
  13029.      DdfSetFont 
  13030.      DdfSetFontStyle 
  13031.      DdfSetFormat 
  13032.      DdfSetTextAlign 
  13033.      DdfText 
  13034.  
  13035.  
  13036. ΓòÉΓòÉΓòÉ <hidden> DdfBitmap - Example Code ΓòÉΓòÉΓòÉ
  13037.  
  13038. After initializing a DDF buffer with DdfInitialize, the example obtains a 
  13039. device context (DevOpenDC), creates a presentation space (GpiCreatePS), and 
  13040. loads a bit map (GpiLoadBitmap). It then uses DdfBitmap to place a reference to 
  13041. the bit map in the DDF buffer. For a more detailed example and discussion of 
  13042. initializing DDF, see the DdfInitialize sample. 
  13043.  
  13044. #define INCL_WINWINDOWMGR       /* General window management     */
  13045. #define INCL_WINMESSAGEMGR      /* Message management            */
  13046. #define INCL_GPICONTROL         /* Basic PS control              */
  13047. #define INCL_GPIBITMAPS         /* Bit maps and Pel Operations   */
  13048. #define INCL_GPIPRIMITIVES      /* Drawing Primitives/Attributes */
  13049. #define INCL_DDF                /* Dynamic Data Facility         */
  13050. #include <os2.h>
  13051. #include <pmhelp.h>
  13052.  
  13053. #define ACVP_HAB  12
  13054. #define BM_HPS    16
  13055. #define BM_HDC    20
  13056. #define BM_HWND   24
  13057. #define ID_LEFT   255
  13058.  
  13059. MRESULT WindowProc( HWND hwnd, ULONG ulMsg, MPARAM mp1, MPARAM mp2 )
  13060. {
  13061.     HWND    hwndParent;     /* parent window                        */
  13062.     HWND    hwndInstance;   /* help instance window                 */
  13063.     HDDF    hDdf;           /* DDF handle                           */
  13064.     HDC     hdc;            /* device context handle                */
  13065.     HPS     hps;            /* presentation space handle            */
  13066.     HAB     hab;            /* anchor block handle                  */
  13067.     SIZEL   sizel = {0L,0L};/* size of new PS                       */
  13068.     HBITMAP hBitmap;        /* bit map handle                       */
  13069.     HMODULE hModule;        /* module handle                        */
  13070.  
  13071.     switch( ulMsg )
  13072.     {
  13073.     case HM_QUERY_DDF_DATA:
  13074.         hwndParent = WinQueryWindow( hwnd, QW_PARENT );
  13075.         hwndParent = WinQueryWindow( hwndParent, QW_PARENT );
  13076.         hwndInstance = (HWND)WinSendMsg( hwndParent, HM_QUERY,
  13077.                                  MPFROMSHORT( HMQW_INSTANCE ), NULL );
  13078.  
  13079.         /* Allocate 1K Buffer (default)  */
  13080.         hDdf = DdfInitialize(
  13081.                        hwndInstance,  /* Handle of help instance */
  13082.                        0L,            /* Default buffer size     */
  13083.                        0L             /* Default increment       */
  13084.                        );
  13085.  
  13086.         if (hDdf == NULLHANDLE)       /* Check return code       */
  13087.         {
  13088.             return (MRESULT)FALSE;
  13089.         }
  13090.  
  13091.         /* get module handle for bit map */
  13092.         DosQueryModuleHandle("bitmap", &hModule);
  13093.         if (hModule == NULLHANDLE)
  13094.         {
  13095.             return (MRESULT)FALSE;
  13096.         }
  13097.  
  13098.         /* get hab for this window */
  13099.         if ((hab = (HAB)WinQueryWindowULong(hwnd, ACVP_HAB)) == NULLHANDLE)
  13100.         {
  13101.             return (MRESULT)FALSE;
  13102.         }
  13103.  
  13104.         /* create a device context */
  13105.         if ((hdc = DevOpenDC(hab, OD_MEMORY, "*", 0L,
  13106.                             (PDEVOPENDATA)NULL, (HDC)NULL)) == NULLHANDLE)
  13107.         {
  13108.            return (MRESULT)FALSE;
  13109.         }
  13110.  
  13111.         /* save hdc in reserved word */
  13112.         WinSetWindowULong(hwnd, BM_HDC, (ULONG)hdc);
  13113.  
  13114.         /* create a noncached micro presentation space */
  13115.         /* and associate it with the window */
  13116.         if ((hps = GpiCreatePS(hab, hdc, &sizel,
  13117.                    PU_PELS | GPIF_DEFAULT
  13118.                    | GPIT_MICRO | GPIA_ASSOC)) == NULLHANDLE)
  13119.         {
  13120.            return (MRESULT)FALSE;
  13121.         }
  13122.  
  13123.         /* save hps in reserved word */
  13124.         WinSetWindowULong(hwnd, BM_HPS, (ULONG)hps);
  13125.  
  13126.         /* Load the Bit map to display */
  13127.         if ((hBitmap = GpiLoadBitmap(hps, hModule, ID_LEFT, 300L,
  13128.                                      300L)) == NULLHANDLE)
  13129.         {
  13130.             return (MRESULT)FALSE;
  13131.         }
  13132.  
  13133.         /* save bit map hwnd in reserved word */
  13134.         WinSetWindowULong(hwnd, BM_HWND, (ULONG)hBitmap);
  13135.  
  13136.         /* Display the bit map align left */
  13137.         if (!DdfBitmap(hDdf, hBitmap, ART_LEFT))
  13138.         {
  13139.             return (MRESULT)FALSE;
  13140.         }
  13141.  
  13142.         return (MRESULT)hDdf;
  13143.  
  13144.     case WM_CLOSE:
  13145.         /* release PS, DC, and bit map */
  13146.         GpiDestroyPS((HPS)WinQueryWindowULong(hwnd, BM_HPS));
  13147.         DevCloseDC((HDC)WinQueryWindowULong(hwnd, BM_HDC));
  13148.         GpiDeleteBitmap((HBITMAP)WinQueryWindowULong(hwnd, BM_HWND));
  13149.         WinDestroyWindow(WinQueryWindow(hwnd, QW_PARENT));
  13150.         return (MRESULT)TRUE;
  13151.     }
  13152. }
  13153.  
  13154.  
  13155. ΓòÉΓòÉΓòÉ <hidden> DdfBitmap - Topics ΓòÉΓòÉΓòÉ
  13156.  
  13157. Select an item: 
  13158.  
  13159. Syntax
  13160. Parameters
  13161. Returns
  13162. Errors
  13163. Remarks
  13164. Example Code
  13165. Related Functions
  13166. Glossary
  13167.  
  13168.  
  13169. ΓòÉΓòÉΓòÉ 18.3. DdfEndList ΓòÉΓòÉΓòÉ
  13170.  
  13171.  
  13172. ΓòÉΓòÉΓòÉ <hidden> DdfEndList - Syntax ΓòÉΓòÉΓòÉ
  13173.  
  13174. This function terminates the definition list initialized by DdfBeginList. 
  13175.  
  13176.  
  13177. #define INCL_DDF
  13178. #include <os2.h>
  13179.  
  13180. HDDF    hddf;  /*  Handle to DDF returned by DdfInitialize. */
  13181. BOOL    rc;    /*  Success indicator. */
  13182.  
  13183. rc = DdfEndList(hddf);
  13184.  
  13185.  
  13186. ΓòÉΓòÉΓòÉ <hidden> DdfEndList Parameter - hddf ΓòÉΓòÉΓòÉ
  13187.  
  13188.  hddf (HDDF) - input 
  13189.     Handle to DDF returned by DdfInitialize. 
  13190.  
  13191.  
  13192. ΓòÉΓòÉΓòÉ <hidden> DdfEndList Return Value - rc ΓòÉΓòÉΓòÉ
  13193.  
  13194.  rc (BOOL) - returns 
  13195.     Success indicator. 
  13196.  
  13197.     TRUE 
  13198.             Successful completion 
  13199.     FALSE 
  13200.             Error occurred. 
  13201.  
  13202.  
  13203. ΓòÉΓòÉΓòÉ <hidden> DdfEndList - Parameters ΓòÉΓòÉΓòÉ
  13204.  
  13205.  hddf (HDDF) - input 
  13206.     Handle to DDF returned by DdfInitialize. 
  13207.  
  13208.  rc (BOOL) - returns 
  13209.     Success indicator. 
  13210.  
  13211.     TRUE 
  13212.             Successful completion 
  13213.     FALSE 
  13214.             Error occurred. 
  13215.  
  13216.  
  13217. ΓòÉΓòÉΓòÉ <hidden> DdfEndList - Errors ΓòÉΓòÉΓòÉ
  13218.  
  13219. Possible returns from WinGetLastError 
  13220.  
  13221.  HMERR_DDF_LIST_UNINITIALIZED (0x3008) 
  13222.     No definition list has been initialized by DdfBeginList. 
  13223.  
  13224.  
  13225. ΓòÉΓòÉΓòÉ <hidden> DdfEndList - Related Functions ΓòÉΓòÉΓòÉ
  13226.  
  13227.      DdfBeginList 
  13228.      DdfBitmap 
  13229.      DdfEndList 
  13230.      DdfHyperText 
  13231.      DdfInform 
  13232.      DdfInitialize 
  13233.      DdfListItem 
  13234.      DdfMetafile 
  13235.      DdfPara 
  13236.      DdfSetColor 
  13237.      DdfSetFont 
  13238.      DdfSetFontStyle 
  13239.      DdfSetFormat 
  13240.      DdfSetTextAlign 
  13241.      DdfText 
  13242.  
  13243.  
  13244. ΓòÉΓòÉΓòÉ <hidden> DdfEndList - Example Code ΓòÉΓòÉΓòÉ
  13245.  
  13246. After initializing a DDF buffer with DdfInitialize, the example uses 
  13247. DdfBeginList to indicate the beginning of a definition list in the DDF buffer 
  13248. (this corresponds to the IPF dl tag). For a more detailed example and 
  13249. discussion of initializing DDF, see the DdfInitialize sample. 
  13250.  
  13251. #define INCL_WINWINDOWMGR       /* General window management    */
  13252. #define INCL_WINMESSAGEMGR      /* Message management           */
  13253. #define INCL_DDF                /* Dynamic Data Facility        */
  13254. #include <os2.h>
  13255. #include <pmhelp.h>
  13256.  
  13257. struct _LISTITEM        /* definition list                      */
  13258. {
  13259.     PSZ Term;
  13260.     PSZ Desc;
  13261. } Definition[2] = {{"MVS", "Multiple Virtual System"},
  13262.                    {"VM",  "Virtual Machine"}};
  13263.  
  13264. MRESULT WindowProc( HWND hwnd, ULONG ulMsg, MPARAM mp1, MPARAM mp2)
  13265. {
  13266.  
  13267.     HWND   hwndParent;
  13268.     HWND   hwndInstance;
  13269.     HDDF   hDdf;            /* DDF handle                           */
  13270.     SHORT  i;               /* loop index                           */
  13271.  
  13272.     switch( ulMsg )
  13273.     {
  13274.     case HM_QUERY_DDF_DATA:
  13275.         /* get the help instance */
  13276.         hwndParent = WinQueryWindow( hwnd, QW_PARENT );
  13277.         hwndParent = WinQueryWindow( hwndParent, QW_PARENT );
  13278.         hwndInstance = (HWND)WinSendMsg( hwndParent, HM_QUERY,
  13279.                                  MPFROMSHORT( HMQW_INSTANCE ), NULL );
  13280.  
  13281.         /* Allocate 1K Buffer (default)  */
  13282.         hDdf = DdfInitialize(
  13283.                    hwndInstance,  /* Handle of help instance */
  13284.                    0L,            /* Default buffer size     */
  13285.                    0L             /* Default increment       */
  13286.                    );
  13287.  
  13288.         if (hDdf == NULLHANDLE)       /* Check return code       */
  13289.         {
  13290.             return (MRESULT)FALSE;
  13291.         }
  13292.  
  13293.         /* begin definition list */
  13294.         if (!DdfBeginList(hDdf, 3L, HMBT_ALL, HMLS_SINGLELINE))
  13295.         {
  13296.             return (MRESULT)FALSE;
  13297.         }
  13298.  
  13299.         /* insert 2 entries into definition list */
  13300.         for (i=0; i < 2; i++)
  13301.         {
  13302.             if (!DdfListItem(hDdf, Definition[i].Term,
  13303.                                    Definition[i].Desc))
  13304.             {
  13305.                return (MRESULT)FALSE;
  13306.             }
  13307.         }
  13308.  
  13309.         /* terminate definition list */
  13310.         if (!DdfEndList(hDdf))
  13311.         {
  13312.             return (MRESULT)FALSE;
  13313.         }
  13314.  
  13315.         return (MRESULT)hDdf;
  13316.     }
  13317. }
  13318.  
  13319.  
  13320. ΓòÉΓòÉΓòÉ <hidden> DdfEndList - Topics ΓòÉΓòÉΓòÉ
  13321.  
  13322. Select an item: 
  13323.  
  13324. Syntax
  13325. Parameters
  13326. Returns
  13327. Errors
  13328. Example Code
  13329. Related Functions
  13330. Glossary
  13331.  
  13332.  
  13333. ΓòÉΓòÉΓòÉ 18.4. DdfHyperText ΓòÉΓòÉΓòÉ
  13334.  
  13335.  
  13336. ΓòÉΓòÉΓòÉ <hidden> DdfHyperText - Syntax ΓòÉΓòÉΓòÉ
  13337.  
  13338. This function defines a hypertext link to another panel, which is equal to a 
  13339. link of reftype=hd.  Links to footnotes, launch links and links to external 
  13340. databases are not supported. 
  13341.  
  13342.  
  13343. #define INCL_DDF
  13344. #include <os2.h>
  13345.  
  13346. HDDF     hddf;            /*  Handle to DDF returned by DdfInitialize. */
  13347. PCSZ     pszText;         /*  Hypertext phrase. */
  13348. PCSZ     pszReference;    /*  Pointer to a string containing the link reference. */
  13349. ULONG    fReferenceType;  /*  Reference Type. */
  13350. BOOL     rc;              /*  Success indicator. */
  13351.  
  13352. rc = DdfHyperText(hddf, pszText, pszReference,
  13353.        fReferenceType);
  13354.  
  13355.  
  13356. ΓòÉΓòÉΓòÉ <hidden> DdfHyperText Parameter - hddf ΓòÉΓòÉΓòÉ
  13357.  
  13358.  hddf (HDDF) - input 
  13359.     Handle to DDF returned by DdfInitialize. 
  13360.  
  13361.  
  13362. ΓòÉΓòÉΓòÉ <hidden> DdfHyperText Parameter - pszText ΓòÉΓòÉΓòÉ
  13363.  
  13364.  pszText (PCSZ) - input 
  13365.     Hypertext phrase. 
  13366.  
  13367.  
  13368. ΓòÉΓòÉΓòÉ <hidden> DdfHyperText Parameter - pszReference ΓòÉΓòÉΓòÉ
  13369.  
  13370.  pszReference (PCSZ) - input 
  13371.     Pointer to a string containing the link reference. 
  13372.  
  13373.     The value of this parameter depends on the value of fReferenceType. 
  13374.  
  13375.     If fReferenceType is REFERENCE_BY_RES 
  13376.             pszReference must contain a pointer to a numeric string containing 
  13377.             the res number; otherwise it will default to a res number of zero. 
  13378.             Valid values are 1 - 64000; all other values are reserved. 
  13379.  
  13380.     If fReferenceType is REFERENCE_BY_ID 
  13381.             pszReference must contain a pointer to a string containing the 
  13382.             alphanumeric identifier of the destination panel. 
  13383.  
  13384.  
  13385. ΓòÉΓòÉΓòÉ <hidden> DdfHyperText Parameter - fReferenceType ΓòÉΓòÉΓòÉ
  13386.  
  13387.  fReferenceType (ULONG) - input 
  13388.     Reference Type. 
  13389.  
  13390.     This parameter specifies whether you are linking via a resource identifier 
  13391.     (res number) or via an alphanumeric identifier. 
  13392.  
  13393.     REFERENCE_BY_RES 
  13394.             To link via a resource identifier. 
  13395.     REFERENCE_BY_ID 
  13396.             To link via an alphanumeric identifier. 
  13397.  
  13398.  
  13399. ΓòÉΓòÉΓòÉ <hidden> DdfHyperText Return Value - rc ΓòÉΓòÉΓòÉ
  13400.  
  13401.  rc (BOOL) - returns 
  13402.     Success indicator. 
  13403.  
  13404.     TRUE 
  13405.             Successful completion 
  13406.     FALSE 
  13407.             Error occurred. 
  13408.  
  13409.  
  13410. ΓòÉΓòÉΓòÉ <hidden> DdfHyperText - Parameters ΓòÉΓòÉΓòÉ
  13411.  
  13412.  hddf (HDDF) - input 
  13413.     Handle to DDF returned by DdfInitialize. 
  13414.  
  13415.  pszText (PCSZ) - input 
  13416.     Hypertext phrase. 
  13417.  
  13418.  pszReference (PCSZ) - input 
  13419.     Pointer to a string containing the link reference. 
  13420.  
  13421.     The value of this parameter depends on the value of fReferenceType. 
  13422.  
  13423.     If fReferenceType is REFERENCE_BY_RES 
  13424.             pszReference must contain a pointer to a numeric string containing 
  13425.             the res number; otherwise it will default to a res number of zero. 
  13426.             Valid values are 1 - 64000; all other values are reserved. 
  13427.  
  13428.     If fReferenceType is REFERENCE_BY_ID 
  13429.             pszReference must contain a pointer to a string containing the 
  13430.             alphanumeric identifier of the destination panel. 
  13431.  
  13432.  fReferenceType (ULONG) - input 
  13433.     Reference Type. 
  13434.  
  13435.     This parameter specifies whether you are linking via a resource identifier 
  13436.     (res number) or via an alphanumeric identifier. 
  13437.  
  13438.     REFERENCE_BY_RES 
  13439.             To link via a resource identifier. 
  13440.     REFERENCE_BY_ID 
  13441.             To link via an alphanumeric identifier. 
  13442.  
  13443.  rc (BOOL) - returns 
  13444.     Success indicator. 
  13445.  
  13446.     TRUE 
  13447.             Successful completion 
  13448.     FALSE 
  13449.             Error occurred. 
  13450.  
  13451.  
  13452. ΓòÉΓòÉΓòÉ <hidden> DdfHyperText - Remarks ΓòÉΓòÉΓòÉ
  13453.  
  13454. There is a 3-byte ESC code overhead in the DDF internal buffer for each word in 
  13455. the text buffer.  There is a 1-byte ESC code overhead for each blank and for 
  13456. each newline character.  If fReferenceType is REFERENCE_BY_ID, then there is a 
  13457. (3-byte + Reference length) ESC code overhead. For a fReferenceType of 
  13458. REFERENCE_BY_RES, the overhead is 5 bytes. Finally, there is a 3-byte ESC code 
  13459. overhead that is required for ending the hypertext link. 
  13460.  
  13461.  
  13462. ΓòÉΓòÉΓòÉ <hidden> DdfHyperText - Errors ΓòÉΓòÉΓòÉ
  13463.  
  13464. Possible returns from WinGetLastError 
  13465.  
  13466.  HMERR_DDF_MEMORY (0x3001) 
  13467.     Not enough memory is available. 
  13468.  
  13469.  HMERR_DDF_REFTYPE (0x3006) 
  13470.     The reference type is not valid. 
  13471.  
  13472.  
  13473. ΓòÉΓòÉΓòÉ <hidden> DdfHyperText - Related Functions ΓòÉΓòÉΓòÉ
  13474.  
  13475.      DdfBeginList 
  13476.      DdfBitmap 
  13477.      DdfEndList 
  13478.      DdfHyperText 
  13479.      DdfInform 
  13480.      DdfInitialize 
  13481.      DdfListItem 
  13482.      DdfMetafile 
  13483.      DdfPara 
  13484.      DdfSetColor 
  13485.      DdfSetFont 
  13486.      DdfSetFontStyle 
  13487.      DdfSetFormat 
  13488.      DdfSetTextAlign 
  13489.      DdfText 
  13490.  
  13491.  
  13492. ΓòÉΓòÉΓòÉ <hidden> DdfHyperText - Example Code ΓòÉΓòÉΓòÉ
  13493.  
  13494. After initializing a DDF buffer with DdfInitialize, the example uses 
  13495. DdfHyperText to create a hypertext link with another resource. For a more 
  13496. detailed example and discussion of initializing DDF, see the DdfInitialize 
  13497. sample. 
  13498.  
  13499. #define INCL_WINWINDOWMGR       /* General window management    */
  13500. #define INCL_WINMESSAGEMGR      /* Message management           */
  13501. #define INCL_DDF                /* Dynamic Data Facility        */
  13502. #include <os2.h>
  13503. #include <pmhelp.h>
  13504.  
  13505. PSZ    Text = "This text is a HYPERTEXT message.\n"; /* hypertext string  */
  13506. PSZ    ResID = "1";     /* Resource identifier                  */
  13507.  
  13508. MRESULT WindowProc( HWND hwnd, ULONG ulMsg, MPARAM mp1, MPARAM mp2 )
  13509. {
  13510.     HWND   hwndParent;
  13511.     HWND   hwndInstance;
  13512.     HDDF   hDdf;            /* DDF handle                           */
  13513.  
  13514.     switch( ulMsg )
  13515.     {
  13516.     case HM_QUERY_DDF_DATA:
  13517.         /* get the help instance */
  13518.         hwndParent = WinQueryWindow( hwnd, QW_PARENT );
  13519.         hwndParent = WinQueryWindow( hwndParent, QW_PARENT );
  13520.         hwndInstance = (HWND)WinSendMsg( hwndParent, HM_QUERY,
  13521.                                  MPFROMSHORT( HMQW_INSTANCE ), NULL );
  13522.  
  13523.         /* Allocate 1K Buffer (default)  */
  13524.         hDdf = DdfInitialize(
  13525.                     hwndInstance,  /* Handle of help instance */
  13526.                     0L,            /* Default buffer size     */
  13527.                     0L             /* Default increment       */
  13528.                     );
  13529.  
  13530.         if (hDdf == NULLHANDLE)       /* Check return code       */
  13531.         {
  13532.             return (MRESULT)FALSE;
  13533.         }
  13534.  
  13535.         /* create hypertext link with resource 1 */
  13536.         if (!DdfHyperText(hDdf, (PSZ)Text, ResID, REFERENCE_BY_RES))
  13537.         {
  13538.             return (MRESULT)FALSE;
  13539.         }
  13540.  
  13541.         return (MRESULT)hDdf;
  13542.     }
  13543. }
  13544.  
  13545.  
  13546. ΓòÉΓòÉΓòÉ <hidden> DdfHyperText - Topics ΓòÉΓòÉΓòÉ
  13547.  
  13548. Select an item: 
  13549.  
  13550. Syntax
  13551. Parameters
  13552. Returns
  13553. Errors
  13554. Remarks
  13555. Example Code
  13556. Related Functions
  13557. Glossary
  13558.  
  13559.  
  13560. ΓòÉΓòÉΓòÉ 18.5. DdfInform ΓòÉΓòÉΓòÉ
  13561.  
  13562.  
  13563. ΓòÉΓòÉΓòÉ <hidden> DdfInform - Syntax ΓòÉΓòÉΓòÉ
  13564.  
  13565. This function defines a hypertext inform link, which sends an HM_INFORM message 
  13566. to the application with a res= attribute. It also corresponds to the link tag 
  13567. with reftype=inform. 
  13568.  
  13569.  
  13570. #define INCL_DDF
  13571. #include <os2.h>
  13572.  
  13573. HDDF     hddf;             /*  Handle to DDF returned by DdfInitialize. */
  13574. PCSZ     pszText;          /*  Hypertext phrase. */
  13575. ULONG    resInformNumber;  /*  Res number associated with this hypertext field. */
  13576. BOOL     rc;               /*  Success indicator. */
  13577.  
  13578. rc = DdfInform(hddf, pszText, resInformNumber);
  13579.  
  13580.  
  13581. ΓòÉΓòÉΓòÉ <hidden> DdfInform Parameter - hddf ΓòÉΓòÉΓòÉ
  13582.  
  13583.  hddf (HDDF) - input 
  13584.     Handle to DDF returned by DdfInitialize. 
  13585.  
  13586.  
  13587. ΓòÉΓòÉΓòÉ <hidden> DdfInform Parameter - pszText ΓòÉΓòÉΓòÉ
  13588.  
  13589.  pszText (PCSZ) - input 
  13590.     Hypertext phrase. 
  13591.  
  13592.  
  13593. ΓòÉΓòÉΓòÉ <hidden> DdfInform Parameter - resInformNumber ΓòÉΓòÉΓòÉ
  13594.  
  13595.  resInformNumber (ULONG) - input 
  13596.     Res number associated with this hypertext field. 
  13597.  
  13598.     Possible values are 1 to 64000; all other values are reserved. 
  13599.  
  13600.  
  13601. ΓòÉΓòÉΓòÉ <hidden> DdfInform Return Value - rc ΓòÉΓòÉΓòÉ
  13602.  
  13603.  rc (BOOL) - returns 
  13604.     Success indicator. 
  13605.  
  13606.     TRUE 
  13607.             Successful completion 
  13608.     FALSE 
  13609.             Error occurred. 
  13610.  
  13611.  
  13612. ΓòÉΓòÉΓòÉ <hidden> DdfInform - Parameters ΓòÉΓòÉΓòÉ
  13613.  
  13614.  hddf (HDDF) - input 
  13615.     Handle to DDF returned by DdfInitialize. 
  13616.  
  13617.  pszText (PCSZ) - input 
  13618.     Hypertext phrase. 
  13619.  
  13620.  resInformNumber (ULONG) - input 
  13621.     Res number associated with this hypertext field. 
  13622.  
  13623.     Possible values are 1 to 64000; all other values are reserved. 
  13624.  
  13625.  rc (BOOL) - returns 
  13626.     Success indicator. 
  13627.  
  13628.     TRUE 
  13629.             Successful completion 
  13630.     FALSE 
  13631.             Error occurred. 
  13632.  
  13633.  
  13634. ΓòÉΓòÉΓòÉ <hidden> DdfInform - Errors ΓòÉΓòÉΓòÉ
  13635.  
  13636. Possible returns from WinGetLastError 
  13637.  
  13638.  HMERR_DDF_MEMORY (0x3001) 
  13639.     Not enough memory is available. 
  13640.  
  13641.  
  13642. ΓòÉΓòÉΓòÉ <hidden> DdfInform - Related Functions ΓòÉΓòÉΓòÉ
  13643.  
  13644.      DdfBeginList 
  13645.      DdfBitmap 
  13646.      DdfEndList 
  13647.      DdfHyperText 
  13648.      DdfInform 
  13649.      DdfInitialize 
  13650.      DdfListItem 
  13651.      DdfMetafile 
  13652.      DdfPara 
  13653.      DdfSetColor 
  13654.      DdfSetFont 
  13655.      DdfSetFontStyle 
  13656.      DdfSetFormat 
  13657.      DdfSetTextAlign 
  13658.      DdfText 
  13659.  
  13660.  
  13661. ΓòÉΓòÉΓòÉ <hidden> DdfInform - Example Code ΓòÉΓòÉΓòÉ
  13662.  
  13663. After initializing a DDF buffer with DdfInitialize, the example uses DdfInform 
  13664. to create a hypertext inform link with another resource (corresponds to the IPF 
  13665. :link. tag with reftype=inform). For a more detailed example and discussion of 
  13666. initializing DDF, see the DdfInitialize sample. 
  13667.  
  13668. #define INCL_WINWINDOWMGR       /* General window management    */
  13669. #define INCL_WINMESSAGEMGR      /* Message management           */
  13670. #define INCL_DDF                /* Dynamic Data Facility        */
  13671. #include <os2.h>
  13672. #include <pmhelp.h>
  13673.  
  13674. PSZ    Text = "This text is a HYPERTEXT message.\n"; /* hypertext string  */
  13675. MRESULT WindowProc( HWND hwnd, ULONG ulMsg, MPARAM mp1, MPARAM mp2 )
  13676. {
  13677.     HWND   hwndParent;
  13678.     HWND   hwndInstance;
  13679.     HDDF   hDdf;            /* DDF handle                           */
  13680.  
  13681.     switch( ulMsg )
  13682.     {
  13683.         case HM_QUERY_DDF_DATA:
  13684.             /* get the help instance */
  13685.             hwndParent = WinQueryWindow( hwnd, QW_PARENT );
  13686.             hwndParent = WinQueryWindow( hwndParent, QW_PARENT );
  13687.             hwndInstance = (HWND)WinSendMsg( hwndParent, HM_QUERY,
  13688.                                      MPFROMSHORT( HMQW_INSTANCE ), NULL );
  13689.  
  13690.         /* Allocate 1K Buffer (default)  */
  13691.         hDdf = DdfInitialize(
  13692.                         hwndInstance,  /* Handle of help instance */
  13693.                         0L,            /* Default buffer size     */
  13694.                         0L             /* Default increment       */
  13695.                         );
  13696.  
  13697.         if (hDdf == NULLHANDLE)       /* Check return code       */
  13698.         {
  13699.             return (MRESULT)FALSE;
  13700.         }
  13701.  
  13702.         /* create hypertext inform link with resource 1 */
  13703.         if (!DdfInform(hDdf, (PSZ)Text, 1L))
  13704.         {
  13705.             return (MRESULT)FALSE;
  13706.         }
  13707.  
  13708.         return (MRESULT)hDdf;
  13709.     }
  13710. }
  13711.  
  13712.  
  13713. ΓòÉΓòÉΓòÉ <hidden> DdfInform - Topics ΓòÉΓòÉΓòÉ
  13714.  
  13715. Select an item: 
  13716.  
  13717. Syntax
  13718. Parameters
  13719. Returns
  13720. Errors
  13721. Example Code
  13722. Related Functions
  13723. Glossary
  13724.  
  13725.  
  13726. ΓòÉΓòÉΓòÉ 18.6. DdfInitialize ΓòÉΓòÉΓòÉ
  13727.  
  13728.  
  13729. ΓòÉΓòÉΓòÉ <hidden> DdfInitialize - Syntax ΓòÉΓòÉΓòÉ
  13730.  
  13731. This function initializes the IPF internal structures for dynamic data 
  13732. formatting and returns a DDF handle. The application uses this handle to refer 
  13733. to a particular DDF panel. 
  13734.  
  13735.  
  13736. #define INCL_DDF
  13737. #include <os2.h>
  13738.  
  13739. HWND     hwndHelpInstance;  /*  Handle of a help instance. */
  13740. ULONG    cbBuffer;          /*  Initial length of internal buffer. */
  13741. ULONG    ulIncrement;       /*  Amount by which to increment the buffer size, if necessary. */
  13742. HDDF     hddf;              /*  Handle to DDF. */
  13743.  
  13744. hddf = DdfInitialize(hwndHelpInstance, cbBuffer,
  13745.          ulIncrement);
  13746.  
  13747.  
  13748. ΓòÉΓòÉΓòÉ <hidden> DdfInitialize Parameter - hwndHelpInstance ΓòÉΓòÉΓòÉ
  13749.  
  13750.  hwndHelpInstance (HWND) - input 
  13751.     Handle of a help instance. 
  13752.  
  13753.  
  13754. ΓòÉΓòÉΓòÉ <hidden> DdfInitialize Parameter - cbBuffer ΓòÉΓòÉΓòÉ
  13755.  
  13756.  cbBuffer (ULONG) - input 
  13757.     Initial length of internal buffer. 
  13758.  
  13759.     Initial length of internal buffer where DDF information is to be stored. If 
  13760.     this field is 0L, a default value of 1K is defined. The maximum value is 61 
  13761.     440 bytes (60KB). 
  13762.  
  13763.  
  13764. ΓòÉΓòÉΓòÉ <hidden> DdfInitialize Parameter - ulIncrement ΓòÉΓòÉΓòÉ
  13765.  
  13766.  ulIncrement (ULONG) - input 
  13767.     Amount by which to increment the buffer size, if necessary. 
  13768.  
  13769.     If this field is NULL, a default value of 256 bytes is defined.  The 
  13770.     maximum value is 60KB. 
  13771.  
  13772.  
  13773. ΓòÉΓòÉΓòÉ <hidden> DdfInitialize Return Value - hddf ΓòÉΓòÉΓòÉ
  13774.  
  13775.  hddf (HDDF) - returns 
  13776.     Handle to DDF. 
  13777.  
  13778.     A handle to DDF is returned if initialization was successful. Otherwise, 
  13779.     the value returned is NULL, indicating that an error has occurred because 
  13780.     of insufficient memory or incorrect instance. 
  13781.  
  13782.  
  13783. ΓòÉΓòÉΓòÉ <hidden> DdfInitialize - Parameters ΓòÉΓòÉΓòÉ
  13784.  
  13785.  hwndHelpInstance (HWND) - input 
  13786.     Handle of a help instance. 
  13787.  
  13788.  cbBuffer (ULONG) - input 
  13789.     Initial length of internal buffer. 
  13790.  
  13791.     Initial length of internal buffer where DDF information is to be stored. If 
  13792.     this field is 0L, a default value of 1K is defined. The maximum value is 61 
  13793.     440 bytes (60KB). 
  13794.  
  13795.  ulIncrement (ULONG) - input 
  13796.     Amount by which to increment the buffer size, if necessary. 
  13797.  
  13798.     If this field is NULL, a default value of 256 bytes is defined.  The 
  13799.     maximum value is 60KB. 
  13800.  
  13801.  hddf (HDDF) - returns 
  13802.     Handle to DDF. 
  13803.  
  13804.     A handle to DDF is returned if initialization was successful. Otherwise, 
  13805.     the value returned is NULL, indicating that an error has occurred because 
  13806.     of insufficient memory or incorrect instance. 
  13807.  
  13808.  
  13809. ΓòÉΓòÉΓòÉ <hidden> DdfInitialize - Remarks ΓòÉΓòÉΓòÉ
  13810.  
  13811. At initialization, the default for dynamic data display is that text aligned on 
  13812. the left, and formatting is turned on. 
  13813.  
  13814.  
  13815. ΓòÉΓòÉΓòÉ <hidden> DdfInitialize - Related Functions ΓòÉΓòÉΓòÉ
  13816.  
  13817.      DdfBeginList 
  13818.      DdfBitmap 
  13819.      DdfEndList 
  13820.      DdfHyperText 
  13821.      DdfInform 
  13822.      DdfInitialize 
  13823.      DdfListItem 
  13824.      DdfMetafile 
  13825.      DdfPara 
  13826.      DdfSetColor 
  13827.      DdfSetFont 
  13828.      DdfSetFontStyle 
  13829.      DdfSetFormat 
  13830.      DdfSetTextAlign 
  13831.      DdfText 
  13832.  
  13833.  
  13834. ΓòÉΓòÉΓòÉ <hidden> DdfInitialize - Example Code ΓòÉΓòÉΓòÉ
  13835.  
  13836. This example shows how to initialize and use the Dynamic Data Facility for 
  13837. displaying an online document. Two functions are defined: the first, SampleObj, 
  13838. creates a window that will display the online information and specifies the 
  13839. second function, SampleWindowProc, as the corresponding window procedure. These 
  13840. two functions are compiled into a DLL and exported, so that IPF can invoke them 
  13841. when it encounters the :ddf and :acviewport tags during execution. The 
  13842. :acviewport tag will specify the DLL name and the SampleObj function; when IPF 
  13843. calls SampleObj, it initializes an application-controlled window with 
  13844. SampleWindowProc as the window procedure and returns the window handle. Later, 
  13845. when IPF encounters the :ddf tag, it will send SampleWindowProc an 
  13846. HM_QUERY_DDF_DATA message. At this point, before calling any of the DDF API, 
  13847. DdfInitialize must first be called to initiate a DDF buffer, after which the 
  13848. other DDF API can be called to display the online information. 
  13849.  
  13850. #define INCL_WINWINDOWMGR       /* General window management    */
  13851. #define INCL_WINMESSAGEMGR      /* Message management           */
  13852. #define INCL_WINDIALOGS         /* Dialog boxes                 */
  13853. #define INCL_DDF                /* Dynamic Data Facility        */
  13854. #define INCL_32
  13855. #include <os2.h>
  13856. #include <pmhelp.h>
  13857.  
  13858. #define COM_HWND 4                /* window word offsets        */
  13859. #define PAGE_HWND 8
  13860. #define ACVP_HAB  12
  13861.  
  13862. USHORT DdfClass = FALSE;
  13863.  
  13864. MRESULT EXPENTRY SampleWindowProc(HWND hWnd, ULONG Message,
  13865.                                  MPARAM lParam1, MPARAM lParam2);
  13866.  
  13867. USHORT APIENTRY SampleObj(PACVP pACVP, PCH Parameter)
  13868. {
  13869. HWND DdfHwnd;           /* Client window handle                  */
  13870. HWND DdfCHwnd;          /* Child window handle                   */
  13871. HWND PreviousHwnd;      /* Handle for setting comm window active */
  13872.  
  13873.     /* register DDF Base class if not registered already */
  13874.     if (!DdfClass)
  13875.     {
  13876.          if (!WinRegisterClass(
  13877.                    pACVP->hAB,        /* Anchor block handle           */
  13878.                    "CLASS_Ddf",       /* Application window class name */
  13879.                    SampleWindowProc,  /* Address of window procedure   */
  13880.                    CS_SYNCPAINT |     /* Window class style            */
  13881.                    CS_SIZEREDRAW |
  13882.                    CS_MOVENOTIFY,
  13883.                    20))               /* Extra storage                 */
  13884.         {
  13885.             return TRUE;
  13886.         }
  13887.         DdfClass = TRUE;
  13888.     }
  13889.  
  13890.     /*  create standard window  */
  13891.     if (!(DdfHwnd = WinCreateStdWindow(
  13892.                       pACVP->hWndParent, /* ACVP is parent       */
  13893.                       0L,                /* No class style       */
  13894.                       NULL,              /* Frame control flag   */
  13895.                       "CLASS_Ddf",       /* Window class name    */
  13896.                       NULL,              /* No title bar         */
  13897.                       0L,                /* No special style     */
  13898.                       0L,                /* Resource in .EXE     */
  13899.                       0,                 /* No window identifier */
  13900.                       &DdfCHwnd )))      /* Client window handle */
  13901.     {
  13902.         return FALSE;
  13903.     }
  13904.  
  13905.     /* store the frame window handle in ACVP data structure */
  13906.     pACVP->hWndACVP = DdfHwnd;
  13907.  
  13908.     /* set this window as active communication window */
  13909.     PreviousHwnd = (HWND)WinSendMsg(pACVP->hWndParent,
  13910.                            HM_SET_OBJCOM_WINDOW,
  13911.                            MPFROMHWND(DdfHwnd), NULL);
  13912.  
  13913.     /* save returned communication hwnd in reserved word */
  13914.     WinSetWindowULong(DdfCHwnd, COM_HWND, (ULONG)PreviousHwnd);
  13915.  
  13916.     /* save anchor block handle in reserved word */
  13917.     WinSetWindowULong (DdfCHwnd, ACVP_HAB, (ULONG)pACVP->hAB);
  13918.  
  13919.     return FALSE;
  13920. } /* SampleObj */
  13921.  
  13922. MRESULT EXPENTRY SampleWindowProc(HWND hWnd, ULONG Message,
  13923.                                  MPARAM lParam1, MPARAM lParam2)
  13924. {
  13925.     HWND   hwndParent;       /* parent window                        */
  13926.     HWND   hwndHelpInstance; /* help instance window                 */
  13927.     HDDF   hDdf;             /* DDF handle                           */
  13928.     ULONG  DdfID;            /* DDF resource id                      */
  13929.  
  13930.     switch (Message)
  13931.     {
  13932.     case HM_QUERY_DDF_DATA:
  13933.         WinSetWindowULong(hWnd, PAGE_HWND, LONGFROMMP(lParam1));
  13934.         DdfID = LONGFROMMP(lParam2);
  13935.         hwndParent = WinQueryWindow(hWnd, QW_PARENT);
  13936.         hwndParent = WinQueryWindow(hwndParent, QW_PARENT);
  13937.         hwndHelpInstance = (HWND)WinSendMsg(hwndParent, HM_QUERY,
  13938.                                   MPFROMSHORT(HMQW_INSTANCE), NULL);
  13939.  
  13940.         /* Allocate 1K Buffer (default)  */
  13941.         hDdf = DdfInitialize(
  13942.                         hwndHelpInstance, /* Handle of help instance */
  13943.                         0L,               /* Default buffer size     */
  13944.                         0L                /* Default increment       */
  13945.                         );
  13946.  
  13947.         if (hDdf == NULLHANDLE)       /* Check return code       */
  13948.         {
  13949.             return (MRESULT)FALSE;
  13950.         }
  13951.  
  13952.         return (MRESULT)hDdf;
  13953.  
  13954.     default:
  13955.         return (WinDefWindowProc(hWnd, Message, lParam1, lParam2));
  13956.     }
  13957. } /* SampleWindowProc */
  13958.  
  13959.  
  13960. ΓòÉΓòÉΓòÉ <hidden> DdfInitialize - Topics ΓòÉΓòÉΓòÉ
  13961.  
  13962. Select an item: 
  13963.  
  13964. Syntax
  13965. Parameters
  13966. Returns
  13967. Remarks
  13968. Example Code
  13969. Related Functions
  13970. Glossary
  13971.  
  13972.  
  13973. ΓòÉΓòÉΓòÉ 18.7. DdfListItem ΓòÉΓòÉΓòÉ
  13974.  
  13975.  
  13976. ΓòÉΓòÉΓòÉ <hidden> DdfListItem - Syntax ΓòÉΓòÉΓòÉ
  13977.  
  13978. This function inserts a definition list entry in the DDF buffer; it corresponds 
  13979. to a combination of the :dt. (definition term) and :dd. (definition define) 
  13980. tags. 
  13981.  
  13982.  
  13983. #define INCL_DDF
  13984. #include <os2.h>
  13985.  
  13986. HDDF    hddf;            /*  Handle to DDF returned by DdfInitialize. */
  13987. PCSZ    pszTerm;         /*  Term portion of the definition list entry. */
  13988. PCSZ    pszDescription;  /*  Description portion of the definition list entry. */
  13989. BOOL    rc;              /*  Success indicator. */
  13990.  
  13991. rc = DdfListItem(hddf, pszTerm, pszDescription);
  13992.  
  13993.  
  13994. ΓòÉΓòÉΓòÉ <hidden> DdfListItem Parameter - hddf ΓòÉΓòÉΓòÉ
  13995.  
  13996.  hddf (HDDF) - input 
  13997.     Handle to DDF returned by DdfInitialize. 
  13998.  
  13999.  
  14000. ΓòÉΓòÉΓòÉ <hidden> DdfListItem Parameter - pszTerm ΓòÉΓòÉΓòÉ
  14001.  
  14002.  pszTerm (PCSZ) - input 
  14003.     Term portion of the definition list entry. 
  14004.  
  14005.  
  14006. ΓòÉΓòÉΓòÉ <hidden> DdfListItem Parameter - pszDescription ΓòÉΓòÉΓòÉ
  14007.  
  14008.  pszDescription (PCSZ) - input 
  14009.     Description portion of the definition list entry. 
  14010.  
  14011.     Note:  There is a 3-byte ESC code overhead in the DDF internal buffer for 
  14012.     each word in both the term and the description.  There is a 1-byte ESC code 
  14013.     overhead for each blank and for each newline character.  For each list 
  14014.     item, there is a 5-byte ESC code overhead for the margin alignment. 
  14015.  
  14016.  
  14017. ΓòÉΓòÉΓòÉ <hidden> DdfListItem Return Value - rc ΓòÉΓòÉΓòÉ
  14018.  
  14019.  rc (BOOL) - returns 
  14020.     Success indicator. 
  14021.  
  14022.     TRUE 
  14023.             Successful completion 
  14024.     FALSE 
  14025.             Error occurred. 
  14026.  
  14027.  
  14028. ΓòÉΓòÉΓòÉ <hidden> DdfListItem - Parameters ΓòÉΓòÉΓòÉ
  14029.  
  14030.  hddf (HDDF) - input 
  14031.     Handle to DDF returned by DdfInitialize. 
  14032.  
  14033.  pszTerm (PCSZ) - input 
  14034.     Term portion of the definition list entry. 
  14035.  
  14036.  pszDescription (PCSZ) - input 
  14037.     Description portion of the definition list entry. 
  14038.  
  14039.     Note:  There is a 3-byte ESC code overhead in the DDF internal buffer for 
  14040.     each word in both the term and the description.  There is a 1-byte ESC code 
  14041.     overhead for each blank and for each newline character.  For each list 
  14042.     item, there is a 5-byte ESC code overhead for the margin alignment. 
  14043.  
  14044.  rc (BOOL) - returns 
  14045.     Success indicator. 
  14046.  
  14047.     TRUE 
  14048.             Successful completion 
  14049.     FALSE 
  14050.             Error occurred. 
  14051.  
  14052.  
  14053. ΓòÉΓòÉΓòÉ <hidden> DdfListItem - Remarks ΓòÉΓòÉΓòÉ
  14054.  
  14055. The handle to the presentation space in which the bit map was created cannot be 
  14056. freed by the application while the panel is displayed. 
  14057.  
  14058. Note:  There is a (3-byte + size of HBITMAP structure) ESC code overhead in the 
  14059. DDF internal buffer for this function. There is a 1-byte ESC code overhead 
  14060. required for the Align flag. 
  14061.  
  14062.  
  14063. ΓòÉΓòÉΓòÉ <hidden> DdfListItem - Errors ΓòÉΓòÉΓòÉ
  14064.  
  14065. Possible returns from WinGetLastError 
  14066.  
  14067.  HMERR_DDF_MEMORY (0x3001) 
  14068.     Not enough memory is available. 
  14069.  
  14070.  HMERR_DDF_LIST_UNINITIALIZED (0x3008) 
  14071.     No definition list has been initialized by DdfBeginList. 
  14072.  
  14073.  
  14074. ΓòÉΓòÉΓòÉ <hidden> DdfListItem - Related Functions ΓòÉΓòÉΓòÉ
  14075.  
  14076.      DdfBeginList 
  14077.      DdfBitmap 
  14078.      DdfEndList 
  14079.      DdfHyperText 
  14080.      DdfInform 
  14081.      DdfInitialize 
  14082.      DdfListItem 
  14083.      DdfMetafile 
  14084.      DdfPara 
  14085.      DdfSetColor 
  14086.      DdfSetFont 
  14087.      DdfSetFontStyle 
  14088.      DdfSetFormat 
  14089.      DdfSetTextAlign 
  14090.      DdfText 
  14091.  
  14092.  
  14093. ΓòÉΓòÉΓòÉ <hidden> DdfListItem - Example Code ΓòÉΓòÉΓòÉ
  14094.  
  14095. After initializing a DDF buffer with DdfInitialize, the example uses 
  14096. DdfBeginList to indicate the beginning of a definition list in the DDF buffer 
  14097. (this corresponds to the IPF dl tag). For a more detailed example and 
  14098. discussion of initializing DDF, see the DdfInitialize sample. 
  14099.  
  14100. #define INCL_WINWINDOWMGR       /* General window management    */
  14101. #define INCL_WINMESSAGEMGR      /* Message management           */
  14102. #define INCL_DDF                /* Dynamic Data Facility        */
  14103. #include <os2.h>
  14104. #include <pmhelp.h>
  14105.  
  14106. struct _LISTITEM        /* definition list                      */
  14107. {
  14108.     PSZ Term;
  14109.     PSZ Desc;
  14110. } Definition[2] = {{"MVS", "Multiple Virtual System"},
  14111.                    {"VM",  "Virtual Machine"}};
  14112.  
  14113. MRESULT WindowProc( HWND hwnd, ULONG ulMsg, MPARAM mp1, MPARAM mp2)
  14114. {
  14115.  
  14116.     HWND   hwndParent;
  14117.     HWND   hwndInstance;
  14118.     HDDF   hDdf;            /* DDF handle                           */
  14119.     SHORT i;               /* loop index                           */
  14120.  
  14121.     switch( ulMsg )
  14122.     {
  14123.     case HM_QUERY_DDF_DATA:
  14124.         /* get the help instance */
  14125.         hwndParent = WinQueryWindow( hwnd, QW_PARENT );
  14126.         hwndParent = WinQueryWindow( hwndParent, QW_PARENT );
  14127.         hwndInstance = (HWND)WinSendMsg( hwndParent, HM_QUERY,
  14128.                                  MPFROMSHORT( HMQW_INSTANCE ), NULL );
  14129.  
  14130.         /* Allocate 1K Buffer (default)  */
  14131.         hDdf = DdfInitialize(
  14132.                    hwndInstance,  /* Handle of help instance */
  14133.                    0L,            /* Default buffer size     */
  14134.                    0L             /* Default increment       */
  14135.                    );
  14136.  
  14137.         if (hDdf == NULLHANDLE)       /* Check return code       */
  14138.         {
  14139.             return (MRESULT)FALSE;
  14140.         }
  14141.  
  14142.         /* begin definition list */
  14143.         if (!DdfBeginList(hDdf, 3L, HMBT_ALL, HMLS_SINGLELINE))
  14144.         {
  14145.             return (MRESULT)FALSE;
  14146.         }
  14147.  
  14148.         /* insert 2 entries into definition list */
  14149.         for (i=0; i < 2; i++)
  14150.         {
  14151.             if (!DdfListItem(hDdf, Definition[i].Term,
  14152.                                    Definition[i].Desc))
  14153.             {
  14154.                return (MRESULT)FALSE;
  14155.             }
  14156.         }
  14157.  
  14158.         /* terminate definition list */
  14159.         if (!DdfEndList(hDdf))
  14160.         {
  14161.             return (MRESULT)FALSE;
  14162.         }
  14163.  
  14164.         return (MRESULT)hDdf;
  14165.     }
  14166. }
  14167.  
  14168.  
  14169. ΓòÉΓòÉΓòÉ <hidden> DdfListItem - Topics ΓòÉΓòÉΓòÉ
  14170.  
  14171. Select an item: 
  14172.  
  14173. Syntax
  14174. Parameters
  14175. Returns
  14176. Errors
  14177. Remarks
  14178. Example Code
  14179. Related Functions
  14180. Glossary
  14181.  
  14182.  
  14183. ΓòÉΓòÉΓòÉ 18.8. DdfMetafile ΓòÉΓòÉΓòÉ
  14184.  
  14185.  
  14186. ΓòÉΓòÉΓòÉ <hidden> DdfMetafile - Syntax ΓòÉΓòÉΓòÉ
  14187.  
  14188. This function places a reference to a metafile into the DDF buffer. 
  14189.  
  14190.  
  14191. #define INCL_DDF
  14192. #include <os2.h>
  14193.  
  14194. HDDF      hddf;      /*  Handle to DDF returned by DdfInitialize. */
  14195. HMF       hmf;       /*  The handle of the metafile to display. */
  14196. PRECTL    prclRect;  /*  Size of the rectangle. */
  14197. BOOL      rc;        /*  Success indicator. */
  14198.  
  14199. rc = DdfMetafile(hddf, hmf, prclRect);
  14200.  
  14201.  
  14202. ΓòÉΓòÉΓòÉ <hidden> DdfMetafile Parameter - hddf ΓòÉΓòÉΓòÉ
  14203.  
  14204.  hddf (HDDF) - input 
  14205.     Handle to DDF returned by DdfInitialize. 
  14206.  
  14207.  
  14208. ΓòÉΓòÉΓòÉ <hidden> DdfMetafile Parameter - hmf ΓòÉΓòÉΓòÉ
  14209.  
  14210.  hmf (HMF) - input 
  14211.     The handle of the metafile to display. 
  14212.  
  14213.  
  14214. ΓòÉΓòÉΓòÉ <hidden> DdfMetafile Parameter - prclRect ΓòÉΓòÉΓòÉ
  14215.  
  14216.  prclRect (PRECTL) - input 
  14217.     Size of the rectangle. 
  14218.  
  14219.     If not NULL, contains the size of the rectangle in which the metafile will 
  14220.     be displayed.  The aspect ratio of the metafile is adjusted to fit this 
  14221.     rectangle. 
  14222.  
  14223.  
  14224. ΓòÉΓòÉΓòÉ <hidden> DdfMetafile Return Value - rc ΓòÉΓòÉΓòÉ
  14225.  
  14226.  rc (BOOL) - returns 
  14227.     Success indicator. 
  14228.  
  14229.     TRUE 
  14230.             Successful completion 
  14231.     FALSE 
  14232.             Error occurred. 
  14233.  
  14234.  
  14235. ΓòÉΓòÉΓòÉ <hidden> DdfMetafile - Parameters ΓòÉΓòÉΓòÉ
  14236.  
  14237.  hddf (HDDF) - input 
  14238.     Handle to DDF returned by DdfInitialize. 
  14239.  
  14240.  hmf (HMF) - input 
  14241.     The handle of the metafile to display. 
  14242.  
  14243.  prclRect (PRECTL) - input 
  14244.     Size of the rectangle. 
  14245.  
  14246.     If not NULL, contains the size of the rectangle in which the metafile will 
  14247.     be displayed.  The aspect ratio of the metafile is adjusted to fit this 
  14248.     rectangle. 
  14249.  
  14250.  rc (BOOL) - returns 
  14251.     Success indicator. 
  14252.  
  14253.     TRUE 
  14254.             Successful completion 
  14255.     FALSE 
  14256.             Error occurred. 
  14257.  
  14258.  
  14259. ΓòÉΓòÉΓòÉ <hidden> DdfMetafile - Remarks ΓòÉΓòÉΓòÉ
  14260.  
  14261. There is a 3-byte ESC code overhead in the DDF internal buffer for this 
  14262. function.  There is also a (MetaFilename length) overhead. Finally, the 
  14263. prclRect variable requires an additional 16 bytes of overhead in the DDF 
  14264. internal buffer. 
  14265.  
  14266.  
  14267. ΓòÉΓòÉΓòÉ <hidden> DdfMetafile - Errors ΓòÉΓòÉΓòÉ
  14268.  
  14269. Possible returns from WinGetLastError 
  14270.  
  14271.  HMERR_DDF_MEMORY (0x3001) 
  14272.     Not enough memory is available. 
  14273.  
  14274.  
  14275. ΓòÉΓòÉΓòÉ <hidden> DdfMetafile - Related Functions ΓòÉΓòÉΓòÉ
  14276.  
  14277.      DdfBeginList 
  14278.      DdfBitmap 
  14279.      DdfEndList 
  14280.      DdfHyperText 
  14281.      DdfInform 
  14282.      DdfInitialize 
  14283.      DdfListItem 
  14284.      DdfMetafile 
  14285.      DdfPara 
  14286.      DdfSetColor 
  14287.      DdfSetFont 
  14288.      DdfSetFontStyle 
  14289.      DdfSetFormat 
  14290.      DdfSetTextAlign 
  14291.      DdfText 
  14292.  
  14293.  
  14294. ΓòÉΓòÉΓòÉ <hidden> DdfMetafile - Example Code ΓòÉΓòÉΓòÉ
  14295.  
  14296. After initializing a DDF buffer with DdfInitialize, and loading a metafile with 
  14297. GpiLoadMetaFile, the example uses DdfMetafile to place a reference to the 
  14298. metafile in the DDF buffer.  For a more detailed example and discussion of 
  14299. initializing DDF, see the DdfInitialize sample. 
  14300.  
  14301. #define INCL_WINWINDOWMGR       /* General window management    */
  14302. #define INCL_WINMESSAGEMGR      /* Message management           */
  14303. #define INCL_DDF                /* Dynamic Data Facility        */
  14304. #define INCL_GPIMETAFILES       /* MetaFiles                    */
  14305. #include <os2.h>
  14306. #include <pmhelp.h>
  14307.  
  14308. #define MF_HWND   0
  14309. #define ACVP_HAB  4
  14310.  
  14311. MRESULT WindowProc( HWND hwnd, ULONG ulMsg, MPARAM mp1, MPARAM mp2 )
  14312. {
  14313.     HWND   hwndParent;
  14314.     HAB    hab;
  14315.     HWND   hwndInstance;    /* help instance window                 */
  14316.     HDDF   hDdf;            /* DDF handle                           */
  14317.     HMF    hwndMetaFile;    /* metafile handle                      */
  14318.  
  14319.     switch( ulMsg )
  14320.     {
  14321.     case HM_QUERY_DDF_DATA:
  14322.         /* get the help instance */
  14323.         hwndParent = WinQueryWindow( hwnd, QW_PARENT );
  14324.         hwndParent = WinQueryWindow( hwndParent, QW_PARENT );
  14325.         hwndInstance = (HWND)WinSendMsg( hwndParent, HM_QUERY,
  14326.                                  MPFROMSHORT( HMQW_INSTANCE ), NULL );
  14327.  
  14328.         /* Allocate 1K Buffer (default)  */
  14329.         hDdf = DdfInitialize(
  14330.                     hwndInstance,  /* Handle of help instance */
  14331.                     0L,            /* Default buffer size     */
  14332.                     0L             /* Default increment       */
  14333.                     );
  14334.  
  14335.         if (hDdf == NULLHANDLE)       /* Check return code       */
  14336.         {
  14337.             return (MRESULT)FALSE;
  14338.         }
  14339.  
  14340.         /* get hab for this window */
  14341.         if ((hab = (HAB)WinQueryWindowULong(hwnd, ACVP_HAB)) == NULLHANDLE)
  14342.         {
  14343.            return (MRESULT)FALSE;
  14344.         }
  14345.  
  14346.         /* Load the Metafile to display */
  14347.         if ((hwndMetaFile = GpiLoadMetaFile(hab, "SAMP.MET")) == NULLHANDLE)
  14348.         {
  14349.             return (MRESULT)FALSE;
  14350.         }
  14351.  
  14352.         /* Save MetaFile hwnd in reserved word */
  14353.         WinSetWindowULong(hwnd, MF_HWND, hwndMetaFile);
  14354.  
  14355.         if (!DdfMetafile(hDdf, hwndMetaFile, NULL))
  14356.         {
  14357.             return (MRESULT)FALSE;
  14358.         }
  14359.  
  14360.         return (hDdf);
  14361.  
  14362.     case WM_CLOSE:
  14363.         GpiDeleteMetaFile((HMF)WinQueryWindowULong(hwnd, MF_HWND));
  14364.         WinDestroyWindow(WinQueryWindow(hwnd, QW_PARENT));
  14365.  
  14366.         return (MRESULT)TRUE;
  14367.     }
  14368.     return WinDefWindowProc( hwnd, ulMsg, mp1, mp2 );
  14369. }
  14370.  
  14371.  
  14372. ΓòÉΓòÉΓòÉ <hidden> DdfMetafile - Topics ΓòÉΓòÉΓòÉ
  14373.  
  14374. Select an item: 
  14375.  
  14376. Syntax
  14377. Parameters
  14378. Returns
  14379. Errors
  14380. Remarks
  14381. Example Code
  14382. Related Functions
  14383. Glossary
  14384.  
  14385.  
  14386. ΓòÉΓòÉΓòÉ 18.9. DdfPara ΓòÉΓòÉΓòÉ
  14387.  
  14388.  
  14389. ΓòÉΓòÉΓòÉ <hidden> DdfPara - Syntax ΓòÉΓòÉΓòÉ
  14390.  
  14391. This function creates a paragraph within the DDF buffer. It corresponds to the 
  14392. :p. tag. This function places a reference to a bit map in the DDF buffer. 
  14393.  
  14394.  
  14395. #define INCL_DDF
  14396. #include <os2.h>
  14397.  
  14398. HDDF    hddf;  /*  Handle to DDF returned by DdfInitialize. */
  14399. BOOL    rc;    /*  Success indicator. */
  14400.  
  14401. rc = DdfPara(hddf);
  14402.  
  14403.  
  14404. ΓòÉΓòÉΓòÉ <hidden> DdfPara Parameter - hddf ΓòÉΓòÉΓòÉ
  14405.  
  14406.  hddf (HDDF) - input 
  14407.     Handle to DDF returned by DdfInitialize. 
  14408.  
  14409.  
  14410. ΓòÉΓòÉΓòÉ <hidden> DdfPara Return Value - rc ΓòÉΓòÉΓòÉ
  14411.  
  14412.  rc (BOOL) - returns 
  14413.     Success indicator. 
  14414.  
  14415.     TRUE 
  14416.             Successful completion 
  14417.     FALSE 
  14418.             Error occurred. 
  14419.  
  14420.  
  14421. ΓòÉΓòÉΓòÉ <hidden> DdfPara - Parameters ΓòÉΓòÉΓòÉ
  14422.  
  14423.  hddf (HDDF) - input 
  14424.     Handle to DDF returned by DdfInitialize. 
  14425.  
  14426.  rc (BOOL) - returns 
  14427.     Success indicator. 
  14428.  
  14429.     TRUE 
  14430.             Successful completion 
  14431.     FALSE 
  14432.             Error occurred. 
  14433.  
  14434.  
  14435. ΓòÉΓòÉΓòÉ <hidden> DdfPara - Remarks ΓòÉΓòÉΓòÉ
  14436.  
  14437. There is a 1-byte ESC code overhead in the DDF internal buffer for this 
  14438. function. 
  14439.  
  14440.  
  14441. ΓòÉΓòÉΓòÉ <hidden> DdfPara - Errors ΓòÉΓòÉΓòÉ
  14442.  
  14443. Possible returns from WinGetLastError 
  14444.  
  14445.  HMERR_DDF_MEMORY (0x3001) 
  14446.     Not enough memory is available. 
  14447.  
  14448.  
  14449. ΓòÉΓòÉΓòÉ <hidden> DdfPara - Related Functions ΓòÉΓòÉΓòÉ
  14450.  
  14451.      DdfBeginList 
  14452.      DdfBitmap 
  14453.      DdfEndList 
  14454.      DdfHyperText 
  14455.      DdfInform 
  14456.      DdfInitialize 
  14457.      DdfListItem 
  14458.      DdfMetafile 
  14459.      DdfPara 
  14460.      DdfSetColor 
  14461.      DdfSetFont 
  14462.      DdfSetFontStyle 
  14463.      DdfSetFormat 
  14464.      DdfSetTextAlign 
  14465.      DdfText 
  14466.  
  14467.  
  14468. ΓòÉΓòÉΓòÉ <hidden> DdfPara - Example Code ΓòÉΓòÉΓòÉ
  14469.  
  14470. After initializing a DDF buffer with DdfInitialize, the example uses DdfPara to 
  14471. start a new paragraph, DdfSetFont and DdfSetFontStyle to have the text 
  14472. displayed in a large, bold Courier font, DdfSetColor to change the text color, 
  14473. and DdfText to place text in the buffer.  For a more detailed example and 
  14474. discussion of initializing DDF, see the DdfInitialize DdfInitialize sample. 
  14475.  
  14476. #define INCL_WINWINDOWMGR       /* General window management    */
  14477. #define INCL_WINMESSAGEMGR      /* Message management           */
  14478. #define INCL_DDF                /* Dynamic Data Facility        */
  14479. #include <os2.h>
  14480. #include <pmhelp.h>
  14481.  
  14482. MRESULT WindowProc( HWND hwnd, ULONG ulMsg, MPARAM mp1, MPARAM mp2 )
  14483. {
  14484.    HWND   hwndParent;
  14485.    HWND   hwndInstance;    /* help instance window                 */
  14486.    HDDF   hDdf;            /* DDF handle                           */
  14487.  
  14488.     switch( ulMsg )
  14489.     {
  14490.     case HM_QUERY_DDF_DATA:
  14491.         /* get the help instance */
  14492.         hwndParent = WinQueryWindow( hwnd, QW_PARENT );
  14493.         hwndParent = WinQueryWindow( hwndParent, QW_PARENT );
  14494.         hwndInstance = (HWND)WinSendMsg( hwndParent, HM_QUERY,
  14495.                                  MPFROMSHORT( HMQW_INSTANCE ), NULL );
  14496.  
  14497.         /* Allocate 1K Buffer (default)  */
  14498.         hDdf = DdfInitialize(
  14499.                     hwndInstance,  /* Handle of help instance */
  14500.                     0L,            /* Default buffer size     */
  14501.                     0L             /* Default increment       */
  14502.                     );
  14503.  
  14504.         if (hDdf == NULLHANDLE)       /* Check return code       */
  14505.         {
  14506.             return (MRESULT)FALSE;
  14507.         }
  14508.  
  14509.         /* create paragraph in DDF buffer */
  14510.         if( !DdfPara( hDdf ) )
  14511.         {
  14512.            return (MRESULT)FALSE;
  14513.         }
  14514.  
  14515.         /* Change to large (100 x 100 dimensions) Courier font */
  14516.         if( !DdfSetFont( hDdf, "Courier", 100L, 100L ) )
  14517.         {
  14518.            return (MRESULT)FALSE;
  14519.         }
  14520.  
  14521.         /* make the font BOLDFACE */
  14522.         if( !DdfSetFontStyle( hDdf, FM_SEL_BOLD ) )
  14523.         {
  14524.            return (MRESULT)FALSE;
  14525.         }
  14526.  
  14527.         /* make the text display as BLUE on a PALE GRAY background */
  14528.         if( !DdfSetColor( hDdf, CLR_PALEGRAY, CLR_BLUE ) )
  14529.         {
  14530.            return (MRESULT)FALSE;
  14531.         }
  14532.  
  14533.         /* Write data into the buffer */
  14534.         if (!DdfText(hDdf, "Sample Text"))
  14535.         {
  14536.            return (MRESULT)FALSE;
  14537.         }
  14538.  
  14539.         return (MRESULT)hDdf;
  14540.     }
  14541.     return WinDefWindowProc( hwnd, ulMsg, mp1, mp2 );
  14542. }
  14543.  
  14544.  
  14545. ΓòÉΓòÉΓòÉ <hidden> DdfPara - Topics ΓòÉΓòÉΓòÉ
  14546.  
  14547. Select an item: 
  14548.  
  14549. Syntax
  14550. Parameters
  14551. Returns
  14552. Errors
  14553. Remarks
  14554. Example Code
  14555. Related Functions
  14556. Glossary
  14557.  
  14558.  
  14559. ΓòÉΓòÉΓòÉ 18.10. DdfSetColor ΓòÉΓòÉΓòÉ
  14560.  
  14561.  
  14562. ΓòÉΓòÉΓòÉ <hidden> DdfSetColor - Syntax ΓòÉΓòÉΓòÉ
  14563.  
  14564. This function sets the background and foreground colors of the displayed text. 
  14565.  
  14566.  
  14567. #define INCL_DDF
  14568. #include <os2.h>
  14569.  
  14570. HDDF     hddf;        /*  Handle to DDF returned by DdfInitialize. */
  14571. COLOR    fBackColor;  /*  Specifies the desired background color. */
  14572. COLOR    fForColor;   /*  Specifies the desired foreground color. */
  14573. BOOL     rc;          /*  Success indicator. */
  14574.  
  14575. rc = DdfSetColor(hddf, fBackColor, fForColor);
  14576.  
  14577.  
  14578. ΓòÉΓòÉΓòÉ <hidden> DdfSetColor Parameter - hddf ΓòÉΓòÉΓòÉ
  14579.  
  14580.  hddf (HDDF) - input 
  14581.     Handle to DDF returned by DdfInitialize. 
  14582.  
  14583.  
  14584. ΓòÉΓòÉΓòÉ <hidden> DdfSetColor Parameter - fBackColor ΓòÉΓòÉΓòÉ
  14585.  
  14586.  fBackColor (COLOR) - input 
  14587.     Specifies the desired background color. 
  14588.  
  14589.  
  14590. ΓòÉΓòÉΓòÉ <hidden> DdfSetColor Parameter - fForColor ΓòÉΓòÉΓòÉ
  14591.  
  14592.  fForColor (COLOR) - input 
  14593.     Specifies the desired foreground color. 
  14594.  
  14595.     The following color value constants may be used for the foreground and 
  14596.     background colors: 
  14597.  
  14598.          CLR_DEFAULT -  used to set IPF default text color 
  14599.          CLR_BLACK 
  14600.          CLR_BLUE 
  14601.          CLR_RED 
  14602.          CLR_PINK 
  14603.          CLR_GREEN 
  14604.          CLR_CYAN 
  14605.          CLR_YELLOW 
  14606.          CLR_BROWN 
  14607.          CLR_DARKGRAY 
  14608.          CLR_DARKBLUE 
  14609.          CLR_DARKRED 
  14610.          CLR_DARKPINK 
  14611.          CLR_DARKGREEN 
  14612.          CLR_DARKCYAN 
  14613.          CLR_PALEGRAY 
  14614.  
  14615.  
  14616. ΓòÉΓòÉΓòÉ <hidden> DdfSetColor Return Value - rc ΓòÉΓòÉΓòÉ
  14617.  
  14618.  rc (BOOL) - returns 
  14619.     Success indicator. 
  14620.  
  14621.     TRUE 
  14622.             Successful completion 
  14623.     FALSE 
  14624.             Error occurred. 
  14625.  
  14626.  
  14627. ΓòÉΓòÉΓòÉ <hidden> DdfSetColor - Parameters ΓòÉΓòÉΓòÉ
  14628.  
  14629.  hddf (HDDF) - input 
  14630.     Handle to DDF returned by DdfInitialize. 
  14631.  
  14632.  fBackColor (COLOR) - input 
  14633.     Specifies the desired background color. 
  14634.  
  14635.  fForColor (COLOR) - input 
  14636.     Specifies the desired foreground color. 
  14637.  
  14638.     The following color value constants may be used for the foreground and 
  14639.     background colors: 
  14640.  
  14641.          CLR_DEFAULT -  used to set IPF default text color 
  14642.          CLR_BLACK 
  14643.          CLR_BLUE 
  14644.          CLR_RED 
  14645.          CLR_PINK 
  14646.          CLR_GREEN 
  14647.          CLR_CYAN 
  14648.          CLR_YELLOW 
  14649.          CLR_BROWN 
  14650.          CLR_DARKGRAY 
  14651.          CLR_DARKBLUE 
  14652.          CLR_DARKRED 
  14653.          CLR_DARKPINK 
  14654.          CLR_DARKGREEN 
  14655.          CLR_DARKCYAN 
  14656.          CLR_PALEGRAY 
  14657.  
  14658.  rc (BOOL) - returns 
  14659.     Success indicator. 
  14660.  
  14661.     TRUE 
  14662.             Successful completion 
  14663.     FALSE 
  14664.             Error occurred. 
  14665.  
  14666.  
  14667. ΓòÉΓòÉΓòÉ <hidden> DdfSetColor - Remarks ΓòÉΓòÉΓòÉ
  14668.  
  14669. There is a 4-byte ESC code overhead in the DDF internal buffer for the 
  14670. foreground color, and a 4-byte overhead for the background color, with this 
  14671. function. 
  14672.  
  14673.  
  14674. ΓòÉΓòÉΓòÉ <hidden> DdfSetColor - Errors ΓòÉΓòÉΓòÉ
  14675.  
  14676. Possible returns from WinGetLastError 
  14677.  
  14678.  HMERR_DDF_MEMORY (0x3001) 
  14679.     Not enough memory is available. 
  14680.  
  14681.  HMERR_DDF_BACKCOLOR (0x3003) 
  14682.     The background color is not valid. 
  14683.  
  14684.  HMERR_DDF_FORECOLOR (0x3004) 
  14685.     The foreground color is not valid. 
  14686.  
  14687.  
  14688. ΓòÉΓòÉΓòÉ <hidden> DdfSetColor - Related Functions ΓòÉΓòÉΓòÉ
  14689.  
  14690.      DdfBeginList 
  14691.      DdfBitmap 
  14692.      DdfEndList 
  14693.      DdfHyperText 
  14694.      DdfInform 
  14695.      DdfInitialize 
  14696.      DdfListItem 
  14697.      DdfMetafile 
  14698.      DdfPara 
  14699.      DdfSetColor 
  14700.      DdfSetFont 
  14701.      DdfSetFontStyle 
  14702.      DdfSetFormat 
  14703.      DdfSetTextAlign 
  14704.      DdfText 
  14705.  
  14706.  
  14707. ΓòÉΓòÉΓòÉ <hidden> DdfSetColor - Example Code ΓòÉΓòÉΓòÉ
  14708.  
  14709. After initializing a DDF buffer with DdfInitialize, the example uses DdfPara to 
  14710. start a new paragraph, DdfSetFont and DdfSetFontStyle to have the text 
  14711. displayed in a large, bold Courier font, DdfSetColor to change the text color, 
  14712. and DdfText to place text in the buffer.  For a more detailed example and 
  14713. discussion of initializing DDF, see the DdfInitialize sample. 
  14714.  
  14715. #define INCL_WINWINDOWMGR       /* General window management    */
  14716. #define INCL_WINMESSAGEMGR      /* Message management           */
  14717. #define INCL_DDF                /* Dynamic Data Facility        */
  14718. #include <os2.h>
  14719. #include <pmhelp.h>
  14720.  
  14721. MRESULT WindowProc( HWND hwnd, ULONG ulMsg, MPARAM mp1, MPARAM mp2 )
  14722. {
  14723.    HWND   hwndParent;
  14724.    HWND   hwndInstance;    /* help instance window                 */
  14725.    HDDF   hDdf;            /* DDF handle                           */
  14726.  
  14727.     switch( ulMsg )
  14728.     {
  14729.     case HM_QUERY_DDF_DATA:
  14730.         /* get the help instance */
  14731.         hwndParent = WinQueryWindow( hwnd, QW_PARENT );
  14732.         hwndParent = WinQueryWindow( hwndParent, QW_PARENT );
  14733.         hwndInstance = (HWND)WinSendMsg( hwndParent, HM_QUERY,
  14734.                                  MPFROMSHORT( HMQW_INSTANCE ), NULL );
  14735.  
  14736.         /* Allocate 1K Buffer (default)  */
  14737.         hDdf = DdfInitialize(
  14738.                     hwndInstance,  /* Handle of help instance */
  14739.                     0L,            /* Default buffer size     */
  14740.                     0L             /* Default increment       */
  14741.                     );
  14742.  
  14743.         if (hDdf == NULLHANDLE)       /* Check return code       */
  14744.         {
  14745.             return (MRESULT)FALSE;
  14746.         }
  14747.  
  14748.         /* create paragraph in DDF buffer */
  14749.         if( !DdfPara( hDdf ) )
  14750.         {
  14751.            return (MRESULT)FALSE;
  14752.         }
  14753.  
  14754.         /* Change to large (100 x 100 dimensions) Courier font */
  14755.         if( !DdfSetFont( hDdf, "Courier", 100L, 100L ) )
  14756.         {
  14757.            return (MRESULT)FALSE;
  14758.         }
  14759.  
  14760.         /* make the font BOLDFACE */
  14761.         if( !DdfSetFontStyle( hDdf, FM_SEL_BOLD ) )
  14762.         {
  14763.            return (MRESULT)FALSE;
  14764.         }
  14765.  
  14766.         /* make the text display as BLUE on a PALE GRAY background */
  14767.         if( !DdfSetColor( hDdf, CLR_PALEGRAY, CLR_BLUE ) )
  14768.         {
  14769.            return (MRESULT)FALSE;
  14770.         }
  14771.  
  14772.         /* Write data into the buffer */
  14773.         if (!DdfText(hDdf, "Sample Text"))
  14774.         {
  14775.            return (MRESULT)FALSE;
  14776.         }
  14777.  
  14778.         return (MRESULT)hDdf;
  14779.     }
  14780.     return WinDefWindowProc( hwnd, ulMsg, mp1, mp2 );
  14781. }
  14782.  
  14783.  
  14784. ΓòÉΓòÉΓòÉ <hidden> DdfSetColor - Topics ΓòÉΓòÉΓòÉ
  14785.  
  14786. Select an item: 
  14787.  
  14788. Syntax
  14789. Parameters
  14790. Returns
  14791. Errors
  14792. Remarks
  14793. Example Code
  14794. Related Functions
  14795. Glossary
  14796.  
  14797.  
  14798. ΓòÉΓòÉΓòÉ 18.11. DdfSetFont ΓòÉΓòÉΓòÉ
  14799.  
  14800.  
  14801. ΓòÉΓòÉΓòÉ <hidden> DdfSetFont - Syntax ΓòÉΓòÉΓòÉ
  14802.  
  14803. This function specifies a text font in the DDF buffer. 
  14804.  
  14805.  
  14806. #define INCL_DDF
  14807. #include <os2.h>
  14808.  
  14809. HDDF     hddf;         /*  Handle to DDF returned by DdfInitialize. */
  14810. PCSZ     pszFaceName;  /*  Pointer to font name. */
  14811. ULONG    ulWidth;      /*  Font width in points. */
  14812. ULONG    ulHeight;     /*  Font height in points. */
  14813. BOOL     rc;           /*  Success indicator. */
  14814.  
  14815. rc = DdfSetFont(hddf, pszFaceName, ulWidth,
  14816.        ulHeight);
  14817.  
  14818.  
  14819. ΓòÉΓòÉΓòÉ <hidden> DdfSetFont Parameter - hddf ΓòÉΓòÉΓòÉ
  14820.  
  14821.  hddf (HDDF) - input 
  14822.     Handle to DDF returned by DdfInitialize. 
  14823.  
  14824.  
  14825. ΓòÉΓòÉΓòÉ <hidden> DdfSetFont Parameter - pszFaceName ΓòÉΓòÉΓòÉ
  14826.  
  14827.  pszFaceName (PCSZ) - input 
  14828.     Pointer to font name. 
  14829.  
  14830.     This parameter can be specified in two ways: 
  14831.  
  14832.         An ASCIIZ string specifying the font name. 
  14833.         NULL or "default" to specify the default font. 
  14834.  
  14835.  
  14836. ΓòÉΓòÉΓòÉ <hidden> DdfSetFont Parameter - ulWidth ΓòÉΓòÉΓòÉ
  14837.  
  14838.  ulWidth (ULONG) - input 
  14839.     Font width in points. 
  14840.  
  14841.     A point is approximately 1/72 of an inch. 
  14842.  
  14843.  
  14844. ΓòÉΓòÉΓòÉ <hidden> DdfSetFont Parameter - ulHeight ΓòÉΓòÉΓòÉ
  14845.  
  14846.  ulHeight (ULONG) - input 
  14847.     Font height in points. 
  14848.  
  14849.  
  14850. ΓòÉΓòÉΓòÉ <hidden> DdfSetFont Return Value - rc ΓòÉΓòÉΓòÉ
  14851.  
  14852.  rc (BOOL) - returns 
  14853.     Success indicator. 
  14854.  
  14855.     TRUE 
  14856.             Successful completion 
  14857.     FALSE 
  14858.             Error occurred. 
  14859.  
  14860.  
  14861. ΓòÉΓòÉΓòÉ <hidden> DdfSetFont - Parameters ΓòÉΓòÉΓòÉ
  14862.  
  14863.  hddf (HDDF) - input 
  14864.     Handle to DDF returned by DdfInitialize. 
  14865.  
  14866.  pszFaceName (PCSZ) - input 
  14867.     Pointer to font name. 
  14868.  
  14869.     This parameter can be specified in two ways: 
  14870.  
  14871.         An ASCIIZ string specifying the font name. 
  14872.         NULL or "default" to specify the default font. 
  14873.  
  14874.  ulWidth (ULONG) - input 
  14875.     Font width in points. 
  14876.  
  14877.     A point is approximately 1/72 of an inch. 
  14878.  
  14879.  ulHeight (ULONG) - input 
  14880.     Font height in points. 
  14881.  
  14882.  rc (BOOL) - returns 
  14883.     Success indicator. 
  14884.  
  14885.     TRUE 
  14886.             Successful completion 
  14887.     FALSE 
  14888.             Error occurred. 
  14889.  
  14890.  
  14891. ΓòÉΓòÉΓòÉ <hidden> DdfSetFont - Errors ΓòÉΓòÉΓòÉ
  14892.  
  14893. Possible returns from WinGetLastError 
  14894.  
  14895.  HMERR_DDF_MEMORY (0x3001) 
  14896.     Not enough memory is available. 
  14897.  
  14898.  
  14899. ΓòÉΓòÉΓòÉ <hidden> DdfSetFont - Related Functions ΓòÉΓòÉΓòÉ
  14900.  
  14901.      DdfBeginList 
  14902.      DdfBitmap 
  14903.      DdfEndList 
  14904.      DdfHyperText 
  14905.      DdfInform 
  14906.      DdfInitialize 
  14907.      DdfListItem 
  14908.      DdfMetafile 
  14909.      DdfPara 
  14910.      DdfSetColor 
  14911.      DdfSetFont 
  14912.      DdfSetFontStyle 
  14913.      DdfSetFormat 
  14914.      DdfSetTextAlign 
  14915.      DdfText 
  14916.  
  14917.  
  14918. ΓòÉΓòÉΓòÉ <hidden> DdfSetFont - Example Code ΓòÉΓòÉΓòÉ
  14919.  
  14920. After initializing a DDF buffer with DdfInitialize, the example uses DdfPara to 
  14921. start a new paragraph, DdfSetFont and DdfSetFontStyle to have the text 
  14922. displayed in a large, bold Courier font, DdfSetColor to change the text color, 
  14923. and DdfText to place text in the buffer.  For a more detailed example and 
  14924. discussion of initializing DDF, see the DdfInitialize sample. 
  14925.  
  14926. #define INCL_WINWINDOWMGR       /* General window management    */
  14927. #define INCL_WINMESSAGEMGR      /* Message management           */
  14928. #define INCL_DDF                /* Dynamic Data Facility        */
  14929. #include <os2.h>
  14930. #include <pmhelp.h>
  14931.  
  14932. MRESULT WindowProc( HWND hwnd, ULONG ulMsg, MPARAM mp1, MPARAM mp2 )
  14933. {
  14934.    HWND   hwndParent;
  14935.    HWND   hwndInstance;    /* help instance window                 */
  14936.    HDDF   hDdf;            /* DDF handle                           */
  14937.  
  14938.     switch( ulMsg )
  14939.     {
  14940.     case HM_QUERY_DDF_DATA:
  14941.         /* get the help instance */
  14942.         hwndParent = WinQueryWindow( hwnd, QW_PARENT );
  14943.         hwndParent = WinQueryWindow( hwndParent, QW_PARENT );
  14944.         hwndInstance = (HWND)WinSendMsg( hwndParent, HM_QUERY,
  14945.                                  MPFROMSHORT( HMQW_INSTANCE ), NULL );
  14946.  
  14947.         /* Allocate 1K Buffer (default)  */
  14948.         hDdf = DdfInitialize(
  14949.                     hwndInstance,  /* Handle of help instance */
  14950.                     0L,            /* Default buffer size     */
  14951.                     0L             /* Default increment       */
  14952.                     );
  14953.  
  14954.         if (hDdf == NULLHANDLE)       /* Check return code       */
  14955.         {
  14956.             return (MRESULT)FALSE;
  14957.         }
  14958.  
  14959.         /* create paragraph in DDF buffer */
  14960.         if( !DdfPara( hDdf ) )
  14961.         {
  14962.            return (MRESULT)FALSE;
  14963.         }
  14964.  
  14965.         /* Change to large (100 x 100 dimensions) Courier font */
  14966.         if( !DdfSetFont( hDdf, "Courier", 100L, 100L ) )
  14967.         {
  14968.            return (MRESULT)FALSE;
  14969.         }
  14970.  
  14971.         /* make the font BOLDFACE */
  14972.         if( !DdfSetFontStyle( hDdf, FM_SEL_BOLD ) )
  14973.         {
  14974.            return (MRESULT)FALSE;
  14975.         }
  14976.  
  14977.         /* make the text display as BLUE on a PALE GRAY background */
  14978.         if( !DdfSetColor( hDdf, CLR_PALEGRAY, CLR_BLUE ) )
  14979.         {
  14980.            return (MRESULT)FALSE;
  14981.         }
  14982.  
  14983.         /* Write data into the buffer */
  14984.         if (!DdfText(hDdf, "Sample Text"))
  14985.         {
  14986.            return (MRESULT)FALSE;
  14987.         }
  14988.  
  14989.         return (MRESULT)hDdf;
  14990.     }
  14991.     return WinDefWindowProc( hwnd, ulMsg, mp1, mp2 );
  14992. }
  14993.  
  14994.  
  14995. ΓòÉΓòÉΓòÉ <hidden> DdfSetFont - Topics ΓòÉΓòÉΓòÉ
  14996.  
  14997. Select an item: 
  14998.  
  14999. Syntax
  15000. Parameters
  15001. Returns
  15002. Errors
  15003. Example Code
  15004. Related Functions
  15005. Glossary
  15006.  
  15007.  
  15008. ΓòÉΓòÉΓòÉ 18.12. DdfSetFontStyle ΓòÉΓòÉΓòÉ
  15009.  
  15010.  
  15011. ΓòÉΓòÉΓòÉ <hidden> DdfSetFontStyle - Syntax ΓòÉΓòÉΓòÉ
  15012.  
  15013. This function specifies a text font style in the DDF buffer. 
  15014.  
  15015.  
  15016. #define INCL_DDF
  15017. #include <os2.h>
  15018.  
  15019. HDDF     hddf;        /*  Handle to DDF returned by DdfInitialize. */
  15020. ULONG    fFontStyle;  /*  Font style flag. */
  15021. BOOL     rc;          /*  Success indicator. */
  15022.  
  15023. rc = DdfSetFontStyle(hddf, fFontStyle);
  15024.  
  15025.  
  15026. ΓòÉΓòÉΓòÉ <hidden> DdfSetFontStyle Parameter - hddf ΓòÉΓòÉΓòÉ
  15027.  
  15028.  hddf (HDDF) - input 
  15029.     Handle to DDF returned by DdfInitialize. 
  15030.  
  15031.  
  15032. ΓòÉΓòÉΓòÉ <hidden> DdfSetFontStyle Parameter - fFontStyle ΓòÉΓòÉΓòÉ
  15033.  
  15034.  fFontStyle (ULONG) - input 
  15035.     Font style flag. 
  15036.  
  15037.     A NULL value for this parameter will set the font-style back to the 
  15038.     default. Any of the following values can be specified: 
  15039.  
  15040.          FM_SEL_ITALIC 
  15041.          FM_SEL_BOLD 
  15042.          FM_SEL_UNDERSCORE 
  15043.  
  15044.     These values can be "ORed" together to combine different font styles. 
  15045.  
  15046.     Note:  There is a 4-byte ESC code overhead in the DDF internal buffer for 
  15047.     fFontStyle. 
  15048.  
  15049.  
  15050. ΓòÉΓòÉΓòÉ <hidden> DdfSetFontStyle Return Value - rc ΓòÉΓòÉΓòÉ
  15051.  
  15052.  rc (BOOL) - returns 
  15053.     Success indicator. 
  15054.  
  15055.     TRUE 
  15056.             Successful completion. 
  15057.     FALSE 
  15058.             Error occurred. 
  15059.  
  15060.  
  15061. ΓòÉΓòÉΓòÉ <hidden> DdfSetFontStyle - Parameters ΓòÉΓòÉΓòÉ
  15062.  
  15063.  hddf (HDDF) - input 
  15064.     Handle to DDF returned by DdfInitialize. 
  15065.  
  15066.  fFontStyle (ULONG) - input 
  15067.     Font style flag. 
  15068.  
  15069.     A NULL value for this parameter will set the font-style back to the 
  15070.     default. Any of the following values can be specified: 
  15071.  
  15072.          FM_SEL_ITALIC 
  15073.          FM_SEL_BOLD 
  15074.          FM_SEL_UNDERSCORE 
  15075.  
  15076.     These values can be "ORed" together to combine different font styles. 
  15077.  
  15078.     Note:  There is a 4-byte ESC code overhead in the DDF internal buffer for 
  15079.     fFontStyle. 
  15080.  
  15081.  rc (BOOL) - returns 
  15082.     Success indicator. 
  15083.  
  15084.     TRUE 
  15085.             Successful completion. 
  15086.     FALSE 
  15087.             Error occurred. 
  15088.  
  15089.  
  15090. ΓòÉΓòÉΓòÉ <hidden> DdfSetFontStyle - Errors ΓòÉΓòÉΓòÉ
  15091.  
  15092. Possible returns from WinGetLastError 
  15093.  
  15094.  HMERR_DDF_MEMORY (0x3001) 
  15095.     Not enough memory is available. 
  15096.  
  15097.  HMERR_DDF_FONTSTYLE (0x3005) 
  15098.     The font style is not valid. 
  15099.  
  15100.  
  15101. ΓòÉΓòÉΓòÉ <hidden> DdfSetFontStyle - Related Functions ΓòÉΓòÉΓòÉ
  15102.  
  15103.      DdfBeginList 
  15104.      DdfBitmap 
  15105.      DdfEndList 
  15106.      DdfHyperText 
  15107.      DdfInform 
  15108.      DdfInitialize 
  15109.      DdfListItem 
  15110.      DdfMetafile 
  15111.      DdfPara 
  15112.      DdfSetColor 
  15113.      DdfSetFont 
  15114.      DdfSetFontStyle 
  15115.      DdfSetFormat 
  15116.      DdfSetTextAlign 
  15117.      DdfText 
  15118.  
  15119.  
  15120. ΓòÉΓòÉΓòÉ <hidden> DdfSetFontStyle - Example Code ΓòÉΓòÉΓòÉ
  15121.  
  15122. After initializing a DDF buffer with DdfInitialize, the example uses DdfPara to 
  15123. start a new paragraph, DdfSetFont and DdfSetFontStyle to have the text 
  15124. displayed in a large, bold Courier font, DdfSetColor to change the text color, 
  15125. and DdfText to place text in the buffer.  For a more detailed example and 
  15126. discussion of initializing DDF, see the DdfInitialize sample. 
  15127.  
  15128. #define INCL_WINWINDOWMGR       /* General window management    */
  15129. #define INCL_WINMESSAGEMGR      /* Message management           */
  15130. #define INCL_DDF                /* Dynamic Data Facility        */
  15131. #include <os2.h>
  15132. #include <pmhelp.h>
  15133.  
  15134. MRESULT WindowProc( HWND hwnd, ULONG ulMsg, MPARAM mp1, MPARAM mp2 )
  15135. {
  15136.    HWND   hwndParent;
  15137.    HWND   hwndInstance;    /* help instance window                 */
  15138.    HDDF   hDdf;            /* DDF handle                           */
  15139.  
  15140.     switch( ulMsg )
  15141.     {
  15142.     case HM_QUERY_DDF_DATA:
  15143.         /* get the help instance */
  15144.         hwndParent = WinQueryWindow( hwnd, QW_PARENT );
  15145.         hwndParent = WinQueryWindow( hwndParent, QW_PARENT );
  15146.         hwndInstance = (HWND)WinSendMsg( hwndParent, HM_QUERY,
  15147.                                  MPFROMSHORT( HMQW_INSTANCE ), NULL );
  15148.  
  15149.         /* Allocate 1K Buffer (default)  */
  15150.         hDdf = DdfInitialize(
  15151.                     hwndInstance,  /* Handle of help instance */
  15152.                     0L,            /* Default buffer size     */
  15153.                     0L             /* Default increment       */
  15154.                     );
  15155.  
  15156.         if (hDdf == NULLHANDLE)       /* Check return code       */
  15157.         {
  15158.             return (MRESULT)FALSE;
  15159.         }
  15160.  
  15161.         /* create paragraph in DDF buffer */
  15162.         if( !DdfPara( hDdf ) )
  15163.         {
  15164.            return (MRESULT)FALSE;
  15165.         }
  15166.  
  15167.         /* Change to large (100 x 100 dimensions) Courier font */
  15168.         if( !DdfSetFont( hDdf, "Courier", 100L, 100L ) )
  15169.         {
  15170.            return (MRESULT)FALSE;
  15171.         }
  15172.  
  15173.         /* make the font BOLDFACE */
  15174.         if( !DdfSetFontStyle( hDdf, FM_SEL_BOLD ) )
  15175.         {
  15176.            return (MRESULT)FALSE;
  15177.         }
  15178.  
  15179.         /* make the text display as BLUE on a PALE GRAY background */
  15180.         if( !DdfSetColor( hDdf, CLR_PALEGRAY, CLR_BLUE ) )
  15181.         {
  15182.            return (MRESULT)FALSE;
  15183.         }
  15184.  
  15185.         /* Write data into the buffer */
  15186.         if (!DdfText(hDdf, "Sample Text"))
  15187.         {
  15188.            return (MRESULT)FALSE;
  15189.         }
  15190.  
  15191.         return (MRESULT)hDdf;
  15192.     }
  15193.     return WinDefWindowProc( hwnd, ulMsg, mp1, mp2 );
  15194. }
  15195.  
  15196.  
  15197. ΓòÉΓòÉΓòÉ <hidden> DdfSetFontStyle - Topics ΓòÉΓòÉΓòÉ
  15198.  
  15199. Select an item: 
  15200.  
  15201. Syntax
  15202. Parameters
  15203. Returns
  15204. Errors
  15205. Example Code
  15206. Related Functions
  15207. Glossary
  15208.  
  15209.  
  15210. ΓòÉΓòÉΓòÉ 18.13. DdfSetFormat ΓòÉΓòÉΓòÉ
  15211.  
  15212.  
  15213. ΓòÉΓòÉΓòÉ <hidden> DdfSetFormat - Syntax ΓòÉΓòÉΓòÉ
  15214.  
  15215. This function is used to turn formatting off or on. It corresponds to the 
  15216. :lines. tag. 
  15217.  
  15218.  
  15219. #define INCL_DDF
  15220. #include <os2.h>
  15221.  
  15222. HDDF     hddf;         /*  Handle to DDF returned by DdfInitialize. */
  15223. ULONG    fFormatType;  /*  Formatting-activation flag. */
  15224. BOOL     rc;           /*  Success indicator. */
  15225.  
  15226. rc = DdfSetFormat(hddf, fFormatType);
  15227.  
  15228.  
  15229. ΓòÉΓòÉΓòÉ <hidden> DdfSetFormat Parameter - hddf ΓòÉΓòÉΓòÉ
  15230.  
  15231.  hddf (HDDF) - input 
  15232.     Handle to DDF returned by DdfInitialize. 
  15233.  
  15234.  
  15235. ΓòÉΓòÉΓòÉ <hidden> DdfSetFormat Parameter - fFormatType ΓòÉΓòÉΓòÉ
  15236.  
  15237.  fFormatType (ULONG) - input 
  15238.     Formatting-activation flag. 
  15239.  
  15240.     Only the following constants may be used in this parameter: 
  15241.  
  15242.     TRUE 
  15243.             Turn formatting on. 
  15244.     FALSE 
  15245.             Turn formatting off. 
  15246.  
  15247.  
  15248. ΓòÉΓòÉΓòÉ <hidden> DdfSetFormat Return Value - rc ΓòÉΓòÉΓòÉ
  15249.  
  15250.  rc (BOOL) - returns 
  15251.     Success indicator. 
  15252.  
  15253.     TRUE 
  15254.             Successful completion 
  15255.     FALSE 
  15256.             Error occurred. 
  15257.  
  15258.  
  15259. ΓòÉΓòÉΓòÉ <hidden> DdfSetFormat - Parameters ΓòÉΓòÉΓòÉ
  15260.  
  15261.  hddf (HDDF) - input 
  15262.     Handle to DDF returned by DdfInitialize. 
  15263.  
  15264.  fFormatType (ULONG) - input 
  15265.     Formatting-activation flag. 
  15266.  
  15267.     Only the following constants may be used in this parameter: 
  15268.  
  15269.     TRUE 
  15270.             Turn formatting on. 
  15271.     FALSE 
  15272.             Turn formatting off. 
  15273.  
  15274.  rc (BOOL) - returns 
  15275.     Success indicator. 
  15276.  
  15277.     TRUE 
  15278.             Successful completion 
  15279.     FALSE 
  15280.             Error occurred. 
  15281.  
  15282.  
  15283. ΓòÉΓòÉΓòÉ <hidden> DdfSetFormat - Remarks ΓòÉΓòÉΓòÉ
  15284.  
  15285. If formatting is ON, there is a 3-byte ESC code overhead in the DDF internal 
  15286. buffer for this function. Otherwise, there is a 4-byte ESC code overhead. 
  15287.  
  15288.  
  15289. ΓòÉΓòÉΓòÉ <hidden> DdfSetFormat - Errors ΓòÉΓòÉΓòÉ
  15290.  
  15291. Possible returns from WinGetLastError 
  15292.  
  15293.  HMERR_DDF_MEMORY (0x3001) 
  15294.     Not enough memory is available. 
  15295.  
  15296.  
  15297. ΓòÉΓòÉΓòÉ <hidden> DdfSetFormat - Related Functions ΓòÉΓòÉΓòÉ
  15298.  
  15299.      DdfBeginList 
  15300.      DdfBitmap 
  15301.      DdfEndList 
  15302.      DdfHyperText 
  15303.      DdfInform 
  15304.      DdfInitialize 
  15305.      DdfListItem 
  15306.      DdfMetafile 
  15307.      DdfPara 
  15308.      DdfSetColor 
  15309.      DdfSetFont 
  15310.      DdfSetFontStyle 
  15311.      DdfSetFormat 
  15312.      DdfSetTextAlign 
  15313.      DdfText 
  15314.  
  15315.  
  15316. ΓòÉΓòÉΓòÉ <hidden> DdfSetFormat - Example Code ΓòÉΓòÉΓòÉ
  15317.  
  15318. After initializing a DDF buffer with DdfInitialize, the example uses 
  15319. DdfSetTextAlign to specify left justified test in the DDF buffer when 
  15320. formatting is OFF. The example then uses DdfSetFormat to turn off formatting 
  15321. for text in the DDF buffer (corresponds to the IPF lines tag). For a more 
  15322. detailed example and discussion of initializing DDF, see the DdfInitialize 
  15323. sample. 
  15324.  
  15325. #define INCL_WINWINDOWMGR       /* General window management    */
  15326. #define INCL_WINMESSAGEMGR      /* Message management           */
  15327. #define INCL_GPIPRIMITIVES      /* Drawing Primitives/Attributes*/
  15328. #define INCL_DDF                /* Dynamic Data Facility        */
  15329. #include <os2.h>
  15330. #include <pmhelp.h>
  15331.  
  15332. MRESULT WindowProc( HWND hwnd, ULONG ulMsg, MPARAM mp1, MPARAM mp2 )
  15333. {
  15334.    HWND   hwndParent;
  15335.    HWND   hwndInstance;    /* help instance window                 */
  15336.    HDDF   hDdf;            /* DDF handle                           */
  15337.  
  15338.     switch( ulMsg )
  15339.     {
  15340.     case HM_QUERY_DDF_DATA:
  15341.         /* get the help instance */
  15342.         hwndParent = WinQueryWindow( hwnd, QW_PARENT );
  15343.         hwndParent = WinQueryWindow( hwndParent, QW_PARENT );
  15344.         hwndInstance = (HWND)WinSendMsg( hwndParent, HM_QUERY,
  15345.                                  MPFROMSHORT( HMQW_INSTANCE ), NULL );
  15346.  
  15347.         /* Allocate 1K Buffer (default)  */
  15348.         hDdf = DdfInitialize(
  15349.                     hwndInstance,  /* Handle of help instance */
  15350.                     0L,            /* Default buffer size     */
  15351.                     0L             /* Default increment       */
  15352.                     );
  15353.  
  15354.         if (hDdf == NULLHANDLE)       /* Check return code       */
  15355.         {
  15356.            return (MRESULT)FALSE;
  15357.         }
  15358.  
  15359.         /* left justify text when formatting is OFF */
  15360.         if (!DdfSetTextAlign(hDdf, TA_LEFT))
  15361.         {
  15362.            return (MRESULT)FALSE;
  15363.         }
  15364.  
  15365.         /* turn formatting OFF */
  15366.         if (!DdfSetFormat(hDdf, FALSE))
  15367.         {
  15368.            return (MRESULT)FALSE;
  15369.         }
  15370.  
  15371.         if (!DdfText(hDdf,
  15372.                 "Format OFF: This text should be Left Aligned!\n"))
  15373.         {
  15374.            return (MRESULT)FALSE;
  15375.         }
  15376.  
  15377.         return (MRESULT)hDdf;
  15378.      }
  15379.      return WinDefWindowProc( hwnd, ulMsg, mp1, mp2 );
  15380. }
  15381.  
  15382.  
  15383. ΓòÉΓòÉΓòÉ <hidden> DdfSetFormat - Topics ΓòÉΓòÉΓòÉ
  15384.  
  15385. Select an item: 
  15386.  
  15387. Syntax
  15388. Parameters
  15389. Returns
  15390. Errors
  15391. Remarks
  15392. Example Code
  15393. Related Functions
  15394. Glossary
  15395.  
  15396.  
  15397. ΓòÉΓòÉΓòÉ 18.14. DdfSetTextAlign ΓòÉΓòÉΓòÉ
  15398.  
  15399.  
  15400. ΓòÉΓòÉΓòÉ <hidden> DdfSetTextAlign - Syntax ΓòÉΓòÉΓòÉ
  15401.  
  15402. This function defines whether left, center, or right text justification is to 
  15403. be used when text formatting is off. 
  15404.  
  15405.  
  15406. #define INCL_DDF
  15407. #include <os2.h>
  15408.  
  15409. HDDF     hddf;    /*  Handle to DDF returned by DdfInitialize. */
  15410. ULONG    fAlign;  /*  Justification flag. */
  15411. BOOL     rc;      /*  Success indicator. */
  15412.  
  15413. rc = DdfSetTextAlign(hddf, fAlign);
  15414.  
  15415.  
  15416. ΓòÉΓòÉΓòÉ <hidden> DdfSetTextAlign Parameter - hddf ΓòÉΓòÉΓòÉ
  15417.  
  15418.  hddf (HDDF) - input 
  15419.     Handle to DDF returned by DdfInitialize. 
  15420.  
  15421.  
  15422. ΓòÉΓòÉΓòÉ <hidden> DdfSetTextAlign Parameter - fAlign ΓòÉΓòÉΓòÉ
  15423.  
  15424.  fAlign (ULONG) - input 
  15425.     Justification flag. 
  15426.  
  15427.     Only the following constants may be used: 
  15428.  
  15429.     TA_LEFT 
  15430.             Left-justify text. 
  15431.     TA_RIGHT 
  15432.             Right-justify text. 
  15433.     TA_CENTER 
  15434.             Center text. 
  15435.  
  15436.  
  15437. ΓòÉΓòÉΓòÉ <hidden> DdfSetTextAlign Return Value - rc ΓòÉΓòÉΓòÉ
  15438.  
  15439.  rc (BOOL) - returns 
  15440.     Success indicator. 
  15441.  
  15442.     TRUE 
  15443.             Successful completion. 
  15444.     FALSE 
  15445.             Error occurred. 
  15446.  
  15447.  
  15448. ΓòÉΓòÉΓòÉ <hidden> DdfSetTextAlign - Parameters ΓòÉΓòÉΓòÉ
  15449.  
  15450.  hddf (HDDF) - input 
  15451.     Handle to DDF returned by DdfInitialize. 
  15452.  
  15453.  fAlign (ULONG) - input 
  15454.     Justification flag. 
  15455.  
  15456.     Only the following constants may be used: 
  15457.  
  15458.     TA_LEFT 
  15459.             Left-justify text. 
  15460.     TA_RIGHT 
  15461.             Right-justify text. 
  15462.     TA_CENTER 
  15463.             Center text. 
  15464.  
  15465.  rc (BOOL) - returns 
  15466.     Success indicator. 
  15467.  
  15468.     TRUE 
  15469.             Successful completion. 
  15470.     FALSE 
  15471.             Error occurred. 
  15472.  
  15473.  
  15474. ΓòÉΓòÉΓòÉ <hidden> DdfSetTextAlign - Remarks ΓòÉΓòÉΓòÉ
  15475.  
  15476. It should be called before DdfSetFormat is called to turn off text formatting, 
  15477. and should not be called again until formatting is turned back on. Note that 
  15478. leading and trailing spaces are not stripped from the text as a result of this 
  15479. alignment. 
  15480.  
  15481.  
  15482. ΓòÉΓòÉΓòÉ <hidden> DdfSetTextAlign - Errors ΓòÉΓòÉΓòÉ
  15483.  
  15484. Possible returns from WinGetLastError 
  15485.  
  15486.  HMERR_DDF_ALIGN_TYPE (0x3002) 
  15487.     The alignment type is not valid. 
  15488.  
  15489.  
  15490. ΓòÉΓòÉΓòÉ <hidden> DdfSetTextAlign - Related Functions ΓòÉΓòÉΓòÉ
  15491.  
  15492.      DdfBeginList 
  15493.      DdfBitmap 
  15494.      DdfEndList 
  15495.      DdfHyperText 
  15496.      DdfInform 
  15497.      DdfInitialize 
  15498.      DdfListItem 
  15499.      DdfMetafile 
  15500.      DdfPara 
  15501.      DdfSetColor 
  15502.      DdfSetFont 
  15503.      DdfSetFontStyle 
  15504.      DdfSetFormat 
  15505.      DdfSetTextAlign 
  15506.      DdfText 
  15507.  
  15508.  
  15509. ΓòÉΓòÉΓòÉ <hidden> DdfSetTextAlign - Example Code ΓòÉΓòÉΓòÉ
  15510.  
  15511. After initializing a DDF buffer with DdfInitialize, the example uses 
  15512. DdfSetTextAlign to specify left justified test in the DDF buffer when 
  15513. formatting is OFF. The example then uses DdfSetFormat to turn off formatting 
  15514. for text in the DDF buffer (corresponds to the IPF lines tag). For a more 
  15515. detailed example and discussion of initializing DDF, see the DdfInitialize 
  15516. sample. 
  15517.  
  15518. #define INCL_WINWINDOWMGR       /* General window management    */
  15519. #define INCL_WINMESSAGEMGR      /* Message management           */
  15520. #define INCL_GPIPRIMITIVES      /* Drawing Primitives/Attributes*/
  15521. #define INCL_DDF                /* Dynamic Data Facility        */
  15522. #include <os2.h>
  15523. #include <pmhelp.h>
  15524.  
  15525. MRESULT WindowProc( HWND hwnd, ULONG ulMsg, MPARAM mp1, MPARAM mp2 )
  15526. {
  15527.    HWND   hwndParent;
  15528.    HWND   hwndInstance;    /* help instance window                 */
  15529.    HDDF   hDdf;            /* DDF handle                           */
  15530.  
  15531.     switch( ulMsg )
  15532.     {
  15533.     case HM_QUERY_DDF_DATA:
  15534.         /* get the help instance */
  15535.         hwndParent = WinQueryWindow( hwnd, QW_PARENT );
  15536.         hwndParent = WinQueryWindow( hwndParent, QW_PARENT );
  15537.         hwndInstance = (HWND)WinSendMsg( hwndParent, HM_QUERY,
  15538.                                  MPFROMSHORT( HMQW_INSTANCE ), NULL );
  15539.  
  15540.         /* Allocate 1K Buffer (default)  */
  15541.         hDdf = DdfInitialize(
  15542.                     hwndInstance,  /* Handle of help instance */
  15543.                     0L,            /* Default buffer size     */
  15544.                     0L             /* Default increment       */
  15545.                     );
  15546.  
  15547.         if (hDdf == NULLHANDLE)       /* Check return code       */
  15548.         {
  15549.            return (MRESULT)FALSE;
  15550.         }
  15551.  
  15552.         /* left justify text when formatting is OFF */
  15553.         if (!DdfSetTextAlign(hDdf, TA_LEFT))
  15554.         {
  15555.            return (MRESULT)FALSE;
  15556.         }
  15557.  
  15558.         /* turn formatting OFF */
  15559.         if (!DdfSetFormat(hDdf, FALSE))
  15560.         {
  15561.            return (MRESULT)FALSE;
  15562.         }
  15563.  
  15564.         if (!DdfText(hDdf,
  15565.                 "Format OFF: This text should be Left Aligned!\n"))
  15566.         {
  15567.            return (MRESULT)FALSE;
  15568.         }
  15569.  
  15570.         return (MRESULT)hDdf;
  15571.      }
  15572.      return WinDefWindowProc( hwnd, ulMsg, mp1, mp2 );
  15573. }
  15574.  
  15575.  
  15576. ΓòÉΓòÉΓòÉ <hidden> DdfSetTextAlign - Topics ΓòÉΓòÉΓòÉ
  15577.  
  15578. Select an item: 
  15579.  
  15580. Syntax
  15581. Parameters
  15582. Returns
  15583. Errors
  15584. Remarks
  15585. Example Code
  15586. Related Functions
  15587. Glossary
  15588.  
  15589.  
  15590. ΓòÉΓòÉΓòÉ 18.15. DdfText ΓòÉΓòÉΓòÉ
  15591.  
  15592.  
  15593. ΓòÉΓòÉΓòÉ <hidden> DdfText - Syntax ΓòÉΓòÉΓòÉ
  15594.  
  15595. This function adds text to the DDF buffer. 
  15596.  
  15597.  
  15598. #define INCL_DDF
  15599. #include <os2.h>
  15600.  
  15601. HDDF    hddf;     /*  Handle to DDF returned by DdfInitialize. */
  15602. PCSZ    pszText;  /*  Pointer to the text buffer to be formatted. */
  15603. BOOL    rc;       /*  Success indicator. */
  15604.  
  15605. rc = DdfText(hddf, pszText);
  15606.  
  15607.  
  15608. ΓòÉΓòÉΓòÉ <hidden> DdfText Parameter - hddf ΓòÉΓòÉΓòÉ
  15609.  
  15610.  hddf (HDDF) - input 
  15611.     Handle to DDF returned by DdfInitialize. 
  15612.  
  15613.  
  15614. ΓòÉΓòÉΓòÉ <hidden> DdfText Parameter - pszText ΓòÉΓòÉΓòÉ
  15615.  
  15616.  pszText (PCSZ) - input 
  15617.     Pointer to the text buffer to be formatted. 
  15618.  
  15619.     Note:  There is a 3-byte ESC code overhead in the DDF internal buffer for 
  15620.            each word in the text buffer. There is a 1-byte ESC code overhead 
  15621.            for each blank and for each newline character. 
  15622.  
  15623.  
  15624. ΓòÉΓòÉΓòÉ <hidden> DdfText Return Value - rc ΓòÉΓòÉΓòÉ
  15625.  
  15626.  rc (BOOL) - returns 
  15627.     Success indicator. 
  15628.  
  15629.     TRUE 
  15630.             Successful completion. 
  15631.     FALSE 
  15632.             Error occurred. 
  15633.  
  15634.  
  15635. ΓòÉΓòÉΓòÉ <hidden> DdfText - Parameters ΓòÉΓòÉΓòÉ
  15636.  
  15637.  hddf (HDDF) - input 
  15638.     Handle to DDF returned by DdfInitialize. 
  15639.  
  15640.  pszText (PCSZ) - input 
  15641.     Pointer to the text buffer to be formatted. 
  15642.  
  15643.     Note:  There is a 3-byte ESC code overhead in the DDF internal buffer for 
  15644.            each word in the text buffer. There is a 1-byte ESC code overhead 
  15645.            for each blank and for each newline character. 
  15646.  
  15647.  rc (BOOL) - returns 
  15648.     Success indicator. 
  15649.  
  15650.     TRUE 
  15651.             Successful completion. 
  15652.     FALSE 
  15653.             Error occurred. 
  15654.  
  15655.  
  15656. ΓòÉΓòÉΓòÉ <hidden> DdfText - Related Functions ΓòÉΓòÉΓòÉ
  15657.  
  15658.      DdfBeginList 
  15659.      DdfBitmap 
  15660.      DdfEndList 
  15661.      DdfHyperText 
  15662.      DdfInform 
  15663.      DdfInitialize 
  15664.      DdfListItem 
  15665.      DdfMetafile 
  15666.      DdfPara 
  15667.      DdfSetColor 
  15668.      DdfSetFont 
  15669.      DdfSetFontStyle 
  15670.      DdfSetFormat 
  15671.      DdfSetTextAlign 
  15672.      DdfText 
  15673.  
  15674.  
  15675. ΓòÉΓòÉΓòÉ <hidden> DdfText - Example Code ΓòÉΓòÉΓòÉ
  15676.  
  15677. After initializing a DDF buffer with DdfInitialize, the example uses DdfPara to 
  15678. start a new paragraph, DdfSetFont and DdfSetFontStyle to have the text 
  15679. displayed in a large, bold Courier font, DdfSetColor to change the text color, 
  15680. and DdfText to place text in the buffer.  For a more detailed example and 
  15681. discussion of initializing DDF, see the DdfInitialize sample. 
  15682.  
  15683. #define INCL_WINWINDOWMGR       /* General window management    */
  15684. #define INCL_WINMESSAGEMGR      /* Message management           */
  15685. #define INCL_DDF                /* Dynamic Data Facility        */
  15686. #include <os2.h>
  15687. #include <pmhelp.h>
  15688.  
  15689. MRESULT WindowProc( HWND hwnd, ULONG ulMsg, MPARAM mp1, MPARAM mp2 )
  15690. {
  15691.    HWND   hwndParent;
  15692.    HWND   hwndInstance;    /* help instance window                 */
  15693.    HDDF   hDdf;            /* DDF handle                           */
  15694.  
  15695.     switch( ulMsg )
  15696.     {
  15697.     case HM_QUERY_DDF_DATA:
  15698.         /* get the help instance */
  15699.         hwndParent = WinQueryWindow( hwnd, QW_PARENT );
  15700.         hwndParent = WinQueryWindow( hwndParent, QW_PARENT );
  15701.         hwndInstance = (HWND)WinSendMsg( hwndParent, HM_QUERY,
  15702.                                  MPFROMSHORT( HMQW_INSTANCE ), NULL );
  15703.  
  15704.         /* Allocate 1K Buffer (default)  */
  15705.         hDdf = DdfInitialize(
  15706.                     hwndInstance,  /* Handle of help instance */
  15707.                     0L,            /* Default buffer size     */
  15708.                     0L             /* Default increment       */
  15709.                     );
  15710.  
  15711.         if (hDdf == NULLHANDLE)       /* Check return code       */
  15712.         {
  15713.             return (MRESULT)FALSE;
  15714.         }
  15715.  
  15716.         /* create paragraph in DDF buffer */
  15717.         if( !DdfPara( hDdf ) )
  15718.         {
  15719.            return (MRESULT)FALSE;
  15720.         }
  15721.  
  15722.         /* Change to large (100 x 100 dimensions) Courier font */
  15723.         if( !DdfSetFont( hDdf, "Courier", 100L, 100L ) )
  15724.         {
  15725.            return (MRESULT)FALSE;
  15726.         }
  15727.  
  15728.         /* make the font BOLDFACE */
  15729.         if( !DdfSetFontStyle( hDdf, FM_SEL_BOLD ) )
  15730.         {
  15731.            return (MRESULT)FALSE;
  15732.         }
  15733.  
  15734.         /* make the text display as BLUE on a PALE GRAY background */
  15735.         if( !DdfSetColor( hDdf, CLR_PALEGRAY, CLR_BLUE ) )
  15736.         {
  15737.            return (MRESULT)FALSE;
  15738.         }
  15739.  
  15740.         /* Write data into the buffer */
  15741.         if (!DdfText(hDdf, "Sample Text"))
  15742.         {
  15743.            return (MRESULT)FALSE;
  15744.         }
  15745.  
  15746.         return (MRESULT)hDdf;
  15747.     }
  15748.     return WinDefWindowProc( hwnd, ulMsg, mp1, mp2 );
  15749. }
  15750.  
  15751.  
  15752. ΓòÉΓòÉΓòÉ <hidden> DdfText - Topics ΓòÉΓòÉΓòÉ
  15753.  
  15754. Select an item: 
  15755.  
  15756. Syntax
  15757. Parameters
  15758. Returns
  15759. Example Code
  15760. Related Functions
  15761. Glossary
  15762.  
  15763.  
  15764. ΓòÉΓòÉΓòÉ 19. Help Manager Messages ΓòÉΓòÉΓòÉ
  15765.  
  15766. The following is a summary of the messages sent by IPF and the application in 
  15767. response to user help requests. 
  15768.  
  15769.  HM_ACTIONBAR_COMMAND 
  15770.      This message is sent by IPF and notifies the application that a user has 
  15771.      selected a tailored menu bar item. 
  15772.  
  15773.  HM_CONTROL 
  15774.      This message is sent to the application or the communication object by IPF 
  15775.      prior to the addition of a push button in the control area of a window. 
  15776.  
  15777.  HM_CREATE_HELP_TABLE 
  15778.      This message is sent by the application and informs IPF to use the new 
  15779.      help table indicated by this address in memory. 
  15780.  
  15781.  HM_DISMISS_WINDOW 
  15782.      This message is sent by the application and informs IPF to remove the 
  15783.      active help window. 
  15784.  
  15785.  HM_DISPLAY_HELP 
  15786.      This message is sent by the application and informs IPF to display a 
  15787.      specific help window. 
  15788.  
  15789.  HM_ERROR 
  15790.      This message notifies the application of an error caused by user 
  15791.      interaction. 
  15792.  
  15793.  HM_EXT_HELP 
  15794.      This message is sent by the application and informs IPF to display the 
  15795.      extended help window for the active application window. 
  15796.  
  15797.  HM_EXT_HELP_UNDEFINED 
  15798.      This message is sent by IPF and notifies the application that an extended 
  15799.      help window has not been defined. 
  15800.  
  15801.  HM_GENERAL_HELP 
  15802.      This message is sent by the application and informs IPF to display the 
  15803.      general help window for the active application window. 
  15804.  
  15805.  HM_GENERAL_HELP_UNDEFINED 
  15806.      This message is sent by IPF and notifies the application that a general 
  15807.      help window has not been defined. 
  15808.  
  15809.  HM_HELP_CONTENTS 
  15810.      This message is sent by the application and informs IPF to display the 
  15811.      Contents window. 
  15812.  
  15813.  HM_HELP_INDEX 
  15814.      This message is sent by the application and informs IPF to display the 
  15815.      help index window. 
  15816.  
  15817.  HM_HELPSUBITEM_NOT_FOUND 
  15818.      This message is sent by IPF and notifies the application that a user has 
  15819.      requested help on a field but that IPF cannot find a related entry in the 
  15820.      help subtable. 
  15821.  
  15822.  HM_INFORM 
  15823.      This message is sent by IPF and notifies the application that a user has 
  15824.      selected a hypertext field that was specified with the reftype=inform 
  15825.      attribute of the :link. tag. 
  15826.  
  15827.  HM_INVALIDATE_DDF_DATA 
  15828.      This message is sent by the application and informs IPF that previous 
  15829.      dynamic data formatting (DDF) information is no longer valid. 
  15830.  
  15831.  HM_KEYS_HELP 
  15832.      This message is sent by the application and informs IPF to display the 
  15833.      keys help window. 
  15834.  
  15835.  HM_LOAD_HELP_TABLE 
  15836.      This message is sent by the application and provides IPF with the module 
  15837.      handle that contains the help table, the help subtable, and the identity 
  15838.      of the help table. 
  15839.  
  15840.  HM_NOTIFY 
  15841.      This message is sent by IPF and notifies the application or communication 
  15842.      object that an event has occurred that the application may be interested 
  15843.      in controlling. 
  15844.  
  15845.  HM_QUERY 
  15846.      This message is sent by the application and notifies IPF that the 
  15847.      application requires IPF-specific information. 
  15848.  
  15849.  HM_QUERY_DDF_DATA 
  15850.      This message is sent by IPF and notifies the communication object that IPF 
  15851.      has encountered the dynamic data formatting tag (:ddf.). 
  15852.  
  15853.  HM_QUERY_KEYS_HELP 
  15854.      This message is sent by IPF and notifies the application that a user has 
  15855.      requested keys help for a function. 
  15856.  
  15857.  HM_REPLACE_HELP_FOR_HELP 
  15858.      This message is sent by the application and informs IPF to display the 
  15859.      application-defined Help for Help window instead of the IPF Help for Help 
  15860.      window. 
  15861.  
  15862.  HM_REPLACE_USING_HELP 
  15863.      This message is sent by the application and informs IPF to display the 
  15864.      application-defined Using help window instead of the IPF Using help 
  15865.      window. 
  15866.  
  15867.  HM_SET_ACTIVE_WINDOW 
  15868.      This message is sent by the application and enables the application to 
  15869.      change the active application window with which the IPF help window is 
  15870.      associated. 
  15871.  
  15872.  HM_SET_COVERPAGE_SIZE 
  15873.      This message is sent by the application and informs IPF to set the size of 
  15874.      the coverpage window (the window within which all other IPF windows are 
  15875.      displayed). 
  15876.  
  15877.  HM_SET_HELP_LIBRARY_NAME 
  15878.      This message is sent by the application and informs IPF to replace the 
  15879.      list of help libraries specified in the initialization structure with a 
  15880.      new list. 
  15881.  
  15882.  HM_SET_HELP_WINDOW_TITLE 
  15883.      This message is sent by the application and informs IPF to change the text 
  15884.      of a help window title. 
  15885.  
  15886.  HM_SET_OBJCOM_WINDOW 
  15887.      This message is sent by the application and informs IPF to identify the 
  15888.      communication object to which the HM_INFORM and HM_QUERY_DDF_DATA messages 
  15889.      are sent. 
  15890.  
  15891.  HM_SET_SHOW_PANEL_ID 
  15892.      This message is sent by the application and informs IPF to display or hide 
  15893.      window IDs for each help window. 
  15894.  
  15895.  HM_SET_USERDATA 
  15896.      This message is sent by the application and informs IPF to store data in 
  15897.      the IPF data area. 
  15898.  
  15899.  HM_TUTORIAL 
  15900.      This message is sent by IPF and notifies the application when the user 
  15901.      selects Tutorial choice from the Help menu bar. 
  15902.  
  15903.  HM_UPDATE_OBJCOM_WINDOW_CHAIN 
  15904.      This message is sent to the currently active communication object by the 
  15905.      communication object who wants to withdraw from the communication chain. 
  15906.  
  15907.  A detailed description of the parameters and returns for these messages 
  15908.  follows. 
  15909.  
  15910.  
  15911. ΓòÉΓòÉΓòÉ 19.1. HM_ACTIONBAR_COMMAND ΓòÉΓòÉΓòÉ
  15912.  
  15913.  
  15914. ΓòÉΓòÉΓòÉ <hidden> HM_ACTIONBAR_COMMAND - Syntax ΓòÉΓòÉΓòÉ
  15915.  
  15916. This message is sent to the current active application window by the Help 
  15917. Manager to notify the application when the user selects a tailored action bar 
  15918. item. 
  15919.  
  15920.  
  15921. param1
  15922.     USHORT  idCommand   /*  Identity of the action bar item that was selected. */
  15923.  
  15924. param2
  15925.     ULONG   ulReserved  /*  Reserved value, should be 0. */
  15926.  
  15927. returns
  15928.     ULONG   ulReserved  /*  Reserved value, should be 0. */
  15929.  
  15930.  
  15931. ΓòÉΓòÉΓòÉ <hidden> HM_ACTIONBAR_COMMAND Field - idCommand ΓòÉΓòÉΓòÉ
  15932.  
  15933.  idCommand (USHORT) 
  15934.     Identity of the action bar item that was selected. 
  15935.  
  15936.  
  15937. ΓòÉΓòÉΓòÉ <hidden> HM_ACTIONBAR_COMMAND Field - ulReserved ΓòÉΓòÉΓòÉ
  15938.  
  15939.  ulReserved (ULONG) 
  15940.     Reserved value, should be 0. 
  15941.  
  15942.  
  15943. ΓòÉΓòÉΓòÉ <hidden> HM_ACTIONBAR_COMMAND Return Value - ulReserved ΓòÉΓòÉΓòÉ
  15944.  
  15945.  ulReserved (ULONG) 
  15946.     Reserved value, should be 0. 
  15947.  
  15948.  
  15949. ΓòÉΓòÉΓòÉ <hidden> HM_ACTIONBAR_COMMAND - Parameters ΓòÉΓòÉΓòÉ
  15950.  
  15951.  idCommand (USHORT) 
  15952.     Identity of the action bar item that was selected. 
  15953.  
  15954.  ulReserved (ULONG) 
  15955.     Reserved value, should be 0. 
  15956.  
  15957.  ulReserved (ULONG) 
  15958.     Reserved value, should be 0. 
  15959.  
  15960.  
  15961. ΓòÉΓòÉΓòÉ <hidden> HM_ACTIONBAR_COMMAND - Default Processing ΓòÉΓòÉΓòÉ
  15962.  
  15963. None. 
  15964.  
  15965.  
  15966. ΓòÉΓòÉΓòÉ <hidden> HM_ACTIONBAR_COMMAND - Topics ΓòÉΓòÉΓòÉ
  15967.  
  15968. Select an item: 
  15969.  
  15970. Syntax
  15971. Parameters
  15972. Returns
  15973. Default Processing
  15974. Glossary
  15975.  
  15976.  
  15977. ΓòÉΓòÉΓòÉ 19.2. HM_CONTROL ΓòÉΓòÉΓòÉ
  15978.  
  15979.  
  15980. ΓòÉΓòÉΓòÉ <hidden> HM_CONTROL - Syntax ΓòÉΓòÉΓòÉ
  15981.  
  15982. This message is sent by the Help Manager to the child of the coverpage window 
  15983. to add a control in the control area of a window. 
  15984.  
  15985.  
  15986. param1
  15987.     USHORT  usReserve   /*  Reserved value. */
  15988.     USHORT  controlres  /*  Res number of the control that was selected. */
  15989.  
  15990. param2
  15991.     ULONG   ulReserved  /*  Reserved value. */
  15992.  
  15993. returns
  15994.     ULONG   ulReserved  /*  Reserved value, should be 0. */
  15995.  
  15996.  
  15997. ΓòÉΓòÉΓòÉ <hidden> HM_CONTROL Field - usReserve ΓòÉΓòÉΓòÉ
  15998.  
  15999.  usReserve (USHORT) 
  16000.     Reserved value. 
  16001.  
  16002.  
  16003. ΓòÉΓòÉΓòÉ <hidden> HM_CONTROL Field - controlres ΓòÉΓòÉΓòÉ
  16004.  
  16005.  controlres (USHORT) 
  16006.     Res number of the control that was selected. 
  16007.  
  16008.     For author-defined push buttons, this is the res identification number that 
  16009.     was specified with the push button tag (:pbutton.).  For default push 
  16010.     buttons, this is the res identification number defined in the PMHELP.H 
  16011.     file. 
  16012.  
  16013.  
  16014. ΓòÉΓòÉΓòÉ <hidden> HM_CONTROL Field - ulReserved ΓòÉΓòÉΓòÉ
  16015.  
  16016.  ulReserved (ULONG) 
  16017.     Reserved value. 
  16018.  
  16019.  
  16020. ΓòÉΓòÉΓòÉ <hidden> HM_CONTROL Return Value - ulReserved ΓòÉΓòÉΓòÉ
  16021.  
  16022.  ulReserved (ULONG) 
  16023.     Reserved value, should be 0. 
  16024.  
  16025.  
  16026. ΓòÉΓòÉΓòÉ <hidden> HM_CONTROL - Parameters ΓòÉΓòÉΓòÉ
  16027.  
  16028.  usReserve (USHORT) 
  16029.     Reserved value. 
  16030.  
  16031.  controlres (USHORT) 
  16032.     Res number of the control that was selected. 
  16033.  
  16034.     For author-defined push buttons, this is the res identification number that 
  16035.     was specified with the push button tag (:pbutton.).  For default push 
  16036.     buttons, this is the res identification number defined in the PMHELP.H 
  16037.     file. 
  16038.  
  16039.  ulReserved (ULONG) 
  16040.     Reserved value. 
  16041.  
  16042.  ulReserved (ULONG) 
  16043.     Reserved value, should be 0. 
  16044.  
  16045.  
  16046. ΓòÉΓòÉΓòÉ <hidden> HM_CONTROL - Remarks ΓòÉΓòÉΓòÉ
  16047.  
  16048. If an application wants to filter any of the controls, it can subclass the 
  16049. child of the coverpage window and intercept this message.  If the application 
  16050. does not intercept this message, the Help Manager adds the control to the 
  16051. control area. 
  16052.  
  16053.  
  16054. ΓòÉΓòÉΓòÉ <hidden> HM_CONTROL - Default Processing ΓòÉΓòÉΓòÉ
  16055.  
  16056. None. 
  16057.  
  16058.  
  16059. ΓòÉΓòÉΓòÉ <hidden> HM_CONTROL - Topics ΓòÉΓòÉΓòÉ
  16060.  
  16061. Select an item: 
  16062.  
  16063. Syntax
  16064. Parameters
  16065. Returns
  16066. Remarks
  16067. Default Processing
  16068. Glossary
  16069.  
  16070.  
  16071. ΓòÉΓòÉΓòÉ 19.3. HM_CREATE_HELP_TABLE ΓòÉΓòÉΓòÉ
  16072.  
  16073.  
  16074. ΓòÉΓòÉΓòÉ <hidden> HM_CREATE_HELP_TABLE - Syntax ΓòÉΓòÉΓòÉ
  16075.  
  16076. This message is sent by the application to give the Help Manager a new help 
  16077. table. 
  16078.  
  16079.  
  16080. param1
  16081.     PHELPTABLE  pHELPTABLE  /*  Help table. */
  16082.  
  16083. param2
  16084.     ULONG       ulReserved  /*  Reserved value, should be 0. */
  16085.  
  16086. returns
  16087.     ULONG       rc          /*  Return code. */
  16088.  
  16089.  
  16090. ΓòÉΓòÉΓòÉ <hidden> HM_CREATE_HELP_TABLE Field - pHELPTABLE ΓòÉΓòÉΓòÉ
  16091.  
  16092.  pHELPTABLE (PHELPTABLE) 
  16093.     Help table. 
  16094.  
  16095.     This points to a help table structure; see HELPTABLE. 
  16096.  
  16097.  
  16098. ΓòÉΓòÉΓòÉ <hidden> HM_CREATE_HELP_TABLE Field - ulReserved ΓòÉΓòÉΓòÉ
  16099.  
  16100.  ulReserved (ULONG) 
  16101.     Reserved value, should be 0. 
  16102.  
  16103.  
  16104. ΓòÉΓòÉΓòÉ <hidden> HM_CREATE_HELP_TABLE Return Value - rc ΓòÉΓòÉΓòÉ
  16105.  
  16106.  rc (ULONG) 
  16107.     Return code. 
  16108.  
  16109.     0 
  16110.             The procedure was successfully completed 
  16111.     Other 
  16112.             See the values of the ulErrorCode parameter of the HM_ERROR 
  16113.             message. 
  16114.  
  16115.  
  16116. ΓòÉΓòÉΓòÉ <hidden> HM_CREATE_HELP_TABLE - Parameters ΓòÉΓòÉΓòÉ
  16117.  
  16118.  pHELPTABLE (PHELPTABLE) 
  16119.     Help table. 
  16120.  
  16121.     This points to a help table structure; see HELPTABLE. 
  16122.  
  16123.  ulReserved (ULONG) 
  16124.     Reserved value, should be 0. 
  16125.  
  16126.  rc (ULONG) 
  16127.     Return code. 
  16128.  
  16129.     0 
  16130.             The procedure was successfully completed 
  16131.     Other 
  16132.             See the values of the ulErrorCode parameter of the HM_ERROR 
  16133.             message. 
  16134.  
  16135.  
  16136. ΓòÉΓòÉΓòÉ <hidden> HM_CREATE_HELP_TABLE - Default Processing ΓòÉΓòÉΓòÉ
  16137.  
  16138. None. 
  16139.  
  16140.  
  16141. ΓòÉΓòÉΓòÉ <hidden> HM_CREATE_HELP_TABLE - Topics ΓòÉΓòÉΓòÉ
  16142.  
  16143. Select an item: 
  16144.  
  16145. Syntax
  16146. Parameters
  16147. Returns
  16148. Default Processing
  16149. Glossary
  16150.  
  16151.  
  16152. ΓòÉΓòÉΓòÉ 19.4. HM_DISMISS_WINDOW ΓòÉΓòÉΓòÉ
  16153.  
  16154.  
  16155. ΓòÉΓòÉΓòÉ <hidden> HM_DISMISS_WINDOW - Syntax ΓòÉΓòÉΓòÉ
  16156.  
  16157. This message tells the Help Manager to remove the active help window. 
  16158.  
  16159.  
  16160. param1
  16161.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  16162.  
  16163. param2
  16164.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  16165.  
  16166. returns
  16167.     ULONG  rc          /*  Return code. */
  16168.  
  16169.  
  16170. ΓòÉΓòÉΓòÉ <hidden> HM_DISMISS_WINDOW Field - ulReserved ΓòÉΓòÉΓòÉ
  16171.  
  16172.  ulReserved (ULONG) 
  16173.     Reserved value, should be 0. 
  16174.  
  16175.  
  16176. ΓòÉΓòÉΓòÉ <hidden> HM_DISMISS_WINDOW Field - ulReserved ΓòÉΓòÉΓòÉ
  16177.  
  16178.  ulReserved (ULONG) 
  16179.     Reserved value, should be 0. 
  16180.  
  16181.  
  16182. ΓòÉΓòÉΓòÉ <hidden> HM_DISMISS_WINDOW Return Value - rc ΓòÉΓòÉΓòÉ
  16183.  
  16184.  rc (ULONG) 
  16185.     Return code. 
  16186.  
  16187.     0 
  16188.             The help window was successfully removed 
  16189.     Other 
  16190.             There was no associated help window. 
  16191.  
  16192.             See also the values of the ulErrorCode parameter of the HM_ERROR 
  16193.             message. 
  16194.  
  16195.  
  16196. ΓòÉΓòÉΓòÉ <hidden> HM_DISMISS_WINDOW - Parameters ΓòÉΓòÉΓòÉ
  16197.  
  16198.  ulReserved (ULONG) 
  16199.     Reserved value, should be 0. 
  16200.  
  16201.  ulReserved (ULONG) 
  16202.     Reserved value, should be 0. 
  16203.  
  16204.  rc (ULONG) 
  16205.     Return code. 
  16206.  
  16207.     0 
  16208.             The help window was successfully removed 
  16209.     Other 
  16210.             There was no associated help window. 
  16211.  
  16212.             See also the values of the ulErrorCode parameter of the HM_ERROR 
  16213.             message. 
  16214.  
  16215.  
  16216. ΓòÉΓòÉΓòÉ <hidden> HM_DISMISS_WINDOW - Remarks ΓòÉΓòÉΓòÉ
  16217.  
  16218. If the user requests help from a primary or secondary window, and then 
  16219. interacts with the primary or secondary window without leaving help, the 
  16220. currently displayed help window might not be appropriate for the application 
  16221. window. This message gives the application the ability to remove that help 
  16222. window. 
  16223.  
  16224.  
  16225. ΓòÉΓòÉΓòÉ <hidden> HM_DISMISS_WINDOW - Default Processing ΓòÉΓòÉΓòÉ
  16226.  
  16227. None. 
  16228.  
  16229.  
  16230. ΓòÉΓòÉΓòÉ <hidden> HM_DISMISS_WINDOW - Topics ΓòÉΓòÉΓòÉ
  16231.  
  16232. Select an item: 
  16233.  
  16234. Syntax
  16235. Parameters
  16236. Returns
  16237. Remarks
  16238. Default Processing
  16239. Glossary
  16240.  
  16241.  
  16242. ΓòÉΓòÉΓòÉ 19.5. HM_DISPLAY_HELP ΓòÉΓòÉΓòÉ
  16243.  
  16244.  
  16245. ΓòÉΓòÉΓòÉ <hidden> HM_DISPLAY_HELP - Syntax ΓòÉΓòÉΓòÉ
  16246.  
  16247. This message tells the Help Manager to display a specific help window. 
  16248.  
  16249.  
  16250. param1
  16251.     USHORT  idHelpPanelId     /*  Identity of the help window. */
  16252.     PSZ     pszHelpPanelName  /*  Name of the help window. */
  16253.  
  16254. param2
  16255.     USHORT  usTypeFlag        /*  Flag indicating how to interpret the first parameter. */
  16256.  
  16257. returns
  16258.     ULONG   rc                /*  Return code. */
  16259.  
  16260.  
  16261. ΓòÉΓòÉΓòÉ <hidden> HM_DISPLAY_HELP Field - idHelpPanelId ΓòÉΓòÉΓòÉ
  16262.  
  16263.  idHelpPanelId (USHORT) 
  16264.     Identity of the help window. 
  16265.  
  16266.     This points to a USHORT data type. 
  16267.  
  16268.  For a value of the usTypeFlag parameter of HM_PANELNAME. 
  16269.  
  16270.  
  16271. ΓòÉΓòÉΓòÉ <hidden> HM_DISPLAY_HELP Field - pszHelpPanelName ΓòÉΓòÉΓòÉ
  16272.  
  16273.  pszHelpPanelName (PSZ) 
  16274.     Name of the help window. 
  16275.  
  16276.     This points to a string containing the name of the help window. 
  16277.  
  16278.  
  16279. ΓòÉΓòÉΓòÉ <hidden> HM_DISPLAY_HELP Field - usTypeFlag ΓòÉΓòÉΓòÉ
  16280.  
  16281.  usTypeFlag (USHORT) 
  16282.     Flag indicating how to interpret the first parameter. 
  16283.  
  16284.     HM_RESOURCEID 
  16285.             Indicates the param1 points to the identity of the help window. 
  16286.  
  16287.     HM_PANELNAME 
  16288.             Indicates the param1 points to the name of the help window. 
  16289.  
  16290.  
  16291. ΓòÉΓòÉΓòÉ <hidden> HM_DISPLAY_HELP Return Value - rc ΓòÉΓòÉΓòÉ
  16292.  
  16293.  rc (ULONG) 
  16294.     Return code. 
  16295.  
  16296.     0 
  16297.             The window was successfully displayed 
  16298.     Other 
  16299.             See the values of the ulErrorCode parameter of the HM_ERROR 
  16300.             message. 
  16301.  
  16302.  
  16303. ΓòÉΓòÉΓòÉ <hidden> HM_DISPLAY_HELP - Parameters ΓòÉΓòÉΓòÉ
  16304.  
  16305.  idHelpPanelId (USHORT) 
  16306.     Identity of the help window. 
  16307.  
  16308.     This points to a USHORT data type. 
  16309.  
  16310.  For a value of the usTypeFlag parameter of HM_PANELNAME. 
  16311.  
  16312.  pszHelpPanelName (PSZ) 
  16313.     Name of the help window. 
  16314.  
  16315.     This points to a string containing the name of the help window. 
  16316.  
  16317.  usTypeFlag (USHORT) 
  16318.     Flag indicating how to interpret the first parameter. 
  16319.  
  16320.     HM_RESOURCEID 
  16321.             Indicates the param1 points to the identity of the help window. 
  16322.  
  16323.     HM_PANELNAME 
  16324.             Indicates the param1 points to the name of the help window. 
  16325.  
  16326.  rc (ULONG) 
  16327.     Return code. 
  16328.  
  16329.     0 
  16330.             The window was successfully displayed 
  16331.     Other 
  16332.             See the values of the ulErrorCode parameter of the HM_ERROR 
  16333.             message. 
  16334.  
  16335.  
  16336. ΓòÉΓòÉΓòÉ <hidden> HM_DISPLAY_HELP - Remarks ΓòÉΓòÉΓòÉ
  16337.  
  16338. param1 depends on the value of the usTypeFlag parameter. 
  16339.  
  16340.  
  16341. ΓòÉΓòÉΓòÉ <hidden> HM_DISPLAY_HELP - Default Processing ΓòÉΓòÉΓòÉ
  16342.  
  16343. None. 
  16344.  
  16345.  
  16346. ΓòÉΓòÉΓòÉ <hidden> HM_DISPLAY_HELP - Topics ΓòÉΓòÉΓòÉ
  16347.  
  16348. Select an item: 
  16349.  
  16350. Syntax
  16351. Parameters
  16352. Returns
  16353. Remarks
  16354. Default Processing
  16355. Glossary
  16356.  
  16357.  
  16358. ΓòÉΓòÉΓòÉ 19.6. HM_ERROR ΓòÉΓòÉΓòÉ
  16359.  
  16360.  
  16361. ΓòÉΓòÉΓòÉ <hidden> HM_ERROR - Syntax ΓòÉΓòÉΓòÉ
  16362.  
  16363. This message notifies the application of an error caused by a user interaction. 
  16364.  
  16365.  
  16366. param1
  16367.     ULONG  ulErrorCode  /*  Error code. */
  16368.  
  16369. param2
  16370.     ULONG  ulReserved   /*  Reserved value, should be 0. */
  16371.  
  16372. returns
  16373.     ULONG  ulReserved   /*  Reserved value, should be 0. */
  16374.  
  16375.  
  16376. ΓòÉΓòÉΓòÉ <hidden> HM_ERROR Field - ulErrorCode ΓòÉΓòÉΓòÉ
  16377.  
  16378.  ulErrorCode (ULONG) 
  16379.     Error code. 
  16380.  
  16381.     A constant describing the type of error that occurred. The application can 
  16382.     also receive some of these error constants in the ulReserved parameter of 
  16383.     messages it has sent to the Help Manager. 
  16384.  
  16385.     The error constants are: 
  16386.  
  16387.     HMERR_LOAD_DLL 
  16388.              The resource DLL was unable to be loaded. 
  16389.  
  16390.     HMERR_NO_FRAME_WND_IN_CHAIN 
  16391.              There is no frame window in the window chain from which to find or 
  16392.              set the associated help instance. 
  16393.  
  16394.     HMERR_INVALID_ASSOC_APP_WND 
  16395.              The application window handle specified on the 
  16396.              WinAssociateHelpInstance function is not a valid window handle. 
  16397.  
  16398.     HMERR_INVALID_ASSOC_HELP_INST 
  16399.              The help instance handle specified on the WinAssociateHelpInstance 
  16400.              function is not a valid window handle. 
  16401.  
  16402.     HMERR_INVALID_DESTROY_HELP_INST 
  16403.              The window handle specified as the help instance to destroy is not 
  16404.              of the help instance class. 
  16405.  
  16406.     HMERR_NO_HELP_INST_IN_CHAIN 
  16407.              The parent or owner chain of the application window specified does 
  16408.              not have an associated help instance. 
  16409.  
  16410.     HMERR_INVALID_HELP_INSTANCE_HDL 
  16411.              The handle specified to be a help instance does not have the class 
  16412.              name of a Help Manager instance. 
  16413.  
  16414.     HMERR_INVALID_QUERY_APP_WND 
  16415.              The application window specified on a WinQueryHelpInstance 
  16416.              function is not a valid window handle. 
  16417.  
  16418.     HMERR_HELP_INST_CALLED_INVALID 
  16419.              The handle of the instance specified on a call to the Help Manager 
  16420.              does not have the class name of a Help Manager instance. 
  16421.  
  16422.     HMERR_HELPTABLE_UNDEFINE 
  16423.              The application did not provide a help table for context-sensitive 
  16424.              help. 
  16425.  
  16426.     HMERR_HELP_INSTANCE_UNDEFINE 
  16427.              The help instance handle specified is invalid. 
  16428.  
  16429.     HMERR_HELPITEM_NOT_FOUND 
  16430.              Context-sensitive help was requested but the ID of the main help 
  16431.              item specified was not found in the help table. 
  16432.  
  16433.     HMERR_INVALID_HELPSUBITEM_SIZE 
  16434.              The help subtable item size is less than 2. 
  16435.  
  16436.     HMERR_HELPSUBITEM_NOT_FOUND 
  16437.              Context-sensitive help was requested but the ID of the help item 
  16438.              specified was not found in the help subtable. 
  16439.  
  16440.     HMERR_INDEX_NOT_FOUND 
  16441.              The index is not in the library file. 
  16442.  
  16443.     HMERR_CONTENT_NOT_FOUND 
  16444.              The library file does not have any content. 
  16445.  
  16446.     HMERR_OPEN_LIB_FILE 
  16447.              The library file cannot be opened. 
  16448.  
  16449.     HMERR_READ_LIB_FILE 
  16450.              The library file cannot be read. 
  16451.  
  16452.     HMERR_CLOSE_LIB_FILE 
  16453.              The library file cannot be closed. 
  16454.  
  16455.     HMERR_INVALID_LIB_FILE 
  16456.              Improper library file provided. 
  16457.  
  16458.     HMERR_NO_MEMORY 
  16459.              Unable to allocate the requested amount of memory. 
  16460.  
  16461.     HMERR_ALLOCATE_SEGMENT 
  16462.              Unable to allocate a segment of memory for memory allocation 
  16463.              requests from the Help Manager. 
  16464.  
  16465.     HMERR_FREE_MEMORY 
  16466.              Unable to free allocated memory. 
  16467.  
  16468.     HMERR_PANEL_NOT_FOUND 
  16469.              Unable to find the requested help window. 
  16470.  
  16471.     HMERR_DATABASE_NOT_OPEN 
  16472.              Unable to read the unopened database. 
  16473.  
  16474.  
  16475. ΓòÉΓòÉΓòÉ <hidden> HM_ERROR Field - ulReserved ΓòÉΓòÉΓòÉ
  16476.  
  16477.  ulReserved (ULONG) 
  16478.     Reserved value, should be 0. 
  16479.  
  16480.  
  16481. ΓòÉΓòÉΓòÉ <hidden> HM_ERROR Return Value - ulReserved ΓòÉΓòÉΓòÉ
  16482.  
  16483.  ulReserved (ULONG) 
  16484.     Reserved value, should be 0. 
  16485.  
  16486.  
  16487. ΓòÉΓòÉΓòÉ <hidden> HM_ERROR - Parameters ΓòÉΓòÉΓòÉ
  16488.  
  16489.  ulErrorCode (ULONG) 
  16490.     Error code. 
  16491.  
  16492.     A constant describing the type of error that occurred. The application can 
  16493.     also receive some of these error constants in the ulReserved parameter of 
  16494.     messages it has sent to the Help Manager. 
  16495.  
  16496.     The error constants are: 
  16497.  
  16498.     HMERR_LOAD_DLL 
  16499.              The resource DLL was unable to be loaded. 
  16500.  
  16501.     HMERR_NO_FRAME_WND_IN_CHAIN 
  16502.              There is no frame window in the window chain from which to find or 
  16503.              set the associated help instance. 
  16504.  
  16505.     HMERR_INVALID_ASSOC_APP_WND 
  16506.              The application window handle specified on the 
  16507.              WinAssociateHelpInstance function is not a valid window handle. 
  16508.  
  16509.     HMERR_INVALID_ASSOC_HELP_INST 
  16510.              The help instance handle specified on the WinAssociateHelpInstance 
  16511.              function is not a valid window handle. 
  16512.  
  16513.     HMERR_INVALID_DESTROY_HELP_INST 
  16514.              The window handle specified as the help instance to destroy is not 
  16515.              of the help instance class. 
  16516.  
  16517.     HMERR_NO_HELP_INST_IN_CHAIN 
  16518.              The parent or owner chain of the application window specified does 
  16519.              not have an associated help instance. 
  16520.  
  16521.     HMERR_INVALID_HELP_INSTANCE_HDL 
  16522.              The handle specified to be a help instance does not have the class 
  16523.              name of a Help Manager instance. 
  16524.  
  16525.     HMERR_INVALID_QUERY_APP_WND 
  16526.              The application window specified on a WinQueryHelpInstance 
  16527.              function is not a valid window handle. 
  16528.  
  16529.     HMERR_HELP_INST_CALLED_INVALID 
  16530.              The handle of the instance specified on a call to the Help Manager 
  16531.              does not have the class name of a Help Manager instance. 
  16532.  
  16533.     HMERR_HELPTABLE_UNDEFINE 
  16534.              The application did not provide a help table for context-sensitive 
  16535.              help. 
  16536.  
  16537.     HMERR_HELP_INSTANCE_UNDEFINE 
  16538.              The help instance handle specified is invalid. 
  16539.  
  16540.     HMERR_HELPITEM_NOT_FOUND 
  16541.              Context-sensitive help was requested but the ID of the main help 
  16542.              item specified was not found in the help table. 
  16543.  
  16544.     HMERR_INVALID_HELPSUBITEM_SIZE 
  16545.              The help subtable item size is less than 2. 
  16546.  
  16547.     HMERR_HELPSUBITEM_NOT_FOUND 
  16548.              Context-sensitive help was requested but the ID of the help item 
  16549.              specified was not found in the help subtable. 
  16550.  
  16551.     HMERR_INDEX_NOT_FOUND 
  16552.              The index is not in the library file. 
  16553.  
  16554.     HMERR_CONTENT_NOT_FOUND 
  16555.              The library file does not have any content. 
  16556.  
  16557.     HMERR_OPEN_LIB_FILE 
  16558.              The library file cannot be opened. 
  16559.  
  16560.     HMERR_READ_LIB_FILE 
  16561.              The library file cannot be read. 
  16562.  
  16563.     HMERR_CLOSE_LIB_FILE 
  16564.              The library file cannot be closed. 
  16565.  
  16566.     HMERR_INVALID_LIB_FILE 
  16567.              Improper library file provided. 
  16568.  
  16569.     HMERR_NO_MEMORY 
  16570.              Unable to allocate the requested amount of memory. 
  16571.  
  16572.     HMERR_ALLOCATE_SEGMENT 
  16573.              Unable to allocate a segment of memory for memory allocation 
  16574.              requests from the Help Manager. 
  16575.  
  16576.     HMERR_FREE_MEMORY 
  16577.              Unable to free allocated memory. 
  16578.  
  16579.     HMERR_PANEL_NOT_FOUND 
  16580.              Unable to find the requested help window. 
  16581.  
  16582.     HMERR_DATABASE_NOT_OPEN 
  16583.              Unable to read the unopened database. 
  16584.  
  16585.  ulReserved (ULONG) 
  16586.     Reserved value, should be 0. 
  16587.  
  16588.  ulReserved (ULONG) 
  16589.     Reserved value, should be 0. 
  16590.  
  16591.  
  16592. ΓòÉΓòÉΓòÉ <hidden> HM_ERROR - Remarks ΓòÉΓòÉΓòÉ
  16593.  
  16594. There is no other way to communicate the error to the application since the 
  16595. user initiated communication, not the application. Other errors which occur 
  16596. when the application sends a message to the Help Manager are returned as the 
  16597. ulReserved parameter of the message. 
  16598.  
  16599. The Help Manager does not display any error messages to the user. Instead, the 
  16600. Help Manager sends or returns all error notifications to the application so 
  16601. that it can display its own messages. This procedure ensures a consistent 
  16602. message interface for all user messages. 
  16603.  
  16604.  
  16605. ΓòÉΓòÉΓòÉ <hidden> HM_ERROR - Default Processing ΓòÉΓòÉΓòÉ
  16606.  
  16607. None. 
  16608.  
  16609.  
  16610. ΓòÉΓòÉΓòÉ <hidden> HM_ERROR - Topics ΓòÉΓòÉΓòÉ
  16611.  
  16612. Select an item: 
  16613.  
  16614. Syntax
  16615. Parameters
  16616. Returns
  16617. Remarks
  16618. Default Processing
  16619. Glossary
  16620.  
  16621.  
  16622. ΓòÉΓòÉΓòÉ 19.7. HM_EXT_HELP ΓòÉΓòÉΓòÉ
  16623.  
  16624.  
  16625. ΓòÉΓòÉΓòÉ <hidden> HM_EXT_HELP - Syntax ΓòÉΓòÉΓòÉ
  16626.  
  16627. When the Help Manager receives this message, it displays the extended help 
  16628. window for the active application panel. 
  16629.  
  16630.  
  16631. param1
  16632.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  16633.  
  16634. param2
  16635.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  16636.  
  16637. returns
  16638.     ULONG  rc          /*  Return code. */
  16639.  
  16640.  
  16641. ΓòÉΓòÉΓòÉ <hidden> HM_EXT_HELP Field - ulReserved ΓòÉΓòÉΓòÉ
  16642.  
  16643.  ulReserved (ULONG) 
  16644.     Reserved value, should be 0. 
  16645.  
  16646.  
  16647. ΓòÉΓòÉΓòÉ <hidden> HM_EXT_HELP Field - ulReserved ΓòÉΓòÉΓòÉ
  16648.  
  16649.  ulReserved (ULONG) 
  16650.     Reserved value, should be 0. 
  16651.  
  16652.  
  16653. ΓòÉΓòÉΓòÉ <hidden> HM_EXT_HELP Return Value - rc ΓòÉΓòÉΓòÉ
  16654.  
  16655.  rc (ULONG) 
  16656.     Return code. 
  16657.  
  16658.     0 
  16659.             The extended help window was successfully displayed 
  16660.     Other 
  16661.             See the values of the ulErrorCode parameter of the HM_ERROR 
  16662.             message. 
  16663.  
  16664.  
  16665. ΓòÉΓòÉΓòÉ <hidden> HM_EXT_HELP - Parameters ΓòÉΓòÉΓòÉ
  16666.  
  16667.  ulReserved (ULONG) 
  16668.     Reserved value, should be 0. 
  16669.  
  16670.  ulReserved (ULONG) 
  16671.     Reserved value, should be 0. 
  16672.  
  16673.  rc (ULONG) 
  16674.     Return code. 
  16675.  
  16676.     0 
  16677.             The extended help window was successfully displayed 
  16678.     Other 
  16679.             See the values of the ulErrorCode parameter of the HM_ERROR 
  16680.             message. 
  16681.  
  16682.  
  16683. ΓòÉΓòÉΓòÉ <hidden> HM_EXT_HELP - Default Processing ΓòÉΓòÉΓòÉ
  16684.  
  16685. None. 
  16686.  
  16687.  
  16688. ΓòÉΓòÉΓòÉ <hidden> HM_EXT_HELP - Topics ΓòÉΓòÉΓòÉ
  16689.  
  16690. Select an item: 
  16691.  
  16692. Syntax
  16693. Parameters
  16694. Returns
  16695. Default Processing
  16696. Glossary
  16697.  
  16698.  
  16699. ΓòÉΓòÉΓòÉ 19.8. HM_EXT_HELP_UNDEFINED ΓòÉΓòÉΓòÉ
  16700.  
  16701.  
  16702. ΓòÉΓòÉΓòÉ <hidden> HM_EXT_HELP_UNDEFINED - Syntax ΓòÉΓòÉΓòÉ
  16703.  
  16704. This message is sent to the application by the Help Manager to notify it that 
  16705. an extended help window has not been defined. 
  16706.  
  16707.  
  16708. param1
  16709.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  16710.  
  16711. param2
  16712.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  16713.  
  16714. returns
  16715.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  16716.  
  16717.  
  16718. ΓòÉΓòÉΓòÉ <hidden> HM_EXT_HELP_UNDEFINED Field - ulReserved ΓòÉΓòÉΓòÉ
  16719.  
  16720.  ulReserved (ULONG) 
  16721.     Reserved value, should be 0. 
  16722.  
  16723.  
  16724. ΓòÉΓòÉΓòÉ <hidden> HM_EXT_HELP_UNDEFINED Field - ulReserved ΓòÉΓòÉΓòÉ
  16725.  
  16726.  ulReserved (ULONG) 
  16727.     Reserved value, should be 0. 
  16728.  
  16729.  
  16730. ΓòÉΓòÉΓòÉ <hidden> HM_EXT_HELP_UNDEFINED Return Value - ulReserved ΓòÉΓòÉΓòÉ
  16731.  
  16732.  ulReserved (ULONG) 
  16733.     Reserved value, should be 0. 
  16734.  
  16735.  
  16736. ΓòÉΓòÉΓòÉ <hidden> HM_EXT_HELP_UNDEFINED - Parameters ΓòÉΓòÉΓòÉ
  16737.  
  16738.  ulReserved (ULONG) 
  16739.     Reserved value, should be 0. 
  16740.  
  16741.  ulReserved (ULONG) 
  16742.     Reserved value, should be 0. 
  16743.  
  16744.  ulReserved (ULONG) 
  16745.     Reserved value, should be 0. 
  16746.  
  16747.  
  16748. ΓòÉΓòÉΓòÉ <hidden> HM_EXT_HELP_UNDEFINED - Remarks ΓòÉΓòÉΓòÉ
  16749.  
  16750. When the extended help window is requested, the Help Manager searches the help 
  16751. table for its identity. If the extended help window identity associated with 
  16752. the current active window is zero, the Help Manager sends this message to the 
  16753. application to notify it that an extended help window has not been defined. The 
  16754. application then can: 
  16755.  
  16756.      Ignore the request for help and not display a help window. 
  16757.  
  16758.      Display its own window. 
  16759.  
  16760.      Use the HM_DISPLAY_HELP message to tell the Help Manager to display a 
  16761.       particular window. 
  16762.  
  16763.  
  16764. ΓòÉΓòÉΓòÉ <hidden> HM_EXT_HELP_UNDEFINED - Default Processing ΓòÉΓòÉΓòÉ
  16765.  
  16766. None. 
  16767.  
  16768.  
  16769. ΓòÉΓòÉΓòÉ <hidden> HM_EXT_HELP_UNDEFINED - Topics ΓòÉΓòÉΓòÉ
  16770.  
  16771. Select an item: 
  16772.  
  16773. Syntax
  16774. Parameters
  16775. Returns
  16776. Remarks
  16777. Default Processing
  16778. Glossary
  16779.  
  16780.  
  16781. ΓòÉΓòÉΓòÉ 19.9. HM_GENERAL_HELP ΓòÉΓòÉΓòÉ
  16782.  
  16783.  
  16784. ΓòÉΓòÉΓòÉ <hidden> HM_GENERAL_HELP - Syntax ΓòÉΓòÉΓòÉ
  16785.  
  16786. When the Help Manager receives this message, it displays the general help 
  16787. window for the active application window. 
  16788.  
  16789.  
  16790. param1
  16791.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  16792.  
  16793. param2
  16794.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  16795.  
  16796. returns
  16797.     ULONG  rc          /*  Return code. */
  16798.  
  16799.  
  16800. ΓòÉΓòÉΓòÉ <hidden> HM_GENERAL_HELP Field - ulReserved ΓòÉΓòÉΓòÉ
  16801.  
  16802.  ulReserved (ULONG) 
  16803.     Reserved value, should be 0. 
  16804.  
  16805.  
  16806. ΓòÉΓòÉΓòÉ <hidden> HM_GENERAL_HELP Field - ulReserved ΓòÉΓòÉΓòÉ
  16807.  
  16808.  ulReserved (ULONG) 
  16809.     Reserved value, should be 0. 
  16810.  
  16811.  
  16812. ΓòÉΓòÉΓòÉ <hidden> HM_GENERAL_HELP Return Value - rc ΓòÉΓòÉΓòÉ
  16813.  
  16814.  rc (ULONG) 
  16815.     Return code. 
  16816.  
  16817.     0 
  16818.             The general help window was successfully displayed. 
  16819.     Other 
  16820.             See the values of the ulErrorCode parameter of the HM_ERROR 
  16821.             message. 
  16822.  
  16823.  
  16824. ΓòÉΓòÉΓòÉ <hidden> HM_GENERAL_HELP - Parameters ΓòÉΓòÉΓòÉ
  16825.  
  16826.  ulReserved (ULONG) 
  16827.     Reserved value, should be 0. 
  16828.  
  16829.  ulReserved (ULONG) 
  16830.     Reserved value, should be 0. 
  16831.  
  16832.  rc (ULONG) 
  16833.     Return code. 
  16834.  
  16835.     0 
  16836.             The general help window was successfully displayed. 
  16837.     Other 
  16838.             See the values of the ulErrorCode parameter of the HM_ERROR 
  16839.             message. 
  16840.  
  16841.  
  16842. ΓòÉΓòÉΓòÉ <hidden> HM_GENERAL_HELP - Default Processing ΓòÉΓòÉΓòÉ
  16843.  
  16844. None. 
  16845.  
  16846.  
  16847. ΓòÉΓòÉΓòÉ <hidden> HM_GENERAL_HELP - Topics ΓòÉΓòÉΓòÉ
  16848.  
  16849. Select an item: 
  16850.  
  16851. Syntax
  16852. Parameters
  16853. Returns
  16854. Default Processing
  16855. Glossary
  16856.  
  16857.  
  16858. ΓòÉΓòÉΓòÉ 19.10. HM_GENERAL_HELP_UNDEFINED ΓòÉΓòÉΓòÉ
  16859.  
  16860.  
  16861. ΓòÉΓòÉΓòÉ <hidden> HM_GENERAL_HELP_UNDEFINED - Syntax ΓòÉΓòÉΓòÉ
  16862.  
  16863. This message is sent to the application by the Help Manager to notify it that a 
  16864. general help window has not been defined. 
  16865.  
  16866.  
  16867. param1
  16868.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  16869.  
  16870. param2
  16871.     ULONG  ulReserved  /*  Reserved. */
  16872.  
  16873. returns
  16874.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  16875.  
  16876.  
  16877. ΓòÉΓòÉΓòÉ <hidden> HM_GENERAL_HELP_UNDEFINED Field - ulReserved ΓòÉΓòÉΓòÉ
  16878.  
  16879.  ulReserved (ULONG) 
  16880.     Reserved value, should be 0. 
  16881.  
  16882.  
  16883. ΓòÉΓòÉΓòÉ <hidden> HM_GENERAL_HELP_UNDEFINED Field - ulReserved ΓòÉΓòÉΓòÉ
  16884.  
  16885.  ulReserved (ULONG) 
  16886.     Reserved. 
  16887.  
  16888.     0 
  16889.             Reserved value, 0. 
  16890.  
  16891.  
  16892. ΓòÉΓòÉΓòÉ <hidden> HM_GENERAL_HELP_UNDEFINED Return Value - ulReserved ΓòÉΓòÉΓòÉ
  16893.  
  16894.  ulReserved (ULONG) 
  16895.     Reserved value, should be 0. 
  16896.  
  16897.  
  16898. ΓòÉΓòÉΓòÉ <hidden> HM_GENERAL_HELP_UNDEFINED - Parameters ΓòÉΓòÉΓòÉ
  16899.  
  16900.  ulReserved (ULONG) 
  16901.     Reserved value, should be 0. 
  16902.  
  16903.  ulReserved (ULONG) 
  16904.     Reserved. 
  16905.  
  16906.     0 
  16907.             Reserved value, 0. 
  16908.  
  16909.  ulReserved (ULONG) 
  16910.     Reserved value, should be 0. 
  16911.  
  16912.  
  16913. ΓòÉΓòÉΓòÉ <hidden> HM_GENERAL_HELP_UNDEFINED - Remarks ΓòÉΓòÉΓòÉ
  16914.  
  16915. When the general help window is requested, the Help Manager searches the help 
  16916. table for its identity. If the general help window identity associated with the 
  16917. current active window is zero, the Help Manager sends this message to the 
  16918. application to notify it that a general help window has not been defined. The 
  16919. application can then: 
  16920.  
  16921.      Ignore the request for help and not display a help window. 
  16922.  
  16923.      Display its own window. 
  16924.  
  16925.      Use the HM_DISPLAY_HELP message to tell the Help Manager to display a 
  16926.       particular window. 
  16927.  
  16928.  
  16929. ΓòÉΓòÉΓòÉ <hidden> HM_GENERAL_HELP_UNDEFINED - Default Processing ΓòÉΓòÉΓòÉ
  16930.  
  16931. None. 
  16932.  
  16933.  
  16934. ΓòÉΓòÉΓòÉ <hidden> HM_GENERAL_HELP_UNDEFINED - Topics ΓòÉΓòÉΓòÉ
  16935.  
  16936. Select an item: 
  16937.  
  16938. Syntax
  16939. Parameters
  16940. Returns
  16941. Remarks
  16942. Default Processing
  16943. Glossary
  16944.  
  16945.  
  16946. ΓòÉΓòÉΓòÉ 19.11. HM_HELP_CONTENTS ΓòÉΓòÉΓòÉ
  16947.  
  16948.  
  16949. ΓòÉΓòÉΓòÉ <hidden> HM_HELP_CONTENTS - Syntax ΓòÉΓòÉΓòÉ
  16950.  
  16951. When the Help Manager receives this message, it displays the help contents 
  16952. window. 
  16953.  
  16954.  
  16955. param1
  16956.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  16957.  
  16958. param2
  16959.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  16960.  
  16961. returns
  16962.     ULONG  rc          /*  Return code. */
  16963.  
  16964.  
  16965. ΓòÉΓòÉΓòÉ <hidden> HM_HELP_CONTENTS Field - ulReserved ΓòÉΓòÉΓòÉ
  16966.  
  16967.  ulReserved (ULONG) 
  16968.     Reserved value, should be 0. 
  16969.  
  16970.  
  16971. ΓòÉΓòÉΓòÉ <hidden> HM_HELP_CONTENTS Field - ulReserved ΓòÉΓòÉΓòÉ
  16972.  
  16973.  ulReserved (ULONG) 
  16974.     Reserved value, should be 0. 
  16975.  
  16976.  
  16977. ΓòÉΓòÉΓòÉ <hidden> HM_HELP_CONTENTS Return Value - rc ΓòÉΓòÉΓòÉ
  16978.  
  16979.  rc (ULONG) 
  16980.     Return code. 
  16981.  
  16982.     0 
  16983.             The help contents window was successfully displayed. 
  16984.     Other 
  16985.             See the values of the ulErrorCode parameter of the HM_ERROR 
  16986.             message. 
  16987.  
  16988.  
  16989. ΓòÉΓòÉΓòÉ <hidden> HM_HELP_CONTENTS - Parameters ΓòÉΓòÉΓòÉ
  16990.  
  16991.  ulReserved (ULONG) 
  16992.     Reserved value, should be 0. 
  16993.  
  16994.  ulReserved (ULONG) 
  16995.     Reserved value, should be 0. 
  16996.  
  16997.  rc (ULONG) 
  16998.     Return code. 
  16999.  
  17000.     0 
  17001.             The help contents window was successfully displayed. 
  17002.     Other 
  17003.             See the values of the ulErrorCode parameter of the HM_ERROR 
  17004.             message. 
  17005.  
  17006.  
  17007. ΓòÉΓòÉΓòÉ <hidden> HM_HELP_CONTENTS - Default Processing ΓòÉΓòÉΓòÉ
  17008.  
  17009. None. 
  17010.  
  17011.  
  17012. ΓòÉΓòÉΓòÉ <hidden> HM_HELP_CONTENTS - Topics ΓòÉΓòÉΓòÉ
  17013.  
  17014. Select an item: 
  17015.  
  17016. Syntax
  17017. Parameters
  17018. Returns
  17019. Default Processing
  17020. Glossary
  17021.  
  17022.  
  17023. ΓòÉΓòÉΓòÉ 19.12. HM_HELP_INDEX ΓòÉΓòÉΓòÉ
  17024.  
  17025.  
  17026. ΓòÉΓòÉΓòÉ <hidden> HM_HELP_INDEX - Syntax ΓòÉΓòÉΓòÉ
  17027.  
  17028. When the Help Manager receives this message, it displays the help index window. 
  17029.  
  17030.  
  17031. param1
  17032.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  17033.  
  17034. param2
  17035.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  17036.  
  17037. returns
  17038.     ULONG  rc          /*  Return code. */
  17039.  
  17040.  
  17041. ΓòÉΓòÉΓòÉ <hidden> HM_HELP_INDEX Field - ulReserved ΓòÉΓòÉΓòÉ
  17042.  
  17043.  ulReserved (ULONG) 
  17044.     Reserved value, should be 0. 
  17045.  
  17046.  
  17047. ΓòÉΓòÉΓòÉ <hidden> HM_HELP_INDEX Field - ulReserved ΓòÉΓòÉΓòÉ
  17048.  
  17049.  ulReserved (ULONG) 
  17050.     Reserved value, should be 0. 
  17051.  
  17052.  
  17053. ΓòÉΓòÉΓòÉ <hidden> HM_HELP_INDEX Return Value - rc ΓòÉΓòÉΓòÉ
  17054.  
  17055.  rc (ULONG) 
  17056.     Return code. 
  17057.  
  17058.     0 
  17059.             The help index window was successfully displayed. 
  17060.     Other 
  17061.             See the values of the ulErrorCode parameter of the HM_ERROR 
  17062.             message. 
  17063.  
  17064.  
  17065. ΓòÉΓòÉΓòÉ <hidden> HM_HELP_INDEX - Parameters ΓòÉΓòÉΓòÉ
  17066.  
  17067.  ulReserved (ULONG) 
  17068.     Reserved value, should be 0. 
  17069.  
  17070.  ulReserved (ULONG) 
  17071.     Reserved value, should be 0. 
  17072.  
  17073.  rc (ULONG) 
  17074.     Return code. 
  17075.  
  17076.     0 
  17077.             The help index window was successfully displayed. 
  17078.     Other 
  17079.             See the values of the ulErrorCode parameter of the HM_ERROR 
  17080.             message. 
  17081.  
  17082.  
  17083. ΓòÉΓòÉΓòÉ <hidden> HM_HELP_INDEX - Default Processing ΓòÉΓòÉΓòÉ
  17084.  
  17085. None. 
  17086.  
  17087.  
  17088. ΓòÉΓòÉΓòÉ <hidden> HM_HELP_INDEX - Topics ΓòÉΓòÉΓòÉ
  17089.  
  17090. Select an item: 
  17091.  
  17092. Syntax
  17093. Parameters
  17094. Returns
  17095. Default Processing
  17096. Glossary
  17097.  
  17098.  
  17099. ΓòÉΓòÉΓòÉ 19.13. HM_HELPSUBITEM_NOT_FOUND ΓòÉΓòÉΓòÉ
  17100.  
  17101.  
  17102. ΓòÉΓòÉΓòÉ <hidden> HM_HELPSUBITEM_NOT_FOUND - Syntax ΓòÉΓòÉΓòÉ
  17103.  
  17104. The Help Manager sends this message to the application when the user requests 
  17105. help on a field and it cannot find a related entry in the help subtable. 
  17106.  
  17107.  
  17108. param1
  17109.     USHORT  usContext  /*  Type of window on which help was requested. */
  17110.  
  17111. param2
  17112.     SHORT   sTopic     /*  Topic identifier. */
  17113.     SHORT   sSubTopic  /*  Subtopic identifier. */
  17114.  
  17115. returns
  17116.     BOOL    rc         /*  Action indicator. */
  17117.  
  17118.  
  17119. ΓòÉΓòÉΓòÉ <hidden> HM_HELPSUBITEM_NOT_FOUND Field - usContext ΓòÉΓòÉΓòÉ
  17120.  
  17121.  usContext (USHORT) 
  17122.     Type of window on which help was requested. 
  17123.  
  17124.     HLPM_WINDOW            An application window 
  17125.     HLPM_FRAME             A frame window 
  17126.     HLPM_MENU              A menu window. 
  17127.  
  17128.  
  17129. ΓòÉΓòÉΓòÉ <hidden> HM_HELPSUBITEM_NOT_FOUND Field - sTopic ΓòÉΓòÉΓòÉ
  17130.  
  17131.  sTopic (SHORT) 
  17132.     Topic identifier. 
  17133.  
  17134.     For a value of the usContext parameter of HLPM_WINDOW or HLPM_FRAME: 
  17135.  
  17136.     window 
  17137.             Identity of the window containing the field on which help was 
  17138.             requested. 
  17139.     menu 
  17140.             Identity of the submenu containing the field on which help was 
  17141.             requested. 
  17142.  
  17143.  
  17144. ΓòÉΓòÉΓòÉ <hidden> HM_HELPSUBITEM_NOT_FOUND Field - sSubTopic ΓòÉΓòÉΓòÉ
  17145.  
  17146.  sSubTopic (SHORT) 
  17147.     Subtopic identifier. 
  17148.  
  17149.     For a value of the usContext parameter of HLPM_WINDOW or HLPM_FRAME: 
  17150.  
  17151.     control        Control identity of the cursored field and on which help was 
  17152.                    requested. 
  17153.  
  17154.     For a value of the usContext parameter of HLPM_MENU: 
  17155.  
  17156.     -1             No menu item was selected 
  17157.  
  17158.     other          Menu item identity of the currently selected submenu item on 
  17159.                    which help was requested. 
  17160.  
  17161.  
  17162. ΓòÉΓòÉΓòÉ <hidden> HM_HELPSUBITEM_NOT_FOUND Return Value - rc ΓòÉΓòÉΓòÉ
  17163.  
  17164.  rc (BOOL) 
  17165.     Action indicator. 
  17166.  
  17167.  
  17168. ΓòÉΓòÉΓòÉ <hidden> HM_HELPSUBITEM_NOT_FOUND - Parameters ΓòÉΓòÉΓòÉ
  17169.  
  17170.  usContext (USHORT) 
  17171.     Type of window on which help was requested. 
  17172.  
  17173.     HLPM_WINDOW            An application window 
  17174.     HLPM_FRAME             A frame window 
  17175.     HLPM_MENU              A menu window. 
  17176.  
  17177.  sTopic (SHORT) 
  17178.     Topic identifier. 
  17179.  
  17180.     For a value of the usContext parameter of HLPM_WINDOW or HLPM_FRAME: 
  17181.  
  17182.     window 
  17183.             Identity of the window containing the field on which help was 
  17184.             requested. 
  17185.     menu 
  17186.             Identity of the submenu containing the field on which help was 
  17187.             requested. 
  17188.  
  17189.  sSubTopic (SHORT) 
  17190.     Subtopic identifier. 
  17191.  
  17192.     For a value of the usContext parameter of HLPM_WINDOW or HLPM_FRAME: 
  17193.  
  17194.     control        Control identity of the cursored field and on which help was 
  17195.                    requested. 
  17196.  
  17197.     For a value of the usContext parameter of HLPM_MENU: 
  17198.  
  17199.     -1             No menu item was selected 
  17200.  
  17201.     other          Menu item identity of the currently selected submenu item on 
  17202.                    which help was requested. 
  17203.  
  17204.  rc (BOOL) 
  17205.     Action indicator. 
  17206.  
  17207.  
  17208. ΓòÉΓòÉΓòÉ <hidden> HM_HELPSUBITEM_NOT_FOUND - Remarks ΓòÉΓòÉΓòÉ
  17209.  
  17210. If FALSE is returned from this message, the Help Manager displays the extended 
  17211. help window. 
  17212.  
  17213. The application has the following options: 
  17214.  
  17215.      Ignore the notification and not display help for that field or window. 
  17216.  
  17217.      Display its own window. 
  17218.  
  17219.      Use the HM_DISPLAY_HELP message to tell the Help Manager to display a 
  17220.       particular window. 
  17221.  
  17222.  
  17223. ΓòÉΓòÉΓòÉ <hidden> HM_HELPSUBITEM_NOT_FOUND - Default Processing ΓòÉΓòÉΓòÉ
  17224.  
  17225. None. 
  17226.  
  17227.  
  17228. ΓòÉΓòÉΓòÉ <hidden> HM_HELPSUBITEM_NOT_FOUND - Topics ΓòÉΓòÉΓòÉ
  17229.  
  17230. Select an item: 
  17231.  
  17232. Syntax
  17233. Parameters
  17234. Returns
  17235. Remarks
  17236. Default Processing
  17237. Glossary
  17238.  
  17239.  
  17240. ΓòÉΓòÉΓòÉ 19.14. HM_INFORM ΓòÉΓòÉΓòÉ
  17241.  
  17242.  
  17243. ΓòÉΓòÉΓòÉ <hidden> HM_INFORM - Syntax ΓòÉΓòÉΓòÉ
  17244.  
  17245. This message is used by the Help Manager to notify the application when the 
  17246. user selects a hypertext field that was specified with the reftype=inform 
  17247. attribute of the :link. tag. 
  17248.  
  17249.  
  17250. param1
  17251.     USHORT  idnum       /*  Window identity. */
  17252.  
  17253. param2
  17254.     ULONG   ulReserved  /*  Reserved value, should be 0. */
  17255.  
  17256. returns
  17257.     ULONG   ulReserved  /*  Reserved value, should be 0. */
  17258.  
  17259.  
  17260. ΓòÉΓòÉΓòÉ <hidden> HM_INFORM Field - idnum ΓòÉΓòÉΓòÉ
  17261.  
  17262.  idnum (USHORT) 
  17263.     Window identity. 
  17264.  
  17265.     The identity that is associated with the hypertext field. 
  17266.  
  17267.  
  17268. ΓòÉΓòÉΓòÉ <hidden> HM_INFORM Field - ulReserved ΓòÉΓòÉΓòÉ
  17269.  
  17270.  ulReserved (ULONG) 
  17271.     Reserved value, should be 0. 
  17272.  
  17273.  
  17274. ΓòÉΓòÉΓòÉ <hidden> HM_INFORM Return Value - ulReserved ΓòÉΓòÉΓòÉ
  17275.  
  17276.  ulReserved (ULONG) 
  17277.     Reserved value, should be 0. 
  17278.  
  17279.     0 
  17280.             Reserved value, zero. 
  17281.  
  17282.  
  17283. ΓòÉΓòÉΓòÉ <hidden> HM_INFORM - Parameters ΓòÉΓòÉΓòÉ
  17284.  
  17285.  idnum (USHORT) 
  17286.     Window identity. 
  17287.  
  17288.     The identity that is associated with the hypertext field. 
  17289.  
  17290.  ulReserved (ULONG) 
  17291.     Reserved value, should be 0. 
  17292.  
  17293.  ulReserved (ULONG) 
  17294.     Reserved value, should be 0. 
  17295.  
  17296.     0 
  17297.             Reserved value, zero. 
  17298.  
  17299.  
  17300. ΓòÉΓòÉΓòÉ <hidden> HM_INFORM - Default Processing ΓòÉΓòÉΓòÉ
  17301.  
  17302. None. 
  17303.  
  17304.  
  17305. ΓòÉΓòÉΓòÉ <hidden> HM_INFORM - Topics ΓòÉΓòÉΓòÉ
  17306.  
  17307. Select an item: 
  17308.  
  17309. Syntax
  17310. Parameters
  17311. Returns
  17312. Default Processing
  17313. Glossary
  17314.  
  17315.  
  17316. ΓòÉΓòÉΓòÉ 19.15. HM_INVALIDATE_DDF_DATA ΓòÉΓòÉΓòÉ
  17317.  
  17318.  
  17319. ΓòÉΓòÉΓòÉ <hidden> HM_INVALIDATE_DDF_DATA - Syntax ΓòÉΓòÉΓòÉ
  17320.  
  17321. The application sends this message to IPF to indicate that the previous DDF 
  17322. data is no longer valid. 
  17323.  
  17324.  
  17325. param1
  17326.     ULONG    rescount  /*  The count of DDFs to be invalidated. */
  17327.  
  17328. param2
  17329.     PUSHORT  resarray  /*  Pointer to an array. */
  17330.  
  17331. returns
  17332.     ULONG    rc        /*  Return code. */
  17333.  
  17334.  
  17335. ΓòÉΓòÉΓòÉ <hidden> HM_INVALIDATE_DDF_DATA Field - rescount ΓòÉΓòÉΓòÉ
  17336.  
  17337.  rescount (ULONG) 
  17338.     The count of DDFs to be invalidated. 
  17339.  
  17340.  
  17341. ΓòÉΓòÉΓòÉ <hidden> HM_INVALIDATE_DDF_DATA Field - resarray ΓòÉΓòÉΓòÉ
  17342.  
  17343.  resarray (PUSHORT) 
  17344.     Pointer to an array. 
  17345.  
  17346.     The pointer to an array of unsigned 16-bit (USHORT) integers that are the 
  17347.     res numbers of DDFs to be invalidated. 
  17348.  
  17349.     Note:  If both param1 and param2 are NULL, then all the DDFs in that page 
  17350.            will be invalidated. 
  17351.  
  17352.  
  17353. ΓòÉΓòÉΓòÉ <hidden> HM_INVALIDATE_DDF_DATA Return Value - rc ΓòÉΓòÉΓòÉ
  17354.  
  17355.  rc (ULONG) 
  17356.     Return code. 
  17357.  
  17358.     0 
  17359.             The procedure was successfully completed. 
  17360.     Other 
  17361.             See the values of the errorcode parameter of the HM_ERROR message. 
  17362.  
  17363.  
  17364. ΓòÉΓòÉΓòÉ <hidden> HM_INVALIDATE_DDF_DATA - Parameters ΓòÉΓòÉΓòÉ
  17365.  
  17366.  rescount (ULONG) 
  17367.     The count of DDFs to be invalidated. 
  17368.  
  17369.  resarray (PUSHORT) 
  17370.     Pointer to an array. 
  17371.  
  17372.     The pointer to an array of unsigned 16-bit (USHORT) integers that are the 
  17373.     res numbers of DDFs to be invalidated. 
  17374.  
  17375.     Note:  If both param1 and param2 are NULL, then all the DDFs in that page 
  17376.            will be invalidated. 
  17377.  
  17378.  rc (ULONG) 
  17379.     Return code. 
  17380.  
  17381.     0 
  17382.             The procedure was successfully completed. 
  17383.     Other 
  17384.             See the values of the errorcode parameter of the HM_ERROR message. 
  17385.  
  17386.  
  17387. ΓòÉΓòÉΓòÉ <hidden> HM_INVALIDATE_DDF_DATA - Remarks ΓòÉΓòÉΓòÉ
  17388.  
  17389. When IPF receives this message, it discards the current DDF data and sends a 
  17390. new HM_QUERY_DDF_DATA message to the object communication window. 
  17391.  
  17392. This message should be sent to the child of the coverpage window handle. 
  17393.  
  17394.  
  17395. ΓòÉΓòÉΓòÉ <hidden> HM_INVALIDATE_DDF_DATA - Default Processing ΓòÉΓòÉΓòÉ
  17396.  
  17397. None. 
  17398.  
  17399.  
  17400. ΓòÉΓòÉΓòÉ <hidden> HM_INVALIDATE_DDF_DATA - Topics ΓòÉΓòÉΓòÉ
  17401.  
  17402. Select an item: 
  17403.  
  17404. Syntax
  17405. Parameters
  17406. Returns
  17407. Remarks
  17408. Default Processing
  17409. Glossary
  17410.  
  17411.  
  17412. ΓòÉΓòÉΓòÉ 19.16. HM_KEYS_HELP ΓòÉΓòÉΓòÉ
  17413.  
  17414.  
  17415. ΓòÉΓòÉΓòÉ <hidden> HM_KEYS_HELP - Syntax ΓòÉΓòÉΓòÉ
  17416.  
  17417. This message is sent by the application and informs the help manager to display 
  17418. the keys help window. 
  17419.  
  17420.  
  17421. param1
  17422.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  17423.  
  17424. param2
  17425.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  17426.  
  17427. returns
  17428.     ULONG  rc          /*  Return code. */
  17429.  
  17430.  
  17431. ΓòÉΓòÉΓòÉ <hidden> HM_KEYS_HELP Field - ulReserved ΓòÉΓòÉΓòÉ
  17432.  
  17433.  ulReserved (ULONG) 
  17434.     Reserved value, should be 0. 
  17435.  
  17436.  
  17437. ΓòÉΓòÉΓòÉ <hidden> HM_KEYS_HELP Field - ulReserved ΓòÉΓòÉΓòÉ
  17438.  
  17439.  ulReserved (ULONG) 
  17440.     Reserved value, should be 0. 
  17441.  
  17442.  
  17443. ΓòÉΓòÉΓòÉ <hidden> HM_KEYS_HELP Return Value - rc ΓòÉΓòÉΓòÉ
  17444.  
  17445.  rc (ULONG) 
  17446.     Return code. 
  17447.  
  17448.     0 
  17449.             The keys help window was successfully displayed 
  17450.     Other 
  17451.             See the values of the ulErrorCode parameter of the HM_ERROR 
  17452.             message. 
  17453.  
  17454.  
  17455. ΓòÉΓòÉΓòÉ <hidden> HM_KEYS_HELP - Parameters ΓòÉΓòÉΓòÉ
  17456.  
  17457.  ulReserved (ULONG) 
  17458.     Reserved value, should be 0. 
  17459.  
  17460.  ulReserved (ULONG) 
  17461.     Reserved value, should be 0. 
  17462.  
  17463.  rc (ULONG) 
  17464.     Return code. 
  17465.  
  17466.     0 
  17467.             The keys help window was successfully displayed 
  17468.     Other 
  17469.             See the values of the ulErrorCode parameter of the HM_ERROR 
  17470.             message. 
  17471.  
  17472.  
  17473. ΓòÉΓòÉΓòÉ <hidden> HM_KEYS_HELP - Remarks ΓòÉΓòÉΓòÉ
  17474.  
  17475. When the Help Manager receives this message, it sends a HM_QUERY_KEYS_HELP 
  17476. message to the active application window. The active application window is the 
  17477. window that was specified when the last HM_SET_ACTIVE_WINDOW message was sent. 
  17478. If no HM_SET_ACTIVE_WINDOW message was issued, then the active application 
  17479. window is the window specified in the WinAssociateHelpInstance call. 
  17480.  
  17481. The application must return one of the following: 
  17482.  
  17483.      The identity of a keys help window in the usHelpPanel parameter of the 
  17484.       HM_QUERY_KEYS_HELP message. 
  17485.  
  17486.      Zero, if no action is to be taken by the Help Manager for keys help. 
  17487.  
  17488.  
  17489. ΓòÉΓòÉΓòÉ <hidden> HM_KEYS_HELP - Default Processing ΓòÉΓòÉΓòÉ
  17490.  
  17491. None. 
  17492.  
  17493.  
  17494. ΓòÉΓòÉΓòÉ <hidden> HM_KEYS_HELP - Topics ΓòÉΓòÉΓòÉ
  17495.  
  17496. Select an item: 
  17497.  
  17498. Syntax
  17499. Parameters
  17500. Returns
  17501. Remarks
  17502. Default Processing
  17503. Glossary
  17504.  
  17505.  
  17506. ΓòÉΓòÉΓòÉ 19.17. HM_LOAD_HELP_TABLE ΓòÉΓòÉΓòÉ
  17507.  
  17508.  
  17509. ΓòÉΓòÉΓòÉ <hidden> HM_LOAD_HELP_TABLE - Syntax ΓòÉΓòÉΓòÉ
  17510.  
  17511. The application sends this message to give the Help Manager the module handle 
  17512. that contains the help table, the help subtable, and the identity of the help 
  17513. table. 
  17514.  
  17515.  
  17516. param1
  17517.     USHORT   idHelpTable     /*  Identity of the help table. */
  17518.     USHORT   fsidentityflag  /*  Help table identity indicator. */
  17519.  
  17520. param2
  17521.     HMODULE  MODULE          /*  Resource identity. */
  17522.  
  17523. returns
  17524.     ULONG    rc              /*  Return code. */
  17525.  
  17526.  
  17527. ΓòÉΓòÉΓòÉ <hidden> HM_LOAD_HELP_TABLE Field - idHelpTable ΓòÉΓòÉΓòÉ
  17528.  
  17529.  idHelpTable (USHORT) 
  17530.     Identity of the help table. 
  17531.  
  17532.  
  17533. ΓòÉΓòÉΓòÉ <hidden> HM_LOAD_HELP_TABLE Field - fsidentityflag ΓòÉΓòÉΓòÉ
  17534.  
  17535.  fsidentityflag (USHORT) 
  17536.     Help table identity indicator. 
  17537.  
  17538.     0xFFFF 
  17539.             Reserved value. 
  17540.  
  17541.  
  17542. ΓòÉΓòÉΓòÉ <hidden> HM_LOAD_HELP_TABLE Field - MODULE ΓòÉΓòÉΓòÉ
  17543.  
  17544.  MODULE (HMODULE) 
  17545.     Resource identity. 
  17546.  
  17547.     Handle of the module that contains the help table and help subtable. 
  17548.  
  17549.  
  17550. ΓòÉΓòÉΓòÉ <hidden> HM_LOAD_HELP_TABLE Return Value - rc ΓòÉΓòÉΓòÉ
  17551.  
  17552.  rc (ULONG) 
  17553.     Return code. 
  17554.  
  17555.     0 
  17556.             The procedure was successfully completed. 
  17557.     Other 
  17558.             See the values of the ulErrorCode parameter of the HM_ERROR 
  17559.             message. 
  17560.  
  17561.  
  17562. ΓòÉΓòÉΓòÉ <hidden> HM_LOAD_HELP_TABLE - Parameters ΓòÉΓòÉΓòÉ
  17563.  
  17564.  idHelpTable (USHORT) 
  17565.     Identity of the help table. 
  17566.  
  17567.  fsidentityflag (USHORT) 
  17568.     Help table identity indicator. 
  17569.  
  17570.     0xFFFF 
  17571.             Reserved value. 
  17572.  
  17573.  MODULE (HMODULE) 
  17574.     Resource identity. 
  17575.  
  17576.     Handle of the module that contains the help table and help subtable. 
  17577.  
  17578.  rc (ULONG) 
  17579.     Return code. 
  17580.  
  17581.     0 
  17582.             The procedure was successfully completed. 
  17583.     Other 
  17584.             See the values of the ulErrorCode parameter of the HM_ERROR 
  17585.             message. 
  17586.  
  17587.  
  17588. ΓòÉΓòÉΓòÉ <hidden> HM_LOAD_HELP_TABLE - Default Processing ΓòÉΓòÉΓòÉ
  17589.  
  17590. None. 
  17591.  
  17592.  
  17593. ΓòÉΓòÉΓòÉ <hidden> HM_LOAD_HELP_TABLE - Topics ΓòÉΓòÉΓòÉ
  17594.  
  17595. Select an item: 
  17596.  
  17597. Syntax
  17598. Parameters
  17599. Returns
  17600. Default Processing
  17601. Glossary
  17602.  
  17603.  
  17604. ΓòÉΓòÉΓòÉ 19.18. HM_NOTIFY ΓòÉΓòÉΓòÉ
  17605.  
  17606.  
  17607. ΓòÉΓòÉΓòÉ <hidden> HM_NOTIFY - Syntax ΓòÉΓòÉΓòÉ
  17608.  
  17609. This message is used by the application to sub-class and change the behavior or 
  17610. appearance of the help window. 
  17611.  
  17612.  
  17613. param1
  17614.     USHORT  controlres  /*  Res number of the control that was selected. */
  17615.     USHORT  usReserve   /*  Reserved value, should be 0. */
  17616.     USHORT  usevent     /*  The type of event which has occurred. */
  17617.  
  17618. param2
  17619.     ULONG   ulhwnd      /*  Window handle of relevant window. */
  17620.  
  17621. returns
  17622.     BOOL    rc          /*  Return code. */
  17623.  
  17624.  
  17625. ΓòÉΓòÉΓòÉ <hidden> HM_NOTIFY Field - controlres ΓòÉΓòÉΓòÉ
  17626.  
  17627.  controlres (USHORT) 
  17628.     Res number of the control that was selected. 
  17629.  
  17630.     For author-defined push buttons, this is the res number that was specified 
  17631.     with the push button tag (:pbutton.).  For default push buttons, this is 
  17632.     the res number defined in the PMHELP.H file. 
  17633.  
  17634.  
  17635. ΓòÉΓòÉΓòÉ <hidden> HM_NOTIFY Field - usReserve ΓòÉΓòÉΓòÉ
  17636.  
  17637.  usReserve (USHORT) 
  17638.     Reserved value, should be 0. 
  17639.  
  17640.     Reserved for events other than CONTROL_SELECTED and HELP_REQUESTED. 
  17641.  
  17642.  
  17643. ΓòÉΓòÉΓòÉ <hidden> HM_NOTIFY Field - usevent ΓòÉΓòÉΓòÉ
  17644.  
  17645.  usevent (USHORT) 
  17646.     The type of event which has occurred. 
  17647.  
  17648.     CONTROL_SELECTED                A control was selected. 
  17649.  
  17650.     HELP_REQUESTED                  Help was requested. 
  17651.  
  17652.     OPEN_COVERPAGE                  The coverpage is displayed. 
  17653.  
  17654.     OPEN_PAGE                       The child window of the coverpage is 
  17655.                                     opened. 
  17656.  
  17657.     SWAP_PAGE                       The child window of the coverpage is 
  17658.                                     swapped. 
  17659.  
  17660.     OPEN_INDEX                      The index window is displayed. 
  17661.  
  17662.     OPEN_TOC                        The table of contents window is displayed. 
  17663.  
  17664.     OPEN_HISTORY                    The history window is displayed. 
  17665.  
  17666.     OPEN_LIBRARY                    The new library is opened. 
  17667.  
  17668.     OPEN_SEARCH_HIT_LIST            The search list displayed. 
  17669.  
  17670.  
  17671. ΓòÉΓòÉΓòÉ <hidden> HM_NOTIFY Field - ulhwnd ΓòÉΓòÉΓòÉ
  17672.  
  17673.  ulhwnd (ULONG) 
  17674.     Window handle of relevant window. 
  17675.  
  17676.  
  17677. ΓòÉΓòÉΓòÉ <hidden> HM_NOTIFY Return Value - rc ΓòÉΓòÉΓòÉ
  17678.  
  17679.  rc (BOOL) 
  17680.     Return code. 
  17681.  
  17682.     TRUE 
  17683.             IPF will not format the controls and re-size the window. 
  17684.     FALSE 
  17685.             IPF will process as normal. 
  17686.  
  17687.  
  17688. ΓòÉΓòÉΓòÉ <hidden> HM_NOTIFY - Parameters ΓòÉΓòÉΓòÉ
  17689.  
  17690.  controlres (USHORT) 
  17691.     Res number of the control that was selected. 
  17692.  
  17693.     For author-defined push buttons, this is the res number that was specified 
  17694.     with the push button tag (:pbutton.).  For default push buttons, this is 
  17695.     the res number defined in the PMHELP.H file. 
  17696.  
  17697.  usReserve (USHORT) 
  17698.     Reserved value, should be 0. 
  17699.  
  17700.     Reserved for events other than CONTROL_SELECTED and HELP_REQUESTED. 
  17701.  
  17702.  usevent (USHORT) 
  17703.     The type of event which has occurred. 
  17704.  
  17705.     CONTROL_SELECTED                A control was selected. 
  17706.  
  17707.     HELP_REQUESTED                  Help was requested. 
  17708.  
  17709.     OPEN_COVERPAGE                  The coverpage is displayed. 
  17710.  
  17711.     OPEN_PAGE                       The child window of the coverpage is 
  17712.                                     opened. 
  17713.  
  17714.     SWAP_PAGE                       The child window of the coverpage is 
  17715.                                     swapped. 
  17716.  
  17717.     OPEN_INDEX                      The index window is displayed. 
  17718.  
  17719.     OPEN_TOC                        The table of contents window is displayed. 
  17720.  
  17721.     OPEN_HISTORY                    The history window is displayed. 
  17722.  
  17723.     OPEN_LIBRARY                    The new library is opened. 
  17724.  
  17725.     OPEN_SEARCH_HIT_LIST            The search list displayed. 
  17726.  
  17727.  ulhwnd (ULONG) 
  17728.     Window handle of relevant window. 
  17729.  
  17730.  rc (BOOL) 
  17731.     Return code. 
  17732.  
  17733.     TRUE 
  17734.             IPF will not format the controls and re-size the window. 
  17735.     FALSE 
  17736.             IPF will process as normal. 
  17737.  
  17738.  
  17739. ΓòÉΓòÉΓòÉ <hidden> HM_NOTIFY - Remarks ΓòÉΓòÉΓòÉ
  17740.  
  17741. This message is sent to the application to notify it of events that the 
  17742. application would be interested in controlling. 
  17743.  
  17744.  
  17745. ΓòÉΓòÉΓòÉ <hidden> HM_NOTIFY - Default Processing ΓòÉΓòÉΓòÉ
  17746.  
  17747. None. 
  17748.  
  17749.  
  17750. ΓòÉΓòÉΓòÉ <hidden> HM_NOTIFY - Topics ΓòÉΓòÉΓòÉ
  17751.  
  17752. Select an item: 
  17753.  
  17754. Syntax
  17755. Parameters
  17756. Returns
  17757. Remarks
  17758. Default Processing
  17759. Glossary
  17760.  
  17761.  
  17762. ΓòÉΓòÉΓòÉ 19.19. HM_QUERY ΓòÉΓòÉΓòÉ
  17763.  
  17764.  
  17765. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY - Syntax ΓòÉΓòÉΓòÉ
  17766.  
  17767. This message is sent to IPF by the application to request IPF-specific 
  17768. information, such as the current Instance handle, the active communication 
  17769. object window, the active window, or the group number of the current window. 
  17770.  
  17771.  
  17772. param1
  17773.     USHORT  usselectionid  /*  What is being requested. */
  17774.     USHORT  usmessageid    /*  Type of window queried. */
  17775.  
  17776. param2
  17777.     PVOID   pvoid          /*  Varies, depending on value selected above. */
  17778.  
  17779. returns
  17780.     ULONG   rc             /*  Return code. */
  17781.  
  17782.  
  17783. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY Field - usselectionid ΓòÉΓòÉΓòÉ
  17784.  
  17785.  usselectionid (USHORT) 
  17786.     What is being requested. 
  17787.  
  17788.     This parameter should be specified only if the query is for HMQW_VIEWPORT 
  17789.     and should otherwise be coded as NULL. 
  17790.  
  17791.     Specifies whether a res ID, ID number, or group number is being requested. 
  17792.     The value can be any of the following constants: 
  17793.  
  17794.     HMQVP_NUMBER 
  17795.                                   A pointer to a USHORT that holds the res ID 
  17796.                                   of the window. 
  17797.  
  17798.     HMQVP_NAME 
  17799.                                   A pointer to a null-terminated string that 
  17800.                                   holds the ID of the window. 
  17801.  
  17802.     HMQVP_GROUP 
  17803.                                   The group number of the window. 
  17804.  
  17805.  
  17806. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY Field - usmessageid ΓòÉΓòÉΓòÉ
  17807.  
  17808.  usmessageid (USHORT) 
  17809.     Type of window queried. 
  17810.  
  17811.     Specifies the type of window to query.  The value can be any of the 
  17812.     following constants: 
  17813.  
  17814.     HMQW_INDEX 
  17815.                                        The handle of the index window. 
  17816.     HMQW_TOC 
  17817.                                        The handle of the Table of Contents 
  17818.                                        window. 
  17819.     HMQW_SEARCH 
  17820.                                        The handle of the Search Hitlist window. 
  17821.     HMQW_VIEWEDPAGES 
  17822.                                        The handle of the Viewed Pages window. 
  17823.     HMQW_LIBRARY 
  17824.                                        The handle of the Library List window. 
  17825.     HMQW_OBJCOM_WINDOW 
  17826.                                        The handle of the active communication 
  17827.                                        window. 
  17828.     HMQW_INSTANCE 
  17829.                                        The handle of the help instance. 
  17830.     HMQW_COVERPAGE 
  17831.                                        The handle of the help manager multiple 
  17832.                                        document interface (MDI) parent window. 
  17833.                                        It is where the secondary windows are 
  17834.                                        contained within the parent window. 
  17835.     HMQW_VIEWPORT 
  17836.                                        The handle of the viewport window 
  17837.                                        specified in the low-order word of 
  17838.                                        param1 and in param2. 
  17839.  
  17840.                                        When HMQW_VIEWPORT is specified in 
  17841.                                        usmessageid, a value must be specified 
  17842.                                        in usselectionid to indicate whether a 
  17843.                                        res ID, ID number, or group number is 
  17844.                                        being requested. 
  17845.     HMQW_GROUP_VIEWPORT 
  17846.                                        The group number of the window whose 
  17847.                                        handle is specified in param2. 
  17848.     HMQW_RES_VIEWPORT 
  17849.                                        The res number of the window whose 
  17850.                                        handle is specified in param2. 
  17851.     HMQW_ACTIVEVIEWPORT 
  17852.                                        The handle of the currently active 
  17853.                                        window. 
  17854.     USERDATA 
  17855.                                        The previously stored user-data. 
  17856.  
  17857.  
  17858. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY Field - pvoid ΓòÉΓòÉΓòÉ
  17859.  
  17860.  pvoid (PVOID) 
  17861.     Varies, depending on value selected above. 
  17862.  
  17863.     param2 depends on the value of param1 usmessageid. 
  17864.  
  17865.     If param1 usmessageid is HMQW_VIEWPORT, then param2 is a pointer to the res 
  17866.     number, ID, or group ID. 
  17867.  
  17868.     If param1 usmessageid is HMQW_GROUP_VIEWPORT, then param2 is the handle of 
  17869.     the viewport for which the group number is assigned. 
  17870.  
  17871.     If param1 usmessageid is HMQW_RES_VIEWPORT, then param2 is the handle of 
  17872.     the viewport for which the res number is requested. 
  17873.  
  17874.  
  17875. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY Return Value - rc ΓòÉΓòÉΓòÉ
  17876.  
  17877.  rc (ULONG) 
  17878.     Return code. 
  17879.  
  17880.     0 
  17881.             The procedure was not successfully completed. 
  17882.  
  17883.     Other 
  17884.             The handle (HWND), group number (USHORT), or res number (USHORT) of 
  17885.             the window, or the user data (USHORT), depending on the value of 
  17886.             param1 usselectionid. 
  17887.  
  17888.  
  17889. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY - Parameters ΓòÉΓòÉΓòÉ
  17890.  
  17891.  usselectionid (USHORT) 
  17892.     What is being requested. 
  17893.  
  17894.     This parameter should be specified only if the query is for HMQW_VIEWPORT 
  17895.     and should otherwise be coded as NULL. 
  17896.  
  17897.     Specifies whether a res ID, ID number, or group number is being requested. 
  17898.     The value can be any of the following constants: 
  17899.  
  17900.     HMQVP_NUMBER 
  17901.                                   A pointer to a USHORT that holds the res ID 
  17902.                                   of the window. 
  17903.  
  17904.     HMQVP_NAME 
  17905.                                   A pointer to a null-terminated string that 
  17906.                                   holds the ID of the window. 
  17907.  
  17908.     HMQVP_GROUP 
  17909.                                   The group number of the window. 
  17910.  
  17911.  usmessageid (USHORT) 
  17912.     Type of window queried. 
  17913.  
  17914.     Specifies the type of window to query.  The value can be any of the 
  17915.     following constants: 
  17916.  
  17917.     HMQW_INDEX 
  17918.                                        The handle of the index window. 
  17919.     HMQW_TOC 
  17920.                                        The handle of the Table of Contents 
  17921.                                        window. 
  17922.     HMQW_SEARCH 
  17923.                                        The handle of the Search Hitlist window. 
  17924.     HMQW_VIEWEDPAGES 
  17925.                                        The handle of the Viewed Pages window. 
  17926.     HMQW_LIBRARY 
  17927.                                        The handle of the Library List window. 
  17928.     HMQW_OBJCOM_WINDOW 
  17929.                                        The handle of the active communication 
  17930.                                        window. 
  17931.     HMQW_INSTANCE 
  17932.                                        The handle of the help instance. 
  17933.     HMQW_COVERPAGE 
  17934.                                        The handle of the help manager multiple 
  17935.                                        document interface (MDI) parent window. 
  17936.                                        It is where the secondary windows are 
  17937.                                        contained within the parent window. 
  17938.     HMQW_VIEWPORT 
  17939.                                        The handle of the viewport window 
  17940.                                        specified in the low-order word of 
  17941.                                        param1 and in param2. 
  17942.  
  17943.                                        When HMQW_VIEWPORT is specified in 
  17944.                                        usmessageid, a value must be specified 
  17945.                                        in usselectionid to indicate whether a 
  17946.                                        res ID, ID number, or group number is 
  17947.                                        being requested. 
  17948.     HMQW_GROUP_VIEWPORT 
  17949.                                        The group number of the window whose 
  17950.                                        handle is specified in param2. 
  17951.     HMQW_RES_VIEWPORT 
  17952.                                        The res number of the window whose 
  17953.                                        handle is specified in param2. 
  17954.     HMQW_ACTIVEVIEWPORT 
  17955.                                        The handle of the currently active 
  17956.                                        window. 
  17957.     USERDATA 
  17958.                                        The previously stored user-data. 
  17959.  
  17960.  pvoid (PVOID) 
  17961.     Varies, depending on value selected above. 
  17962.  
  17963.     param2 depends on the value of param1 usmessageid. 
  17964.  
  17965.     If param1 usmessageid is HMQW_VIEWPORT, then param2 is a pointer to the res 
  17966.     number, ID, or group ID. 
  17967.  
  17968.     If param1 usmessageid is HMQW_GROUP_VIEWPORT, then param2 is the handle of 
  17969.     the viewport for which the group number is assigned. 
  17970.  
  17971.     If param1 usmessageid is HMQW_RES_VIEWPORT, then param2 is the handle of 
  17972.     the viewport for which the res number is requested. 
  17973.  
  17974.  rc (ULONG) 
  17975.     Return code. 
  17976.  
  17977.     0 
  17978.             The procedure was not successfully completed. 
  17979.  
  17980.     Other 
  17981.             The handle (HWND), group number (USHORT), or res number (USHORT) of 
  17982.             the window, or the user data (USHORT), depending on the value of 
  17983.             param1 usselectionid. 
  17984.  
  17985.  
  17986. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY - Default Processing ΓòÉΓòÉΓòÉ
  17987.  
  17988. None. 
  17989.  
  17990.  
  17991. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY - Topics ΓòÉΓòÉΓòÉ
  17992.  
  17993. Select an item: 
  17994.  
  17995. Syntax
  17996. Parameters
  17997. Returns
  17998. Default Processing
  17999. Glossary
  18000.  
  18001.  
  18002. ΓòÉΓòÉΓòÉ 19.20. HM_QUERY_DDF_DATA ΓòÉΓòÉΓòÉ
  18003.  
  18004.  
  18005. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY_DDF_DATA - Syntax ΓòÉΓòÉΓòÉ
  18006.  
  18007. This message is sent to the communication object window by IPF when it 
  18008. encounters the dynamic data formatting (:ddf.) tag. 
  18009.  
  18010.  
  18011. param1
  18012.     HWND   pageclienthwnd  /*  Client handle. */
  18013.  
  18014. param2
  18015.     ULONG  resid           /*  The res ID associated with the DDF tag. */
  18016.  
  18017. returns
  18018.     HDDF   rc              /*  Return code. */
  18019.  
  18020.  
  18021. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY_DDF_DATA Field - pageclienthwnd ΓòÉΓòÉΓòÉ
  18022.  
  18023.  pageclienthwnd (HWND) 
  18024.     Client handle. 
  18025.  
  18026.     The client handle of the page that contains the object communication 
  18027.     window. 
  18028.  
  18029.  
  18030. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY_DDF_DATA Field - resid ΓòÉΓòÉΓòÉ
  18031.  
  18032.  resid (ULONG) 
  18033.     The res ID associated with the DDF tag. 
  18034.  
  18035.  
  18036. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY_DDF_DATA Return Value - rc ΓòÉΓòÉΓòÉ
  18037.  
  18038.  rc (HDDF) 
  18039.     Return code. 
  18040.  
  18041.     0 
  18042.             An error has occurred in the application's DDF processing. 
  18043.  
  18044.     Other 
  18045.             The DDF handle to be displayed. 
  18046.  
  18047.             Note:  Once this handle has been returned, the HDDF handle can no 
  18048.                    longer be used by the application. 
  18049.  
  18050.  
  18051. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY_DDF_DATA - Parameters ΓòÉΓòÉΓòÉ
  18052.  
  18053.  pageclienthwnd (HWND) 
  18054.     Client handle. 
  18055.  
  18056.     The client handle of the page that contains the object communication 
  18057.     window. 
  18058.  
  18059.  resid (ULONG) 
  18060.     The res ID associated with the DDF tag. 
  18061.  
  18062.  rc (HDDF) 
  18063.     Return code. 
  18064.  
  18065.     0 
  18066.             An error has occurred in the application's DDF processing. 
  18067.  
  18068.     Other 
  18069.             The DDF handle to be displayed. 
  18070.  
  18071.             Note:  Once this handle has been returned, the HDDF handle can no 
  18072.                    longer be used by the application. 
  18073.  
  18074.  
  18075. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY_DDF_DATA - Remarks ΓòÉΓòÉΓòÉ
  18076.  
  18077. Upon receiving this message, the communication object calls DdfInitialize to 
  18078. indicate the start of dynamic data formatting (DDF).  Any combination of other 
  18079. DDF calls are then made to describe this data.  When this is complete, the 
  18080. communication object finishes processing this message, indicating that the DDF 
  18081. data is complete.  After that time, the DDF handle received from DdfInitialize 
  18082. is considered invalid. 
  18083.  
  18084.  
  18085. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY_DDF_DATA - Default Processing ΓòÉΓòÉΓòÉ
  18086.  
  18087. None. 
  18088.  
  18089.  
  18090. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY_DDF_DATA - Topics ΓòÉΓòÉΓòÉ
  18091.  
  18092. Select an item: 
  18093.  
  18094. Syntax
  18095. Parameters
  18096. Returns
  18097. Remarks
  18098. Default Processing
  18099. Glossary
  18100.  
  18101.  
  18102. ΓòÉΓòÉΓòÉ 19.21. HM_QUERY_KEYS_HELP ΓòÉΓòÉΓòÉ
  18103.  
  18104.  
  18105. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY_KEYS_HELP - Syntax ΓòÉΓòÉΓòÉ
  18106.  
  18107. When the user requests the keys help function, the Help Manager sends this 
  18108. message to the application. 
  18109.  
  18110.  
  18111. param1
  18112.     ULONG   ulReserved   /*  Reserved value, should be 0. */
  18113.  
  18114. param2
  18115.     ULONG   ulReserved   /*  Reserved value, should be 0. */
  18116.  
  18117. returns
  18118.     USHORT  usHelpPanel  /*  Help panel ID. */
  18119.  
  18120.  
  18121. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY_KEYS_HELP Field - ulReserved ΓòÉΓòÉΓòÉ
  18122.  
  18123.  ulReserved (ULONG) 
  18124.     Reserved value, should be 0. 
  18125.  
  18126.  
  18127. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY_KEYS_HELP Field - ulReserved ΓòÉΓòÉΓòÉ
  18128.  
  18129.  ulReserved (ULONG) 
  18130.     Reserved value, should be 0. 
  18131.  
  18132.  
  18133. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY_KEYS_HELP Return Value - usHelpPanel ΓòÉΓòÉΓòÉ
  18134.  
  18135.  usHelpPanel (USHORT) 
  18136.     Help panel ID. 
  18137.  
  18138.     The identity of the application-defined keys help window to be displayed. 
  18139.  
  18140.     0 
  18141.             Do nothing 
  18142.     Other 
  18143.             Identity of the keys help window to be displayed. 
  18144.  
  18145.  
  18146. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY_KEYS_HELP - Parameters ΓòÉΓòÉΓòÉ
  18147.  
  18148.  ulReserved (ULONG) 
  18149.     Reserved value, should be 0. 
  18150.  
  18151.  ulReserved (ULONG) 
  18152.     Reserved value, should be 0. 
  18153.  
  18154.  usHelpPanel (USHORT) 
  18155.     Help panel ID. 
  18156.  
  18157.     The identity of the application-defined keys help window to be displayed. 
  18158.  
  18159.     0 
  18160.             Do nothing 
  18161.     Other 
  18162.             Identity of the keys help window to be displayed. 
  18163.  
  18164.  
  18165. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY_KEYS_HELP - Remarks ΓòÉΓòÉΓòÉ
  18166.  
  18167. The application responds by returning the identity of the requested keys help 
  18168. window. The Help Manager then displays that help window. Returning 0 in the 
  18169. usHelpPanel parameter indicates that the Help Manager should do nothing for the 
  18170. keys help function. 
  18171.  
  18172.  
  18173. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY_KEYS_HELP - Default Processing ΓòÉΓòÉΓòÉ
  18174.  
  18175. None. 
  18176.  
  18177.  
  18178. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY_KEYS_HELP - Topics ΓòÉΓòÉΓòÉ
  18179.  
  18180. Select an item: 
  18181.  
  18182. Syntax
  18183. Parameters
  18184. Returns
  18185. Remarks
  18186. Default Processing
  18187. Glossary
  18188.  
  18189.  
  18190. ΓòÉΓòÉΓòÉ 19.22. HM_REPLACE_HELP_FOR_HELP ΓòÉΓòÉΓòÉ
  18191.  
  18192.  
  18193. ΓòÉΓòÉΓòÉ <hidden> HM_REPLACE_HELP_FOR_HELP - Syntax ΓòÉΓòÉΓòÉ
  18194.  
  18195. This message tells the Help Manager to display the application-defined Help for 
  18196. Help window instead of the Help Manager Help for Help window. 
  18197.  
  18198.  
  18199. param1
  18200.     USHORT  idHelpForHelpPanel  /*  Identity of the application-defined Help for Help window. */
  18201.  
  18202. param2
  18203.     ULONG   ulReserved          /*  Reserved value, should be 0. */
  18204.  
  18205. returns
  18206.     ULONG   ulReserved          /*  Reserved value, should be 0. */
  18207.  
  18208.  
  18209. ΓòÉΓòÉΓòÉ <hidden> HM_REPLACE_HELP_FOR_HELP Field - idHelpForHelpPanel ΓòÉΓòÉΓòÉ
  18210.  
  18211.  idHelpForHelpPanel (USHORT) 
  18212.     Identity of the application-defined Help for Help window. 
  18213.  
  18214.     0 
  18215.             Use the Help Manager Help for Help window. 
  18216.     Other 
  18217.             Identity of the application-defined Help for Help window. 
  18218.  
  18219.  
  18220. ΓòÉΓòÉΓòÉ <hidden> HM_REPLACE_HELP_FOR_HELP Field - ulReserved ΓòÉΓòÉΓòÉ
  18221.  
  18222.  ulReserved (ULONG) 
  18223.     Reserved value, should be 0. 
  18224.  
  18225.  
  18226. ΓòÉΓòÉΓòÉ <hidden> HM_REPLACE_HELP_FOR_HELP Return Value - ulReserved ΓòÉΓòÉΓòÉ
  18227.  
  18228.  ulReserved (ULONG) 
  18229.     Reserved value, should be 0. 
  18230.  
  18231.  
  18232. ΓòÉΓòÉΓòÉ <hidden> HM_REPLACE_HELP_FOR_HELP - Parameters ΓòÉΓòÉΓòÉ
  18233.  
  18234.  idHelpForHelpPanel (USHORT) 
  18235.     Identity of the application-defined Help for Help window. 
  18236.  
  18237.     0 
  18238.             Use the Help Manager Help for Help window. 
  18239.     Other 
  18240.             Identity of the application-defined Help for Help window. 
  18241.  
  18242.  ulReserved (ULONG) 
  18243.     Reserved value, should be 0. 
  18244.  
  18245.  ulReserved (ULONG) 
  18246.     Reserved value, should be 0. 
  18247.  
  18248.  
  18249. ΓòÉΓòÉΓòÉ <hidden> HM_REPLACE_HELP_FOR_HELP - Remarks ΓòÉΓòÉΓòÉ
  18250.  
  18251. An application may prefer to provide information that is more specific to 
  18252. itself, rather than the more general help information provided in the Help 
  18253. Manager Help for Help window. 
  18254.  
  18255.  
  18256. ΓòÉΓòÉΓòÉ <hidden> HM_REPLACE_HELP_FOR_HELP - Default Processing ΓòÉΓòÉΓòÉ
  18257.  
  18258. None. 
  18259.  
  18260.  
  18261. ΓòÉΓòÉΓòÉ <hidden> HM_REPLACE_HELP_FOR_HELP - Topics ΓòÉΓòÉΓòÉ
  18262.  
  18263. Select an item: 
  18264.  
  18265. Syntax
  18266. Parameters
  18267. Returns
  18268. Remarks
  18269. Default Processing
  18270. Glossary
  18271.  
  18272.  
  18273. ΓòÉΓòÉΓòÉ 19.23. HM_REPLACE_USING_HELP ΓòÉΓòÉΓòÉ
  18274.  
  18275.  
  18276. ΓòÉΓòÉΓòÉ <hidden> HM_REPLACE_USING_HELP - Syntax ΓòÉΓòÉΓòÉ
  18277.  
  18278. This message tells the Help Manager to display the application-defined Using 
  18279. help window instead of the Help Manager Using help window. 
  18280.  
  18281.  
  18282. param1
  18283.     USHORT  idUsingHelpPanel
  18284.  
  18285. param2
  18286.     ULONG   ulReserved        /*  Reserved value, should be 0. */
  18287.  
  18288. returns
  18289.     ULONG   ulReserved        /*  Reserved value, should be 0. */
  18290.  
  18291.  
  18292. ΓòÉΓòÉΓòÉ <hidden> HM_REPLACE_USING_HELP Field - idUsingHelpPanel ΓòÉΓòÉΓòÉ
  18293.  
  18294.  idUsingHelpPanel (USHORT) 
  18295.     The identity of the application-defined Using Help window. 
  18296.  
  18297.     0 
  18298.             Use the Help Manager Using Help window. 
  18299.     Other 
  18300.             The identity of the application-defined Using Help window. 
  18301.  
  18302.  
  18303. ΓòÉΓòÉΓòÉ <hidden> HM_REPLACE_USING_HELP Field - ulReserved ΓòÉΓòÉΓòÉ
  18304.  
  18305.  ulReserved (ULONG) 
  18306.     Reserved value, should be 0. 
  18307.  
  18308.  
  18309. ΓòÉΓòÉΓòÉ <hidden> HM_REPLACE_USING_HELP Return Value - ulReserved ΓòÉΓòÉΓòÉ
  18310.  
  18311.  ulReserved (ULONG) 
  18312.     Reserved value, should be 0. 
  18313.  
  18314.  
  18315. ΓòÉΓòÉΓòÉ <hidden> HM_REPLACE_USING_HELP - Parameters ΓòÉΓòÉΓòÉ
  18316.  
  18317.  idUsingHelpPanel (USHORT) 
  18318.     The identity of the application-defined Using Help window. 
  18319.  
  18320.     0 
  18321.             Use the Help Manager Using Help window. 
  18322.     Other 
  18323.             The identity of the application-defined Using Help window. 
  18324.  
  18325.  ulReserved (ULONG) 
  18326.     Reserved value, should be 0. 
  18327.  
  18328.  ulReserved (ULONG) 
  18329.     Reserved value, should be 0. 
  18330.  
  18331.  
  18332. ΓòÉΓòÉΓòÉ <hidden> HM_REPLACE_USING_HELP - Remarks ΓòÉΓòÉΓòÉ
  18333.  
  18334. An application may prefer to provide information that is more specific to 
  18335. itself, rather than the more general help information that is provided in the 
  18336. Help Manager Using help window.  The guidelines that define the current CUA 
  18337. interface recommend the Using help choice be provided in a pull-down menu from 
  18338. the Help choice. 
  18339.  
  18340.  
  18341. ΓòÉΓòÉΓòÉ <hidden> HM_REPLACE_USING_HELP - Default Processing ΓòÉΓòÉΓòÉ
  18342.  
  18343. None. 
  18344.  
  18345.  
  18346. ΓòÉΓòÉΓòÉ <hidden> HM_REPLACE_USING_HELP - Topics ΓòÉΓòÉΓòÉ
  18347.  
  18348. Select an item: 
  18349.  
  18350. Syntax
  18351. Parameters
  18352. Returns
  18353. Remarks
  18354. Default Processing
  18355. Glossary
  18356.  
  18357.  
  18358. ΓòÉΓòÉΓòÉ 19.24. HM_SET_ACTIVE_WINDOW ΓòÉΓòÉΓòÉ
  18359.  
  18360.  
  18361. ΓòÉΓòÉΓòÉ <hidden> HM_SET_ACTIVE_WINDOW - Syntax ΓòÉΓòÉΓòÉ
  18362.  
  18363. This message allows the application to change the window with which the Help 
  18364. Manager communicates and the window to which the help window is to be 
  18365. positioned. 
  18366.  
  18367.  
  18368. param1
  18369.     HWND   hwndActiveWindow    /*  The handle of the window to be made active. */
  18370.  
  18371. param2
  18372.     HWND   hwndRelativeWindow  /*  The handle of the window next to which the help window is to be positioned. */
  18373.  
  18374. returns
  18375.     ULONG  rc                  /*  Return code. */
  18376.  
  18377.  
  18378. ΓòÉΓòÉΓòÉ <hidden> HM_SET_ACTIVE_WINDOW Field - hwndActiveWindow ΓòÉΓòÉΓòÉ
  18379.  
  18380.  hwndActiveWindow (HWND) 
  18381.     The handle of the window to be made active. 
  18382.  
  18383.     Its window procedure receives all messages from the Help Manager until the 
  18384.     application changes the active window with another HM_SET_ACTIVE_WINDOW 
  18385.     message. 
  18386.  
  18387.  
  18388. ΓòÉΓòÉΓòÉ <hidden> HM_SET_ACTIVE_WINDOW Field - hwndRelativeWindow ΓòÉΓòÉΓòÉ
  18389.  
  18390.  hwndRelativeWindow (HWND) 
  18391.     The handle of the window next to which the help window is to be positioned. 
  18392.  
  18393.     The handle of the application window next to which the Help Manager will 
  18394.     position a new help window. 
  18395.  
  18396.     HWND_PARENT 
  18397.             This Help Manager defined constant tells the Help Manager to trace 
  18398.             the parent chain of the window that had the focus when the user 
  18399.             requested help. 
  18400.  
  18401.     Other 
  18402.             Handle of the window next to which the help window is to be 
  18403.             positioned. 
  18404.  
  18405.  
  18406. ΓòÉΓòÉΓòÉ <hidden> HM_SET_ACTIVE_WINDOW Return Value - rc ΓòÉΓòÉΓòÉ
  18407.  
  18408.  rc (ULONG) 
  18409.     Return code. 
  18410.  
  18411.     0 
  18412.             The procedure has been successfully completed. 
  18413.     Other 
  18414.             See the values of the ulErrorCode parameter of the HM_ERROR 
  18415.             message. 
  18416.  
  18417.  
  18418. ΓòÉΓòÉΓòÉ <hidden> HM_SET_ACTIVE_WINDOW - Parameters ΓòÉΓòÉΓòÉ
  18419.  
  18420.  hwndActiveWindow (HWND) 
  18421.     The handle of the window to be made active. 
  18422.  
  18423.     Its window procedure receives all messages from the Help Manager until the 
  18424.     application changes the active window with another HM_SET_ACTIVE_WINDOW 
  18425.     message. 
  18426.  
  18427.  hwndRelativeWindow (HWND) 
  18428.     The handle of the window next to which the help window is to be positioned. 
  18429.  
  18430.     The handle of the application window next to which the Help Manager will 
  18431.     position a new help window. 
  18432.  
  18433.     HWND_PARENT 
  18434.             This Help Manager defined constant tells the Help Manager to trace 
  18435.             the parent chain of the window that had the focus when the user 
  18436.             requested help. 
  18437.  
  18438.     Other 
  18439.             Handle of the window next to which the help window is to be 
  18440.             positioned. 
  18441.  
  18442.  rc (ULONG) 
  18443.     Return code. 
  18444.  
  18445.     0 
  18446.             The procedure has been successfully completed. 
  18447.     Other 
  18448.             See the values of the ulErrorCode parameter of the HM_ERROR 
  18449.             message. 
  18450.  
  18451.  
  18452. ΓòÉΓòÉΓòÉ <hidden> HM_SET_ACTIVE_WINDOW - Remarks ΓòÉΓòÉΓòÉ
  18453.  
  18454. Normally the Help Manager communicates with the application window with which 
  18455. the Help Manager instance has been associated. The help window is positioned 
  18456. next to this same application window. 
  18457.  
  18458. If the hwndActiveWindow parameter is 0, the hwndRelativeWindow parameter is set 
  18459. to 0. That is, if the active window is NULL HANDLE, the relative window is not 
  18460. used. 
  18461.  
  18462.  
  18463. ΓòÉΓòÉΓòÉ <hidden> HM_SET_ACTIVE_WINDOW - Default Processing ΓòÉΓòÉΓòÉ
  18464.  
  18465. None. 
  18466.  
  18467.  
  18468. ΓòÉΓòÉΓòÉ <hidden> HM_SET_ACTIVE_WINDOW - Topics ΓòÉΓòÉΓòÉ
  18469.  
  18470. Select an item: 
  18471.  
  18472. Syntax
  18473. Parameters
  18474. Returns
  18475. Remarks
  18476. Default Processing
  18477. Glossary
  18478.  
  18479.  
  18480. ΓòÉΓòÉΓòÉ 19.25. HM_SET_COVERPAGE_SIZE ΓòÉΓòÉΓòÉ
  18481.  
  18482.  
  18483. ΓòÉΓòÉΓòÉ <hidden> HM_SET_COVERPAGE_SIZE - Syntax ΓòÉΓòÉΓòÉ
  18484.  
  18485. This message is sent to IPF by the application to set the size of the 
  18486. coverpage, the window within which all other IPF windows are displayed. 
  18487.  
  18488.  
  18489. param1
  18490.     PRECTL  coverpagerectl  /*  Pointer to RECTL containing the size of the coverpage. */
  18491.  
  18492. param2
  18493.     ULONG   ulReserved      /*  Reserved value, should be 0. */
  18494.  
  18495. returns
  18496.     ULONG   rc              /*  Return code. */
  18497.  
  18498.  
  18499. ΓòÉΓòÉΓòÉ <hidden> HM_SET_COVERPAGE_SIZE Field - coverpagerectl ΓòÉΓòÉΓòÉ
  18500.  
  18501.  coverpagerectl (PRECTL) 
  18502.     Pointer to RECTL containing the size of the coverpage. 
  18503.  
  18504.  
  18505. ΓòÉΓòÉΓòÉ <hidden> HM_SET_COVERPAGE_SIZE Field - ulReserved ΓòÉΓòÉΓòÉ
  18506.  
  18507.  ulReserved (ULONG) 
  18508.     Reserved value, should be 0. 
  18509.  
  18510.  
  18511. ΓòÉΓòÉΓòÉ <hidden> HM_SET_COVERPAGE_SIZE Return Value - rc ΓòÉΓòÉΓòÉ
  18512.  
  18513.  rc (ULONG) 
  18514.     Return code. 
  18515.  
  18516.     0 
  18517.             The procedure was successfully completed. 
  18518.     Other 
  18519.             See the values of the errorcode parameter of the HM_ERROR message. 
  18520.  
  18521.  
  18522. ΓòÉΓòÉΓòÉ <hidden> HM_SET_COVERPAGE_SIZE - Parameters ΓòÉΓòÉΓòÉ
  18523.  
  18524.  coverpagerectl (PRECTL) 
  18525.     Pointer to RECTL containing the size of the coverpage. 
  18526.  
  18527.  ulReserved (ULONG) 
  18528.     Reserved value, should be 0. 
  18529.  
  18530.  rc (ULONG) 
  18531.     Return code. 
  18532.  
  18533.     0 
  18534.             The procedure was successfully completed. 
  18535.     Other 
  18536.             See the values of the errorcode parameter of the HM_ERROR message. 
  18537.  
  18538.  
  18539. ΓòÉΓòÉΓòÉ <hidden> HM_SET_COVERPAGE_SIZE - Remarks ΓòÉΓòÉΓòÉ
  18540.  
  18541. The default size for the coverpage of a book is the full width of the screen, 
  18542. while the default size for a help file is one-half the width of the screen. 
  18543.  
  18544. This message takes effect immediately, changing the size of the coverpage.  If 
  18545. the coverpage is not currently open, the requested size is saved for the next 
  18546. open. 
  18547.  
  18548.  
  18549. ΓòÉΓòÉΓòÉ <hidden> HM_SET_COVERPAGE_SIZE - Default Processing ΓòÉΓòÉΓòÉ
  18550.  
  18551. None. 
  18552.  
  18553.  
  18554. ΓòÉΓòÉΓòÉ <hidden> HM_SET_COVERPAGE_SIZE - Topics ΓòÉΓòÉΓòÉ
  18555.  
  18556. Select an item: 
  18557.  
  18558. Syntax
  18559. Parameters
  18560. Returns
  18561. Remarks
  18562. Default Processing
  18563. Glossary
  18564.  
  18565.  
  18566. ΓòÉΓòÉΓòÉ 19.26. HM_SET_HELP_LIBRARY_NAME ΓòÉΓòÉΓòÉ
  18567.  
  18568.  
  18569. ΓòÉΓòÉΓòÉ <hidden> HM_SET_HELP_LIBRARY_NAME - Syntax ΓòÉΓòÉΓòÉ
  18570.  
  18571. This message identifies a list of help window library names to the Help Manager 
  18572. instance. 
  18573.  
  18574.  
  18575. param1
  18576.     PSZ    pszHelpLibraryName  /*  Library name. */
  18577.  
  18578. param2
  18579.     ULONG  ulReserved          /*  Reserved value, should be 0. */
  18580.  
  18581. returns
  18582.     ULONG  rc                  /*  Return code. */
  18583.  
  18584.  
  18585. ΓòÉΓòÉΓòÉ <hidden> HM_SET_HELP_LIBRARY_NAME Field - pszHelpLibraryName ΓòÉΓòÉΓòÉ
  18586.  
  18587.  pszHelpLibraryName (PSZ) 
  18588.     Library name. 
  18589.  
  18590.     This points to a string that contains a list of help window library names 
  18591.     that will be searched by the Help Manager for the requested help window. 
  18592.     The names must be separated by a blank. 
  18593.  
  18594.  
  18595. ΓòÉΓòÉΓòÉ <hidden> HM_SET_HELP_LIBRARY_NAME Field - ulReserved ΓòÉΓòÉΓòÉ
  18596.  
  18597.  ulReserved (ULONG) 
  18598.     Reserved value, should be 0. 
  18599.  
  18600.  
  18601. ΓòÉΓòÉΓòÉ <hidden> HM_SET_HELP_LIBRARY_NAME Return Value - rc ΓòÉΓòÉΓòÉ
  18602.  
  18603.  rc (ULONG) 
  18604.     Return code. 
  18605.  
  18606.     0 
  18607.             The newly specified library successfully replaced the current help 
  18608.             window library name. 
  18609.     Other 
  18610.             See the values of the ulErrorCode parameter of the HM_ERROR 
  18611.             message. 
  18612.  
  18613.  
  18614. ΓòÉΓòÉΓòÉ <hidden> HM_SET_HELP_LIBRARY_NAME - Parameters ΓòÉΓòÉΓòÉ
  18615.  
  18616.  pszHelpLibraryName (PSZ) 
  18617.     Library name. 
  18618.  
  18619.     This points to a string that contains a list of help window library names 
  18620.     that will be searched by the Help Manager for the requested help window. 
  18621.     The names must be separated by a blank. 
  18622.  
  18623.  ulReserved (ULONG) 
  18624.     Reserved value, should be 0. 
  18625.  
  18626.  rc (ULONG) 
  18627.     Return code. 
  18628.  
  18629.     0 
  18630.             The newly specified library successfully replaced the current help 
  18631.             window library name. 
  18632.     Other 
  18633.             See the values of the ulErrorCode parameter of the HM_ERROR 
  18634.             message. 
  18635.  
  18636.  
  18637. ΓòÉΓòÉΓòÉ <hidden> HM_SET_HELP_LIBRARY_NAME - Remarks ΓòÉΓòÉΓòÉ
  18638.  
  18639. Any subsequent communication to the Help Manager with this message replaces the 
  18640. current list of names with the newly specified list. 
  18641.  
  18642. When help is requested, the Help Manager will search each library in the list 
  18643. for the requested help window. 
  18644.  
  18645.  
  18646. ΓòÉΓòÉΓòÉ <hidden> HM_SET_HELP_LIBRARY_NAME - Default Processing ΓòÉΓòÉΓòÉ
  18647.  
  18648. None. 
  18649.  
  18650.  
  18651. ΓòÉΓòÉΓòÉ <hidden> HM_SET_HELP_LIBRARY_NAME - Topics ΓòÉΓòÉΓòÉ
  18652.  
  18653. Select an item: 
  18654.  
  18655. Syntax
  18656. Parameters
  18657. Returns
  18658. Remarks
  18659. Default Processing
  18660. Glossary
  18661.  
  18662.  
  18663. ΓòÉΓòÉΓòÉ 19.27. HM_SET_HELP_WINDOW_TITLE ΓòÉΓòÉΓòÉ
  18664.  
  18665.  
  18666. ΓòÉΓòÉΓòÉ <hidden> HM_SET_HELP_WINDOW_TITLE - Syntax ΓòÉΓòÉΓòÉ
  18667.  
  18668. This message allows the application to change the window text of a help window 
  18669. title. 
  18670.  
  18671.  
  18672. param1
  18673.     PSZ    pszHelpWindowTitle  /*  Help window title. */
  18674.  
  18675. param2
  18676.     ULONG  ulReserved          /*  Reserved value, should be 0. */
  18677.  
  18678. returns
  18679.     ULONG  rc                  /*  Return code. */
  18680.  
  18681.  
  18682. ΓòÉΓòÉΓòÉ <hidden> HM_SET_HELP_WINDOW_TITLE Field - pszHelpWindowTitle ΓòÉΓòÉΓòÉ
  18683.  
  18684.  pszHelpWindowTitle (PSZ) 
  18685.     Help window title. 
  18686.  
  18687.     This points to a string containing the new Help Window title. 
  18688.  
  18689.  
  18690. ΓòÉΓòÉΓòÉ <hidden> HM_SET_HELP_WINDOW_TITLE Field - ulReserved ΓòÉΓòÉΓòÉ
  18691.  
  18692.  ulReserved (ULONG) 
  18693.     Reserved value, should be 0. 
  18694.  
  18695.  
  18696. ΓòÉΓòÉΓòÉ <hidden> HM_SET_HELP_WINDOW_TITLE Return Value - rc ΓòÉΓòÉΓòÉ
  18697.  
  18698.  rc (ULONG) 
  18699.     Return code. 
  18700.  
  18701.     0 
  18702.             The window title was successfully set. 
  18703.     Other 
  18704.             See the values of the ulErrorCode parameter of the HM_ERROR 
  18705.             message. 
  18706.  
  18707.  
  18708. ΓòÉΓòÉΓòÉ <hidden> HM_SET_HELP_WINDOW_TITLE - Parameters ΓòÉΓòÉΓòÉ
  18709.  
  18710.  pszHelpWindowTitle (PSZ) 
  18711.     Help window title. 
  18712.  
  18713.     This points to a string containing the new Help Window title. 
  18714.  
  18715.  ulReserved (ULONG) 
  18716.     Reserved value, should be 0. 
  18717.  
  18718.  rc (ULONG) 
  18719.     Return code. 
  18720.  
  18721.     0 
  18722.             The window title was successfully set. 
  18723.     Other 
  18724.             See the values of the ulErrorCode parameter of the HM_ERROR 
  18725.             message. 
  18726.  
  18727.  
  18728. ΓòÉΓòÉΓòÉ <hidden> HM_SET_HELP_WINDOW_TITLE - Default Processing ΓòÉΓòÉΓòÉ
  18729.  
  18730. None. 
  18731.  
  18732.  
  18733. ΓòÉΓòÉΓòÉ <hidden> HM_SET_HELP_WINDOW_TITLE - Topics ΓòÉΓòÉΓòÉ
  18734.  
  18735. Select an item: 
  18736.  
  18737. Syntax
  18738. Parameters
  18739. Returns
  18740. Default Processing
  18741. Glossary
  18742.  
  18743.  
  18744. ΓòÉΓòÉΓòÉ 19.28. HM_SET_OBJCOM_WINDOW ΓòÉΓòÉΓòÉ
  18745.  
  18746.  
  18747. ΓòÉΓòÉΓòÉ <hidden> HM_SET_OBJCOM_WINDOW - Syntax ΓòÉΓòÉΓòÉ
  18748.  
  18749. This message is sent to IPF by the application to identify the communication 
  18750. object window to which the HM_INFORM and HM_QUERY_DDF_DATA messages will be 
  18751. sent.  This message is not necessary if the communication object does not 
  18752. expect to receive either of these messages. 
  18753.  
  18754.  
  18755. hwndparam1
  18756.     HWND   objcomhwnd        /*  Handle of the communication object window to be set. */
  18757.  
  18758. param2
  18759.     ULONG  ulReserved        /*  Reserved value, should be 0. */
  18760.  
  18761. returns
  18762.     HWND   hwndprevioushwnd  /*  The handle of the previous communication object window. */
  18763.  
  18764.  
  18765. ΓòÉΓòÉΓòÉ <hidden> HM_SET_OBJCOM_WINDOW Field - objcomhwnd ΓòÉΓòÉΓòÉ
  18766.  
  18767.  objcomhwnd (HWND) 
  18768.     Handle of the communication object window to be set. 
  18769.  
  18770.  
  18771. ΓòÉΓòÉΓòÉ <hidden> HM_SET_OBJCOM_WINDOW Field - ulReserved ΓòÉΓòÉΓòÉ
  18772.  
  18773.  ulReserved (ULONG) 
  18774.     Reserved value, should be 0. 
  18775.  
  18776.  
  18777. ΓòÉΓòÉΓòÉ <hidden> HM_SET_OBJCOM_WINDOW Return Value - hwndprevioushwnd ΓòÉΓòÉΓòÉ
  18778.  
  18779.  hwndprevioushwnd (HWND) 
  18780.     The handle of the previous communication object window. 
  18781.  
  18782.  
  18783. ΓòÉΓòÉΓòÉ <hidden> HM_SET_OBJCOM_WINDOW - Parameters ΓòÉΓòÉΓòÉ
  18784.  
  18785.  objcomhwnd (HWND) 
  18786.     Handle of the communication object window to be set. 
  18787.  
  18788.  ulReserved (ULONG) 
  18789.     Reserved value, should be 0. 
  18790.  
  18791.  hwndprevioushwnd (HWND) 
  18792.     The handle of the previous communication object window. 
  18793.  
  18794.  
  18795. ΓòÉΓòÉΓòÉ <hidden> HM_SET_OBJCOM_WINDOW - Remarks ΓòÉΓòÉΓòÉ
  18796.  
  18797. HM_INFORM and HM_QUERY_DDF_DATA messages which are not processed must be passed 
  18798. to the previous communication object window which was returned when 
  18799. HM_SET_OBJECT_WINDOW was sent. 
  18800.  
  18801.  
  18802. ΓòÉΓòÉΓòÉ <hidden> HM_SET_OBJCOM_WINDOW - Default Processing ΓòÉΓòÉΓòÉ
  18803.  
  18804. None. 
  18805.  
  18806.  
  18807. ΓòÉΓòÉΓòÉ <hidden> HM_SET_OBJCOM_WINDOW - Topics ΓòÉΓòÉΓòÉ
  18808.  
  18809. Select an item: 
  18810.  
  18811. Syntax
  18812. Parameters
  18813. Returns
  18814. Remarks
  18815. Default Processing
  18816. Glossary
  18817.  
  18818.  
  18819. ΓòÉΓòÉΓòÉ 19.29. HM_SET_SHOW_PANEL_ID ΓòÉΓòÉΓòÉ
  18820.  
  18821.  
  18822. ΓòÉΓòÉΓòÉ <hidden> HM_SET_SHOW_PANEL_ID - Syntax ΓòÉΓòÉΓòÉ
  18823.  
  18824. This message tells the Help Manager to display, hide, or toggle the window 
  18825. identity for each help window displayed. 
  18826.  
  18827.  
  18828. param1
  18829.     USHORT  fsShowPanelId  /*  The show window identity indicator. */
  18830.  
  18831. param2
  18832.     ULONG   ulReserved     /*  Reserved value, should be 0. */
  18833.  
  18834. rc
  18835.     ULONG   rc             /*  Return code. */
  18836.  
  18837.  
  18838. ΓòÉΓòÉΓòÉ <hidden> HM_SET_SHOW_PANEL_ID Field - fsShowPanelId ΓòÉΓòÉΓòÉ
  18839.  
  18840.  fsShowPanelId (USHORT) 
  18841.     The show window identity indicator. 
  18842.  
  18843.     CMIC_HIDE_PANEL_ID 
  18844.             Sets the show option off and the window identity is not displayed. 
  18845.  
  18846.     CMIC_SHOW_PANEL_ID 
  18847.             Sets the show option on and the window identity is displayed. 
  18848.  
  18849.     CMIC_TOGGLE_PANEL_ID 
  18850.             Toggles the display of the window identity. 
  18851.  
  18852.  
  18853. ΓòÉΓòÉΓòÉ <hidden> HM_SET_SHOW_PANEL_ID Field - ulReserved ΓòÉΓòÉΓòÉ
  18854.  
  18855.  ulReserved (ULONG) 
  18856.     Reserved value, should be 0. 
  18857.  
  18858.  
  18859. ΓòÉΓòÉΓòÉ <hidden> HM_SET_SHOW_PANEL_ID Parameter - rc ΓòÉΓòÉΓòÉ
  18860.  
  18861.  rc (ULONG) 
  18862.     Return code. 
  18863.  
  18864.     0 
  18865.             The show window identity indicator was successfully changed. 
  18866.     Other 
  18867.             See the values of the ulErrorCode parameter of the HM_ERROR 
  18868.             message. 
  18869.  
  18870.  
  18871. ΓòÉΓòÉΓòÉ <hidden> HM_SET_SHOW_PANEL_ID - Parameters ΓòÉΓòÉΓòÉ
  18872.  
  18873.  fsShowPanelId (USHORT) 
  18874.     The show window identity indicator. 
  18875.  
  18876.     CMIC_HIDE_PANEL_ID 
  18877.             Sets the show option off and the window identity is not displayed. 
  18878.  
  18879.     CMIC_SHOW_PANEL_ID 
  18880.             Sets the show option on and the window identity is displayed. 
  18881.  
  18882.     CMIC_TOGGLE_PANEL_ID 
  18883.             Toggles the display of the window identity. 
  18884.  
  18885.  ulReserved (ULONG) 
  18886.     Reserved value, should be 0. 
  18887.  
  18888.  rc (ULONG) 
  18889.     Return code. 
  18890.  
  18891.     0 
  18892.             The show window identity indicator was successfully changed. 
  18893.     Other 
  18894.             See the values of the ulErrorCode parameter of the HM_ERROR 
  18895.             message. 
  18896.  
  18897.  
  18898. ΓòÉΓòÉΓòÉ <hidden> HM_SET_SHOW_PANEL_ID - Default Processing ΓòÉΓòÉΓòÉ
  18899.  
  18900. None. 
  18901.  
  18902.  
  18903. ΓòÉΓòÉΓòÉ <hidden> HM_SET_SHOW_PANEL_ID - Topics ΓòÉΓòÉΓòÉ
  18904.  
  18905. Select an item: 
  18906.  
  18907. Syntax
  18908. Parameters
  18909. Default Processing
  18910. Glossary
  18911.  
  18912.  
  18913. ΓòÉΓòÉΓòÉ 19.30. HM_SET_USERDATA ΓòÉΓòÉΓòÉ
  18914.  
  18915.  
  18916. ΓòÉΓòÉΓòÉ <hidden> HM_SET_USERDATA - Syntax ΓòÉΓòÉΓòÉ
  18917.  
  18918. The application sends this message to IPF to store data in the IPF data area. 
  18919.  
  18920.  
  18921. param1
  18922.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  18923.  
  18924. param2
  18925.     VOID   usrdata     /*  4-byte user data area. */
  18926.  
  18927. rc
  18928.     ULONG  rc          /*  Return code. */
  18929.  
  18930.  
  18931. ΓòÉΓòÉΓòÉ <hidden> HM_SET_USERDATA Field - ulReserved ΓòÉΓòÉΓòÉ
  18932.  
  18933.  ulReserved (ULONG) 
  18934.     Reserved value, should be 0. 
  18935.  
  18936.  
  18937. ΓòÉΓòÉΓòÉ <hidden> HM_SET_USERDATA Field - usrdata ΓòÉΓòÉΓòÉ
  18938.  
  18939.  usrdata (VOID) 
  18940.     4-byte user data area. 
  18941.  
  18942.  
  18943. ΓòÉΓòÉΓòÉ <hidden> HM_SET_USERDATA Parameter - rc ΓòÉΓòÉΓòÉ
  18944.  
  18945.  rc (ULONG) 
  18946.     Return code. 
  18947.  
  18948.     TRUE 
  18949.             The user data was successfully stored. 
  18950.     FALSE 
  18951.             The call failed. 
  18952.  
  18953.  
  18954. ΓòÉΓòÉΓòÉ <hidden> HM_SET_USERDATA - Parameters ΓòÉΓòÉΓòÉ
  18955.  
  18956.  ulReserved (ULONG) 
  18957.     Reserved value, should be 0. 
  18958.  
  18959.  usrdata (VOID) 
  18960.     4-byte user data area. 
  18961.  
  18962.  rc (ULONG) 
  18963.     Return code. 
  18964.  
  18965.     TRUE 
  18966.             The user data was successfully stored. 
  18967.     FALSE 
  18968.             The call failed. 
  18969.  
  18970.  
  18971. ΓòÉΓòÉΓòÉ <hidden> HM_SET_USERDATA - Default Processing ΓòÉΓòÉΓòÉ
  18972.  
  18973. None. 
  18974.  
  18975.  
  18976. ΓòÉΓòÉΓòÉ <hidden> HM_SET_USERDATA - Topics ΓòÉΓòÉΓòÉ
  18977.  
  18978. Select an item: 
  18979.  
  18980. Syntax
  18981. Parameters
  18982. Default Processing
  18983. Glossary
  18984.  
  18985.  
  18986. ΓòÉΓòÉΓòÉ 19.31. HM_TUTORIAL ΓòÉΓòÉΓòÉ
  18987.  
  18988.  
  18989. ΓòÉΓòÉΓòÉ <hidden> HM_TUTORIAL - Syntax ΓòÉΓòÉΓòÉ
  18990.  
  18991. The Help Manager sends this message to the application window when the user 
  18992. selects the Tutorial choice from a help window. 
  18993.  
  18994.  
  18995. param1
  18996.     PSZ    pszTutorialName  /*  Default tutorial name. */
  18997.  
  18998. param2
  18999.     ULONG  ulReserved       /*  Reserved value, should be 0. */
  19000.  
  19001. returns
  19002.     ULONG  ulReserved       /*  Reserved value, should be 0. */
  19003.  
  19004.  
  19005. ΓòÉΓòÉΓòÉ <hidden> HM_TUTORIAL Field - pszTutorialName ΓòÉΓòÉΓòÉ
  19006.  
  19007.  pszTutorialName (PSZ) 
  19008.     Default tutorial name. 
  19009.  
  19010.     This points to a string that contains the name of the default tutorial 
  19011.     program specified in the Help Manager initialization structure. A tutorial 
  19012.     name specified in the help window definition overrides this default 
  19013.     tutorial program. 
  19014.  
  19015.  
  19016. ΓòÉΓòÉΓòÉ <hidden> HM_TUTORIAL Field - ulReserved ΓòÉΓòÉΓòÉ
  19017.  
  19018.  ulReserved (ULONG) 
  19019.     Reserved value, should be 0. 
  19020.  
  19021.  
  19022. ΓòÉΓòÉΓòÉ <hidden> HM_TUTORIAL Return Value - ulReserved ΓòÉΓòÉΓòÉ
  19023.  
  19024.  ulReserved (ULONG) 
  19025.     Reserved value, should be 0. 
  19026.  
  19027.  
  19028. ΓòÉΓòÉΓòÉ <hidden> HM_TUTORIAL - Parameters ΓòÉΓòÉΓòÉ
  19029.  
  19030.  pszTutorialName (PSZ) 
  19031.     Default tutorial name. 
  19032.  
  19033.     This points to a string that contains the name of the default tutorial 
  19034.     program specified in the Help Manager initialization structure. A tutorial 
  19035.     name specified in the help window definition overrides this default 
  19036.     tutorial program. 
  19037.  
  19038.  ulReserved (ULONG) 
  19039.     Reserved value, should be 0. 
  19040.  
  19041.  ulReserved (ULONG) 
  19042.     Reserved value, should be 0. 
  19043.  
  19044.  
  19045. ΓòÉΓòÉΓòÉ <hidden> HM_TUTORIAL - Remarks ΓòÉΓòÉΓòÉ
  19046.  
  19047. The application then calls its own tutorial program. 
  19048.  
  19049.  
  19050. ΓòÉΓòÉΓòÉ <hidden> HM_TUTORIAL - Default Processing ΓòÉΓòÉΓòÉ
  19051.  
  19052. None. 
  19053.  
  19054.  
  19055. ΓòÉΓòÉΓòÉ <hidden> HM_TUTORIAL - Topics ΓòÉΓòÉΓòÉ
  19056.  
  19057. Select an item: 
  19058.  
  19059. Syntax
  19060. Parameters
  19061. Returns
  19062. Remarks
  19063. Default Processing
  19064. Glossary
  19065.  
  19066.  
  19067. ΓòÉΓòÉΓòÉ 19.32. HM_UPDATE_OBJCOM_WINDOW_CHAIN ΓòÉΓòÉΓòÉ
  19068.  
  19069.  
  19070. ΓòÉΓòÉΓòÉ <hidden> HM_UPDATE_OBJCOM_WINDOW_CHAIN - Syntax ΓòÉΓòÉΓòÉ
  19071.  
  19072. This message is sent to the currently active communication object by the 
  19073. communication object who wants to withdraw from the communication chain. 
  19074.  
  19075.  
  19076. param1
  19077.     HWND   hwnd        /*  The handle of the object to be withdrawn from the communication chain. */
  19078.  
  19079. param2
  19080.     HWND   hwnd        /*  Window containing the handle of the object to be replaced. */
  19081.  
  19082. returns
  19083.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  19084.  
  19085.  
  19086. ΓòÉΓòÉΓòÉ <hidden> HM_UPDATE_OBJCOM_WINDOW_CHAIN Field - hwnd ΓòÉΓòÉΓòÉ
  19087.  
  19088.  hwnd (HWND) 
  19089.     The handle of the object to be withdrawn from the communication chain. 
  19090.  
  19091.  
  19092. ΓòÉΓòÉΓòÉ <hidden> HM_UPDATE_OBJCOM_WINDOW_CHAIN Field - hwnd ΓòÉΓòÉΓòÉ
  19093.  
  19094.  hwnd (HWND) 
  19095.     Window containing the handle of the object to be replaced. 
  19096.  
  19097.  
  19098. ΓòÉΓòÉΓòÉ <hidden> HM_UPDATE_OBJCOM_WINDOW_CHAIN Return Value - ulReserved ΓòÉΓòÉΓòÉ
  19099.  
  19100.  ulReserved (ULONG) 
  19101.     Reserved value, should be 0. 
  19102.  
  19103.  
  19104. ΓòÉΓòÉΓòÉ <hidden> HM_UPDATE_OBJCOM_WINDOW_CHAIN - Parameters ΓòÉΓòÉΓòÉ
  19105.  
  19106.  hwnd (HWND) 
  19107.     The handle of the object to be withdrawn from the communication chain. 
  19108.  
  19109.  hwnd (HWND) 
  19110.     Window containing the handle of the object to be replaced. 
  19111.  
  19112.  ulReserved (ULONG) 
  19113.     Reserved value, should be 0. 
  19114.  
  19115.  
  19116. ΓòÉΓòÉΓòÉ <hidden> HM_UPDATE_OBJCOM_WINDOW_CHAIN - Remarks ΓòÉΓòÉΓòÉ
  19117.  
  19118. The object that receives this message should check to see if the object handle 
  19119. returned from HM_SET_OBJCOM_WINDOW is equal to the handle in param1. If the 
  19120. handle is equal, then the handle in param1 should be replaced by the handle in 
  19121. param2. If the handle is not equal and the handle previously received is not 
  19122. NULL HANDLE, then send HM_UPDATE_OBJCOM_WINDOW_CHAIN to that object. 
  19123.  
  19124.  
  19125. ΓòÉΓòÉΓòÉ <hidden> HM_UPDATE_OBJCOM_WINDOW_CHAIN - Default Processing ΓòÉΓòÉΓòÉ
  19126.  
  19127. None. 
  19128.  
  19129.  
  19130. ΓòÉΓòÉΓòÉ <hidden> HM_UPDATE_OBJCOM_WINDOW_CHAIN - Topics ΓòÉΓòÉΓòÉ
  19131.  
  19132. Select an item: 
  19133.  
  19134. Syntax
  19135. Parameters
  19136. Returns
  19137. Remarks
  19138. Default Processing
  19139. Glossary
  19140.  
  19141.  
  19142. ΓòÉΓòÉΓòÉ 20. Notices ΓòÉΓòÉΓòÉ
  19143.  
  19144. (April 1997) 
  19145.  
  19146. The following paragraph does not apply to the United Kingdom or any country 
  19147. where such provisions are inconsistent with local law:  INTERNATIONAL BUSINESS 
  19148. MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY 
  19149. KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 
  19150. WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states 
  19151. do not allow disclaimer of express or implied warranties in certain 
  19152. transactions, therefore, this statement may not apply to you. 
  19153.  
  19154. This publication could include technical inaccuracies or typographical errors. 
  19155. Changes are periodically made to the information herein; these changes will be 
  19156. incorporated in new editions of the publication. IBM may make improvements 
  19157. and/or changes in the product(s) and/or the program(s) described in this 
  19158. publication at any time. 
  19159.  
  19160. It is possible that this publication may contain reference to, or information 
  19161. about, IBM products (machines and programs), programming, or services that are 
  19162. not announced in your country.  Such references or information must not be 
  19163. construed to mean that IBM intends to announce such IBM products, programming, 
  19164. or services in your country. 
  19165.  
  19166. Requests for technical information about IBM products should be made to your 
  19167. IBM reseller or IBM marketing representative. 
  19168.  
  19169.  
  19170. ΓòÉΓòÉΓòÉ 20.1. Copyright Notices ΓòÉΓòÉΓòÉ
  19171.  
  19172. COPYRIGHT LICENSE: This publication contains printed sample application 
  19173. programs in source language, which illustrate OS/2 programming techniques. You 
  19174. may copy, modify, and distribute these sample programs in any form without 
  19175. payment to IBM, for the purposes of developing, using, marketing or 
  19176. distributing application programs conforming to the OS/2 application 
  19177. programming interface. 
  19178.  
  19179. Each copy of any portion of these sample programs or any derivative work, which 
  19180. is distributed to others, must include a copyright notice as follows: "(C) 
  19181. (your company name) (year).  All rights reserved." 
  19182.  
  19183. (C) Copyright International Business Machines Corporation 1994, 1996. All 
  19184. rights reserved. 
  19185. Note to U.S. Government Users - Documentation related to restricted rights - 
  19186. Use, duplication or disclosure is subject to restrictions set forth in GSA ADP 
  19187. Schedule Contract with IBM Corp. 
  19188.  
  19189.  
  19190. ΓòÉΓòÉΓòÉ 20.2. Disclaimers ΓòÉΓòÉΓòÉ
  19191.  
  19192. Any reference to an IBM product, program or service is not intended to state or 
  19193. imply that only that IBM product, program, or service may be used. Subject to 
  19194. IBm's valid intellectual property or other legally protectable rights, any 
  19195. functionally equivalent product, program, or service may be used instead of the 
  19196. IBM product, program, or service.  The evaluation and verification of operation 
  19197. in conjunction with other products, except those expressly designated by IBM, 
  19198. are the responsibility of the user. 
  19199.  
  19200. IBM may have patents or pending patent applications covering subject matter in 
  19201. this document. The furnishing of this document does not give you any license to 
  19202. these patents. You can send license inquiries, in writing, to: 
  19203.  
  19204.      IBM Director of Licensing 
  19205.      IBM Corporation 
  19206.      500 Columbus Avenue 
  19207.      Thornwood, NY 10594 
  19208.      U.S.A. 
  19209.  
  19210.  Asia-Pacific users can inquire, in writing, to the IBM Director of 
  19211.  Intellectual Property and Licensing, IBM World Trade Asia Corporation, 2-31 
  19212.  Roppongi 3-chome, Minato-ku, Tokyo 106, Japan. 
  19213.  
  19214.  Licensees of this program who wish to have information about it for the 
  19215.  purpose of enabling:  (i) the exchange of information between independently 
  19216.  created programs and other programs (including this one) and (ii) the mutual 
  19217.  use of the information which has been exchanged, should contact IBM 
  19218.  Corporation, Department LZKS, 11400 Burnet Road, Austin, TX 78758 U.S.A.  Such 
  19219.  information may be available, subject to appropriate terms and conditions, 
  19220.  including in some cases, payment of a fee. 
  19221.  
  19222.  
  19223. ΓòÉΓòÉΓòÉ 20.3. Trademarks ΓòÉΓòÉΓòÉ
  19224.  
  19225. The following terms are trademarks of the IBM Corporation in the United States 
  19226. or other countries or both: 
  19227.  
  19228. Common User Access
  19229. CUA
  19230. IBM
  19231. Operating System/2
  19232. OS/2
  19233. Personal System/2
  19234. Presentation Manager
  19235. Systems Application Architecture
  19236.  
  19237. The following terms are trademarks of other companies: 
  19238.  
  19239.  Adobe               Adobe Systems Incorporated 
  19240.  Helvetica           Linotype AG 
  19241.  Intel486            Intel Corporation 
  19242.  PostScript          Adobe Systems Incorporated 
  19243.  Times New Roman     Monotype Corporation 
  19244.  
  19245.  Windows is a trademark of Microsoft Corporation. 
  19246.  
  19247.  PC Direct is a trademark of Ziff Communications Company and is used by IBM 
  19248.  Corporation under license. 
  19249.  
  19250.  UNIX is a registered trademark in the United States and other countries 
  19251.  licensed exclusively through X/Open Company Limited. 
  19252.  
  19253.  Other company, product, and service names, which may be denoted by a double 
  19254.  asterisk (**), may be trademarks or service marks of others. 
  19255.  
  19256.  
  19257. ΓòÉΓòÉΓòÉ 21. Glossary ΓòÉΓòÉΓòÉ
  19258.  
  19259. This glossary defines many of the terms used in this book. It includes terms 
  19260. and definitions from the IBM Dictionary of Computing, as well as terms specific 
  19261. to the OS/2 operating system and the Presentation Manager. It is not a complete 
  19262. glossary for the entire OS/2 operating system; nor is it a complete dictionary 
  19263. of computer terms. 
  19264.  
  19265. Other primary sources for these definitions are: 
  19266.  
  19267.      The American National Standard Dictionary for Information Systems, ANSI 
  19268.       X3.172-1990, copyrighted 1990 by the American National Standards 
  19269.       Institute, 11 West 42nd Street, New York, New York 10036. These 
  19270.       definitions are identified by the symbol (A) after the definition. 
  19271.  
  19272.      The Information Technology Vocabulary, developed by Subcommittee 1, Joint 
  19273.       Technical Committee 1, of the International Organization for 
  19274.       Standardization and the International Electrotechnical Commission 
  19275.       (ISO/IEC JTC1/SC1). Definitions of published parts of this vocabulary are 
  19276.       identified by the symbol (I) after the definition; definitions taken from 
  19277.       draft international standards, committee drafts, and working papers being 
  19278.       developed by ISO/IEC JTC1/SC1 are identified by the symbol (T) after the 
  19279.       definition, indicating that final agreement has not yet been reached 
  19280.       among the participating National Bodies of SC1. 
  19281.  
  19282.  
  19283. ΓòÉΓòÉΓòÉ 21.1. Glossary Listing ΓòÉΓòÉΓòÉ
  19284.  
  19285. Select a starting letter of glossary terms: 
  19286.  
  19287.  A    N 
  19288.  B    O 
  19289.  C    P 
  19290.  D    Q 
  19291.  E    R 
  19292.  F    S 
  19293.  G    T 
  19294.  H    U 
  19295.  I    V 
  19296.  J    W 
  19297.  K    X 
  19298.  L    Y 
  19299.  M    Z 
  19300.  
  19301.  
  19302. ΓòÉΓòÉΓòÉ <hidden> Glossary - A ΓòÉΓòÉΓòÉ
  19303.  
  19304.  accelerator  - In SAA Common User Access architecture, a key or combination of 
  19305.    keys that invokes an application-defined function. 
  19306.  
  19307.  accelerator table  - A table used to define which key strokes are treated as 
  19308.    accelerators and the commands they are translated into. 
  19309.  
  19310.  access mode  - The manner in which an application gains access to a file it 
  19311.    has opened. Examples of access modes are read-only, write-only, and 
  19312.    read/write. 
  19313.  
  19314.  access permission  - All access rights that a user has regarding an object. (I)
  19315.  
  19316.  action  - One of a set of defined tasks that a computer performs. Users 
  19317.    request the application to perform an action in several ways, such as typing 
  19318.    a command, pressing a function key, or selecting the action name from an 
  19319.    action bar or menu. 
  19320.  
  19321.  action bar  - In SAA Common User Access architecture, the area at the top of a 
  19322.    window that contains choices that give a user access to actions available in 
  19323.    that window. 
  19324.  
  19325.  action point  - The current position on the screen at which the pointer is 
  19326.    pointing. Contrast with hot spot and input focus. 
  19327.  
  19328.  active program  - A program currently running on the computer.  An active 
  19329.    program can be interactive (running and receiving input from the user) or 
  19330.    noninteractive (running but not receiving input from the user). See also 
  19331.    interactive program and noninteractive program. 
  19332.  
  19333.  active window  - The window with which the user is currently interacting. 
  19334.  
  19335.  address space  - (1) The range of addresses available to a program. (A)  (2) 
  19336.    The area of virtual storage available for a particular job. 
  19337.  
  19338.  alphanumeric video output  - Output to the logical video buffer when the video 
  19339.    adapter is in text mode and the logical video buffer is addressed by an 
  19340.    application as a rectangular array of character cells. 
  19341.  
  19342.  American National Standard Code for Information Interchange  - The standard 
  19343.    code, using a coded character set consisting of 7-bit coded characters (8 
  19344.    bits including parity check), that is used for information interchange among 
  19345.    data processing systems, data communication systems, and associated 
  19346.    equipment. The ASCII set consists of control characters and graphic 
  19347.    characters. (A) 
  19348.  
  19349.    Note:  IBM has defined an extension to ASCII code (characters 128-255). 
  19350.  
  19351.  anchor  - A window procedure that handles Presentation Manager message 
  19352.    conversions between an icon procedure and an application. 
  19353.  
  19354.  anchor block  - An area of Presentation-Manager-internal resources to 
  19355.    allocated process or thread that calls WinInitialize. 
  19356.  
  19357.  anchor point  - A point in a window used by a program designer or by a window 
  19358.    manager to position a subsequently appearing window. 
  19359.  
  19360.  ANSI  - American National Standards Institute. 
  19361.  
  19362.  APA  - All points addressable. 
  19363.  
  19364.  API  - Application programming interface. 
  19365.  
  19366.  application  - A collection of software components used to perform specific 
  19367.    types of work on a computer; for example, a payroll application, an airline 
  19368.    reservation application, a network application. 
  19369.  
  19370.  application object  - In SAA Advanced Common User Access architecture, a form 
  19371.    that an application provides for a user; for example, a spreadsheet form. 
  19372.    Contrast with user object. 
  19373.  
  19374.  application programming interface (API)  - A functional interface supplied by 
  19375.    the operating system or by a separately orderable licensed program that 
  19376.    allows an application program written in a high-level language to use 
  19377.    specific data or functions of the operating system or the licensed program. 
  19378.  
  19379.  application-modal  - Pertaining to a message box or dialog box for which 
  19380.    processing must be completed before further interaction with any other 
  19381.    window owned by the same application may take place. 
  19382.  
  19383.  area  - In computer graphics, a filled shape such as a solid rectangle. 
  19384.  
  19385.  ASCII  - American National Standard Code for Information Interchange. 
  19386.  
  19387.  ASCIIZ  - A string of ASCII characters that is terminated with a byte 
  19388.    containing the value 0. 
  19389.  
  19390.  aspect ratio  - In computer graphics, the width-to-height ratio of an area, 
  19391.    symbol, or shape. 
  19392.  
  19393.  asynchronous (ASYNC)  - (1) Pertaining to two or more processes that do not 
  19394.    depend upon the occurrence of specific events such as common timing 
  19395.    signals. (T)  (2) Without regular time relationship;  unexpected or 
  19396.    unpredictable with respect to the execution of program instructions. See 
  19397.    also synchronous. 
  19398.  
  19399.  atom  - A constant that represents a string. As soon as a string has been 
  19400.    defined as an atom, the atom can be used in place of the string to save 
  19401.    space. Strings are associated with their respective atoms in an atom table. 
  19402.    See also integer atom. 
  19403.  
  19404.  atom table  - A table used to relate atoms with the strings that they 
  19405.    represent. Also in the table is the mechanism by which the presence of a 
  19406.    string can be checked. 
  19407.  
  19408.  atomic operation  - An operation that completes its work on an object before 
  19409.    another operation can be performed on the same object. 
  19410.  
  19411.  attribute  - A characteristic or property that can be controlled, usually to 
  19412.    obtain a required appearance;  for example, the color of a line. See also 
  19413.    graphics attributes and segment attributes. 
  19414.  
  19415.  automatic link  - In Information Presentation Facility (IPF), a link that 
  19416.    begins a chain reaction at the primary window. When the user selects the 
  19417.    primary window, an automatic link is activated to display secondary windows. 
  19418.  
  19419.  AVIO  - Advanced Video Input/Output. 
  19420.  
  19421.  
  19422. ΓòÉΓòÉΓòÉ <hidden> Glossary - B ΓòÉΓòÉΓòÉ
  19423.  
  19424.  B╨Æzier curve  - (1) A mathematical technique of specifying smooth continous 
  19425.    lines and surfaces, which require a starting point and a finishing point 
  19426.    with several intermediate points that influence or control the path of the 
  19427.    linking curve. Named after Dr. P. B╨Æzier. (2) (D of C) In the AIX Graphics 
  19428.    Library, a cubic spline approximation to a set of four control points that 
  19429.    passes through the first and fourth control points and that has a continuous 
  19430.    slope where two spline segments meet. Named after Dr. P. B╨Æzier. 
  19431.  
  19432.  background  - (1) In multiprogramming, the conditions under which low-priority 
  19433.    programs are executed. Contrast with foreground. (2) An active session that 
  19434.    is not currently displayed on the screen. 
  19435.  
  19436.  background color  - The color in which the background of a graphic primitive 
  19437.    is drawn. 
  19438.  
  19439.  background mix  - An attribute that determines how the background of a graphic 
  19440.    primitive is combined with the existing color of the graphics presentation 
  19441.    space. Contrast with mix. 
  19442.  
  19443.  background program  - In multiprogramming, a program that executes with a low 
  19444.    priority. Contrast with foreground program. 
  19445.  
  19446.  bit map  - A representation in memory of the data displayed on an APA device, 
  19447.    usually the screen. 
  19448.  
  19449.  block  - (1) A string of data elements recorded or transmitted as a unit. The 
  19450.    elements may be characters, words, or logical records. (T)  (2) To record 
  19451.    data in a block. (3) A collection of contiguous records recorded as a unit. 
  19452.    Blocks are separated by interblock gaps and each block may contain one or 
  19453.    more records. (A)
  19454.  
  19455.  block device  - A storage device that performs I/O operations on blocks of 
  19456.    data called sectors. Data on block devices can be randomly accessed. Block 
  19457.    devices are designated by a drive letter (for example, C:). 
  19458.  
  19459.  blocking mode  - A condition set by an application that determines when its 
  19460.    threads might block. For example, an application might set the Pipemode 
  19461.    parameter for the DosCreateNPipe function so that its threads perform I/O 
  19462.    operations to the named pipe block when no data is available. 
  19463.  
  19464.  border  - A visual indication (for example, a separator line or a background 
  19465.    color) of the boundaries of a window. 
  19466.  
  19467.  boundary determination  - An operation used to compute the size of the 
  19468.    smallest rectangle that encloses a graphics object on the screen. 
  19469.  
  19470.  breakpoint  - (1) A point in a computer program where execution may be halted. 
  19471.    A breakpoint is usually at the beginning of an instruction where halts, 
  19472.    caused by external intervention, are convenient for resuming 
  19473.    execution. (T)  (2) A place in a program, specified by a command or a 
  19474.    condition, where the system halts execution and gives control to the 
  19475.    workstation user or to a specified program. 
  19476.  
  19477.  broken pipe  - When all of the handles that access one end of a pipe have been 
  19478.    closed. 
  19479.  
  19480.  bucket  - One or more fields in which the result of an operation is kept. 
  19481.  
  19482.  buffer  - (1) A portion of storage used to hold input or output data 
  19483.    temporarily. (2) To allocate and schedule the use of buffers. (A)
  19484.  
  19485.  button  - A mechanism used to request or initiate an action. See also barrel 
  19486.    buttons, bezel buttons, mouse button, push button, and radio button. 
  19487.  
  19488.  byte pipe  - Pipes that handle data as byte streams. All unnamed pipes are 
  19489.    byte pipes. Named pipes can be byte pipes or message pipes. See byte stream. 
  19490.  
  19491.  byte stream  - Data that consists of an unbroken stream of bytes. 
  19492.  
  19493.  
  19494. ΓòÉΓòÉΓòÉ <hidden> Glossary - C ΓòÉΓòÉΓòÉ
  19495.  
  19496.  cache  - A high-speed buffer storage that contains frequently accessed 
  19497.    instructions and data; it is used to reduce access time. 
  19498.  
  19499.  cached micro presentation space  - A presentation space from a 
  19500.    Presentation-Manager-owned store of micro presentation spaces. It can be 
  19501.    used for drawing to a window only, and must be returned to the store when 
  19502.    the task is complete. 
  19503.  
  19504.  CAD  - Computer-Aided Design. 
  19505.  
  19506.  call  - (1) The action of bringing a computer program, a routine, or a 
  19507.    subroutine into effect, usually by specifying the entry conditions and 
  19508.    jumping to an entry point. (I)  (A)  (2) To transfer control to a procedure, 
  19509.    program, routine, or subroutine. 
  19510.  
  19511.  calling sequence  - A sequence of instructions together with any associated 
  19512.    data necessary to execute a call. (T)
  19513.  
  19514.  Cancel  - An action that removes the current window or menu without processing 
  19515.    it, and returns the previous window. 
  19516.  
  19517.  cascaded menu  - In the OS/2 operating system, a menu that appears when the 
  19518.    arrow to the right of a cascading choice is selected. It contains a set of 
  19519.    choices that are related to the cascading choice. Cascaded menus are used to 
  19520.    reduce the length of a menu. See also cascading choice. 
  19521.  
  19522.  cascading choice  - In SAA Common User Access architecture, a choice in a menu 
  19523.    that, when selected, produces a cascaded menu containing other choices.  An 
  19524.    arrow () appears to the right of the cascading choice. 
  19525.  
  19526.  CASE statement  - In PM programming, provides the body of a window procedure. 
  19527.    There is usually one CASE statement for each message type supported by an 
  19528.    application. 
  19529.  
  19530.  CGA  - Color graphics adapter. 
  19531.  
  19532.  chained list  - A list in which the data elements may be dispersed but in 
  19533.    which each data element contains information for locating the 
  19534.    next. (T)Synonymous with linked list. 
  19535.  
  19536.  character  - A letter, digit, or other symbol. 
  19537.  
  19538.  character box  - In computer graphics, the boundary that defines, in world 
  19539.    coordinates, the horizontal and vertical space occupied by a single 
  19540.    character from a character set. See also character mode. Contrast with 
  19541.    character cell. 
  19542.  
  19543.  character cell  - The physical, rectangular space in which any single 
  19544.    character is displayed on a screen or printer device. Position is addressed 
  19545.    by row and column coordinates. Contrast with character box. 
  19546.  
  19547.  character code  - The means of addressing a character in a character set, 
  19548.    sometimes called code point. 
  19549.  
  19550.  character device  - A device that performs I/O operations on one character at 
  19551.    a time. Because character devices view data as a stream of bytes, 
  19552.    character-device data cannot be randomly accessed. Character devices include 
  19553.    the keyboard, mouse, and printer, and are referred to by name. 
  19554.  
  19555.  character mode  - A mode that, in conjunction with the font type, determines 
  19556.    the extent to which graphics characters are affected by the character box, 
  19557.    shear, and angle attributes. 
  19558.  
  19559.  character set  - (1) An ordered set of unique representations called 
  19560.    characters; for example, the 26 letters of English alphabet, Boolean 0 and 
  19561.    1, the set of symbols in the Morse code, and the 128 ASCII 
  19562.    characters. (A)  (2) All the valid characters for a programming language or 
  19563.    for a computer system. (3) A group of characters used for a specific reason; 
  19564.    for example, the set of characters a printer can print. 
  19565.  
  19566.  check box  - In SAA Advanced Common User Access architecture, a square box 
  19567.    with associated text that represents a choice. When a user selects a choice, 
  19568.    an X appears in the check box to indicate that the choice is in effect. The 
  19569.    user can clear the check box by selecting the choice again. Contrast with 
  19570.    radio button. 
  19571.  
  19572.  check mark  -  (1) (D of C) In SAA Advanced Common User Access architecture, a 
  19573.    symbol that shows that a choice is currently in effect. (2) The symbol that 
  19574.    is used to indicate a selected item on a pull-down menu. 
  19575.  
  19576.  child process  - In the OS/2 operating system, a process started by another 
  19577.    process, which is called the parent process. Contrast with parent process. 
  19578.  
  19579.  child window  - A window that appears within the border of its parent window 
  19580.    (either a primary window or another child window). When the parent window is 
  19581.    resized, moved, or destroyed, the child window also is resized, moved, or 
  19582.    destroyed; however, the child window can be moved or resized independently 
  19583.    from the parent window, within the boundaries of the parent window. Contrast 
  19584.    with parent window. 
  19585.  
  19586.  choice  - (1) An option that can be selected. The choice can be presented as 
  19587.    text, as a symbol (number or letter), or as an icon (a pictorial symbol). 
  19588.    (2) (D of C) In SAA Common User Access architecture, an item that a user can 
  19589.    select. 
  19590.  
  19591.  chord  - (1) To press more than one button on a pointing device while the 
  19592.    pointer is within the limits that the user has specified for the operating 
  19593.    environment. (2) (D of C) In graphics, a short line segment whose end points 
  19594.    lie on a circle. Chords are a means for producing a circular image from 
  19595.    straight lines. The higher the number of chords per circle, the smoother the 
  19596.    circular image. 
  19597.  
  19598.  class  - A way of categorizing objects based on their behavior and shape. A 
  19599.    class is, in effect, a definition of a generic object. In SOM, a class is a 
  19600.    special kind of object that can manufacture other objects that all have a 
  19601.    common shape and exhibit similar behavior (more precisely, all of the 
  19602.    objects manufactured by a class have the same memory layout and share a 
  19603.    common set of methods). New classes can be defined in terms of existing 
  19604.    classes through a technique known as inheritance. 
  19605.  
  19606.  class method  - A class method of class <X> is a method provided by the 
  19607.    metaclass of class <X>. Class methods are executed without requiring any 
  19608.    instances of class <X> to exist, and are frequently used to create 
  19609.    instances. In System Object Model, an action that can be performed on a 
  19610.    class object. 
  19611.  
  19612.  class object  - In System Object Model, the run-time implementation of a 
  19613.    class. 
  19614.  
  19615.  class style  - The set of properties that apply to every window in a window 
  19616.    class. 
  19617.  
  19618.  client  - (1) A functional unit that receives shared services from a 
  19619.    server. (T)  (2) A user, as in a client process that uses a named pipe or 
  19620.    queue that is created and owned by a server process. 
  19621.  
  19622.  client area  - The part of the window, inside the border, that is below the 
  19623.    menu bar. It is the user's work space, where a user types information and 
  19624.    selects choices from selection fields.  In primary windows, it is where an 
  19625.    application programmer presents the objects that a user works on. 
  19626.  
  19627.  client program  - An application that creates and manipulates instances of 
  19628.    classes. 
  19629.  
  19630.  client window  - The window in which the application displays output and 
  19631.    receives input. This window is located inside the frame window, under the 
  19632.    window title bar and any menu bar, and within any scroll bars. 
  19633.  
  19634.  clip limits  - The area of the paper that can be reached by a printer or 
  19635.    plotter. 
  19636.  
  19637.  clipboard  - In SAA Common User Access architecture, an area of computer 
  19638.    memory, or storage, that temporarily holds data. Data in the clipboard is 
  19639.    available to other applications. 
  19640.  
  19641.  clipping  - In computer graphics, removing those parts of a display image that 
  19642.    lie outside a given boundary. (I)  (A)
  19643.  
  19644.  clipping area  - The area in which the window can paint. 
  19645.  
  19646.  clipping path  - A clipping boundary in world-coordinate space. 
  19647.  
  19648.  clock tick  - The minimum unit of time that the system tracks. If the system 
  19649.    timer currently counts at a rate of X Hz, the system tracks the time every 
  19650.    1/X of a second. Also known as time tick. 
  19651.  
  19652.  CLOCK$  - Character-device name reserved for the system clock. 
  19653.  
  19654.  code page  - An assignment of graphic characters and control-function meanings 
  19655.    to all code points. 
  19656.  
  19657.  code point  - (1) Synonym for character code. (2) (D of C) A 1-byte code 
  19658.    representing one of 256 potential characters. 
  19659.  
  19660.  code segment  - An executable section of programming code within a load 
  19661.    module. 
  19662.  
  19663.  color dithering  - See dithering. 
  19664.  
  19665.  color graphics adapter (CGA)  - An adapter that simultaneously provides four 
  19666.    colors and is supported by all IBM Personal Computer and Personal System/2 
  19667.    models. 
  19668.  
  19669.  command  - The name and parameters associated with an action that a program 
  19670.    can perform. 
  19671.  
  19672.  command area  - An area composed of a command field prompt and a command entry 
  19673.    field. 
  19674.  
  19675.  command entry field  - An entry field in which users type commands. 
  19676.  
  19677.  command line  - On a display screen, a display line, sometimes at the bottom 
  19678.    of the screen, in which only commands can be entered. 
  19679.  
  19680.  command mode  - A state of a system or device in which the user can enter 
  19681.    commands. 
  19682.  
  19683.  command prompt  - A field prompt showing the location of the command entry 
  19684.    field in a panel. 
  19685.  
  19686.  Common Programming Interface (CPI)  - Definitions of those application 
  19687.    development languages and services that have, or are intended to have, 
  19688.    implementations on and a high degree of commonality across the SAA 
  19689.    environments. One of the three SAA architectural areas. See also Common User 
  19690.    Access architecture. 
  19691.  
  19692.  Common User Access (CUA) architecture  -  Guidelines for the dialog between a 
  19693.    human and a workstation or terminal. One of the three SAA architectural 
  19694.    areas. See also Common Programming Interface. 
  19695.  
  19696.  compile  - To translate a program written in a higher-level programming 
  19697.    language into a machine language program. 
  19698.  
  19699.  composite window  - A window composed of other windows (such as a frame 
  19700.    window, frame-control windows, and a client window) that are kept together 
  19701.    as a unit and that interact with each other. 
  19702.  
  19703.  computer-aided design (CAD)  - The use of a computer to design or change a 
  19704.    product, tool, or machine, such as using a computer for drafting or 
  19705.    illustrating. 
  19706.  
  19707.  COM1, COM2, COM3  - Character-device names reserved for serial ports 1 through 
  19708.    3. 
  19709.  
  19710.  CON  - Character-device name reserved for the console keyboard and screen. 
  19711.  
  19712.  conditional cascaded menu  - A pull-down menu associated with a menu item that 
  19713.    has a cascade mini-push button beside it in an object's pop-up menu. The 
  19714.    conditional cascaded menu is displayed when the user selects the mini-push 
  19715.    button. 
  19716.  
  19717.  container  - In SAA Common User Access architecture, an object that holds 
  19718.    other objects. A folder is an example of a container object. See also folder 
  19719.    and object. 
  19720.  
  19721.  contextual help  - In SAA Common User Access Architecture, help that gives 
  19722.    specific information about the item the cursor is on. The help is contextual 
  19723.    because it provides information about a specific item as it is currently 
  19724.    being used. Contrast with extended help. 
  19725.  
  19726.  contiguous  - Touching or joining at a common edge or boundary, for example, 
  19727.    an unbroken consecutive series of storage locations. 
  19728.  
  19729.  control  - In SAA Advanced Common User Access architecture, a component of the 
  19730.    user interface that allows a user to select choices or type information; for 
  19731.    example, a check box, an entry field, a radio button. 
  19732.  
  19733.  control area  - A storage area used by a computer program to hold control information. (I)  (A)
  19734.  
  19735.  Control Panel  - In the Presentation Manager, a program used to set up user 
  19736.    preferences that act globally across the system. 
  19737.  
  19738.  Control Program  - (1) The basic functions of the operating system, including 
  19739.    DOS emulation and the support for keyboard, mouse, and video input/output. 
  19740.    (2) A computer program designed to schedule and to supervise the execution 
  19741.    of programs of a computer system. (I)  (A)
  19742.  
  19743.  control window  - A window that is used as part of a composite window to 
  19744.    perform simple input and output tasks. Radio buttons and check boxes are 
  19745.    examples. 
  19746.  
  19747.  control word  - An instruction within a document that identifies its parts or 
  19748.    indicates how to format the document. 
  19749.  
  19750.  coordinate space  - A two-dimensional set of points used to generate output on 
  19751.    a video display of printer. 
  19752.  
  19753.  Copy  - A choice that places onto the clipboard, a copy of what the user has 
  19754.    selected. See also Cut and Paste. 
  19755.  
  19756.  correlation  - The action of determining which element or object within a 
  19757.    picture is at a given position on the display. This follows a pick 
  19758.    operation. 
  19759.  
  19760.  coverpage window  - A window in which the application's help information is 
  19761.    displayed. 
  19762.  
  19763.  CPI  - Common Programming Interface. 
  19764.  
  19765.  critical extended attribute  - An extended attribute that is necessary for the 
  19766.    correct operation of the system or a particular application. 
  19767.  
  19768.  critical section  - (1) In programming languages, a part of an asynchronous 
  19769.    procedure that cannot be executed simultaneously with a certain part of 
  19770.    another asynchronous procedure. (I)
  19771.  
  19772.    Note:  Part of the other asynchronous procedure also is a critical section. 
  19773.    (2) A section of code that is not reentrant; that is, code that can be 
  19774.    executed by only one thread at a time. 
  19775.  
  19776.  CUA architecture  - Common User Access architecture. 
  19777.  
  19778.  current position  - In computer graphics, the position, in user coordinates, 
  19779.    that becomes the starting point for the next graphics routine, if that 
  19780.    routine does not explicitly specify a starting point. 
  19781.  
  19782.  cursor  - A symbol displayed on the screen and associated with an input 
  19783.    device. The cursor indicates where input from the device will be placed. 
  19784.    Types of cursors include text cursors, graphics cursors, and selection 
  19785.    cursors. Contrast with pointer and input focus. 
  19786.  
  19787.  Cut  - In SAA Common User Access architecture, a choice that removes a 
  19788.    selected object, or a part of an object, to the clipboard, usually 
  19789.    compressing the space it occupied in a window. See also Copy and Paste. 
  19790.  
  19791.  
  19792. ΓòÉΓòÉΓòÉ <hidden> Glossary - D ΓòÉΓòÉΓòÉ
  19793.  
  19794.  daisy chain  - A method of device interconnection for determining interrupt 
  19795.    priority by connecting the interrupt sources serially. 
  19796.  
  19797.  data segment  - A nonexecutable section of a program module; that is, a 
  19798.    section of a program that contains data definitions. 
  19799.  
  19800.  data structure  - The syntactic structure of symbolic expressions and their 
  19801.    storage-allocation characteristics. (T)
  19802.  
  19803.  data transfer  - The movement of data from one object to another by way of the 
  19804.    clipboard or by direct manipulation. 
  19805.  
  19806.  DBCS  - Double-byte character set. 
  19807.  
  19808.  DDE  - Dynamic data exchange. 
  19809.  
  19810.  deadlock  - (1) Unresolved contention for the use of a resource. (2) An error 
  19811.    condition in which processing cannot continue because each of two elements 
  19812.    of the process is waiting for an action by, or a response from, the other. 
  19813.    (3) An impasse that occurs when multiple processes are waiting for the 
  19814.    availability of a resource that will not become available because it is 
  19815.    being held by another process that is in a similar wait state. 
  19816.  
  19817.  debug  - To detect, diagnose, and eliminate errors in programs. (T)
  19818.  
  19819.  decipoint  - In printing, one tenth of a point.  There are 72 points in an 
  19820.    inch. 
  19821.  
  19822.  default procedure  - A function provided by the Presentation Manager Interface 
  19823.    that may be used to process standard messages from dialogs or windows. 
  19824.  
  19825.  default value  - A value assumed when no value has been specified. Synonymous 
  19826.    with assumed value. For example, in the graphics programming interface, the 
  19827.    default line-type is 'solid'. 
  19828.  
  19829.  definition list  - A type of list that pairs a term and its description. 
  19830.  
  19831.  delta  - An application-defined threshold, or number of container items, from 
  19832.    either end of the list. 
  19833.  
  19834.  descendant  - See child process. 
  19835.  
  19836.  descriptive text  - Text used in addition to a field prompt to give more 
  19837.    information about a field. 
  19838.  
  19839.  Deselect all  - A choice that cancels the selection of all of the objects that 
  19840.    have been selected in that window. 
  19841.  
  19842.  Desktop Manager  - In the Presentation Manager, a window that displays a list 
  19843.    of groups of programs, each of which can be started or stopped. 
  19844.  
  19845.  desktop window  - The window, corresponding to the physical device, against 
  19846.    which all other types of windows are established. 
  19847.  
  19848.  detached process  - A background process that runs independent of the parent 
  19849.    process. 
  19850.  
  19851.  detent  - A point on a slider that represents an exact value to which a user 
  19852.    can move the slider arm. 
  19853.  
  19854.  device context  - A logical description of a data destination such as memory, 
  19855.    metafile, display, printer, or plotter. See also direct device context, 
  19856.    information device context, memory device context, metafile device context, 
  19857.    queued device context, and screen device context. 
  19858.  
  19859.  device driver  - A file that contains the code needed to attach and use a 
  19860.    device such as a display, printer, or plotter. 
  19861.  
  19862.  device space  - (1) Coordinate space in which graphics are assembled after all 
  19863.    GPI transformations have been applied. Device space is defined in 
  19864.    device-specific units. (2) ( D of C) In computer graphics, a space defined 
  19865.    by the complete set of addressable points of a display device. (A)
  19866.  
  19867.  dialog  - The interchange of information between a computer and its user 
  19868.    through a sequence of requests by the user and the presentation of responses 
  19869.    by the computer. 
  19870.  
  19871.  dialog box  - In SAA Advanced Common User Access architecture, a movable 
  19872.    window, fixed in size, containing controls that a user uses to provide 
  19873.    information required by an application so that it can continue to process a 
  19874.    user request. See also message box, primary window, secondary window. Also 
  19875.    known as a pop-up window. 
  19876.  
  19877.  Dialog Box Editor  - A WYSIWYG editor that creates dialog boxes for 
  19878.    communicating with the application user. 
  19879.  
  19880.  dialog item  - A component (for example, a menu or a button) of a dialog box. 
  19881.    Dialog items are also used when creating dialog templates. 
  19882.  
  19883.  dialog procedure  - A dialog window that is controlled by a window procedure. 
  19884.    It is responsible for responding to all messages sent to the dialog window. 
  19885.  
  19886.  dialog tag language  - A markup language used by the DTL compiler to create 
  19887.    dialog objects. 
  19888.  
  19889.  dialog template  - The definition of a dialog box, which contains details of 
  19890.    its position, appearance, and window ID, and the window ID of each of its 
  19891.    child windows. 
  19892.  
  19893.  direct device context  - A logical description of a data destination that is a 
  19894.    device other than the screen (for example, a printer or plotter), and where 
  19895.    the output is not to go through the spooler. Its purpose is to satisfy 
  19896.    queries. See also device context. 
  19897.  
  19898.  direct manipulation  - The user's ability to interact with an object by using 
  19899.    the mouse, typically by dragging an object around on the Desktop and 
  19900.    dropping it on other objects. 
  19901.  
  19902.  direct memory access (DMA)  - A technique for moving data directly between 
  19903.    main storage and peripheral equipment without requiring processing of the 
  19904.    data by the processing unit.(T)
  19905.  
  19906.  directory  - A type of file containing the names and controlling information 
  19907.    for other files or other directories. 
  19908.  
  19909.  display point  - Synonym for pel. 
  19910.  
  19911.  dithering  - (1) The process used in color displays whereby every other pel is 
  19912.    set to one color, and the intermediate pels are set to another. Together 
  19913.    they produce the effect of a third color at normal viewing distances. This 
  19914.    process can only be used on solid areas of color; it does not work, for 
  19915.    example, on narrow lines. (2) (D of C ) In computer graphics, a technique of 
  19916.    interleaving dark and light pixels so that the resulting image looks 
  19917.    smoothly shaded when viewed from a distance. 
  19918.  
  19919.  DMA  - Direct memory access. 
  19920.  
  19921.  DOS Protect Mode Interface (DPMI)  - An interface between protect mode and 
  19922.    real mode programs. 
  19923.  
  19924.  double-byte character set (DBCS)  - A set of characters in which each 
  19925.    character is represented by two bytes.  Languages such as Japanese, Chinese, 
  19926.    and Korean, which contain more characters than can be represented by 256 
  19927.    code points, require double-byte character sets. Since each character 
  19928.    requires two bytes, the entering, displaying, and printing of DBCS 
  19929.    characters requires hardware and software that can support DBCS. 
  19930.  
  19931.  doubleword  - A contiguous sequence of bits or characters that comprises two 
  19932.    computer words and is capable of being addressed as a unit. (A)
  19933.  
  19934.  DPMI  - DOS Protect Mode Interface. 
  19935.  
  19936.  drag  - In SAA Common User Access, to use a pointing device to move an object; 
  19937.    for example, clicking on a window border, and dragging it to make the window 
  19938.    larger. 
  19939.  
  19940.  dragging  - (1) In computer graphics, moving an object on the display screen 
  19941.    as if it were attached to the pointer. (2) (D of C) In computer graphics, 
  19942.    moving one or more segments on a display surface by translating. (I)  (A)
  19943.  
  19944.  drawing chain  - See segment chain. 
  19945.  
  19946.  drop  - To fix the position of an object that is being dragged, by releasing 
  19947.    the select button of the pointing device. 
  19948.  
  19949.  drop  - To fix the position of an object that is being dragged, by releasing 
  19950.    the select button of the pointing device. See also drag. 
  19951.  
  19952.  DTL  - Dialog tag language. 
  19953.  
  19954.  dual-boot function  - A feature of the OS/2 operating system that allows the 
  19955.    user to start DOS from within the operating system, or an OS/2 session from 
  19956.    within DOS. 
  19957.  
  19958.  duplex  - Pertaining to communication in which data can be sent and received 
  19959.    at the same time. Synonymous with full duplex. 
  19960.  
  19961.  dynamic data exchange (DDE)  - A message protocol used to communicate between 
  19962.    applications that share data. The protocol uses shared memory as the means 
  19963.    of exchanging data between applications. 
  19964.  
  19965.  dynamic data formatting  - A formatting procedure that enables you to 
  19966.    incorporate text, bit maps or metafiles in an IPF window at execution time. 
  19967.  
  19968.  dynamic link library  - A collection of executable programming code and data 
  19969.    that is bound to an application at load time or run time, rather than during 
  19970.    linking. The programming code and data in a dynamic link library can be 
  19971.    shared by several applications simultaneously. 
  19972.  
  19973.  dynamic linking  - The process of resolving external references in a program 
  19974.    module at load time or run time rather than during linking. 
  19975.  
  19976.  dynamic segments  - Graphics segments drawn in exclusive-OR mix mode so that 
  19977.    they can be moved from one screen position to another without affecting the 
  19978.    rest of the displayed picture. 
  19979.  
  19980.  dynamic storage  - (1) A device that stores data in a manner that permits the 
  19981.    data to move or vary with time such that the specified data is not always 
  19982.    available for recovery. (A)  (2) A storage in which the cells require 
  19983.    repetitive application of control signals in order to retain stored data. 
  19984.    Such repetitive application of the control signals is called a refresh 
  19985.    operation. A dynamic storage may use static addressing or sensing 
  19986.    circuits. (A)  (3) See also static storage. 
  19987.  
  19988.  dynamic time slicing  - Varies the size of the time slice depending on system 
  19989.    load and paging activity. 
  19990.  
  19991.  dynamic-link module  - A module that is linked at load time or run time. 
  19992.  
  19993.  
  19994. ΓòÉΓòÉΓòÉ <hidden> Glossary - E ΓòÉΓòÉΓòÉ
  19995.  
  19996.  EBCDIC  - Extended binary-coded decimal interchange code. A coded character 
  19997.    set consisting of 8-bit coded characters (9 bits including parity check), 
  19998.    used for information interchange among data processing systems, data 
  19999.    communications systems, and associated equipment. 
  20000.  
  20001.  edge-triggered  - Pertaining to an event semaphore that is posted then reset 
  20002.    before a waiting thread gets a chance to run. The semaphore is considered to 
  20003.    be posted for the rest of that thread's waiting period; the thread does not 
  20004.    have to wait for the semaphore to be posted again. 
  20005.  
  20006.  EGA  - Extended graphics adapter. 
  20007.  
  20008.  element  - An entry in a graphics segment that comprises one or more graphics 
  20009.    orders and that is addressed by the element pointer. 
  20010.  
  20011.  EMS  - Expanded Memory Specification. 
  20012.  
  20013.  encapsulation  - Hiding an object's implementation, that is, its private, 
  20014.    internal data and methods. Private variables and methods are accessible only 
  20015.    to the object that contains them. 
  20016.  
  20017.  entry field  - In SAA Common User Access architecture, an area where a user 
  20018.    types information. Its boundaries are usually indicated. See also selection 
  20019.    field. 
  20020.  
  20021.  entry panel  - A defined panel type containing one or more entry fields and 
  20022.    protected information such as headings, prompts, and explanatory text. 
  20023.  
  20024.  entry-field control  - The component of a user interface that provides the 
  20025.    means by which the application receives data entered by the user in an entry 
  20026.    field. When it has the input focus, the entry field displays a flashing 
  20027.    pointer at the position where the next typed character will go. 
  20028.  
  20029.  environment segment  - The list of environment variables and their values for 
  20030.    a process. 
  20031.  
  20032.  environment strings  - ASCII text strings that define the value of environment 
  20033.    variables. 
  20034.  
  20035.  environment variables  - Variables that describe the execution environment of 
  20036.    a process. These variables are named by the operating system or by the 
  20037.    application. Environment variables named by the operating system are PATH, 
  20038.    DPATH, INCLUDE, INIT, LIB, PROMPT, and TEMP. The values of environment 
  20039.    variables are defined by the user in the CONFIG.SYS file, or by using the 
  20040.    SET command at the OS/2 command prompt. 
  20041.  
  20042.  error message  - An indication that an error has been detected. (A)
  20043.  
  20044.  event semaphore  - A semaphore that enables a thread to signal a waiting 
  20045.    thread or threads that an event has occurred or that a task has been 
  20046.    completed. The waiting threads can then perform an action that is dependent 
  20047.    on the completion of the signaled event. 
  20048.  
  20049.  exception  - An abnormal condition such as an I/O error encountered in 
  20050.    processing a data set or a file. 
  20051.  
  20052.  exclusive system semaphore  - A system semaphore that can be modified only by 
  20053.    threads within the same process. 
  20054.  
  20055.  executable file  - (1) A file that contains programs or commands that perform 
  20056.    operations or actions to be taken. (2) A collection of related data records 
  20057.    that execute programs. 
  20058.  
  20059.  exit  - To execute an instruction within a portion of a computer program in 
  20060.    order to terminate the execution of that portion. Such portions of computer 
  20061.    programs include loops, subroutines, modules, and so on. (T)  Repeated exit 
  20062.    requests return the user to the point from which all functions provided to 
  20063.    the system are accessible. Contrast with cancel. 
  20064.  
  20065.  expanded memory specification (EMS)  - Enables DOS applications to access 
  20066.    memory above the 1MB real mode addressing limit. 
  20067.  
  20068.  extended attribute  - An additional piece of information about a file object, 
  20069.    such as its data format or category. It consists of a name and a value. A 
  20070.    file object may have more than one extended attribute associated with it. 
  20071.  
  20072.  extended help  - In SAA Common User Access architecture, a help action that 
  20073.    provides information about the contents of the application window from which 
  20074.    a user requested help. Contrast with contextual help. 
  20075.  
  20076.  extended-choice selection  - A mode that allows the user to select more than 
  20077.    one item from a window. Not all windows allow extended choice selection. 
  20078.    Contrast with multiple-choice selection. 
  20079.  
  20080.  extent  - Continuous space on a disk or diskette that is occupied by or 
  20081.    reserved for a particular data set, data space, or file. 
  20082.  
  20083.  external link  - In Information Presentation Facility, a link that connects 
  20084.    external online document files. 
  20085.  
  20086.  
  20087. ΓòÉΓòÉΓòÉ <hidden> Glossary - F ΓòÉΓòÉΓòÉ
  20088.  
  20089.  family-mode application  - An application program that can run in the OS/2 
  20090.    environment and in the DOS environment; however, it cannot take advantage of 
  20091.    many of the OS/2-mode facilities, such as multitasking, interprocess 
  20092.    communication, and dynamic linking. 
  20093.  
  20094.  FAT  - File allocation table. 
  20095.  
  20096.  FEA  - Full extended attribute. 
  20097.  
  20098.  field-level help  - Information specific to the field on which the cursor is 
  20099.    positioned. This help function is "contextual" because it provides 
  20100.    information about a specific item as it is currently used; the information 
  20101.    is dependent upon the context within the work session. 
  20102.  
  20103.  FIFO  - First-in-first-out. (A)
  20104.  
  20105.  file  - A named set of records stored or processed as a unit. (T)
  20106.  
  20107.  file allocation table (FAT)  - In IBM personal computers, a table used by the 
  20108.    operating system to allocate space on a disk for a file, and to locate and 
  20109.    chain together parts of the file that may be scattered on different sectors 
  20110.    so that the file can be used in a random or sequential manner. 
  20111.  
  20112.  file attribute  - Any of the attributes that describe the characteristics of a 
  20113.    file. 
  20114.  
  20115.  File Manager  - In the Presentation Manager, a program that displays 
  20116.    directories and files, and allows various actions on them. 
  20117.  
  20118.  file specification  - The full identifier for a file, which includes its drive 
  20119.    designation, path, file name, and extension. 
  20120.  
  20121.  file system  - The combination of software and hardware that supports storing 
  20122.    information on a storage device. 
  20123.  
  20124.  file system driver (FSD)  - A program that manages file I\O and controls the 
  20125.    format of information on the storage media. 
  20126.  
  20127.  fillet  - A curve that is tangential to the end points of two adjoining lines. 
  20128.    See also polyfillet. 
  20129.  
  20130.  filtering  - An application process that changes the order of data in a queue. 
  20131.  
  20132.  first-in-first-out (FIFO)  - A queuing technique in which the next item to be 
  20133.    retrieved is the item that has been in the queue for the longest time. (A)
  20134.  
  20135.  flag  - (1) An indicator or parameter that shows the setting of a switch. (2) 
  20136.    A character that signals the occurrence of some condition, such as the end 
  20137.    of a word. (A)  (3) (D of C) A characteristic of a file or directory that 
  20138.    enables it to be used in certain ways. See also archive flag, hidden flag, 
  20139.    and read-only flag. 
  20140.  
  20141.  focus  - See input focus. 
  20142.  
  20143.  folder  - A container used to organize objects. 
  20144.  
  20145.  font  - A particular size and style of typeface that contains definitions of 
  20146.    character sets, marker sets, and pattern sets. 
  20147.  
  20148.  Font Editor  - A utility program provided with the IBM Developers Toolkit that 
  20149.    enables the design and creation of new fonts. 
  20150.  
  20151.  foreground program  - (1) The program with which the user is currently 
  20152.    interacting. Also known as interactive program. Contrast with background 
  20153.    program. (2) (D of C) In multiprogramming,  a high-priority program. 
  20154.  
  20155.  frame  - The part of a window that can contain several different visual 
  20156.    elements specified by the application, but drawn and controlled by the 
  20157.    Presentation Manager. The frame encloses the client area. 
  20158.  
  20159.  frame styles  - Standard window layouts provided by the Presentation Manager. 
  20160.  
  20161.  FSD  - File system driver. 
  20162.  
  20163.  full-duplex  - Synonym for duplex. 
  20164.  
  20165.  full-screen application  - An application that has complete control of the 
  20166.    screen. 
  20167.  
  20168.  function  - (1) In a programming language, a block, with or without formal 
  20169.    parameters, whose execution is invoked by means of a call. (2) A set of 
  20170.    related control statements that cause one or more programs to be performed. 
  20171.  
  20172.  function key  - A key that causes a specified sequence of operations to be 
  20173.    performed when it is pressed, for example, F1 and Alt-K. 
  20174.  
  20175.  function key area  - The area at the bottom of a window that contains function 
  20176.    key assignments such as F1=Help. 
  20177.  
  20178.  
  20179. ΓòÉΓòÉΓòÉ <hidden> Glossary - G ΓòÉΓòÉΓòÉ
  20180.  
  20181.  GDT  - Global Descriptor Table. 
  20182.  
  20183.  general protection fault  - An exception condition that occurs when a process 
  20184.    attempts to use storage or a module that has some level of protection 
  20185.    assigned to it, such as I/O privilege level. See also IOPL code segment. 
  20186.  
  20187.  Global Descriptor Table (GDT)  - A table that defines code and data segments 
  20188.    available to all tasks in an application. 
  20189.  
  20190.  global dynamic-link module  - A dynamic-link module that can be shared by all 
  20191.    processes in the system that refer to the module name. 
  20192.  
  20193.  global file-name character  - Either a question mark (?) or an asterisk (*) 
  20194.    used as a variable in a file name or file name extension when referring to a 
  20195.    particular file or group of files. 
  20196.  
  20197.  glyph  - A graphic symbol whose appearance conveys information. 
  20198.  
  20199.  GPI  - Graphics programming interface. 
  20200.  
  20201.  graphic primitive  - In computer graphics, a basic element, such as an arc or 
  20202.    a line, that is not made up of smaller parts and that is used to create 
  20203.    diagrams and pictures. See also graphics segment. 
  20204.  
  20205.  graphics  - (1) A picture defined in terms of graphic primitives and graphics 
  20206.    attributes. (2) (D of C) The making of charts and pictures. (3) Pertaining 
  20207.    to charts, tables, and their creation. (4) See computer graphics, coordinate 
  20208.    graphics, fixed-image graphics, interactive graphics, passive graphics, 
  20209.    raster graphics. 
  20210.  
  20211.  graphics attributes  - Attributes that apply to graphic primitives. Examples 
  20212.    are color, line type, and shading-pattern definition. See also segment 
  20213.    attributes. 
  20214.  
  20215.  graphics field  - The clipping boundary that defines the visible part of the 
  20216.    presentation-page contents. 
  20217.  
  20218.  graphics mode  - One of several states of a display. The mode determines the 
  20219.    resolution and color content of the screen. 
  20220.  
  20221.  graphics model space  - The conceptual coordinate space in which a picture is 
  20222.    constructed after any model transforms have been applied. Also known as 
  20223.    model space. 
  20224.  
  20225.  Graphics programming interface  - The formally defined programming language 
  20226.    that is between an IBM graphics program and the user of the program. 
  20227.  
  20228.  graphics segment  - A sequence of related graphic primitives and graphics 
  20229.    attributes. See also graphic primitive. 
  20230.  
  20231.  graying  - The indication that a choice on a pull-down is unavailable. 
  20232.  
  20233.  group  - A collection of logically connected controls. For example, the 
  20234.    buttons controlling paper size for a printer could be called a group. See 
  20235.    also program group. 
  20236.  
  20237.  
  20238. ΓòÉΓòÉΓòÉ <hidden> Glossary - H ΓòÉΓòÉΓòÉ
  20239.  
  20240.  handle  - (1) An identifier that represents an object, such as a device or 
  20241.    window, to the Presentation Interface. (2) (D of C) In the Advanced DOS and 
  20242.    OS/2 operating systems, a binary value created by the system that identifies 
  20243.    a drive, directory, and file so that the file can be found and opened. 
  20244.  
  20245.  hard error  - An error condition on a network that requires either that the 
  20246.    system be reconfigured or that the source of the error be removed before the 
  20247.    system can resume reliable operation. 
  20248.  
  20249.  header  - (1) System-defined control information that precedes user data. (2) 
  20250.    The portion of a message that contains control information for the message, 
  20251.    such as one or more destination fields, name of the originating station, 
  20252.    input sequence number, character string indicating the type of message, and 
  20253.    priority level for the message. 
  20254.  
  20255.  heading tags  - A document element that enables information to be displayed in 
  20256.    windows, and that controls entries in the contents window controls placement 
  20257.    of push buttons in a window, and defines the shape and size of windows. 
  20258.  
  20259.  heap  - An area of free storage available for dynamic allocation by an 
  20260.    application. Its size varies according to the storage requirements of the 
  20261.    application. 
  20262.  
  20263.  help function  - (1) A function that provides information about a specific 
  20264.    field, an application panel, or information about the help facility. (2) (D 
  20265.    of C) One or more display images that describe how to use application 
  20266.    software or how to do a system operation. 
  20267.  
  20268.  Help index  - In SAA Common User Access architecture, a help action that 
  20269.    provides an index of the help information available for an application. 
  20270.  
  20271.  help panel  - A panel with information to assist users that is displayed in 
  20272.    response to a help request from the user. 
  20273.  
  20274.  help window  - A Common-User-Access-defined secondary window that displays 
  20275.    information when the user requests help. 
  20276.  
  20277.  hidden file  - An operating system file that is not displayed by a directory 
  20278.    listing. 
  20279.  
  20280.  hide button  - In the OS/2 operating system, a small, square button located in 
  20281.    the right-hand corner of the title bar of a window that, when selected, 
  20282.    removes from the screen all the windows associated with that window. 
  20283.    Contrast with maximize button. See also restore button. 
  20284.  
  20285.  hierarchical inheritance  - The relationship between parent and child classes. 
  20286.    An object that is lower in the inheritance hierarchy than another object, 
  20287.    inherits all the characteristics and behaviors of the objects above it in 
  20288.    the hierarchy. 
  20289.  
  20290.  hierarchy  - A tree of segments beginning with the root segment and proceeding 
  20291.    downward to dependent segment types. 
  20292.  
  20293.  high-performance file system (HPFS)  - In the OS/2 operating system, an 
  20294.    installable file system that uses high-speed buffer storage, known as a 
  20295.    cache, to provide fast access to large disk volumes. The file system also 
  20296.    supports the coexistence of multiple, active file systems on a single 
  20297.    personal computer, with the capability of multiple and different storage 
  20298.    devices. File names used with the HPFS can have as many as 254 characters. 
  20299.  
  20300.  hit testing  - The means of identifying which window is associated with which 
  20301.    input device event. 
  20302.  
  20303.  hook  - A point in a system-defined function where an application can supply 
  20304.    additional code that the system processes as though it were part of the 
  20305.    function. 
  20306.  
  20307.  hook chain  - A sequence of hook procedures that are "chained" together so 
  20308.    that each event is passed, in turn, to each procedure in the chain. 
  20309.  
  20310.  hot spot  - The part of the pointer that must touch an object before it can be 
  20311.    selected. This is usually the tip of the pointer. Contrast with action 
  20312.    point. 
  20313.  
  20314.  HPFS  - high-performance file system. 
  20315.  
  20316.  hypergraphic link  - A connection between one piece of information and another 
  20317.    through the use of graphics. 
  20318.  
  20319.  hypertext  - A way of presenting information online with connections between 
  20320.    one piece of information and another, called hypertext links. See also 
  20321.    hypertext link. 
  20322.  
  20323.  hypertext link  - A connection between one piece of information and another. 
  20324.  
  20325.  
  20326. ΓòÉΓòÉΓòÉ <hidden> Glossary - I ΓòÉΓòÉΓòÉ
  20327.  
  20328.  I/O operation  - An input operation to, or output operation from a device 
  20329.    attached to a computer. 
  20330.  
  20331.  I-beam pointer  - A pointer that indicates an area, such as an entry field in 
  20332.    which text can be edited. 
  20333.  
  20334.  icon  - In SAA Advanced Common User Access architecture, a graphical 
  20335.    representation of an object, consisting of an image, image background, and a 
  20336.    label. Icons can represent items (such as a document file) that the user 
  20337.    wants to work on, and actions that the user wants to perform. In the 
  20338.    Presentation Manager, icons are used for data objects, system actions, and 
  20339.    minimized programs. 
  20340.  
  20341.  icon area  - In the Presentation Manager, the area at the bottom of the screen 
  20342.    that is normally used to display the icons for minimized programs. 
  20343.  
  20344.  Icon Editor  - The Presentation Manager-provided tool for creating icons. 
  20345.  
  20346.  IDL  - Interface Definition Language. 
  20347.  
  20348.  image font  - A set of symbols, each of which is described in a rectangular 
  20349.    array of pels. Some of the pels in the array are set to produce the image of 
  20350.    one of the symbols. Contrast with outline font. 
  20351.  
  20352.  implied metaclass  - Subclassing the metaclass of a parent class without a 
  20353.    separate CSC for the resultant metaclass. 
  20354.  
  20355.  indirect manipulation  - Interaction with an object through choices and 
  20356.    controls. 
  20357.  
  20358.  information device context  - A logical description of a data destination 
  20359.    other than the screen (for example, a printer or plotter), but where no 
  20360.    output will occur. Its purpose is to satisfy queries. See also device 
  20361.    context. 
  20362.  
  20363.  information panel  - A defined panel type characterized by a body containing 
  20364.    only protected information. 
  20365.  
  20366.  Information Presentation Facility (IPF)  - A facility provided by the OS/2 
  20367.    operating system, by which application developers can produce online 
  20368.    documentation and context-sensitive online help panels for their 
  20369.    applications. 
  20370.  
  20371.  inheritance  - The technique of specifying the shape and behavior of one class 
  20372.    (called a subclass) as incremental differences from another class (called 
  20373.    the parent class or superclass). The subclass inherits the superclass' state 
  20374.    representation and methods, and can provide additional data elements and 
  20375.    methods. The subclass also can provide new functions with the same method 
  20376.    names used by the superclass. Such a subclass method is said to override the 
  20377.    superclass method, and will be selected automatically by method resolution 
  20378.    on subclass instances. An overriding method can elect to call upon the 
  20379.    superclass' method as part of its own implementation. 
  20380.  
  20381.  input focus  - (1) The area of a window where user interaction is possible 
  20382.    using an input device, such as a mouse or the keyboard. (2) The position in 
  20383.    the active window where a user's normal interaction with the keyboard will 
  20384.    appear. 
  20385.  
  20386.  input router  - An internal OS/2 process that removes messages from the system 
  20387.    queue. 
  20388.  
  20389.  input/output control  - A device-specific command that requests a function of 
  20390.    a device driver. 
  20391.  
  20392.  installable file system (IFS)  - A file system in which software is installed 
  20393.    when the operating system is started. 
  20394.  
  20395.  instance  - (Or object instance). A specific object, as distinguished from the 
  20396.    abstract definition of an object referred to as its class. 
  20397.  
  20398.  instance method  - A method valid for a particular object. 
  20399.  
  20400.  instruction pointer  - In System/38, a pointer that provides addressability 
  20401.    for a machine interface instruction in a program. 
  20402.  
  20403.  integer atom  - An atom that represents a predefined system constant and 
  20404.    carries no storage overhead. For example, names of window classes provided 
  20405.    by Presentation Manager are expressed as integer atoms. 
  20406.  
  20407.  interactive graphics  - Graphics that can be moved or manipulated by a user at 
  20408.    a terminal. 
  20409.  
  20410.  interactive program  - (1) A program that is running (active) and is ready to 
  20411.    receive (or is receiving) input from a user. (2) A running program that can 
  20412.    receive input from the keyboard or another input device. Compare with active 
  20413.    program and contrast with noninteractive program. 
  20414.  
  20415.    Also known as a foreground program. 
  20416.  
  20417.  interchange file  - A file containing data that can be sent from one 
  20418.    Presentation Manager interface application to another. 
  20419.  
  20420.  Interface Definition Language (IDL)  - Language-neutral interface 
  20421.    specification for a SOM class. 
  20422.  
  20423.  interpreter  - A program that translates and executes each instruction of a 
  20424.    high-level programming language before it translates and executes. 
  20425.  
  20426.  interprocess communication (IPC)  - In the OS/2 operating system, the exchange 
  20427.    of information between processes or threads through semaphores, pipes, 
  20428.    queues, and shared memory. 
  20429.  
  20430.  interval timer  - (1) A timer that provides program interruptions on a 
  20431.    program-controlled basis. (2) An electronic counter that counts intervals of 
  20432.    time under program control. 
  20433.  
  20434.  IOCtl  - Input/output control. 
  20435.  
  20436.  IOPL  - Input/output privilege level. 
  20437.  
  20438.  IOPL code segment  - An IOPL executable section of programming code that 
  20439.    enables an application to directly manipulate hardware interrupts and ports 
  20440.    without replacing the device driver. See also privilege level. 
  20441.  
  20442.  IPC  - Interprocess communication. 
  20443.  
  20444.  IPF  - Information Presentation Facility. 
  20445.  
  20446.  IPF compiler  - A text compiler that interpret tags in a source file and 
  20447.    converts the information into the specified format. 
  20448.  
  20449.  IPF tag language  - A markup language that provides the instructions for 
  20450.    displaying online information. 
  20451.  
  20452.  item  - A data object that can be passed in a DDE transaction. 
  20453.  
  20454.  
  20455. ΓòÉΓòÉΓòÉ <hidden> Glossary - J ΓòÉΓòÉΓòÉ
  20456.  
  20457.  journal  - A special-purpose file that is used to record changes made in the 
  20458.    system. 
  20459.  
  20460.  
  20461. ΓòÉΓòÉΓòÉ <hidden> Glossary - K ΓòÉΓòÉΓòÉ
  20462.  
  20463.  Kanji  - A graphic character set used in Japanese ideographic alphabets. 
  20464.  
  20465.  KBD$  - Character-device name reserved for the keyboard. 
  20466.  
  20467.  kernel  - The part of an operating system that performs basic functions, such 
  20468.    as allocating hardware resources. 
  20469.  
  20470.  kerning  - The design of graphics characters so that their character boxes 
  20471.    overlap. Used to space text proportionally. 
  20472.  
  20473.  keyboard accelerator  - A keystroke that generates a command message for an 
  20474.    application. 
  20475.  
  20476.  keyboard augmentation  - A function that enables a user to press a keyboard 
  20477.    key while pressing a mouse button. 
  20478.  
  20479.  keyboard focus  - A temporary attribute of a window. The window that has a 
  20480.    keyboard focus receives all keyboard input until the focus changes to a 
  20481.    different window. 
  20482.  
  20483.  Keys help  - In SAA Common User Access architecture, a help action that 
  20484.    provides a listing of the application keys and their assigned functions. 
  20485.  
  20486.  
  20487. ΓòÉΓòÉΓòÉ <hidden> Glossary - L ΓòÉΓòÉΓòÉ
  20488.  
  20489.  label  - In a graphics segment, an identifier of one or more elements that is 
  20490.    used when editing the segment. 
  20491.  
  20492.  LAN  - local area network. 
  20493.  
  20494.  language support procedure  - A function provided by the Presentation Manager 
  20495.    Interface for applications that do not, or cannot (as in the case of COBOL 
  20496.    and FORTRAN programs), provide their own dialog or window procedures. 
  20497.  
  20498.  lazy drag  - See pickup and drop. 
  20499.  
  20500.  lazy drag set  - See pickup set. 
  20501.  
  20502.  LDT  - In the OS/2 operating system, Local Descriptor Table. 
  20503.  
  20504.  LIFO stack  - A stack from which data is retrieved in last-in, first-out 
  20505.    order. 
  20506.  
  20507.  linear address  - A unique value that identifies the memory object. 
  20508.  
  20509.  linked list  - Synonym for chained list. 
  20510.  
  20511.  list box  - In SAA Advanced Common User Access architecture, a control that 
  20512.    contains scrollable choices from which a user can select one choice. 
  20513.  
  20514.    Note:  In CUA architecture, this is a programmer term. The end user term is 
  20515.    selection list. 
  20516.  
  20517.  list button  - A button labeled with an underlined down-arrow that presents a 
  20518.    list of valid objects or choices that can be selected for that field. 
  20519.  
  20520.  list panel  - A defined panel type that displays a list of items from which 
  20521.    users can select one or more choices and then specify one or more actions to 
  20522.    work on those choices. 
  20523.  
  20524.  load time  - The point in time at which a program module is loaded into main 
  20525.    storage for execution. 
  20526.  
  20527.  load-on-call  - A function of a linkage editor that allows selected segments 
  20528.    of the module to be disk resident while other segments are executing. Disk 
  20529.    resident segments are loaded for execution and given control when any entry 
  20530.    point that they contain is called. 
  20531.  
  20532.  local area network (LAN)  - (1) A computer network located on a user's 
  20533.    premises within a limited geographical area. Communication within a local 
  20534.    area network is not subject to external regulations;  however, communication 
  20535.    across the LAN boundary may be subject to some form of regulation. (T)
  20536.  
  20537.    Note:  A LAN does not use store and forward techniques. (2) A network 
  20538.    inwhich a set of devices are connected to one another for communication and 
  20539.    that can be connected to a larger network. 
  20540.  
  20541.  Local Descriptor Table (LDT)  - Defines code and data segments specific to a 
  20542.    single task. 
  20543.  
  20544.  lock  - A serialization mechanism by means of which a resource is restricted 
  20545.    for use by the holder of the lock. 
  20546.  
  20547.  logical storage device  - A device that the user can map to a physical 
  20548.    (actual) device. 
  20549.  
  20550.  LPT1, LPT2, LPT3  - Character-device names reserved for parallel printers 1 
  20551.    through 3. 
  20552.  
  20553.  
  20554. ΓòÉΓòÉΓòÉ <hidden> Glossary - M ΓòÉΓòÉΓòÉ
  20555.  
  20556.  main window  - The window that is positioned relative to the desktop window. 
  20557.  
  20558.  manipulation button  - The button on a pointing device a user presses to 
  20559.    directly manipulate an object. 
  20560.  
  20561.  map  - (1) A set of values having a defined correspondence with the quantities 
  20562.    or values of another set. (I)  (A)  (2) To establish a set of values having 
  20563.    a defined correspondence with the quantities or values of another set. (I)
  20564.  
  20565.  marker box  - In computer graphics, the boundary that defines, in world 
  20566.    coordinates, the horizontal and vertical space occupied by a single marker 
  20567.    from a marker set. 
  20568.  
  20569.  marker symbol  - A symbol centered on a point. Graphs and charts can use 
  20570.    marker symbols to indicate the plotted points. 
  20571.  
  20572.  marquee box  - The rectangle that appears during a selection technique in 
  20573.    which a user selects objects by drawing a box around them with a pointing 
  20574.    device. 
  20575.  
  20576.  Master Help Index  - In the OS/2 operating system, an alphabetic list of help 
  20577.    topics related to using the operating system. 
  20578.  
  20579.  maximize  - To enlarge a window to its largest possible size. 
  20580.  
  20581.  media window  - The part of the physical device (display, printer, or plotter) 
  20582.    on which a picture is presented. 
  20583.  
  20584.  memory block  - Part memory within a heap. 
  20585.  
  20586.  memory device context  - A logical description of a data destination that is a 
  20587.    memory bit map. See also device context. 
  20588.  
  20589.  memory management  - A feature of the operating system for allocating, 
  20590.    sharing, and freeing main storage. 
  20591.  
  20592.  memory object  - Logical unit of memory requested by an application, which 
  20593.    forms the granular unit of memory manipulation from the application 
  20594.    viewpoint. 
  20595.  
  20596.  menu  - In SAA Advanced Common User Access architecture, an extension of the 
  20597.    menu bar that displays a list of choices available for a selected choice in 
  20598.    the menu bar. After a user selects a choice in menu bar, the corresponding 
  20599.    menu appears. Additional pop-up windows can appear from menu choices. 
  20600.  
  20601.  menu bar  - In SAA Advanced Common User Access architecture, the area near the 
  20602.    top of a window, below the title bar and above the rest of the window, that 
  20603.    contains choices that provide access to other menus. 
  20604.  
  20605.  menu button  - The button on a pointing device that a user presses to view a 
  20606.    pop-up menu associated with an object. 
  20607.  
  20608.  message  - (1) In the Presentation Manager, a packet of data used for 
  20609.    communication between the Presentation Manager interface and Presentation 
  20610.    Manager applications (2) In a user interface, information not requested by 
  20611.    users but presented to users by the computer in response to a user action or 
  20612.    internal process. 
  20613.  
  20614.  message box  - (1) A dialog window predefined by the system and used as a 
  20615.    simple interface for applications, without the necessity of creating 
  20616.    dialog-template resources or dialog procedures. (2) (D of C) In SAA Advanced 
  20617.    Common User Access architecture, a type of window that shows messages to 
  20618.    users. See also dialog box, primary window, secondary window. 
  20619.  
  20620.  message filter  - The means of selecting which messages from a specific window 
  20621.    will be handled by the application. 
  20622.  
  20623.  message queue  - A sequenced collection of messages to be read by the 
  20624.    application. 
  20625.  
  20626.  message stream mode  - A method of operation in which data is treated as a 
  20627.    stream of messages.  Contrast with  byte stream. 
  20628.  
  20629.  metacharacter  - See global file-name character. 
  20630.  
  20631.  metaclass  - A class whose instances are all classes. In SOM, any class 
  20632.    descended from SOMClass is a metaclass. The methods of a metaclass are 
  20633.    sometimes called "class" methods. 
  20634.  
  20635.  metafile  - A file containing a series of attributes that set color, shape and 
  20636.    size, usually of a picture or a drawing. Using a program that can interpret 
  20637.    these attributes, a user can view the assembled image. 
  20638.  
  20639.  metafile device context  - A logical description of a data destination that is 
  20640.    a metafile, which is used for graphics interchange. See also device context. 
  20641.  
  20642.  metalanguage  - A language used to specify another language. For example, data 
  20643.    types can be described using a metalanguage so as to make the descriptions 
  20644.    independent of any one computer language. 
  20645.  
  20646.  method  - One of the units that makes up the behavior of an object. A method 
  20647.    is a combination of a function and a name, such that many different 
  20648.    functions can have the same name. Which function the name refers to at any 
  20649.    point in time depends on the object that is to execute the method and is the 
  20650.    subject of method resolution. 
  20651.  
  20652.  method override  - The replacement, by a child class, of the implementation of 
  20653.    a method inherited from a parent and an ancestor class. 
  20654.  
  20655.  mickey  - A unit of measurement for physical mouse motion whose value depends 
  20656.    on the mouse device driver currently loaded. 
  20657.  
  20658.  micro presentation space  - A graphics presentation space in which a 
  20659.    restricted set of the GPI function calls is available. 
  20660.  
  20661.  minimize  - To remove from the screen all windows associated with an 
  20662.    application and replace them with an icon that represents the application. 
  20663.  
  20664.  mix  - An attribute that determines how the foreground of a graphic primitive 
  20665.    is combined with the existing color of graphics output. Also known as 
  20666.    foreground mix. Contrast with background mix. 
  20667.  
  20668.  mixed character string  - A string containing a mixture of one-byte and Kanji 
  20669.    or Hangeul (two-byte) characters. 
  20670.  
  20671.  mnemonic  - (1) A method of selecting an item on a pull-down by means of 
  20672.    typing the highlighted letter in the menu item. (2) (D of C) In SAA Advanced 
  20673.    Common User Access architecture, usually a single character, within the text 
  20674.    of a choice, identified by an underscore beneath the character. If all 
  20675.    characters in a choice already serve as mnemonics for other choices, another 
  20676.    character, placed in parentheses immediately following the choice, can be 
  20677.    used. When a user types the mnemonic for a choice, the choice is either 
  20678.    selected or the cursor is moved to that choice. 
  20679.  
  20680.  modal dialog box  - In SAA Advanced Common User Access architecture, a type of 
  20681.    movable window, fixed in size, that requires a user to enter information 
  20682.    before continuing to work in the application window from which it was 
  20683.    displayed. Contrast with modeless dialog box. Also known as a serial dialog 
  20684.    box. Contrast with parallel dialog box. 
  20685.  
  20686.    Note:  In CUA architecture, this is a programmer term. The end user term is 
  20687.    pop-up window. 
  20688.  
  20689.  model space  - See graphics model space. 
  20690.  
  20691.  modeless dialog box  - In SAA Advanced Common User Access architecture, a type 
  20692.    of movable window, fixed in size, that allows users to continue their dialog 
  20693.    with the application without entering information in the dialog box. Also 
  20694.    known as a parallel dialog box. Contrast with modal dialog box. 
  20695.  
  20696.    Note:  In CUA architecture, this is a programmer term. The end user term is 
  20697.    pop-up window. 
  20698.  
  20699.  module definition file  - A file that describes the code segments within a 
  20700.    load module. For example, it indicates whether a code segment is loadable 
  20701.    before module execution begins (preload), or loadable only when referred to 
  20702.    at run time (load-on-call). 
  20703.  
  20704.  mouse  - In SAA usage, a device that a user moves on a flat surface to 
  20705.    position a pointer on the screen. It allows a user to select a choice o 
  20706.    function to be performed or to perform operations on the screen, such as 
  20707.    dragging or drawing lines from one position to another. 
  20708.  
  20709.  MOUSE$  - Character-device name reserved for a mouse. 
  20710.  
  20711.  multiple-choice selection  - In SAA Basic Common User Access architecture, a 
  20712.    type of field from which a user can select one or more choices or select 
  20713.    none. See also check box. Contrast with extended-choice selection. 
  20714.  
  20715.  multiple-line entry field  - In SAA Advanced Common User Access architecture, 
  20716.    a control into which a user types more than one line of information. See 
  20717.    also single-line entry field. 
  20718.  
  20719.  multitasking  - The concurrent processing of applications or parts of 
  20720.    applications. A running application and its data are protected from other 
  20721.    concurrently running applications. 
  20722.  
  20723.  mutex semaphore  - (Mutual exclusion semaphore). A semaphore that enables 
  20724.    threads to serialize their access to resources. Only the thread that 
  20725.    currently owns the mutex semaphore can gain access to the resource, thus 
  20726.    preventing one thread from interrupting operations being performed by 
  20727.    another. 
  20728.  
  20729.  muxwait semaphore  - (Multiple wait semaphore). A semaphore that enables a 
  20730.    thread to wait either for multiple event semaphores to be posted or for 
  20731.    multiple mutex semaphores to be released. Alternatively, a muxwait semaphore 
  20732.    can be set to enable a thread to wait for any ONE of the event or mutex 
  20733.    semaphores in the muxwait semaphore's list to be posted or released. 
  20734.  
  20735.  
  20736. ΓòÉΓòÉΓòÉ <hidden> Glossary - N ΓòÉΓòÉΓòÉ
  20737.  
  20738.  named pipe  - A named buffer that provides client-to-server, server-to-client, 
  20739.    or full duplex communication between unrelated processes. Contrast with 
  20740.    unnamed pipe. 
  20741.  
  20742.  national language support (NLS)  - The modification or conversion of a United 
  20743.    States English product to conform to the requirements of another language or 
  20744.    country. This can include the enabling or retrofitting of a product and the 
  20745.    translation of nomenclature, MRI, or documentation of a product. 
  20746.  
  20747.  nested list  - A list that is contained within another list. 
  20748.  
  20749.  NLS  - national language support. 
  20750.  
  20751.  non-8.3 file-name format  - A file-naming convention in which file names can 
  20752.    consist of up to 255 characters. See also 8.3 file-name format. 
  20753.  
  20754.  noncritical extended attribute  - An extended attribute that is not necessary 
  20755.    for the function of an application. 
  20756.  
  20757.  nondestructive read  - Reading that does not erase the data in the source 
  20758.    location. (T)
  20759.  
  20760.  noninteractive program  - A running program that cannot receive input from the 
  20761.    keyboard or other input device. Compare with active program, and contrast 
  20762.    with interactive program. 
  20763.  
  20764.  nonretained graphics  - Graphic primitives that are not remembered by the 
  20765.    Presentation Manager interface when they have been drawn. Contrast with 
  20766.    retained graphics. 
  20767.  
  20768.  null character (NUL)  - (1) Character-device name reserved for a nonexistent 
  20769.    (dummy) device. (2) (D of C) A control character that is used to accomplish 
  20770.    media-fill or time-fill and that may be inserted into or removed from a 
  20771.    sequence of characters without affecting the meaning of the sequence; 
  20772.    however, the control of equipment or the format may be affected by this 
  20773.    character. (I)  (A)
  20774.  
  20775.  null-terminated string  - A string of (n+1) characters where the (n+1)th 
  20776.    character is the 'null' character (0x00) Also known as 'zero-terminated' 
  20777.    string and 'ASCIIZ' string. 
  20778.  
  20779.  
  20780. ΓòÉΓòÉΓòÉ <hidden> Glossary - O ΓòÉΓòÉΓòÉ
  20781.  
  20782.  object  - The elements of data and function that programs create, manipulate, 
  20783.    pass as arguments, and so forth. An object is a way of associating specific 
  20784.    data values with a specific set of named functions (called methods) for a 
  20785.    period of time (referred to as the lifetime of the object). The data values 
  20786.    of an object are referred to as its state. In SOM, objects are created by 
  20787.    other objects called classes. The specification of what comprises the set of 
  20788.    functions and data elements that make up an object is referred to as the 
  20789.    definition of a class. 
  20790.  
  20791.    SOM objects offer a high degree of encapsulation. This property permits many 
  20792.    aspects of the implementation of an object to change without affecting 
  20793.    client programs that depend on the object's behavior. 
  20794.  
  20795.  object definition  - See class. 
  20796.  
  20797.  object instance  - See instance. 
  20798.  
  20799.  Object Interface Definition Language (OIDL)  - Specification language used in 
  20800.    SOM Version 1 for defining classes. Replaced by Interface Definition 
  20801.    Language (IDL). 
  20802.  
  20803.  object window  - A window that does not have a parent but which might have 
  20804.    child windows. An object window cannot be presented on a device. 
  20805.  
  20806.  OIDL  - Object Interface Definition Language. 
  20807.  
  20808.  open  - To start working with a file, directory, or other object. 
  20809.  
  20810.  ordered list  - Vertical arrangements of items, with each item in the list 
  20811.    preceded by a number or letter. 
  20812.  
  20813.  outline font  - A set of symbols, each of which is created as a series of 
  20814.    lines and curves.  Synonymous with vector font. Contrast with image font. 
  20815.  
  20816.  output area  - An area of storage reserved for output. (A)
  20817.  
  20818.  owner window  - A window into which specific events that occur in another 
  20819.    (owned) window are reported. 
  20820.  
  20821.  ownership  - The determination of how windows communicate using messages. 
  20822.  
  20823.  owning process  - The process that owns the resources that might be shared 
  20824.    with other processes. 
  20825.  
  20826.  
  20827. ΓòÉΓòÉΓòÉ <hidden> Glossary - P ΓòÉΓòÉΓòÉ
  20828.  
  20829.  page  - (1) A 4KB segment of contiguous physical memory. (2) (D of C) A 
  20830.    defined unit of space on a storage medium. 
  20831.  
  20832.  page viewport  - A boundary in device coordinates that defines the area of the 
  20833.    output device in which graphics are to be displayed. The presentation-page 
  20834.    contents are transformed automatically to the page viewport in device space. 
  20835.  
  20836.  paint  - (1) The action of drawing or redrawing the contents of a window. (2) 
  20837.    In computer graphics, to shade an area of a display image;  for example, 
  20838.    with crosshatching or color. 
  20839.  
  20840.  panel  - In SAA Basic Common User Access architecture, a particular 
  20841.    arrangement of information that is presented in a window or pop-up. If some 
  20842.    of the information is not visible, a user can scroll through the 
  20843.    information. 
  20844.  
  20845.  panel area  - An area within a panel that contains related information. The 
  20846.    three major Common User Access-defined panel areas are the action bar, the 
  20847.    function key area, and the panel body. 
  20848.  
  20849.  panel area separator  - In SAA Basic Common User Access architecture, a solid, 
  20850.    dashed, or blank line that provides a visual distinction between two 
  20851.    adjacent areas of a panel. 
  20852.  
  20853.  panel body  - The portion of a panel not occupied by the action bar, function 
  20854.    key area, title or scroll bars. The panel body can contain protected 
  20855.    information, selection fields, and entry fields. The layout and content of 
  20856.    the panel body determine the panel type. 
  20857.  
  20858.  panel body area  - See client area. 
  20859.  
  20860.  panel definition  - A description of the contents and characteristics of a 
  20861.    panel. A panel definition is the application developer's mechanism for 
  20862.    predefining the format to be presented to users in a window. 
  20863.  
  20864.  panel ID  - In SAA Basic Common User Access architecture, a panel identifier, 
  20865.    located in the upper-left corner of a panel.  A user can choose whether to 
  20866.    display the panel ID. 
  20867.  
  20868.  panel title  - In SAA Basic Common User Access architecture, a particular 
  20869.    arrangement of information that is presented in a window or pop-up. If some 
  20870.    of the information is not visible, a user can scroll through the 
  20871.    information. 
  20872.  
  20873.  paper size  - The size of paper, defined in either standard U.S. or European 
  20874.    names (for example, A, B, A4), and measured in inches or millimeters 
  20875.    respectively. 
  20876.  
  20877.  parallel dialog box  - See modeless dialog box. 
  20878.  
  20879.  parameter list  - A list of values that provides a means of associating 
  20880.    addressability of data defined in a called program with data in the calling 
  20881.    program. It contains parameter names and the order in which they are to be 
  20882.    associated in the calling and called program. 
  20883.  
  20884.  parent class  - See inheritance. 
  20885.  
  20886.  parent process  - In the OS/2 operating system, a process that creates other 
  20887.    processes. Contrast with child process. 
  20888.  
  20889.  parent window  - In the OS/2 operating system, a window that creates a child 
  20890.    window. The child window is drawn within the parent window. If the parent 
  20891.    window is moved, resized, or destroyed, the child window also will be moved, 
  20892.    resized, or destroyed. However, the child window can be moved and resized 
  20893.    independently from the parent window, within the boundaries of the parent 
  20894.    window. Contrast with child window. 
  20895.  
  20896.  partition  - (1) A fixed-size division of storage. (2) On an IBM personal 
  20897.    computer fixed disk, one of four possible storage areas of variable size; 
  20898.    one may be accessed by DOS, and each of the others may be assigned to 
  20899.    another operating system. 
  20900.  
  20901.  Paste  - A choice in the Edit pull-down that a user selects to move the 
  20902.    contents of the clipboard into a preselected location. See also Copy and 
  20903.    Cut. 
  20904.  
  20905.  path  - The route used to locate files; the storage location of a file. A 
  20906.    fully qualified path lists the drive identifier, directory name, 
  20907.    subdirectory name (if any), and file name with the associated extension. 
  20908.  
  20909.  PDD  - Physical device driver. 
  20910.  
  20911.  peeking  - An action taken by any thread in the process that owns the queue to 
  20912.    examine queue elements without removing them. 
  20913.  
  20914.  pel  - (1) The smallest area of a display screen capable of being addressed 
  20915.    and switched between visible and invisible states. Synonym for display 
  20916.    point, pixel, and picture element. (2) (D of C) Picture element. 
  20917.  
  20918.  persistent object  - An object whose instance data and state are preserved 
  20919.    between system shutdown and system startup. 
  20920.  
  20921.  physical device driver (PDD)  - A system interface that handles hardware 
  20922.    interrupts and supports a set of input and output functions. 
  20923.  
  20924.  pick  - To select part of a displayed object using the pointer. 
  20925.  
  20926.  pickup  - To add an object or set of objects to the pickup set. 
  20927.  
  20928.  pickup and drop  - A drag operation that does not require the direct 
  20929.    manipulation button to be pressed for the duration of the drag. 
  20930.  
  20931.  pickup set  - The set of objects that have been picked up as part of a pickup 
  20932.    and drop operation. 
  20933.  
  20934.  picture chain  - See segment chain. 
  20935.  
  20936.  picture element  - (1) Synonym for pel. (2) (D of C) In computer graphics, the 
  20937.    smallest element of a display surface that can be independently assigned 
  20938.    color and intensity. (T)  . (3) The area of the finest detail that can be 
  20939.    reproduced effectively on the recording medium. 
  20940.  
  20941.  PID  - Process identification. 
  20942.  
  20943.  pipe  - (1) A named or unnamed buffer used to pass data between processes. A 
  20944.    process reads from or writes to a pipe as if the pipe were a standard-input 
  20945.    or standard-output file. See also named pipe and unnamed pipe. (2) (D of C) 
  20946.    To direct data so that the output from one process becomes the input to 
  20947.    another process. The standard output of one command can be connected to the 
  20948.    standard input of another with the pipe operator (|). 
  20949.  
  20950.  pixel  - (1) Synonym for pel. (2) (D of C) Picture element. 
  20951.  
  20952.  plotter  - An output unit that directly produces a hardcopy record of data on 
  20953.    a removable medium, in the form of a two-dimensional graphic representation. (T)
  20954.  
  20955.  PM  - Presentation Manager. 
  20956.  
  20957.  pointer  - (1) The symbol displayed on the screen that is moved by a pointing 
  20958.    device, such as a mouse. The pointer is used to point at items that users 
  20959.    can select. Contrast with cursor. (2) A data element that indicates the 
  20960.    location of another data element. (T)
  20961.  
  20962.  POINTER$  - Character-device name reserved for a pointer device (mouse screen 
  20963.    support). 
  20964.  
  20965.  pointing device  - In SAA Advanced Common User Access architecture, an 
  20966.    instrument, such as a mouse, trackball, or joystick, used to move a pointer 
  20967.    on the screen. 
  20968.  
  20969.  pointings  - Pairs of x-y coordinates produced by an operator defining 
  20970.    positions on a screen with a pointing device, such as a mouse. 
  20971.  
  20972.  polyfillet  - A curve based on a sequence of lines. The curve is tangential to 
  20973.    the end points of the first and last lines, and tangential also to the 
  20974.    midpoints of all other lines. See also fillet. 
  20975.  
  20976.  polygon  - One or more closed figures that can be drawn filled, outlined, or 
  20977.    filled and outlined. 
  20978.  
  20979.  polyline  - A sequence of adjoining lines. 
  20980.  
  20981.  polymorphism  - The ability to have different implementations of the same 
  20982.    method for two or more classes of objects. 
  20983.  
  20984.  pop  - To retrieve an item from a last-in-first-out stack of items. Contrast 
  20985.    with push. 
  20986.  
  20987.  pop-up menu  - A menu that lists the actions that a user can perform on an 
  20988.    object. The contents of the pop-up menu can vary depending on the context, 
  20989.    or state, of the object. 
  20990.  
  20991.  pop-up window  - (1) A window that appears on top of another window in a 
  20992.    dialog. Each pop-up window must be completed before returning to the 
  20993.    underlying window. (2) (D of C) In SAA Advanced Common User Access 
  20994.    architecture, a movable window, fixed in size, in which a user provides 
  20995.    information required by an application so that it can continue to process a 
  20996.    user request. 
  20997.  
  20998.  presentation drivers  - Special purpose I/O routines that handle field 
  20999.    device-independent I/O requests from the PM and its applications. 
  21000.  
  21001.  Presentation Manager (PM)  - The interface of the OS/2 operating system that 
  21002.    presents, in windows a graphics-based interface to applications and files 
  21003.    installed and running under the OS/2 operating system. 
  21004.  
  21005.  presentation page  - The coordinate space in which a picture is assembled for 
  21006.    display. 
  21007.  
  21008.  presentation space (PS)  - (1) Contains the device-independent definition of a 
  21009.    picture. (2) (D of C) The display space on a display device. 
  21010.  
  21011.  primary window  - In SAA Common User Access architecture, the window in which 
  21012.    the main interaction between the user and the application takes place. In a 
  21013.    multiprogramming environment, each application starts in its own primary 
  21014.    window. The primary window remains for the duration of the application, 
  21015.    although the panel displayed will change as the user's dialog moves forward. 
  21016.    See also secondary window. 
  21017.  
  21018.  primitive  - In computer graphics, one of several simple functions for drawing 
  21019.    on the screen, including, for example, the rectangle, line, ellipse, 
  21020.    polygon, and so on. 
  21021.  
  21022.  primitive attribute  - A specifiable characteristic of a graphic primitive. 
  21023.    See graphics attributes. 
  21024.  
  21025.  print job  - The result of sending a document or picture to be printed. 
  21026.  
  21027.  Print Manager  - In the Presentation Manager, the part of the spooler that 
  21028.    manages the spooling process. It also allows users to view print queues and 
  21029.    to manipulate print jobs. 
  21030.  
  21031.  privilege level  - A protection level imposed by the hardware architecture of 
  21032.    the IBM personal computer.  There are four privilege levels (number 0 
  21033.    through 3).  Only certain types of programs are allowed to execute at each 
  21034.    privilege level.  See also IOPL code segment. 
  21035.  
  21036.  procedure call  - In programming languages, a language construct for invoking 
  21037.    execution of a procedure. 
  21038.  
  21039.  process  - An instance of an executing application and the resources it is 
  21040.    using. 
  21041.  
  21042.  program  - A sequence of instructions that a computer can interpret and 
  21043.    execute. 
  21044.  
  21045.  program details  - Information about a program that is specified in the 
  21046.    Program Manager window and is used when the program is started. 
  21047.  
  21048.  program group  - In the Presentation Manager, several programs that can be 
  21049.    acted upon as a single entity. 
  21050.  
  21051.  program name  - The full file specification of a program. Contrast with 
  21052.    program title. 
  21053.  
  21054.  program title  - The name of a program as it is listed in the Program Manager 
  21055.    window. Contrast with program name. 
  21056.  
  21057.  prompt  - A displayed symbol or message that requests input from the user or 
  21058.    gives operational information; for example, on the display screen of an IBM 
  21059.    personal computer, the DOS A> prompt. The user must respond to the prompt in 
  21060.    order to proceed. 
  21061.  
  21062.  protect mode  - A method of program operation that limits or prevents access 
  21063.    to certain instructions or areas of storage. Contrast with real mode. 
  21064.  
  21065.  protocol  - A set of semantic and syntactic rules that determines the behavior 
  21066.    of functional units in achieving communication. (I)
  21067.  
  21068.  pseudocode  - An artificial language used to describe computer program 
  21069.    algorithms without using the syntax of any particular programming language. (A)
  21070.  
  21071.  pull-down  - (1) An action bar extension that displays a list of choices 
  21072.    available for a selected action bar choice. After users select an action bar 
  21073.    choice, the pull-down appears with the list of choices. Additional pop-up 
  21074.    windows may appear from pull-down choices to further extend the actions 
  21075.    available to users. (2) (D of C) In SAA Common User Access architecture, 
  21076.    pertaining to a choice in an action bar pull-down. 
  21077.  
  21078.  push  - To add an item to a last-in-first-out stack of items. Contrast with 
  21079.    pop. 
  21080.  
  21081.  push button  - In SAA Advanced Common User Access architecture, a rectangle 
  21082.    with text inside. Push buttons are used in windows for actions that occur 
  21083.    immediately when the push button is selected. 
  21084.  
  21085.  putback  - To remove an object or set of objects from the lazy drag set. This 
  21086.    has the effect of undoing the pickup operation for those objects 
  21087.  
  21088.  putdown  - To drop the objects in the lazy drag set on the target object. 
  21089.  
  21090.  
  21091. ΓòÉΓòÉΓòÉ <hidden> Glossary - Q ΓòÉΓòÉΓòÉ
  21092.  
  21093.  queue  - (1) A linked list of elements waiting to be processed in FIFO order. 
  21094.    For example, a queue may be a list of print jobs waiting to be printed. (2) 
  21095.    (D of C) A line or list of items waiting to be processed; for example, work 
  21096.    to be performed or messages to be displayed. 
  21097.  
  21098.  queued device context  - A logical description of a data destination (for 
  21099.    example, a printer or plotter) where the output is to go through the 
  21100.    spooler. See also device context. 
  21101.  
  21102.  
  21103. ΓòÉΓòÉΓòÉ <hidden> Glossary - R ΓòÉΓòÉΓòÉ
  21104.  
  21105.  radio button  - (1) A control window, shaped like a round button on the 
  21106.    screen, that can be in a checked or unchecked state. It is used to select a 
  21107.    single item from a list. Contrast with check box. (2) In SAA Advanced Common 
  21108.    User Access architecture, a circle with text beside it. Radio buttons are 
  21109.    combined to show a user a fixed set of choices from which only one can be 
  21110.    selected. The circle is partially filled when a choice is selected. 
  21111.  
  21112.  RAS  - Reliability, availability, and serviceability. 
  21113.  
  21114.  raster  - (1) In computer graphics, a predetermined pattern of lines that 
  21115.    provides uniform coverage of a display space. (T)  (2) The coordinate grid 
  21116.    that divides the display area of a display device.  (A)
  21117.  
  21118.  read-only file  - A file that can be read from but not written to. 
  21119.  
  21120.  real mode  - A method of program operation that does not limit or prevent 
  21121.    access to any instructions or areas of storage.  The operating system loads 
  21122.    the entire program into storage and gives the program access to all system 
  21123.    resources. Contrast with protect mode. 
  21124.  
  21125.  realize  - To cause the system to ensure, wherever possible, that the physical 
  21126.    color table of a device is set to the closest possible match in the logical 
  21127.    color table. 
  21128.  
  21129.  recursive routine  - A routine that can call itself, or be called by another 
  21130.    routine that was called by the recursive routine. 
  21131.  
  21132.  reentrant  - The attribute of a program or routine that allows the same copy 
  21133.    of the program or routine to be used concurrently by two or more tasks. 
  21134.  
  21135.  reference phrase  - (1) A word or phrase that is emphasized in a 
  21136.    device-dependent manner to inform the user that additional information for 
  21137.    the word or phrase is available. (2) (D of C) In hypertext, text that is 
  21138.    highlighted and preceded by a single-character input field used to signify 
  21139.    the existence of a hypertext link. 
  21140.  
  21141.  reference phrase help  - In SAA Common User Access architecture, highlighted 
  21142.    words or phrases within help information that a user selects to get 
  21143.    additional information. 
  21144.  
  21145.  refresh  - To update a window, with changed information, to its current 
  21146.    status. 
  21147.  
  21148.  region  - A clipping boundary in device space. 
  21149.  
  21150.  register  - A part of internal storage having a specified storage capacity and 
  21151.    usually intended for a specific purpose. (T)
  21152.  
  21153.  remote file system  - A file-system driver that gains access to a remote 
  21154.    system without a block device driver. 
  21155.  
  21156.  resource  - The means of providing extra information used in the definition of 
  21157.    a window. A resource can contain definitions of fonts, templates, 
  21158.    accelerators, and mnemonics; the definitions are held in a resource file. 
  21159.  
  21160.  resource file  - A file containing information used in the definition of a 
  21161.    window. Definitions can be of fonts, templates, accelerators, and mnemonics. 
  21162.  
  21163.  restore  - To return a window to its original size or position following a 
  21164.    sizing or moving action. 
  21165.  
  21166.  retained graphics  - Graphic primitives that are remembered by the 
  21167.    Presentation Manager interface after they have been drawn. Contrast with 
  21168.    nonretained graphics. 
  21169.  
  21170.  return code  - (1) A value returned to a program to indicate the results of an 
  21171.    operation requested by that program. (2) A code used to influence the 
  21172.    execution of succeeding instructions.(A) 
  21173.  
  21174.  reverse video  - (1) A form of highlighting a character, field, or cursor by 
  21175.    reversing the color of the character, field, or cursor with its background; 
  21176.    for example, changing a red character on a black background to a black 
  21177.    character on a red background. (2) In SAA Basic Common User Access 
  21178.    architecture, a screen emphasis feature that interchanges the foreground and 
  21179.    background colors of an item. 
  21180.  
  21181.  REXX Language  - Restructured Extended Executor. A procedural language that 
  21182.    provides batch language functions along with structured programming 
  21183.    constructs such as loops; conditional testing and subroutines. 
  21184.  
  21185.  RGB  - (1) Color coding in which the brightness of the additive primary colors 
  21186.    of light, red, green, and blue, are specified as three distinct values of 
  21187.    white light. (2) Pertaining to a color display that accepts signals 
  21188.    representing red, green, and blue. 
  21189.  
  21190.  roman  - Relating to a type style with upright characters. 
  21191.  
  21192.  root segment  - In a hierarchical database, the highest segment in the tree 
  21193.    structure. 
  21194.  
  21195.  round-robin scheduling  - A process that allows each thread to run for a 
  21196.    specified amount of time. 
  21197.  
  21198.  run time  - (1) Any instant at which the execution of a particular computer 
  21199.    program takes place. (T)  (2) The amount of time needed for the execution of 
  21200.    a particular computer program. (T)  (3) The time during which an instruction 
  21201.    in an instruction register is decoded and performed. Synonym for execution 
  21202.    time. 
  21203.  
  21204.  
  21205. ΓòÉΓòÉΓòÉ <hidden> Glossary - S ΓòÉΓòÉΓòÉ
  21206.  
  21207.  SAA  - Systems Application Architecture. 
  21208.  
  21209.  SBCS  - Single-byte character set. 
  21210.  
  21211.  scheduler  - A computer program designed to perform functions such as 
  21212.    scheduling, initiation, and termination of jobs. 
  21213.  
  21214.  screen  - In SAA Basic Common User Access architecture, the physical surface 
  21215.    of a display device upon which information is shown to a user. 
  21216.  
  21217.  screen device context  - A logical description of a data destination that is a 
  21218.    particular window on the screen. See also device context. 
  21219.  
  21220.  SCREEN$  - Character-device name reserved for the display screen. 
  21221.  
  21222.  scroll bar  - In SAA Advanced Common User Access architecture, a part of a 
  21223.    window, associated with a scrollable area, that a user interacts with to see 
  21224.    information that is not currently allows visible. 
  21225.  
  21226.  scrollable entry field  - An entry field larger than the visible field. 
  21227.  
  21228.  scrollable selection field  - A selection field that contains more choices 
  21229.    than are visible. 
  21230.  
  21231.  scrolling  - Moving a display image vertically or horizontally in a manner 
  21232.    such that new data appears at one edge, as existing data disappears at the 
  21233.    opposite edge. 
  21234.  
  21235.  secondary window  - A window that contains information that is dependent on 
  21236.    information in a primary window and is used to supplement the interaction in 
  21237.    the primary window. 
  21238.  
  21239.  sector  - On disk or diskette storage, an addressable subdivision of a track 
  21240.    used to record one block of a program or data. 
  21241.  
  21242.  segment  - See graphics segment. 
  21243.  
  21244.  segment attributes  - Attributes that apply to the segment as an entity, as 
  21245.    opposed to the individual primitives within the segment. For example, the 
  21246.    visibility or detectability of a segment. 
  21247.  
  21248.  segment chain  - All segments in a graphics presentation space that are 
  21249.    defined with the 'chained' attribute. Synonym for picture chain. 
  21250.  
  21251.  segment priority  - The order in which segments are drawn. 
  21252.  
  21253.  segment store  - An area in a normal graphics presentation space where 
  21254.    retained graphics segments are stored. 
  21255.  
  21256.  select  - To mark or choose an item. Note that select means to mark or type in 
  21257.    a choice on the screen; enter means to send all selected choices to the 
  21258.    computer for processing. 
  21259.  
  21260.  select button  - The button on a pointing device, such as a mouse, that is 
  21261.    pressed to select a menu choice.  Also known as button 1. 
  21262.  
  21263.  selection cursor  - In SAA Advanced Common User Access architecture, a visual 
  21264.    indication that a user has selected a choice. It is represented by outlining 
  21265.    the choice with a dotted box. See also text cursor. 
  21266.  
  21267.  selection field  - (1) In SAA Advanced Common User Access architecture, a set 
  21268.    of related choices. See also entry field. (2) In SAA Basic Common User 
  21269.    Access architecture, an area of a panel that cannot be scrolled and contains 
  21270.    a fixed number of choices. 
  21271.  
  21272.  semantics  - The relationships between symbols and their meanings. 
  21273.  
  21274.  semaphore  - An object used by applications for signalling purposes and for 
  21275.    controlling access to serially reusable resources. 
  21276.  
  21277.  separator  - In SAA Advanced Common User Access architecture, a line or color 
  21278.    boundary that provides a visual distinction between two adjacent areas. 
  21279.  
  21280.  serial dialog box  - See modal dialog box. 
  21281.  
  21282.  serialization  - The consecutive ordering of items. 
  21283.  
  21284.  serialize  - To ensure that one or more events occur in a specified sequence. 
  21285.  
  21286.  serially reusable resource (SRR)  - A logical resource or object that can be 
  21287.    accessed by only one task at a time. 
  21288.  
  21289.  session  - (1) A routing mechanism for user interaction via the console; a 
  21290.    complete environment that determines how an application runs and how users 
  21291.    interact with the application. OS/2 can manage more than one session at a 
  21292.    time, and more than one process can run in a session. Each session has its 
  21293.    own set of environment variables that determine where OS/2 looks for 
  21294.    dynamic-link libraries and other important files. (2) (D of C) In the OS/2 
  21295.    operating system, one instance of a started program or command prompt. Each 
  21296.    session is separate from all other sessions that might be running on the 
  21297.    computer. The operating system is responsible for coordinating the resources 
  21298.    that each session uses, such as computer memory, allocation of processor 
  21299.    time, and windows on the screen. 
  21300.  
  21301.  Settings Notebook  - A control window that is used to display the settings for 
  21302.    an object and to enable the user to change them. 
  21303.  
  21304.  shadow  - An object that refers to another object. A shadow is not a copy of 
  21305.    another object, but is another representation of the object. 
  21306.  
  21307.  shadow box  - The area on the screen that follows mouse movements and shows 
  21308.    what shape the window will take if the mouse button is released. 
  21309.  
  21310.  shared data  - Data that is used by two or more programs. 
  21311.  
  21312.  shared memory  - In the OS/2 operating system, a segment that can be used by 
  21313.    more than one program. 
  21314.  
  21315.  shear  - In computer graphics, the forward or backward slant of a graphics 
  21316.    symbol or string of such symbols relative to a line perpendicular to the 
  21317.    baseline of the symbol. 
  21318.  
  21319.  shell  - (1) A software interface between a user and the operating system of a 
  21320.    computer. Shell programs interpret commands and user interactions on devices 
  21321.    such as keyboards, pointing devices, and touch-sensitive screens, and 
  21322.    communicate them to the operating system. (2) Software that allows a kernel 
  21323.    program to run under different operating-system environments. 
  21324.  
  21325.  shutdown  - The process of ending operation of a system or a subsystem, 
  21326.    following a defined procedure. 
  21327.  
  21328.  sibling processes  - Child processes that have the same parent process. 
  21329.  
  21330.  sibling windows  - Child windows that have the same parent window. 
  21331.  
  21332.  simple list  - A list of like values; for example, a list of user names. 
  21333.    Contrast with mixed list. 
  21334.  
  21335.  single-byte character set (SBCS)  - A character set in which each character is 
  21336.    represented by a one-byte code.  Contrast with double-byte character set. 
  21337.  
  21338.  slider box  - In SAA Advanced Common User Access architecture: a part of the 
  21339.    scroll bar that shows the position and size of the visible information in a 
  21340.    window relative to the total amount of information available. Also known as 
  21341.    thumb mark. 
  21342.  
  21343.  SOM  - System Object Model. 
  21344.  
  21345.  source file  - A file that contains source statements for items such as 
  21346.    high-level language programs and data description specifications. 
  21347.  
  21348.  source statement  - A statement written in a programming language. 
  21349.  
  21350.  specific dynamic-link module  - A dynamic-link module created for the 
  21351.    exclusive use of an application. 
  21352.  
  21353.  spin button  - In SAA Advanced Common User Access architecture, a type of 
  21354.    entry field that shows a scrollable ring of choices from which a user can 
  21355.    select a choice. After the last choice is displayed, the first choice is 
  21356.    displayed again.  A user can also type a choice from the scrollable ring 
  21357.    into the entry field without interacting with the spin button. 
  21358.  
  21359.  spline  - A sequence of one or more B╨Æzier curves. 
  21360.  
  21361.  spooler  - A program that intercepts the data going to printer devices and 
  21362.    writes it to disk. The data is printed or plotted when it is complete and 
  21363.    the required device is available.  The spooler prevents output from 
  21364.    different sources from being intermixed. 
  21365.  
  21366.  stack  - A list constructed and maintained so that the next data element to be 
  21367.    retrieved is the most recently stored. This method is characterized as 
  21368.    last-in-first-out (LIFO). 
  21369.  
  21370.  standard window  - A collection of window elements that form a panel. The 
  21371.    standard window can include one or more of the following window elements: 
  21372.    sizing borders, system menu icon, title bar, maximize/minimize/restore 
  21373.    icons, action bar and pull-downs, scroll bars, and client area. 
  21374.  
  21375.  static control  - The means by which the application presents descriptive 
  21376.    information (for example, headings and descriptors) to the user. The user 
  21377.    cannot change this information. 
  21378.  
  21379.  static storage  - (1) A read/write storage unit in which data is retained in 
  21380.    the absence of control signals. (A)  Static storage may use dynamic 
  21381.    addressing or sensing circuits. (2) Storage other than dynamic storage. (A)
  21382.  
  21383.  style  - See window style. 
  21384.  
  21385.  subclass  - A class that inherits from another class. See also Inheritance. 
  21386.  
  21387.  subdirectory  - In an IBM personal computer, a file referred to in a root 
  21388.    directory that contains the names of other files stored on the diskette or 
  21389.    fixed disk. 
  21390.  
  21391.  superclass  - A class from which another class inherits. See also inheritance. 
  21392.  
  21393.  swapping  - (1) A process that interchanges the contents of an area of real 
  21394.    storage with the contents of an area in auxiliary storage. (I)  (A)  (2) In 
  21395.    a system with virtual storage, a paging technique that writes the active 
  21396.    pages of a job to auxiliary storage and reads pages of another job from 
  21397.    auxiliary storage into real storage. (3) The process of temporarily removing 
  21398.    an active job from main storage, saving it on disk, and processing another 
  21399.    job in the area of main storage formerly occupied by the first job. 
  21400.  
  21401.  switch  - (1) In SAA usage, to move the cursor from one point of interest to 
  21402.    another;  for example, to move from one screen or window to another or from 
  21403.    a place within a displayed image to another place on the same displayed 
  21404.    image. (2) In a computer program, a conditional instruction and an indicator 
  21405.    to be interrogated by that instruction. (3) A device or programming 
  21406.    technique for making a selection, for example, a toggle, a conditional jump. 
  21407.  
  21408.  switch list  - See Task List. 
  21409.  
  21410.  symbolic identifier  - A text string that equates to an integer value in an 
  21411.    include file, which is used to identify a programming object. 
  21412.  
  21413.  symbols  - In Information Presentation Facility, a document element used to 
  21414.    produce characters that cannot be entered from the keyboard. 
  21415.  
  21416.  synchronous  - Pertaining to two or more processes that depend upon the 
  21417.    occurrence of specific events such as common timing signals. (T)  See also 
  21418.    asynchronous. 
  21419.  
  21420.  System Menu  - In the Presentation Manager, the pull-down in the top left 
  21421.    corner of a window that allows it to be moved and sized with the keyboard. 
  21422.  
  21423.  System Object Model (SOM)  - A mechanism for language-neutral, object-oriented 
  21424.    programming in the OS/2 environment. 
  21425.  
  21426.  system queue  - The master queue for all pointer device or keyboard events. 
  21427.  
  21428.  system-defined messages  - Messages that control the operations of 
  21429.    applications and provides input an other information for applications to 
  21430.    process. 
  21431.  
  21432.  Systems Application Architecture (SAA)  - A set of IBM software interfaces, 
  21433.    conventions, and protocols that provide a framework for designing and 
  21434.    developing applications that are consistent across systems. 
  21435.  
  21436.  
  21437. ΓòÉΓòÉΓòÉ <hidden> Glossary - T ΓòÉΓòÉΓòÉ
  21438.  
  21439.  table tags  - In Information Presentation Facility, a document element that 
  21440.    formats text in an arrangement of rows and columns. 
  21441.  
  21442.  tag  - (1) One or more characters attached to a set of data that contain 
  21443.    information about the set, including its identification. (I)  (A)  (2) In 
  21444.    Generalized Markup Language markup, a name for a type of document or 
  21445.    document element that is entered in the source document to identify it. 
  21446.  
  21447.  target object  - An object to which the user is transferring information. 
  21448.  
  21449.  Task List  - In the Presentation Manager, the list of programs that are 
  21450.    active. The list can be used to switch to a program and to stop programs. 
  21451.  
  21452.  terminate-and-stay-resident (TSR)  - Pertaining to an application that 
  21453.    modifies an operating system interrupt vector to point to its own location 
  21454.    (known as hooking an interrupt). 
  21455.  
  21456.  text  - Characters or symbols. 
  21457.  
  21458.  text cursor  - A symbol displayed in an entry field that indicates where typed 
  21459.    input will appear. 
  21460.  
  21461.  text window  - Also known as the VIO window. 
  21462.  
  21463.  text-windowed application  - The environment in which the operating system 
  21464.    performs advanced-video input and output operations. 
  21465.  
  21466.  thread  - A unit of execution within a process. It uses the resources of the 
  21467.    process. 
  21468.  
  21469.  thumb mark  - The portion of the scroll bar that describes the range and 
  21470.    properties of the data that is currently visible in a window. Also known as 
  21471.    a slider box. 
  21472.  
  21473.  thunk  - Term used to describe the process of address conversion, stack and 
  21474.    structure realignment, etc., necessary when passing control between 16-bit 
  21475.    and 32-bit modules. 
  21476.  
  21477.  tilde  - A mark used to denote the character that is to be used as a mnemonic 
  21478.    when selecting text items within a menu. 
  21479.  
  21480.  time slice  - (1) An interval of time on the processing unit allocated for use 
  21481.    in performing a task. After the interval has expired, processing-unit time 
  21482.    is allocated to another task, so a task cannot monopolize processing-unit 
  21483.    time beyond a fixed limit. (2) In systems with time sharing, a segment of 
  21484.    time allocated to a terminal job. 
  21485.  
  21486.  time-critical process  - A process that must be performed within a specified 
  21487.    time after an event has occurred. 
  21488.  
  21489.  timer  - A facility provided under the Presentation Manager, whereby 
  21490.    Presentation Manager will dispatch a message of class WM_TIMER to a 
  21491.    particular window at specified intervals. This capability may be used by an 
  21492.    application to perform a specific processing task at predetermined 
  21493.    intervals, without the necessity for the application to explicitly keep 
  21494.    track of the passage of time. 
  21495.  
  21496.  timer tick  - See clock tick. 
  21497.  
  21498.  title bar  - In SAA Advanced Common User Access architecture, the area at the 
  21499.    top of each window that contains the window title and system menu icon. When 
  21500.    appropriate, it also contains the minimize, maximize, and restore icons. 
  21501.    Contrast with panel title. 
  21502.  
  21503.  TLB  - Translation lookaside buffer. 
  21504.  
  21505.  transaction  - An exchange between a workstation and another device that 
  21506.    accomplishes a particular action or result. 
  21507.  
  21508.  transform  - (1) The action of modifying a picture by scaling, shearing, 
  21509.    reflecting, rotating, or translating. (2) The object that performs or 
  21510.    defines such a modification; also referred to as a transformation. 
  21511.  
  21512.  Translation lookaside buffer (TLB)  - A hardware-based address caching 
  21513.    mechanism for paging information. 
  21514.  
  21515.  Tree  - In the Presentation Manager, the window in the File Manager that shows 
  21516.    the organization of drives and directories. 
  21517.  
  21518.  truncate  - (1) To terminate a computational process in accordance with some 
  21519.    rule (A)  (2) To remove the beginning or ending elements of a string. (3) To 
  21520.    drop data that cannot be printed or displayed in the line width specified or 
  21521.    available. (4) To shorten a field or statement to a specified length. 
  21522.  
  21523.  TSR  - Terminate-and-stay-resident. 
  21524.  
  21525.  unnamed pipe  - A circular buffer, created in memory, used by related 
  21526.    processes to communicate with one another. Contrast with named pipe. 
  21527.  
  21528.  unordered list  - In Information Presentation Facility, a vertical arrangement 
  21529.    of items in a list, with each item in the list preceded by a special 
  21530.    character or bullet. 
  21531.  
  21532.  update region  - A system-provided area of dynamic storage containing one or 
  21533.    more (not necessarily contiguous) rectangular areas of a window that are 
  21534.    visually invalid or incorrect, and therefore are in need of repainting. 
  21535.  
  21536.  user interface  - Hardware, software, or both that allows a user to interact 
  21537.    with and perform operations on a system, program, or device. 
  21538.  
  21539.  User Shell  - A component of OS/2 that uses a graphics-based, windowed 
  21540.    interface to allow the user to manage applications and files installed and 
  21541.    running under OS/2. 
  21542.  
  21543.  utility program  - (1) A computer program in general support of computer 
  21544.    processes; for example, a diagnostic program, a trace program, a sort 
  21545.    program. (T)  (2) A program designed to perform an everyday task such as 
  21546.    copying data from one storage device to another. (A)
  21547.  
  21548.  
  21549. ΓòÉΓòÉΓòÉ <hidden> Glossary - U ΓòÉΓòÉΓòÉ
  21550.  
  21551. There are no glossary terms for this starting letter. 
  21552.  
  21553.  
  21554. ΓòÉΓòÉΓòÉ <hidden> Glossary - V ΓòÉΓòÉΓòÉ
  21555.  
  21556.  value set control  - A visual component that enables a user to select one 
  21557.    choice from a group of mutually exclusive choices. 
  21558.  
  21559.  vector font  - A set of symbols, each of which is created as a series of lines 
  21560.    and curves. Synonymous with outline font. Contrast with image font. 
  21561.  
  21562.  VGA  - Video graphics array. 
  21563.  
  21564.  view  - A way of looking at an object's information. 
  21565.  
  21566.  viewing pipeline  - The series of transformations applied to a graphic object 
  21567.    to map the object to the device on which it is to be presented. 
  21568.  
  21569.  viewing window  - A clipping boundary that defines the visible part of model 
  21570.    space. 
  21571.  
  21572.  VIO  - Video Input/Output. 
  21573.  
  21574.  virtual memory (VM)  - Synonymous with virtual storage. 
  21575.  
  21576.  virtual storage  - (1) The storage space that may be regarded as addressable 
  21577.    main storage by the user of a computer system in which virtual addresses are 
  21578.    mapped into real addresses. The size of virtual storage is limited by the 
  21579.    addressing scheme of the computer system and by the amount of auxiliary 
  21580.    storage available, not by the actual number of main storage 
  21581.    locations. (I)  (A)  (2) Addressable space that is apparent to the user as 
  21582.    the processor storage space, from which the instructions and the data are 
  21583.    mapped into the processor storage locations. (3) Synonymous with virtual 
  21584.    memory. 
  21585.  
  21586.  visible region  - A window's presentation space, clipped to the boundary of 
  21587.    the window and the boundaries of any overlying window. 
  21588.  
  21589.  volume  - (1) A file-system driver that uses a block device driver for input 
  21590.    and output operations to a local or remote device. (I)  (2) A portion of 
  21591.    data, together with its data carrier, that can be handled conveniently as a 
  21592.    unit. 
  21593.  
  21594.  
  21595. ΓòÉΓòÉΓòÉ <hidden> Glossary - W ΓòÉΓòÉΓòÉ
  21596.  
  21597.  wildcard character  - Synonymous with global file-name character. 
  21598.  
  21599.  window  - (1) A portion of a display surface in which display images 
  21600.    pertaining to a particular application can be presented. Different 
  21601.    applications can be displayed simultaneously in different windows. (A)  (2) 
  21602.    An area of the screen with visible boundaries within which information is 
  21603.    displayed. A window can be smaller than or the same size as the screen. 
  21604.    Windows can appear to overlap on the screen. 
  21605.  
  21606.  window class  - The grouping of windows whose processing needs conform to the 
  21607.    services provided by one window procedure. 
  21608.  
  21609.  window coordinates  - A set of coordinates by which a window position or size 
  21610.    is defined; measured in device units, or pels. 
  21611.  
  21612.  window handle  - Unique identifier of a window, generated by Presentation 
  21613.    Manager when the window is created, and used by applications to direct 
  21614.    messages to the window. 
  21615.  
  21616.  window procedure  - Code that is activated in response to a message. The 
  21617.    procedure controls the appearance and behavior of its associated windows. 
  21618.  
  21619.  window rectangle  - The means by which the size and position of a window is 
  21620.    described in relation to the desktop window. 
  21621.  
  21622.  window resource  - A read-only data segment stored in the .EXE file of an 
  21623.    application o the .DLL file of a dynamic link library. 
  21624.  
  21625.  window style  - The set of properties that influence how events related to a 
  21626.    particular window will be processed. 
  21627.  
  21628.  window title  - In SAA Advanced Common User Access architecture, the area in 
  21629.    the title bar that contains the name of the application and the OS/2 
  21630.    operating system file name, if applicable. 
  21631.  
  21632.  Workplace Shell  - The OS/2 object-oriented, graphical user interface. 
  21633.  
  21634.  workstation  - (1) A display screen together with attachments such as a 
  21635.    keyboard, a local copy device, or a tablet. (2) (D of C) One or more 
  21636.    programmable or nonprogrammable devices that allow a user to do work. 
  21637.  
  21638.  world coordinates  - A device-independent Cartesian coordinate system used by 
  21639.    the application program for specifying graphical input and output. (I)  (A)
  21640.  
  21641.  world-coordinate space  - Coordinate space in which graphics are defined 
  21642.    before transformations are applied. 
  21643.  
  21644.  WYSIWYG  - What-You-See-Is-What-You-Get. A capability of a text editor to 
  21645.    continually display pages exactly as they will be printed. 
  21646.  
  21647.  
  21648. ΓòÉΓòÉΓòÉ <hidden> Glossary - X ΓòÉΓòÉΓòÉ
  21649.  
  21650. There are no glossary terms for this starting letter. 
  21651.  
  21652.  
  21653. ΓòÉΓòÉΓòÉ <hidden> Glossary - Y ΓòÉΓòÉΓòÉ
  21654.  
  21655. There are no glossary terms for this starting letter. 
  21656.  
  21657.  
  21658. ΓòÉΓòÉΓòÉ <hidden> Glossary - Z ΓòÉΓòÉΓòÉ
  21659.  
  21660.  z-order  - The order in which sibling windows are presented. The topmost 
  21661.    sibling window obscures any portion of the siblings that it overlaps; the 
  21662.    same effect occurs down through the order of lower sibling windows. 
  21663.  
  21664.  zooming  - The progressive scaling of an entire display image in order to give 
  21665.    the visual impression of movement of all or part of a display group toward 
  21666.    or away from an observer. (I)  (A)
  21667.  
  21668.  8.3 file-name format  - A file-naming convention in which file names are 
  21669.    limited to eight characters before and three characters after a single dot. 
  21670.    Usually pronounced "eight-dot-three." See also non-8.3 file-name format. 
  21671.