home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / warptlk3.zip / TOOLKIT / BOOK / IPFREF.INF (.txt) < prev    next >
OS/2 Help File  |  1995-10-23  |  895KB  |  21,631 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Introducing IPF ΓòÉΓòÉΓòÉ
  3.  
  4. The Information Presentation Facility (IPF) is a tool that enables you to 
  5. create online information, to specify how it will appear on the screen, to 
  6. connect various parts of the information, and to provide help information that 
  7. can be requested by the user. 
  8.  
  9. It is a tool for both the information author and the application programmer. 
  10. IPF implements guidelines recommended by the Common User Access* (CUA*) element 
  11. of the Systems Application Architecture* (SAA*) platform. 
  12.  
  13. *  Trademark of the IBM Corporation 
  14.  
  15.  
  16. ΓòÉΓòÉΓòÉ 1.1. What IPF Offers ΓòÉΓòÉΓòÉ
  17.  
  18. As an author of online information, you need to know what type of information 
  19. users need - tutorial, reference, or help. For example, they might need a 
  20. tutorial to learn a software program, reference information for additional 
  21. topics, or help information for assistance with the program. 
  22.  
  23. As a programmer implementing or customizing online information, you need to 
  24. know how the IPF programming interface supports your intended design. 
  25.  
  26. IPF features include: 
  27.  
  28.      A tagging language that formats text, provides ways to connect 
  29.       information units, and customizes windows 
  30.      A compiler that creates online documents and help windows 
  31.      A viewing program that displays formatted online documents 
  32.      A help manager programming interface that allows you to control and 
  33.       customize the display of online information. 
  34.  
  35.  
  36. ΓòÉΓòÉΓòÉ 1.1.1. The Tag Language ΓòÉΓòÉΓòÉ
  37.  
  38. The IPF tagging language provides the instructions for how online information 
  39. is to be displayed.  With these instructions, or tags, you can: 
  40.  
  41.      Highlight text 
  42.      Set margins 
  43.      Add lists, notes, and notices 
  44.      Create tables 
  45.      Change the size and style (font), and the color of displayed information 
  46.      Control the formatting of lines of text 
  47.      Illustrate with examples, figures, and art 
  48.      Customize windows 
  49.      Define ways to connect information units 
  50.      Establish communication links to other applications. 
  51.  
  52.  
  53. ΓòÉΓòÉΓòÉ 1.1.2. The IPF Compiler ΓòÉΓòÉΓòÉ
  54.  
  55. When you have finished writing and tagging, information is ready to be 
  56. compiled. The IPF compiler interprets the tags in your source file and converts 
  57. the information into the appropriate format.  The compiler is able to 
  58. distinguish between tags and text because each tag starts with a colon (:), is 
  59. immediately followed by the tag name, and then ends with a period (.). For 
  60. example, the tag that indicates a new paragraph is the :p. tag.  When the 
  61. compiler encounters this tag, it interprets it as, "Insert a blank line before 
  62. the paragraph tag and start the text that follows the paragraph tag." 
  63.  
  64. At compile time, you specify what format you want.  For online documents, you 
  65. direct IPF to generate a file with an INF extension.  For help information, you 
  66. specify a file with an HLP extension.  For information about compiler commands 
  67. and options, see Starting the IPF Compiler. 
  68.  
  69.  
  70. ΓòÉΓòÉΓòÉ 1.1.3. The View Program ΓòÉΓòÉΓòÉ
  71.  
  72. The View program (VIEW) enables you to display your compiled document. VIEW 
  73. retrieves files with an INF extension and displays the formatted information in 
  74. a standard OS/2 window. 
  75.  
  76. Note:  You cannot use VIEW to display files with an HLP extension. For 
  77.        information about how to use VIEW, see Viewing an Online Document or see 
  78.        the Command Reference. 
  79.  
  80.  
  81. ΓòÉΓòÉΓòÉ 1.1.4. The Help Manager Programming Interface ΓòÉΓòÉΓòÉ
  82.  
  83. You can use IPF to develop a user interface that provides help for application 
  84. windows and fields within windows. You can even customize help information by 
  85. writing Presentation Manager programs that communicate with IPF. 
  86.  
  87.  
  88. ΓòÉΓòÉΓòÉ 1.2. Features of the IPF Interface ΓòÉΓòÉΓòÉ
  89.  
  90. Online designs need to communicate information through a simple interface that 
  91. lets the user find information quickly and easily.  With IPF you can develop an 
  92. interface that provides unique usability features, including: 
  93.  
  94.      Hypertext links 
  95.      Push buttons 
  96.      Customized windows 
  97.      Master help index and glossary. 
  98.  
  99.  
  100. ΓòÉΓòÉΓòÉ 1.2.1. Hypertext and Hypergraphic Links ΓòÉΓòÉΓòÉ
  101.  
  102. IPF gives the user the ability to connect to different units of text and 
  103. graphics. The connections that join these units are known as hypertext or 
  104. hypergraphic links.  For example, a user can select a particular link to obtain 
  105. related information or perhaps to see a graphical description of the topic. 
  106.  
  107. An advantage of using hypertext or hypergraphic links is that the author can 
  108. present information in a nonlinear way. Users can then access information both 
  109. sequentially and randomly. This lets them explore or branch into subject matter 
  110. that may be unclear or that needs to be reviewed.  For information about 
  111. hypertext and hypergraphic links, see Linking. 
  112.  
  113.  
  114. ΓòÉΓòÉΓòÉ 1.2.2. Push Buttons ΓòÉΓòÉΓòÉ
  115.  
  116. Push buttons provide users with a fast and easy way to access commonly used IPF 
  117. tasks.  When a user selects a push button, the action represented by the text 
  118. on the push button is carried out immediately.  IPF provides one set of push 
  119. buttons for online documents and another set for Help windows.  IPF also 
  120. provides help on how to use the push buttons. 
  121.  
  122. As a designer, you can change the text of a push button, select which push 
  123. buttons you want to use, add your own push buttons, and specify the area of a 
  124. window to place them.  For more information, see Push Buttons. 
  125.  
  126.  
  127. ΓòÉΓòÉΓòÉ 1.2.3. Customized Windows ΓòÉΓòÉΓòÉ
  128.  
  129. A window is the area of the screen in which information is displayed. As an 
  130. author of online information, you can customize windows.  Different windowing 
  131. effects are achieved with the IPF tagging language. For example, a window can 
  132. be split so that scrollable text can be displayed beside a stationary 
  133. illustration that the text describes. 
  134.  
  135. The following figure shows an IPF split-window design that describes the IBM* 
  136. Personal System/2* Model 90 XP 486** series. 
  137.  
  138. * Trademark of the IBM Corporation 
  139.  
  140. ** Trademark of Intel Corporation 
  141.  
  142. IPF Split Window 
  143.  
  144. For more information, see Customizing Windows. 
  145.  
  146.  
  147. ΓòÉΓòÉΓòÉ 1.2.4. Master Help Index and Glossary ΓòÉΓòÉΓòÉ
  148.  
  149. The OS/2 operating system provides online help that can be accessed through 
  150. both a Master Help Index and a Glossary. The Master Help Index and the Glossary 
  151. are both collections of alphabetized pointers to information panels. Their 
  152. primary purpose is to provide quick access to help topics. With them, you can 
  153. provide such features as: 
  154.  
  155.      Availability of the Master Help Index from anywhere in the WorkPlace 
  156.       Shell 
  157.  
  158.      A side-by-side window design that lets the user scan index entries on one 
  159.       side, then display the help-text information on the other side 
  160.  
  161.      A menu and buttons that let the user perform a search, print help-text 
  162.       windows, or request assistance. 
  163.  
  164.  The following figure shows an example of the Master Index window and the 
  165.  opened help-text window, "Changing, Adding, and Deleting Fonts." 
  166.  
  167.  For more information, see Customizing Master Help Index and Glossary Objects 
  168.  
  169.  
  170. ΓòÉΓòÉΓòÉ 2. IPF User Interface ΓòÉΓòÉΓòÉ
  171.  
  172. This chapter describes the components of the IPF user interface.  As an author, 
  173. you will use these components when developing an online document or online 
  174. help. As a programmer, you should understand the IPF user interface before you 
  175. enable your application to work with online help. 
  176.  
  177. Online documents include reference or procedural information, such as converted 
  178. printed material, tutorials, and organization charts.  Online help includes 
  179. information that users of online documents or application programs might want 
  180. to access. 
  181.  
  182. Because they have varying backgrounds, interests, motivations, and experiences, 
  183. no two users of online information are exactly alike.  To accommodate 
  184. differences, IPF provides a flexible interface that can be customized according 
  185. to personal preference.  However, when an online document requires no special 
  186. design considerations, the IPF compiler provides an automatic default design 
  187. that includes: 
  188.  
  189.      A Contents window 
  190.  
  191.      Standard OS/2 windows 
  192.  
  193.      Help. 
  194.  
  195.  
  196. ΓòÉΓòÉΓòÉ 2.1. The Contents Window ΓòÉΓòÉΓòÉ
  197.  
  198. When users first select a document for viewing, IPF displays an OS/2 window 
  199. that includes a table of contents (Contents window) similar to the window shown 
  200. in the following figure. 
  201.  
  202. A Contents Window. Users select the highlighted item and go directly to a 
  203. window of text. 
  204.  
  205.  
  206. ΓòÉΓòÉΓòÉ 2.2. The Standard Window ΓòÉΓòÉΓòÉ
  207.  
  208. Unless special window characteristics are defined with IPF tags, the IPF 
  209. compiler formats a window that includes the following elements: 
  210.  
  211.      Menu bar 
  212.      Title bar icon 
  213.      Title bar 
  214.      Maximize button 
  215.      Hide button 
  216.      Horizontal scroll bar 
  217.      Vertical scroll bar 
  218.      Push buttons. 
  219.  
  220.  The following figure shows a standard window and its elements. 
  221.  
  222.  Standard Window and Elements 
  223.  
  224.  The title bar icon, and the maximize and hide buttons allow a user to change 
  225.  the size and position of a window.  The menu bar, push buttons, and scroll 
  226.  bars allow a user to work with the window's contents.  The window title 
  227.  indicates the subject of the information, or name of the object, seen in the 
  228.  window. 
  229.  
  230.  
  231. ΓòÉΓòÉΓòÉ 2.3. Help ΓòÉΓòÉΓòÉ
  232.  
  233. While using an online document or application program, a user occasionally 
  234. requires additional information about choices, fields, or procedures for a 
  235. task. CUA guidelines recommend that a product provide information to a user 
  236. about how to use the product. Information about how to use a product is known 
  237. as help information. The OS/2 user interface for help information is developed 
  238. with IPF and is accessible from the menu bar.  Help can also be accessed from 
  239. push buttons located at the bottom of the window or by pressing the F1 key. 
  240.  
  241.  
  242. ΓòÉΓòÉΓòÉ 2.3.1. Main Help Window ΓòÉΓòÉΓòÉ
  243.  
  244. When a user requests help from a window, IPF displays the main help window, the 
  245. characteristics of which are: 
  246.  
  247.      Menu bar 
  248.      Title bar icon 
  249.      Title bar 
  250.      Maximize button 
  251.      Horizontal scroll bar 
  252.      Vertical scroll bar 
  253.      Push buttons. 
  254.  
  255.  The main help window cannot be minimized. 
  256.  
  257.  Within the main help window is the help-text window. The help-text window 
  258.  contains the response to the user's request for help. The characteristics of 
  259.  this window are: 
  260.  
  261.      Title bar icon 
  262.      Title bar (shows title of the selected help window) 
  263.      Maximize button 
  264.      Hide button 
  265.      Horizontal scroll bar 
  266.      Vertical scroll bar. 
  267.  
  268.  The windows shown in the lower right corner of the following figure are main 
  269.  help and help-text windows. 
  270.  
  271.  An IPF Main Help Window with its Help-Text Window. The title "Help for Viewing 
  272.  a Document" that appears in the title bar was created by the author of the 
  273.  help-text window. 
  274.  
  275.  When the main help window is first opened, its position is such that it covers 
  276.  the smallest part of the online document or application window as possible. 
  277.  The help-text window is opened at its maximum size within the main help 
  278.  window. 
  279.  
  280.  However, when the main help window is opened, it can be moved and resized, as 
  281.  can the help-text window. If the user makes the help-text window larger or 
  282.  smaller, the text within the window is reformatted to fit the new window size. 
  283.  
  284.  
  285. ΓòÉΓòÉΓòÉ 2.3.2. Selection Lists ΓòÉΓòÉΓòÉ
  286.  
  287. Selection lists appear when some of the following menu bar choices are 
  288. selected: 
  289.  
  290.      Viewed pages, under Options 
  291.      Contents, under Options 
  292.      Help index, under Help 
  293.      Libraries 
  294.  
  295.  The following figure shows the Viewed Pages selection list. 
  296.  
  297.  View Pages Selection List 
  298.  
  299.  Search results also are displayed in a selection list. Selection lists differ 
  300.  from the help-text window in that they can be closed, either by selecting the 
  301.  Close symbol or by pressing the Esc key. 
  302.  
  303.  Selecting the hide button from the title bar while a help-text window, 
  304.  Contents window, Viewed Pages window, Index window, or Search results window 
  305.  is displayed, results in the window being replaced by an icon. 
  306.  
  307.  
  308. ΓòÉΓòÉΓòÉ 2.3.3. Menu Bar ΓòÉΓòÉΓòÉ
  309.  
  310. The following figure shows the menu bar that has the choices Services, Options, 
  311. and Help. 
  312.  
  313. When Services, Options, or Help is selected, a menu appears with a list of 
  314. entries that also can be selected. Some entries have an associated shortcut key 
  315. or key combination.  These are shown to the right of the menu item. 
  316.  
  317.  
  318. ΓòÉΓòÉΓòÉ 2.3.3.1. Services Menu ΓòÉΓòÉΓòÉ
  319.  
  320. The Services menu shows a list of available services. 
  321.  
  322. Services Menu 
  323.  
  324.  
  325. ΓòÉΓòÉΓòÉ 2.3.3.1.1. Search ΓòÉΓòÉΓòÉ
  326.  
  327. This choice, and the Search push button, display the window shown in the 
  328. following figure. The user can type a text string consisting of letters, 
  329. numbers, blank spaces, and special characters, then select any of the choices 
  330. to search for the text string. 
  331.  
  332. Search Window 
  333.  
  334. Global file-name characters (wildcards) can be used with the text string; for 
  335. example: 
  336.  
  337. *current directory*
  338.  
  339. The global file-name character, in this case an asterisk, automatically finds 
  340. all possibilities of the current directory string. 
  341.  
  342. Following are descriptions of Search window choices: 
  343.  
  344.  This section 
  345.          Searches the currently displayed help-text window and highlights all 
  346.          occurrences of the search string that are found. 
  347.  
  348.  Marked sections 
  349.          Searches the online-document windows or help windows whose titles were 
  350.          marked in the Contents window.  IPF does not search unmarked secondary 
  351.          windows, or windows attached to the marked window by hypertext links. 
  352.          Before selecting Marked sections, the user must select Contents then 
  353.          mark the help titles to be searched. If no help titles are marked, the 
  354.          Marked sections choice is dimmed. 
  355.  
  356.          Sections are marked with the mouse by pressing and holding the Ctrl 
  357.          key then clicking mouse button 1. Sections are marked with the 
  358.          keyboard by using the cursor keys to highlight the item and then 
  359.          pressing the spacebar.  The same key sequences are used to unmark the 
  360.          selection. 
  361.  
  362.          If the search is successful, IPF displays a list of the window titles 
  363.          where the text string was found.  The search string is shown in the 
  364.          title bar of the search results window. 
  365.  
  366.  All sections 
  367.          Searches the entire help library or online document and displays a 
  368.          list of the window titles where occurrences of the search string were 
  369.          found. The search string is shown in the title bar of the search 
  370.          results window. It does not search title text. 
  371.  
  372.  Index 
  373.          Searches the index and displays a list of index entries in which the 
  374.          text string was found. 
  375.  
  376.          If no search string is entered, this choice displays an alphabetic 
  377.          list of all index topics in the help library or online document. 
  378.  
  379.  Marked libraries 
  380.          Searches selected help libraries or online documents. The user must be 
  381.          in an active window of an online document or help library and follow 
  382.          this procedure: 
  383.  
  384.          1.     Select Options then Libraries. 
  385.  
  386.          2.     Mark one or more libraries. 
  387.  
  388.          3.     Select Services, then Search, then Marked libraries. 
  389.  
  390.          4.     Select the Search push button. 
  391.  
  392.  All libraries 
  393.          Searches all help libraries or online documents and displays a list of 
  394.          the window titles where the text string was found. The search string 
  395.          is shown in the title bar of the window. 
  396.  
  397.  
  398. ΓòÉΓòÉΓòÉ 2.3.3.1.2. Print ΓòÉΓòÉΓòÉ
  399.  
  400. This choice, and the Print push button, display the window shown in the 
  401. following figure. The output is the text within the window. The user can select 
  402. any of the choices to print online information. All of the printed output is 
  403. sent to the default printer. All of the information prints as WYSIWYG 
  404. (What-You-See-Is-What-You-Get). 
  405.  
  406. Print Window 
  407.  
  408. Following are descriptions of Print window choices: 
  409.  
  410.  This section 
  411.          Sends the contents of the current window to be printed. 
  412.  
  413.  Marked sections 
  414.          Sends the sections whose titles were marked in the Contents window to 
  415.          be printed. Before selecting this choice, the user must select 
  416.          Contents and mark the titles to be printed. If no titles are marked, 
  417.          Marked sections is dimmed. 
  418.  
  419.          Sections are marked with the mouse by pressing and holding the Ctrl 
  420.          key then clicking mouse button 1. Sections are marked with the 
  421.          keyboard by using the cursor keys to highlight the item and then 
  422.          pressing the spacebar.  The same key sequences are used to unmark the 
  423.          selection. 
  424.  
  425.  All sections 
  426.          Sends the entire online document or help library to be printed. 
  427.  
  428.  Index 
  429.          Sends the help-index or online document index to be printed. 
  430.  
  431.  Contents 
  432.          Sends the help library or online-document contents list to be printed. 
  433.  
  434.  
  435. ΓòÉΓòÉΓòÉ 2.3.3.1.3. Bookmark ΓòÉΓòÉΓòÉ
  436.  
  437. This choice displays the window shown in the following figure. 
  438.  
  439. Bookmark Window 
  440.  
  441.  Place       Saves the user's place in the document being viewed. 
  442.  
  443.  View        Redisplays a specific place that was marked. 
  444.  
  445.  Remove      Deletes one marked place. 
  446.  
  447.  Remove all  Deletes all marked places. 
  448.  
  449.  Note        The Bookmark selections are saved across invocations in a file 
  450.              with the same name as that of the book but with a CP extension. 
  451.              Bookmarks are only available in online books. 
  452.  
  453.  
  454. ΓòÉΓòÉΓòÉ 2.3.3.1.4. New window ΓòÉΓòÉΓòÉ
  455.  
  456. This choice opens a new window for the currently selected item (for example, 
  457. table of content entry, hypertext link, index list, or search list) so the user 
  458. can see more than one topic displayed at the same time. The user can resize the 
  459. new window so the previous window also can be seen, then resize both to view 
  460. both windows. 
  461.  
  462.  
  463. ΓòÉΓòÉΓòÉ 2.3.3.1.5. Copy ΓòÉΓòÉΓòÉ
  464.  
  465. Copies the window currently being viewed to the system clipboard. The user can 
  466. then select Paste from the menu of the OS/2 System Editor (or any other editor 
  467. with this capability) to view or edit the information. 
  468.  
  469.  
  470. ΓòÉΓòÉΓòÉ 2.3.3.1.6. Copy to file ΓòÉΓòÉΓòÉ
  471.  
  472. Copies the information to the file, TEXT.TMP. This file is placed in the 
  473. current directory. If TEXT.TMP already exists, it is replaced. 
  474.  
  475.  
  476. ΓòÉΓòÉΓòÉ 2.3.3.1.7. Append to file ΓòÉΓòÉΓòÉ
  477.  
  478. Copies the information to the file, TEXT.TMP. This file is placed in the 
  479. current directory. If TEXT.TMP already exists, the new information is added to 
  480. the existing information. 
  481.  
  482.  
  483. ΓòÉΓòÉΓòÉ 2.3.3.2. Options Menu ΓòÉΓòÉΓòÉ
  484.  
  485. Selecting Options displays the menu shown in the following figure. 
  486.  
  487. Options Menu 
  488.  
  489. The first five choices are active when the Contents window is active. If the 
  490. Contents window is not active, these choices are dimmed. These choices control 
  491. how the table of contents will be displayed. 
  492.  
  493. A tree-structured table of contents is created if more than one heading level 
  494. is specified with IPF heading tags when the windows are created. (For a 
  495. description of heading tags, see Headings.) 
  496.  
  497. If there are additional entries under a heading, "+" appears to the left of the 
  498. entry.  When an entry is expanded one level, the next level of entries 
  499. subordinate to the selected entry is displayed, and the "+" is replaced by a 
  500. "-". The user can click on the "+" or "-" symbols to expand or contract the 
  501. contents. 
  502.  
  503.  
  504. ΓòÉΓòÉΓòÉ 2.3.3.2.1. Expand one level ΓòÉΓòÉΓòÉ
  505.  
  506. Expands the first level subordinate to the selected entry. 
  507.  
  508.  
  509. ΓòÉΓòÉΓòÉ 2.3.3.2.2. Expand branch ΓòÉΓòÉΓòÉ
  510.  
  511. Expands all levels subordinate to the selected entry. 
  512.  
  513.  
  514. ΓòÉΓòÉΓòÉ 2.3.3.2.3. Expand all ΓòÉΓòÉΓòÉ
  515.  
  516. Displays the entire tree structure of the contents. 
  517.  
  518.  
  519. ΓòÉΓòÉΓòÉ 2.3.3.2.4. Collapse branch ΓòÉΓòÉΓòÉ
  520.  
  521. Contracts all levels subordinate to the selected entry. 
  522.  
  523.  
  524. ΓòÉΓòÉΓòÉ 2.3.3.2.5. Collapse all ΓòÉΓòÉΓòÉ
  525.  
  526. Displays only the highest level entries in the contents. 
  527.  
  528.  
  529. ΓòÉΓòÉΓòÉ 2.3.3.2.6. Contents ΓòÉΓòÉΓòÉ
  530.  
  531. Lists the table of contents for the document you are viewing. You can select 
  532. from the topics shown. This choice has the same function as the Contents push 
  533. button. 
  534.  
  535.  
  536. ΓòÉΓòÉΓòÉ 2.3.3.2.7. Index ΓòÉΓòÉΓòÉ
  537.  
  538. Displays an alphabetic list of the topics in the document.  You can select from 
  539. the index entries shown. This choice has the same function as the Index push 
  540. button. 
  541.  
  542.  
  543. ΓòÉΓòÉΓòÉ 2.3.3.2.8. Viewed pages ΓòÉΓòÉΓòÉ
  544.  
  545. This selection displays a list of all windows viewed during the current 
  546. session. Window titles are listed in the order that windows were viewed. If a 
  547. window is viewed more than once, its title appears as many times as it was 
  548. viewed. 
  549.  
  550. The maximum number of entries that can appear in the Viewed Pages window is 50. 
  551.  
  552.  
  553. ΓòÉΓòÉΓòÉ 2.3.3.2.9. Libraries ΓòÉΓòÉΓòÉ
  554.  
  555. Displays a list of online libraries that are available.  The libraries are 
  556. identified by their directory path. The help files are the directories 
  557. identified in the HELP environment variable.  The online books are the 
  558. directories identified in the BOOKSHELF. 
  559.  
  560.  
  561. ΓòÉΓòÉΓòÉ 2.3.3.2.10. Previous ΓòÉΓòÉΓòÉ
  562.  
  563. Displays the previously viewed window. Each time Previous is selected, the 
  564. previously viewed window is displayed, until the first window viewed in the 
  565. current session is shown. Selecting Previous again from a help window, ends the 
  566. current session. This choice has the same function as when the user selects the 
  567. Previous push button; or presses the Esc key. 
  568.  
  569.  
  570. ΓòÉΓòÉΓòÉ 2.3.3.3. Help Menu ΓòÉΓòÉΓòÉ
  571.  
  572. Selecting Help displays the menu shown in the following figure. 
  573.  
  574. Help Menu 
  575.  
  576.  
  577. ΓòÉΓòÉΓòÉ 2.3.3.3.1. Help index ΓòÉΓòÉΓòÉ
  578.  
  579. Displays an alphabetic list of topics for which help information is provided. 
  580.  
  581.  
  582. ΓòÉΓòÉΓòÉ 2.3.3.3.2. General help ΓòÉΓòÉΓòÉ
  583.  
  584. Displays general information describing the user interface and how to access 
  585. it. 
  586.  
  587.  
  588. ΓòÉΓòÉΓòÉ 2.3.3.3.3. Using help ΓòÉΓòÉΓòÉ
  589.  
  590. Displays a list that describes the different help information that is available 
  591. to users of the OS/2 operating system. 
  592.  
  593.  
  594. ΓòÉΓòÉΓòÉ 2.3.3.3.4. Keys help ΓòÉΓòÉΓòÉ
  595.  
  596. Displays information describing key assignments for the application. 
  597.  
  598. Note:  Providing Keys help is the responsibility of the application programmer. 
  599.        A simple help window can be created that lists each key combination 
  600.        assigned to an application function, and a brief description of what the 
  601.        function does. 
  602.  
  603.  
  604. ΓòÉΓòÉΓòÉ 2.3.3.3.5. Product information ΓòÉΓòÉΓòÉ
  605.  
  606. Displays copyright information. Providing product information also is the 
  607. responsibility of the application programmer. 
  608.  
  609.  
  610. ΓòÉΓòÉΓòÉ 2.3.3.3.6. Tutorial ΓòÉΓòÉΓòÉ
  611.  
  612. This choice is included in the Help menu if your application tells IPF that it 
  613. has created a Presentation Manager tutorial application. This choice has the 
  614. same function as the Tutorial push button. 
  615.  
  616. When the user selects Tutorial, IPF sends a message to the application that the 
  617. selection has been made.  The application then starts the tutorial. 
  618.  
  619.  
  620. ΓòÉΓòÉΓòÉ 2.3.3.4. Push Buttons ΓòÉΓòÉΓòÉ
  621.  
  622. Push buttons provide users with a fast and easy way to access commonly used IPF 
  623. functions.  When a user selects a push button, the action represented is 
  624. carried out immediately.  IPF provides the following set of push buttons: 
  625.  
  626.  
  627. ΓòÉΓòÉΓòÉ 2.3.3.4.1. Previous ΓòÉΓòÉΓòÉ
  628.  
  629. This push button lets the user see information from the previously viewed 
  630. window. This is the same function as when the user selects Options then 
  631. Previous from the menu bar, or presses the Esc key. 
  632.  
  633.  
  634. ΓòÉΓòÉΓòÉ 2.3.3.4.2. Search ΓòÉΓòÉΓòÉ
  635.  
  636. This push button displays a window that lets the user search for a word or 
  637. phrase.  This is the same function as when the user selects Services then 
  638. Search from the menu bar. 
  639.  
  640.  
  641. ΓòÉΓòÉΓòÉ 2.3.3.4.3. Print ΓòÉΓòÉΓòÉ
  642.  
  643. This push button displays a window that lets the user print one or more topics. 
  644. This is the same function as when the user selects Services then Print from the 
  645. menu bar. 
  646.  
  647.  
  648. ΓòÉΓòÉΓòÉ 2.3.3.4.4. Index ΓòÉΓòÉΓòÉ
  649.  
  650. This push button displays an alphabetic list of the index topics in a help 
  651. library or an online document.  This is the same function as when the user 
  652. selects Options then Index from the menu bar. 
  653.  
  654.  
  655. ΓòÉΓòÉΓòÉ 2.3.3.4.5. Contents ΓòÉΓòÉΓòÉ
  656.  
  657. This push button displays the Contents window.  This is the same function as 
  658. when the user selects Options then Contents from the menu bar. 
  659.  
  660.  
  661. ΓòÉΓòÉΓòÉ 2.3.3.4.6. Back ΓòÉΓòÉΓòÉ
  662.  
  663. This push button displays the previous page in the table of contents hierarchy. 
  664.  
  665.  
  666. ΓòÉΓòÉΓòÉ 2.3.3.4.7. Forward ΓòÉΓòÉΓòÉ
  667.  
  668. This push button displays the next page in the table of contents hierarchy. 
  669.  
  670.  
  671. ΓòÉΓòÉΓòÉ 2.3.3.4.8. Tutorial ΓòÉΓòÉΓòÉ
  672.  
  673. This push button is included only if a tutorial was specified in your 
  674. application.  This is the same function as when the user selects Help then 
  675. Tutorial from the menu bar. 
  676.  
  677.  
  678. ΓòÉΓòÉΓòÉ 3. Starting with the Tag Language ΓòÉΓòÉΓòÉ
  679.  
  680. As the author of online information, you can use the IPF tag language to define 
  681. various characteristics of text format. You also can use tags to define 
  682. characteristics of the window in which the text is displayed. 
  683.  
  684. There are 45 tags (excluding symbols) that make up the IPF tag language.  The 
  685. tags are mnemonic, making it easy to associate them with their functions. 
  686. However, before you can begin to use this language, you need to familiarize 
  687. yourself with the elements that make up the syntax of the tags, and special 
  688. rules that govern the use of the tags. 
  689.  
  690.  
  691. ΓòÉΓòÉΓòÉ 3.1. Syntax Conventions ΓòÉΓòÉΓòÉ
  692.  
  693. Each tag must start with a colon (:) and end with a period (.). (The period is 
  694. also known as a delimiter.) For example, the tag for a paragraph is: 
  695.  
  696. :p.
  697.  
  698. A tag indicates how the text that immediately follows it is to be processed. In 
  699. the following example, the text immediately after the paragraph tag (:p.) is 
  700. the actual text that is displayed in the window, and it will begin a new 
  701. paragraph. 
  702.  
  703. :p.There are fewer than 1200 manatees...
  704.  
  705.  
  706. ΓòÉΓòÉΓòÉ 3.1.1. End Tags ΓòÉΓòÉΓòÉ
  707.  
  708. Some tags require end tags. An end tag is e immediately followed by the tag. 
  709. For example, the end tag for the :userdoc. tag is: 
  710.  
  711. :euserdoc.
  712.  
  713. Most of the tags that have end tags affect text format or appearance. The end 
  714. tag tells the IPF compiler to end the operation associated with the tag.  If 
  715. you forget an end tag, the compiler displays an error message. 
  716.  
  717.  
  718. ΓòÉΓòÉΓòÉ 3.1.2. Nested Tags ΓòÉΓòÉΓòÉ
  719.  
  720. Nested tags are tags within other tags.  For example, a common way of 
  721. presenting information is in a list form; a tag begins the list, another tag 
  722. identifies each list item, and yet another tag ends the list.  An example of 
  723. the tagging for a simple list follows: 
  724.  
  725. :sl.
  726. :li.List item 1
  727. :li.List item 2
  728. :li.List item 3
  729. :esl.
  730.  
  731. The list-item tag (:li.) is required for each item in the list.  The :li. tags 
  732. are nested between the :sl. tag and the :esl. tag. 
  733.  
  734. Note:  After paragraph and heading tags, you will probably use list tags most 
  735.        often.  IPF provides general-purpose lists (simple, unordered, and 
  736.        ordered), and special-purpose lists (definition and parameter). 
  737.  
  738.  
  739. ΓòÉΓòÉΓòÉ 3.1.3. Text Strings ΓòÉΓòÉΓòÉ
  740.  
  741. Some tags have text strings associated with them. The string can immediately 
  742. follow the tag, or it can start the line immediately following the tag. For 
  743. example, the tagging for the title bar of a window is :h1. (one of the heading 
  744. tags) and a text string, which is called a title string.  You can enter it like 
  745. this: 
  746.  
  747. :h1.Save the Manatee
  748. or like this: 
  749.  
  750. :h1.
  751. Save the Manatee
  752.  
  753.  
  754. ΓòÉΓòÉΓòÉ 3.1.4. Attributes ΓòÉΓòÉΓòÉ
  755.  
  756. A tag also can have one or more attributes. An attribute contains additional 
  757. information about a tag's operation. The attribute has a name, which may have a 
  758. value or keyword assigned to it. 
  759.  
  760. In the following example, the attribute res= specifies a window identifier. 
  761.  
  762. :h1 res=001.Save the Manatee 
  763.  
  764. In this case, 001 is the assigned value.  The value assigned to a res= 
  765. attribute must be unique for each heading tag. This value also will be the 
  766. identifier for linking to the heading from elsewhere in the information. The 
  767. concept of linking is described in Hypertext Links. 
  768.  
  769. Notice that the period follows the attribute, not the heading tag.  The period 
  770. always follows the last attribute in the tag. 
  771.  
  772. You can specify many attributes in one tag, and they can extend over several 
  773. lines.  However, you cannot split an attribute.  For example, you cannot put 
  774. the res= attribute of the heading tag on one line, and its value, 001, on the 
  775. next line. 
  776.  
  777. Some attributes are optional and have a default (an assumed value) if they are 
  778. not included with the tag; other attributes are required. Tag attributes can be 
  779. specified in any order. 
  780.  
  781. As mentioned, some attributes are required.  For example, if you are creating a 
  782. help library, the res= attribute of a heading tag is required as a window 
  783. identifier (see Window Identifiers). 
  784.  
  785. An attribute also can have a keyword associated with it. For example, an 
  786. attribute of the :color. tag is fc= (foreground color), which is used to 
  787. specify the color of the text.  Its value can be equal to any of the following 
  788. keywords: 
  789.  
  790.      DEFAULT 
  791.      BLUE 
  792.      CYAN 
  793.      GREEN 
  794.      NEUTRAL 
  795.      RED 
  796.      YELLOW. 
  797.  
  798.  Not all attributes have values or keywords. For example, if you want a simple 
  799.  list with no blank lines between the list items, add the compact attribute to 
  800.  the simple-list tag (:sl.).  In the following example, notice the compact 
  801.  attribute stands by itself: 
  802.  
  803.   :sl compact.
  804.   :li.List item 1
  805.   :li.List item 2
  806.   :li.List item 3
  807.   :esl.
  808.  
  809.  
  810. ΓòÉΓòÉΓòÉ 3.1.4.1. Attribute Values with Blank Spaces ΓòÉΓòÉΓòÉ
  811.  
  812. If an attribute value includes blank spaces, the value must be enclosed in 
  813. single quotes.  For example: 
  814.  
  815. :font facename='Tms Rmn'.
  816.  
  817. Notice that the value has initial capitals.  For this particular case, they are 
  818. required; otherwise, the IPF compiler will not recognize them as valid values. 
  819.  
  820. Using some of the tags described thus far, you could produce a source file like 
  821. this: 
  822.  
  823. :userdoc.
  824. :h1 res=001.Save the Manatee
  825. :p.
  826. There are fewer than 1200 manatees in the state of Florida.
  827. Ten percent of the existing herds die each year
  828. because of:
  829. :sl compact.
  830. :li.Contact with boat propellers
  831. :li.Impact from boats and barges
  832. :li.Entrapment in locks and dams.
  833. :esl.
  834. :euserdoc.
  835.  
  836. The output produced from the source file is an OS/2 standard window. 
  837.  
  838. The menu-bar choices, Services, Options, and Help are provided automatically by 
  839. IPF. The title-bar line, "Save the Manatee," is generated by the :h1. tag. The 
  840. viewing area of the window displays the formatted information. 
  841.  
  842. An OS/2 Standard Window Produced from Source File 
  843.  
  844. The best way to learn about tags is to study the examples provided in the 
  845. following sections, then create some windows of your own. 
  846.  
  847.  
  848. ΓòÉΓòÉΓòÉ 3.2. Symbols ΓòÉΓòÉΓòÉ
  849.  
  850. You use symbols to produce characters that cannot be entered from the keyboard. 
  851. A symbol begins with an ampersand (&) and is followed by the symbol name and a 
  852. period.  For example, to produce a square bullet, which looks like this: 
  853.  
  854. Γûá
  855. Enter the symbol like this: 
  856.  
  857. &sqbul.
  858.  
  859. If you want the ampersand character (&) to appear in text, define it as the 
  860. symbol,  &.  Otherwise, the IPF compiler tries to interpret whatever text 
  861. follows the ampersand character as the name of a symbol, and will return the 
  862. error message, Invalid symbol. 
  863.  
  864. Symbols are case-sensitive.  That is, if you do not type them exactly as the 
  865. appear in the symbols table (see Symbols) you could get either the message, 
  866. Invalid Symbol, or a symbol different from the one you want. 
  867.  
  868. Note:  The symbols table is also available online when you install the Online 
  869.        Information component of the Developer's Toolkit for OS/2. 
  870.  
  871.  
  872. ΓòÉΓòÉΓòÉ 3.3. Headings ΓòÉΓòÉΓòÉ
  873.  
  874. Perhaps the most versatile tag is the heading tag. Heading tags enable 
  875. information to be displayed in windows, control entries in the Contents window, 
  876. control placement of push buttons in a window, and define the shape and size of 
  877. windows. With IPF, you can specify six levels of headings, :h1 through :h6. 
  878. For information about default heading levels that start a window and place 
  879. entries in the table of contents window, see the following topic on Controlling 
  880. Entries in the Contents Window. 
  881.  
  882.  
  883. ΓòÉΓòÉΓòÉ 3.3.1. Displaying Window Titles ΓòÉΓòÉΓòÉ
  884.  
  885. Every heading tag that starts a window must have an associated text string. The 
  886. text string becomes the window title and appears in the title bar of the 
  887. window.  The window title also becomes an entry in the Contents window, which 
  888. lists the headings of all topics in an online document. 
  889.  
  890. For a window that occupies the full width of the screen, the maximum length of 
  891. a text string, including spaces and blanks, is 70 characters. A narrower window 
  892. requires a shorter text string. The text string can be on the same line as the 
  893. heading tag, or at the beginning of the next line. 
  894.  
  895. The following example shows the tagging for the first three heading levels, 
  896. with a paragraph following each heading. 
  897.  
  898. :userdoc.
  899. :title.An Online Document
  900. :h1.First Heading Level
  901. :p.
  902. This window is defined by a first-level heading tag.
  903. :h2.Second-Level Heading
  904. :p.
  905. This window is defined by a second-level heading tag.
  906. :h3.Third-Level Heading
  907. :p.
  908. This window is defined by a third-level heading tag.
  909. :euserdoc.
  910.  
  911. The Contents window for the formatted output shows the three heading-level 
  912. entries. 
  913.  
  914. A Contents Window 
  915.  
  916.  
  917. ΓòÉΓòÉΓòÉ 3.3.2. Hiding Window Titles ΓòÉΓòÉΓòÉ
  918.  
  919. If you do not want a title to appear in the Contents window, use the hide 
  920. attribute. The heading definition would be entered like this: 
  921.  
  922. :h3 hide.
  923. Another Third-Level Heading
  924.  
  925. Note:  Your source file must contain at least one heading tag without the hide 
  926.        attribute. 
  927.  
  928.  
  929. ΓòÉΓòÉΓòÉ 3.3.3. Controlling Entries in the Contents Window ΓòÉΓòÉΓòÉ
  930.  
  931. The following example shows some tagging that will control what entries appear 
  932. in the Contents window, as well as what headings will start windows. 
  933.  
  934. :userdoc.
  935. :docprof toc=12.
  936. :h1.Heading Levels
  937. :h2.Second-Level Heading
  938. :p.
  939. This window is defined by a heading-level 2 tag.
  940. :h2.Second-Level Heading
  941. :p.
  942. This window also is defined by a heading-level 2 tag.
  943. :p.
  944. :h3.Third-Level Heading
  945. :p.
  946. Because the &colon.docprof. tag at the beginning of the file
  947. specifies that only heading levels 1 and 2 can be entries in the
  948. Contents window (toc=12), the preceding "Third-Level Heading"
  949. and THIS text, which follows it, become part of the
  950. window defined by the preceding heading-level 2 tag.
  951. :h2 toc=123.Another Second-Level Heading
  952. :p.
  953. The heading-level 2 tag for this window contains
  954. a toc=123 specification.
  955. :h3.Third-Level Heading
  956. :p.
  957. Because the toc=123 in the preceding heading-level 2
  958. tag overrides the toc=12 in the &colon.docprof. tag, this
  959. heading-level 3 tag defines a new window and creates a
  960. Contents entry.
  961. :euserdoc.
  962.  
  963. Unless otherwise specified, the default set of heading tags that create entries 
  964. in the Contents window and define the start of windows are :h1., :h2., and 
  965. :h3.. To change this default, specify a numeric sequence with the table of 
  966. content attribute (toc=) of the :docprof. tag. The :docprof. tag controls the 
  967. heading levels displayed in the Contents window. The sequence must begin with 
  968. level 1 and cannot skip a level in the descending hierarchy. For example, the 
  969. :h4., :h5. and :h6. tags do not start separate windows, but control the 
  970. appearance of the text of the window unless you specify: 
  971.  
  972. :docprof toc=123456.
  973.  
  974. To specify that only heading levels 1 and 2 are to define windows and appear as 
  975. entries in the Contents window, the following tag was used: 
  976.  
  977. :docprof toc=12.
  978.  
  979. The value specified for the toc= attribute remains in effect for all the 
  980. heading definitions in the file.  You can override it by specifying another 
  981. value for the toc= attribute in a heading definition. The new value is then in 
  982. effect for the rest of the headings in the file, or until overridden in another 
  983. heading definition. 
  984.  
  985. In the preceding example, the toc= attribute of the :docprof. tag is overridden 
  986. by the toc= attribute of a heading tag. 
  987.  
  988. The next example shows the results of the tagging. Notice the effect of 
  989. including a heading level that is lower in the hierarchy than the range of 
  990. heading levels specified with the :docprof. tag. 
  991.  
  992. Contents Window with Displayed Third-Level Heading Window 
  993.  
  994. When the file is viewed, the :h3. title and the text following it are included 
  995. as part of the window defined by the preceding :h2. tag. 
  996.  
  997.  
  998. ΓòÉΓòÉΓòÉ 3.3.4. Special Rules ΓòÉΓòÉΓòÉ
  999.  
  1000. Sequential Coding for Heading Tags:  Headings for a series of windows must 
  1001. always start with :h1. and proceed in sequence. That is, you cannot have :h1. 
  1002. followed by :h3.. However, you can follow :h3. with :h1.. 
  1003.  
  1004. Source File Size between Heading Tags:  Do not exceed 16 000 words, numbers, 
  1005. and punctuation marks between two consecutive heading tags in your source file. 
  1006. This includes blank spaces, but does not include commented lines (see Comment). 
  1007. If the source file exceeds this limit, the compiler will generate an error 
  1008. message. To correct the error, use another heading tag. 
  1009.  
  1010. For more information about heading tags and attributes that define 
  1011. characteristics of windows, see Customizing Windows. 
  1012.  
  1013. Note:  At least one :h1. must not be hidden. 
  1014.  
  1015.  
  1016. ΓòÉΓòÉΓòÉ 3.4. Push Buttons ΓòÉΓòÉΓòÉ
  1017.  
  1018. Push buttons provide users with a fast and easy way to access commonly used IPF 
  1019. tasks.  When a user selects a push button, the action represented by the text 
  1020. on the push button is carried out immediately. Push buttons are displayed in a 
  1021. window called a control area.  A control area can be defined within the IPF 
  1022. coverpage window, or the IPF text window (the child of the coverpage window), 
  1023. or both.  For information about the IPF coverpage, see the following figure. 
  1024.  
  1025. IPF provides one set of push buttons for online documents and another set for 
  1026. help windows. 
  1027.  
  1028.  For online documents, the set of push buttons consists of: 
  1029.  
  1030.         Previous 
  1031.         Search 
  1032.         Print 
  1033.         Index 
  1034.         Contents 
  1035.         Back 
  1036.         Forward 
  1037.         Tutorial (only if a tutorial is available). 
  1038.  
  1039.  For help windows, the set of push buttons consists of 
  1040.  
  1041.         Previous 
  1042.         Search 
  1043.         Print 
  1044.         Index 
  1045.         Tutorial (only if a tutorial is available). 
  1046.  
  1047.  The following figure shows an online document with a set of push buttons in 
  1048.  the control area of the the coverpage window (the default control area). 
  1049.  
  1050.  The IPF Default Window for Push Buttons. These push buttons appear in the 
  1051.  control area of the coverpage window. 
  1052.  
  1053.  Notice the difference in the following figure. This example shows a help 
  1054.  window with a set of push buttons in the control area of the IPF text window. 
  1055.  
  1056.  A Help Window. These push buttons were defined in the control area of the IPF 
  1057.  page window. 
  1058.  
  1059.  If the user changes the size of the window, the push buttons in the control 
  1060.  area will wrap around onto the next line. The push buttons cannot be clipped 
  1061.  or scrolled horizontally, because the control area is not part of the 
  1062.  scrollable area of the IPF text window. 
  1063.  
  1064.  
  1065. ΓòÉΓòÉΓòÉ 3.4.1. Tagging Example for the Default Set of Push Buttons ΓòÉΓòÉΓòÉ
  1066.  
  1067. The following example shows the minimum tagging required for an online document 
  1068. that is to have a control area with the default set of push buttons displayed 
  1069. in the coverpage window. 
  1070.  
  1071. :userdoc.
  1072. :title.Coverpage Window
  1073. :h1.IPF Text Window
  1074. :p.Text goes here.
  1075. :euserdoc.
  1076.  
  1077. Notice no extra tagging is necessary. 
  1078.  
  1079.  
  1080. ΓòÉΓòÉΓòÉ 3.4.2. Specifying Push Buttons for the Control Area of a Window ΓòÉΓòÉΓòÉ
  1081.  
  1082. The control area tag (:ctrl.) specifies where push buttons are to be displayed, 
  1083. and which push buttons you want displayed.  When specifying a control area, 
  1084. always precede the tagging with :docprof., then imbed :ctrl. between the 
  1085. control-area definition tags (:ctrldef. and :ectrldef.). For example: 
  1086.  
  1087. :docprof toc=123.
  1088. :ctrldef.
  1089. :ctrl.
  1090. :ectrldef.
  1091.  
  1092.  
  1093. ΓòÉΓòÉΓòÉ 3.4.3. Attribute Values for the Control Area of a Window ΓòÉΓòÉΓòÉ
  1094.  
  1095. The controls= attribute of :ctrl. identifies the push buttons that you want in 
  1096. the control area of a window.  Push buttons are displayed in the order in which 
  1097. they are defined. Values that can be specified are: 
  1098.  
  1099.  Search         Specifies the Search push button.  When selected, this push 
  1100.                 button displays a window that lets the user search for a word 
  1101.                 or phrase. 
  1102.  
  1103.  Print          Specifies the Print push button.  When selected, this push 
  1104.                 button displays a window that lets the user print one or more 
  1105.                 topics. 
  1106.  
  1107.  Index          Specifies the Index push button.  When selected, this push 
  1108.                 button displays an alphabetic list of the topics in the 
  1109.                 document. 
  1110.  
  1111.  Contents       Specifies the Contents push button.  When selected, this push 
  1112.                 button displays the Contents window. 
  1113.  
  1114.  Esc            Specifies the Previous push button.  When selected, this push 
  1115.                 button lets the user see information from an earlier request. 
  1116.  
  1117.  Back           Specifies the Back push button.  When selected, this push 
  1118.                 button displays the previous page in the table of contents 
  1119.                 hierarchy. 
  1120.  
  1121.  Forward        Specifies the Forward push button.  When selected, this push 
  1122.                 button displays the next page in the table of contents 
  1123.                 hierarchy. 
  1124.  
  1125.  Note:  A value for the Tutorial push button is not provided because it is 
  1126.         displayed automatically if a tutorial exists. 
  1127.  
  1128.  Both the page and coverpage attributes of :ctrl. affect where push buttons are 
  1129.  displayed.  For example, you use page to specify that push buttons are to be 
  1130.  in the IPF text window; similarly, you use coverpage to specify that push 
  1131.  buttons are to be in the IPF coverpage window. 
  1132.  
  1133.  A control area also can have a value associated with it.  The ctrlid= 
  1134.  attribute specifies the value, which can be either alpha or alphanumeric, and 
  1135.  is referred to by a heading tag. In the following example, ctrlid= specifies a 
  1136.  window identifier, and instructs the compiler to display the Previous, 
  1137.  Forward, and Back push buttons in the control area of the coverpage window: 
  1138.  
  1139.   :docprof toc=123.
  1140.   :ctrldef.
  1141.   :ctrl ctrlid=new1 controls='ESC FORWARD BACK' coverpage.
  1142.   :ectrldef.
  1143.  
  1144.  Conversely, the following example shows the tagging for an online document 
  1145.  that will display the Previous, Forward, and Back push buttons in the control 
  1146.  area of an IPF page window. 
  1147.  
  1148.   :docprof toc=123 ctrlarea=page.
  1149.   :ctrldef.
  1150.   :ctrl ctrlid=new1 controls='ESC FORWARD BACK' page.
  1151.   :ectrldef.
  1152.  
  1153.  Notice the ctrlarea=page attribute of :docprof..  When the IPF compiler 
  1154.  encounters ctrlarea=page, it defines the control area as the IPF page window 
  1155.  and removes the push buttons from the control area of the coverpage window. 
  1156.  You must ALWAYS specify the ctrlarea= attribute in :docprof. when overriding 
  1157.  the default control area in a window. 
  1158.  
  1159.  Other values for ctrlarea= are: 
  1160.  
  1161.  coverpage     Identifies the control area as the bottom of the coverpage 
  1162.                window.  This is the default value. 
  1163.  
  1164.  both          Specifies both the control area within an IPF text window, and 
  1165.                the coverpage window. 
  1166.  
  1167.  none          Specifies that you do not want a control area (that is, you do 
  1168.                not want push buttons). 
  1169.  
  1170.  You can define more than one control area with different sets of push buttons 
  1171.  for the IPF text window; however, only one set of push buttons can be defined 
  1172.  for the coverpage window. 
  1173.  
  1174.  
  1175. ΓòÉΓòÉΓòÉ 3.4.4. Controlling the Display of Push Buttons in Designated Windows ΓòÉΓòÉΓòÉ
  1176.  
  1177. Suppose your document consisted of 100 windows, and you wanted only one window 
  1178. to display push buttons in the control area of the IPF text window.  The 
  1179. ctrlarea= attribute of a heading tag specifies which control area in a window 
  1180. you want to display push buttons.  You would tag your source file as follows: 
  1181.  
  1182. :docprof ctrlarea=none.
  1183. .
  1184. .
  1185. .
  1186. :h1 ctrlarea=page.One Window
  1187.  
  1188. When ctrlarea= is encountered in a heading tag, it overrides the ctrlarea= 
  1189. attribute specified by :docprof.. 
  1190.  
  1191.  
  1192. ΓòÉΓòÉΓòÉ 3.4.5. Disabling the Display of Push Buttons ΓòÉΓòÉΓòÉ
  1193.  
  1194. The following example shows the minimum tagging for an online document without 
  1195. push buttons. 
  1196.  
  1197. :userdoc.
  1198. :title.Coverpage Window Title
  1199. :docprof toc=123 ctrlarea=none.
  1200. :h1.IPF Text Window
  1201. :p.Text goes here.
  1202. :euserdoc.
  1203.  
  1204.  
  1205. ΓòÉΓòÉΓòÉ 3.4.6. Author-Defined Push Buttons ΓòÉΓòÉΓòÉ
  1206.  
  1207. IPF also supports author-defined pushbuttons. For example, you can define a 
  1208. push button for Examples that can be included in the control area of a 
  1209. coverpage or IPF text window.  When an author-defined push button is selected, 
  1210. the message HM_NOTIFY is sent to the application or communication object. It is 
  1211. the responsibility of the application or communication object to respond to 
  1212. this message.  For information about communication objects, see Controlling 
  1213. Windows with Applications (ACVIEWPORTS). 
  1214.  
  1215. The push button tag (:pbutton.) defines author-defined push buttons.  This tag 
  1216. must be imbedded within the :ctrldef. and :ectrldef. tags, and it must precede 
  1217. the :ctrl. tag. 
  1218.  
  1219. The following example shows how to override the default set of push buttons in 
  1220. the coverpage window with a set that consists of Search, Index, Previous, and 
  1221. Example. 
  1222.  
  1223. :userdoc.
  1224. :docprof toc=123 dll='example' objectname='xmpbutton'.
  1225. :ctrldef.
  1226. :pbutton id=xmp res=257 text='~Example'.
  1227. :ctrl ctrlid=new1 controls='SEARCH INDEX ESC XMP' coverpage.
  1228. :ectrldef.
  1229.  
  1230. Notice that a dynamic link library (DLL) is required to support the function 
  1231. you want to provide with an author-defined push button. For more information, 
  1232. see :pbutton. (Push Button). 
  1233.  
  1234.  
  1235. ΓòÉΓòÉΓòÉ 3.4.7. About the Tutorial Push Button ΓòÉΓòÉΓòÉ
  1236.  
  1237. When the Tutorial push button is selected, the message HM_TUTORIAL is sent to 
  1238. the application or communication object.  This is the same message that is sent 
  1239. when the Tutorial choice is selected from the Help pull-down, or when the 
  1240. tutorial attribute is specified with the heading tag. 
  1241.  
  1242. The Tutorial push button is included only if a tutorial was specified in the 
  1243. initialization structure (HMINIT) or with the tutorial attribute in a heading 
  1244. tag. 
  1245.  
  1246.  
  1247. ΓòÉΓòÉΓòÉ 3.5. Indexing ΓòÉΓòÉΓòÉ
  1248.  
  1249. IPF provides an index for both online documents and help windows from the 
  1250. following tags. 
  1251.  
  1252. :i1.
  1253. :i2.
  1254.  
  1255. The :i1. tag creates a primary entry, which means the entry is at the first 
  1256. level. The :i2. tag provides a secondary entry to the primary one. 
  1257.  
  1258. Index entries are imbedded in the text of a window.  You should create at least 
  1259. one index entry for each window, using the :i1. tag. The text of an index entry 
  1260. must be on the same line as the tag. 
  1261.  
  1262. You form an index for online documents and help windows the same way.  For 
  1263. example, to create the index entry: 
  1264.  
  1265. copy program
  1266.  
  1267. use the following tagging 
  1268.  
  1269. :i1.copy program
  1270.  
  1271. To create two levels of index entries, you use the :i1. tag with the id= 
  1272. attribute, and the :i2. tag, with the refid= attribute. Here is how to do it. 
  1273.  
  1274.    1. Create the primary index entry and give it an identifier; for example: 
  1275.  
  1276.             :i1 id=prnt.printers and plotters
  1277.  
  1278.    2. Create the secondary index entries that will be listed under the primary 
  1279.       index entry, and refer to the identifier of the primary entry; for 
  1280.       example: 
  1281.  
  1282.             :i2 refid=prnt.change printer
  1283.             :i2 refid=prnt.add printer
  1284.             :i2 refid=prnt.printer properties
  1285.  
  1286.  When an :i1. tag has an identifier that is referred to by refid= attributes of 
  1287.  :i2. tags, the :i1. tag must precede the :i2. tags in the file. Index entries 
  1288.  can be located in any of the windows defined in your source file; however, 
  1289.  they cannot be in a footnote. 
  1290.  
  1291.  After your source file is compiled and the user selects Index from the Options 
  1292.  menu, or the Index push button, the index entries look like this: 
  1293.  
  1294.   printers and plotters
  1295.      add printer
  1296.      change printer
  1297.      printer properties
  1298.  
  1299.  
  1300. ΓòÉΓòÉΓòÉ 3.5.1. Index-Synonyms ΓòÉΓòÉΓòÉ
  1301.  
  1302. As a way of helping the user search for index entries by using synonyms, IPF 
  1303. provides the index-synonym tag (:isyn.).  This tag requires the root= 
  1304. attribute.  With these, you can specify synonyms that will be associated with 
  1305. primary index entries.  The :i1. tags for these primary entries require a 
  1306. roots='' attribute that associates the entry with the synonyms. 
  1307.  
  1308. For example, assume you have the following entries in your file: 
  1309.  
  1310. :isyn root=copy.
  1311. copy copying duplicate duplicating
  1312. :isyn root=folder.
  1313. folder folders document documents
  1314. :i1 roots='copy folder'.
  1315. copying a document
  1316.  
  1317. The roots=' ' attribute of the :i1. tag associates "copying a document" with 
  1318. the synonyms of the root= attributes of the two :isyn. tags. 
  1319.  
  1320. Now if a user, when requesting a search of the index, specifies any of the 
  1321. words in either of the two :isyn. entries, the search results will include all 
  1322. :i1. entries that contain the specified word, as well as any :i1. entries that 
  1323. have been associated with the word by a roots= attribute. 
  1324.  
  1325. For example, the user enters "duplicating" in a search request.  When the 
  1326. search is completed, one of the entries in the search results window is: 
  1327.  
  1328. copying a document
  1329.  
  1330.  
  1331. ΓòÉΓòÉΓòÉ 3.5.2. Customizing Master Help Index and Glossary Objects ΓòÉΓòÉΓòÉ
  1332.  
  1333. OS/2 online information is accessible through the "Master Help Index" and 
  1334. "Glossary" Workplace Shell objects. Users can access alphabetized lists of 
  1335. index entries simply by double clicking on the icons for these objects. 
  1336.  
  1337. As an author who wants to create or modify Help Indexes and Glossaries, you 
  1338. need to understand that the Master Help Index object and Glossary object that 
  1339. are installed by default with the OS/2 operating system are the same class of 
  1340. object. In other words, they are the exact same kind of object. Like the rest 
  1341. of the Workplace Shell user objects, they can be created, shadowed, copied, and 
  1342. so on. This also means that they can be modified through the "Settings 
  1343. Notebook". To look at the Settings Notebook for the Master Help Index, simply 
  1344. do the following: 
  1345.  
  1346.    1. Select the Master Help Index user object by single-clicking on its icon 
  1347.       with mouse button 1. 
  1348.  
  1349.    2. Press mouse button 2 for the object's pop-up menu. 
  1350.  
  1351.    3. Select "Open" with mouse button 1, then select "Settings" from the pop-up 
  1352.       menu that appears. 
  1353.  
  1354.  The "Properties" page of the Master Help Index object's Settings Notebook can 
  1355.  be modified. On this page, the "Files/Environment name(s):" setting can be 
  1356.  modified. This setting specifies where online helps (.HLP files) containing 
  1357.  Master Help Index entries are located. The Master Help Index object's default 
  1358.  setting is defined in the file CONFIG.SYS by the "HELP" environment variable. 
  1359.  
  1360.  The global attribute of the :i1. and :i2. tags identifies index entries as 
  1361.  candidates for the Master Help Index or Glossary. Good candidates are pointers 
  1362.  to procedural and conceptual topics.  For example, a simple Master Help Index 
  1363.  entry for conceptual information about batch files might look like this: 
  1364.  
  1365.   :i1 global.batch files, creating
  1366.  When referring to an :i1. tag, use the global attribute in both the :i1. and 
  1367.  :i2. tags.  For example: 
  1368.  
  1369.   :i1 id=copy global.copying
  1370.   :i2 refid=copy global.help topics
  1371.   :i2 refid=copy global.document topics
  1372.  
  1373.  As an author, you can create product-specific indexes and glossaries, add 
  1374.  entries to the Master Help Index or Glossary (or customized, renamed copies of 
  1375.  either user object), change their Notebook "Files/Environment name(s):" 
  1376.  Settings to match online helps with global index entries, and so on. However, 
  1377.  it requires programming skills to enable applications to do these tasks at 
  1378.  installation or run time (see Creating Master Indexes and Glossaries with 
  1379.  Applications). 
  1380.  
  1381.  
  1382. ΓòÉΓòÉΓòÉ 3.6. Control Words ΓòÉΓòÉΓòÉ
  1383.  
  1384. In addition to tags, you can include control words in your source files to 
  1385. request special processing from the IPF compiler. A control word is placed at 
  1386. the beginning of a line, and starts with a period (.). Control words must begin 
  1387. in column one. 
  1388.  
  1389. The IPF compiler recognizes the following control words: 
  1390.  
  1391.  .im filename        Imbed this file in the current file. 
  1392.  
  1393.  .*                  Treat this line of text as a comment and do not interpret. 
  1394.  
  1395.  .br                 Start a new line of text. 
  1396.  
  1397.  .nameit             Perform compile time symbol substitution. 
  1398.  
  1399.  .ce                 Centers Text 
  1400.  
  1401.  
  1402. ΓòÉΓòÉΓòÉ 3.6.1. Imbed ΓòÉΓòÉΓòÉ
  1403.  
  1404. The IPF compiler can produce a single output document by processing one master 
  1405. source file that imbeds other source files. The imbed control word (.im) sends 
  1406. a signal to the compiler to process each file in the sequence listed in the 
  1407. master file. 
  1408.  
  1409. This process is most often associated with online documents.  A portion of the 
  1410. master file for the online IPF Reference looks like this: 
  1411.  
  1412. :userdoc.
  1413. .
  1414. .
  1415. .
  1416. .im ipfcch01.ipf
  1417. .im ipfcch02.ipf
  1418. .im ipfcch03.ipf
  1419. .
  1420. .
  1421. .
  1422.  
  1423. If you are imbedding files, the source file that begins with the :userdoc. tag 
  1424. is considered the master file. The imbedded files cannot have :userdoc. and 
  1425. :euserdoc.. 
  1426.  
  1427.  
  1428. ΓòÉΓòÉΓòÉ 3.6.2. Comment ΓòÉΓòÉΓòÉ
  1429.  
  1430. Occasionally, you might want to insert comments in your source file solely for 
  1431. the purpose of providing information. The .* enables you to do this.  Any text 
  1432. on the same line as this control word is ignored by the compiler. For example, 
  1433. the compiler would recognize the following lines as comment lines and ignore 
  1434. them. 
  1435.  
  1436. .*********************************
  1437. .* This file contains the
  1438. .* introduction to IPF.
  1439. .**********************************
  1440.  
  1441.  
  1442. ΓòÉΓòÉΓòÉ 3.6.3. Break ΓòÉΓòÉΓòÉ
  1443.  
  1444. The break control word (.br) interrupts the display of text on a line, and 
  1445. continues it on the next line.  The break control word must be the only entry 
  1446. on the line.  For example, assume the source file has the following lines. 
  1447.  
  1448. :p.These words
  1449. appear on
  1450. the same line.
  1451. .br
  1452. These words
  1453. .br
  1454. do not.
  1455.  
  1456. The output looks like this: 
  1457.  
  1458. These words appear on the same line.
  1459. These words
  1460. do not.
  1461.  
  1462. If you enter text on the same line as the break control word, the IPF compiler 
  1463. ignores the break control word. 
  1464.  
  1465.  
  1466. ΓòÉΓòÉΓòÉ 3.6.4. Nameit ΓòÉΓòÉΓòÉ
  1467.  
  1468. The nameit control word (.nameit) is a macro that allows you to create a 
  1469. special kind of symbol. Nameit has two operands that are used in IPF, SYMBOL 
  1470. and TEXT.  The operands can be in any order (.nameit symbol=name 
  1471. text='string'). 
  1472.  
  1473. Symbol=name identifies the name of the symbols (just the name, without the 
  1474. preceding & or the trailing period) you want to create. It can be up to 10 
  1475. characters long (A-Z, 0-9), with no blanks or special characters; the first 
  1476. character must be a letter. 
  1477.  
  1478. Text='string' identifies the content of the value to be assigned to the symbol 
  1479. and is what is printed. 
  1480.  
  1481. Here's an example of how .nameit could be used in your document: 
  1482.  
  1483. .nameit symbol=os text='operating system'
  1484. .
  1485. .
  1486. :p.The &os supports multitasking.
  1487.  
  1488. The output looks like this: 
  1489.  
  1490. The operating system supports multitasking.
  1491.  
  1492. Note:  You do not use the & in the .nameit when you actually use the symbol. 
  1493.        Also, you must use a period at the end of the symbol name when you use 
  1494.        the symbol. 
  1495.  
  1496.  
  1497. ΓòÉΓòÉΓòÉ 3.6.5. Center Text ΓòÉΓòÉΓòÉ
  1498.  
  1499. The ce control word (.ce) enables you to center text. For example, assume the 
  1500. source file has the following lines. 
  1501.  
  1502. :p.These words
  1503. appear as normal
  1504. text on the same
  1505. line.
  1506. .ce These words appear as centered text on the same line.
  1507.  
  1508. The output looks like this: 
  1509.  
  1510. These words appear as normal text on the same line.
  1511. These words appear as centered text on the same line.
  1512.  
  1513.  
  1514. ΓòÉΓòÉΓòÉ 4. Displaying Text and Graphics ΓòÉΓòÉΓòÉ
  1515.  
  1516. Once you have defined your window, you need to consider the various ways text 
  1517. can be displayed.  This chapter describes how you can use tags and symbols to: 
  1518.  
  1519.      Highlight text 
  1520.      Add notes, notices, and lists 
  1521.      Define tables for a structured display of data 
  1522.      Illustrate your text with examples, figures, and character graphics 
  1523.      Control the formatting of lines of text 
  1524.      Change the font and color of the displayed information 
  1525.      Set the margins of the text 
  1526.      Display art. 
  1527.  
  1528.  
  1529. ΓòÉΓòÉΓòÉ 4.1. Highlighted Phrases ΓòÉΓòÉΓòÉ
  1530.  
  1531. Text can be highlighted by using different type styles or color.  There are 
  1532. nine highlighted-phrase tags you can use to emphasize text (:hp1. through 
  1533. :hp9.). Each tag requires a corresponding end tag (:ehp1. through :ehp9.). 
  1534.  
  1535. In the following example, the highlighted phrases are shown as list items in a 
  1536. compact simple list. 
  1537.  
  1538. Input Example 
  1539.  
  1540.       :sl compact. 
  1541.       :li.:hp1.Highlighted phrase 1 looks like this.:ehp1. 
  1542.       :li.:hp2.Highlighted phrase 2 looks like this.:ehp2. 
  1543.       :li.:hp3.Highlighted phrase 3 looks like this.:ehp3. 
  1544.       :li.:hp4.Highlighted phrase 4 looks like this.:ehp4. (BLUE) 
  1545.       :li.:hp5.Highlighted phrase 5 looks like this.:ehp5. 
  1546.       :li.:hp6.Highlighted phrase 6 looks like this.:ehp6. 
  1547.       :li.:hp7.Highlighted phrase 7 looks like this.:ehp7. 
  1548.       :li.:hp8.Highlighted phrase 8 looks like this.:ehp8. (RED) 
  1549.       :li.:hp9.Highlighted phrase 9 looks like this.:ehp9. (PINK) 
  1550.       :esl. 
  1551.  
  1552.  The following example shows the output produced by these tags. 
  1553.  
  1554.  Formatted Output 
  1555.  
  1556.       Highlighted phrase 1 looks like this. 
  1557.  
  1558.       Highlighted phrase 2 looks like this. 
  1559.  
  1560.       Highlighted phrase 3 looks like this. 
  1561.  
  1562.       Highlighted phrase 4 looks like this. 
  1563.  
  1564.       Highlighted phrase 5 looks like this. 
  1565.  
  1566.       Highlighted phrase 6 looks like this. 
  1567.  
  1568.       Highlighted phrase 7 looks like this. 
  1569.  
  1570.       Highlighted phrase 8 looks like this. 
  1571.  
  1572.       Highlighted phrase 9 looks like this. 
  1573.  
  1574.  Highlighted Phrases 
  1575.  
  1576.  The type styles displayed for highlighted phrases correspond to the typeface 
  1577.  currently being used by IPF. You can change the typeface to Courier, 
  1578.  Helvetica** or Times New Roman** by using the :font. tag.  See Changing Fonts. 
  1579.  
  1580.  ** Helvetica is a trademark of Linotype AG 
  1581.  ** Times New Roman is a trademark of Monotype Corporation 
  1582.  
  1583.  
  1584. ΓòÉΓòÉΓòÉ 4.2. Notes ΓòÉΓòÉΓòÉ
  1585.  
  1586. To include notes in your information, you use a note tag: either :note. or :nt. 
  1587. (with its corresponding :ent.). 
  1588.  
  1589. The one you use depends on whether your note consists of one paragraph or more 
  1590. than one. 
  1591.  
  1592.  
  1593. ΓòÉΓòÉΓòÉ 4.2.1. :note. ΓòÉΓòÉΓòÉ
  1594.  
  1595. Use :note. for single-paragraph notes. You do not need an end tag. 
  1596.  
  1597. Following is an example of :note. and the resulting output. 
  1598.  
  1599. Input Example 
  1600.  
  1601. :note.Complete all entry fields before leaving
  1602. this window.  If you do not, all your information will be lost.
  1603.  
  1604. Formatted Output 
  1605.  
  1606. Note:  Complete all entry fields before leaving this window. If you do not, all 
  1607. your information will be lost. 
  1608.  
  1609.  
  1610. ΓòÉΓòÉΓòÉ 4.2.2. :nt. ΓòÉΓòÉΓòÉ
  1611.  
  1612. Use :nt. to create notes with more than one paragraph.  Remember to end the 
  1613. note with :ent.. In the following example, notice how the IPF compiler indents 
  1614. the text for the paragraphs in the note. 
  1615.  
  1616. Input Example 
  1617.  
  1618. :nt.Complete all entry fields before leaving
  1619. this window.  If you do not, all your information will be lost.
  1620. :p.If your information is lost, retype it in
  1621. the entry fields.
  1622. :ent.
  1623.  
  1624. Formatted Output 
  1625.  
  1626. Note:  Complete all entry fields before leaving this window.  If you do not, 
  1627.        all your information will be lost. 
  1628.  
  1629. If your information is lost, retype it in the entry fields. 
  1630.  
  1631.  Another Name for a Note:  Both :nt. and :note. provide the text= attribute, so 
  1632.  you can substitute your own word or phrase for the word "Note."  The following 
  1633.  shows the use of this attribute: 
  1634.  
  1635.  Input Example 
  1636.  
  1637.   :note text='Reminder'.Complete all
  1638.   entry fields before leaving this window.
  1639.  
  1640.  Formatted Output 
  1641.  
  1642.  Reminder:  Complete all entry fields before leaving this window. 
  1643.  
  1644.  
  1645. ΓòÉΓòÉΓòÉ 4.3. Notices ΓòÉΓòÉΓòÉ
  1646.  
  1647. Two tags enable you to include caution and warning notices in your information. 
  1648. Both tags require end tags. 
  1649.  
  1650.  
  1651. ΓòÉΓòÉΓòÉ 4.3.1. :caution. ΓòÉΓòÉΓòÉ
  1652.  
  1653. The following example shows how :caution. is used: 
  1654.  
  1655. Input Example 
  1656.  
  1657. :caution.
  1658. Be sure to save your data.  If you do not, all data will be lost.
  1659. :ecaution.
  1660.  
  1661. Formatted Output 
  1662.  
  1663. CAUTION:
  1664. Be sure to save your data.  If you do not, all data will be lost.
  1665.  
  1666.  
  1667. ΓòÉΓòÉΓòÉ 4.3.2. :warning. ΓòÉΓòÉΓòÉ
  1668.  
  1669. The following example shows how :warning. is used: 
  1670.  
  1671. Input Example 
  1672.  
  1673. :warning.
  1674. The disk contains bad sectors.
  1675. :ewarning.
  1676.  
  1677. Formatted Output 
  1678.  
  1679. Warning: The disk contains bad sectors. 
  1680.  
  1681. Place the caution and warning statements before the help information to which 
  1682. they apply so the user is cautioned or warned in advance. You can use the text= 
  1683. attribute if you want to use words other than "Caution" and "Warning" with 
  1684. these notices. 
  1685.  
  1686.  
  1687. ΓòÉΓòÉΓòÉ 4.4. Simple List ΓòÉΓòÉΓòÉ
  1688.  
  1689. Simple lists are vertical arrangements of items without any symbol or character 
  1690. preceding the items in the list.  Use simple lists when the order of the items 
  1691. is not important. 
  1692.  
  1693. To create a simple list, use the simple-list tag (:sl.) to begin the list and 
  1694. its corresponding end tag, :esl.. Identify each item in the list with a 
  1695. list-item tag (:li.). 
  1696.  
  1697. Input Example 
  1698.  
  1699. :p.Bring the following for lunch:
  1700. :sl.
  1701. :li.Fruit
  1702. :li.Sandwich
  1703. :li.Drink
  1704. :esl.
  1705.  
  1706. Formatted Output 
  1707.  
  1708. Bring the following for lunch: 
  1709.  
  1710.       Fruit 
  1711.  
  1712.       Sandwich 
  1713.  
  1714.       Drink 
  1715.  
  1716.  A Compact Simple List:  Use the compact attribute to produce a list with no 
  1717.  blank lines between the list items. 
  1718.  
  1719.  Input Example 
  1720.  
  1721.   :p.Bring the following for lunch:
  1722.   :sl compact.
  1723.   :li.Fruit
  1724.   :li.Sandwich
  1725.   :li.Drink
  1726.   :esl.
  1727.  
  1728.  Formatted Output 
  1729.  
  1730.  Bring the following for lunch: 
  1731.  
  1732.       Fruit 
  1733.       Sandwich 
  1734.       Drink 
  1735.  
  1736.  Nested Lists:  A nested list is a list that is contained within another list. 
  1737.  The following shows the tagging for a simple list nested within another simple 
  1738.  list, and the resulting output. 
  1739.  
  1740.  Input Example 
  1741.  
  1742.   :p.Bring the following for lunch:
  1743.   :sl.
  1744.   :li.Fruit, for example:
  1745.   :sl compact.
  1746.   :li.Apple
  1747.   :li.Orange
  1748.   :li.Pear
  1749.   :li.Banana
  1750.   :esl.
  1751.   :li.Sandwich
  1752.   :li.A drink
  1753.   :esl.
  1754.  
  1755.  Formatted Output 
  1756.  
  1757.  Bring the following for lunch: 
  1758.  
  1759.       Fruit, for example: 
  1760.  
  1761.            Apple 
  1762.            Orange 
  1763.            Pear 
  1764.            Banana 
  1765.  
  1766.       Sandwich 
  1767.  
  1768.       A drink 
  1769.  
  1770.  
  1771. ΓòÉΓòÉΓòÉ 4.5. Unordered List ΓòÉΓòÉΓòÉ
  1772.  
  1773. Unordered lists are vertical arrangements of items, with each item in the list 
  1774. preceded by a special character, usually the lowercase "o" (called a bullet). 
  1775.  
  1776. Use unordered lists when the order of the items is not important. 
  1777.  
  1778. To create an unordered list, use the unordered-list tag (:ul.) to begin the 
  1779. list and :eul. to end it.  Identify each item in the list with :li.. 
  1780.  
  1781. Input Example 
  1782.  
  1783. :ul.
  1784. :li.Information typed in Window A will be stored in the
  1785. STORES.DAT file in whatever directory you designate.
  1786. :li.Information typed in Window B will be stored in the
  1787. SALES.DAT file in the current directory.
  1788. :li.Information typed in Window C will be stored in the
  1789. LOSSES.DAT file in the C:\FINANCE directory.
  1790. :eul.
  1791.  
  1792. Formatted Output 
  1793.  
  1794.      Information typed in Window A will be stored in the STORES.DAT file in 
  1795.       whatever directory you designate. 
  1796.  
  1797.      Information typed in Window B will be stored in the SALES.DAT file in the 
  1798.       current directory. 
  1799.  
  1800.      Information typed in Window C will be stored in the LOSSES.DAT file in 
  1801.       the C:\FINANCE directory. 
  1802.  
  1803.  Note:  To change bullet or dash character, change the appropriate .NLS file 
  1804.         coding of ULITEM IDX=' ', located in the \TOOLKIT\IPFC subdirectory. 
  1805.  
  1806.  A Compact Unordered List:  Use the compact attribute to produce a list with no 
  1807.  blank lines between the list items. 
  1808.  
  1809.  Input Example 
  1810.  
  1811.   :ul compact.
  1812.   :li.Information typed in Window A will be stored in the
  1813.   STORES.DAT file in whatever directory you designate.
  1814.   :li.Information typed in Window B will be stored in the
  1815.   SALES.DAT file in the current directory.
  1816.   :li.Information typed in Window C will be stored in the
  1817.   LOSSES.DAT file in the C:\FINANCE directory.
  1818.   :eul.
  1819.  
  1820.  Formatted Output 
  1821.  
  1822.      Information typed in Window A will be stored in the STORES.DAT file in 
  1823.       whatever directory you designate. 
  1824.      Information typed in Window B will be stored in the SALES.DAT file in the 
  1825.       current directory. 
  1826.      Information typed in Window C will be stored in the LOSSES.DAT file in 
  1827.       the C:\FINANCE directory. 
  1828.  
  1829.  Nested Unordered Lists:  The following example contains two nested, unordered 
  1830.  lists. Notice that a bullet (lowercase "o") precedes items in the first-level 
  1831.  list and that a dash (-) precedes items in the second-level lists.  The 
  1832.  bullets and dashes alternate for each level of the list.  That is, third-level 
  1833.  list items would be preceded by bullets, fourth-level by dashes, and so on. 
  1834.  
  1835.  Input Example 
  1836.  
  1837.   :ul compact.
  1838.   :li.C:\REPORTS\SALES.89
  1839.   :ul compact.
  1840.   :li.FIRST.QTR
  1841.   :li.SECOND.QTR
  1842.   :li.THIRD.QTR
  1843.   :li.FOURTH.QTR
  1844.   :eul.
  1845.   :li.C:\REPORTS\SALES.90
  1846.   :ul compact.
  1847.   :li.FIRST.QTR
  1848.   :li.SECOND.QTR
  1849.   :li.THIRD.QTR
  1850.   :li.FOURTH.QTR
  1851.   :eul.
  1852.   :eul.
  1853.  
  1854.  Formatted Output 
  1855.  
  1856.      C:\REPORTS\SALES.89 
  1857.         -  FIRST.QTR 
  1858.         -  SECOND.QTR 
  1859.         -  THIRD.QTR 
  1860.         -  FOURTH.QTR 
  1861.      C:\REPORTS\SALES.90 
  1862.         -  FIRST.QTR 
  1863.         -  SECOND.QTR 
  1864.         -  THIRD.QTR 
  1865.         -  FOURTH.QTR 
  1866.  
  1867.  When nesting lists, make sure you end each list with an end-list tag. 
  1868.  
  1869.  
  1870. ΓòÉΓòÉΓòÉ 4.6. Ordered List ΓòÉΓòÉΓòÉ
  1871.  
  1872. Ordered lists are vertical arrangements of items, with each item in the list 
  1873. preceded by a number or letter.  Use ordered lists when the sequence of the 
  1874. items is important, such as in a procedure. 
  1875.  
  1876. To create an ordered list, use the ordered-list tag (:ol.) to begin the list 
  1877. and :eol. to end it.  Identify each item in the list with :li.. 
  1878.  
  1879. Input Example 
  1880.  
  1881. :ol.
  1882. :li.Open the diskette-drive door.
  1883. :li.Remove the diskette.
  1884. :li.Store the diskette in a safe place.
  1885. :eol.
  1886.  
  1887. Formatted Output 
  1888.  
  1889.    1. Open the diskette-drive door. 
  1890.  
  1891.    2. Remove the diskette. 
  1892.  
  1893.    3. Store the diskette in a safe place. 
  1894.  
  1895.  A Compact Ordered List:  Use the compact attribute to produce a list with no 
  1896.  blank lines between the list items. 
  1897.  
  1898.  Input Example 
  1899.  
  1900.   :ol compact.
  1901.   :li.Open the diskette-drive door.
  1902.   :li.Remove the diskette.
  1903.   :li.Store the diskette in a safe place.
  1904.   :eol.
  1905.  
  1906.  Formatted Output 
  1907.  
  1908.    1. Open the diskette-drive door. 
  1909.    2. Remove the diskette. 
  1910.    3. Store the diskette in a safe place. 
  1911.  
  1912.  Nested Ordered Lists:  The following example contains two nested, ordered 
  1913.  lists. Notice that sequential numbers precede items in the first-level list, 
  1914.  and sequential letters precede items in the second-level list. Numbers and 
  1915.  letters alternate for each level of the list.  That is, third-level list items 
  1916.  would be preceded by numbers, fourth-level by letters, and so on. 
  1917.  
  1918.  Input Example 
  1919.  
  1920.   :ol.
  1921.   :li.First item in the first-level list.
  1922.   :li.Second item in the first-level list.
  1923.   This item has a nested list within it.
  1924.   :ol.
  1925.   :li.First item in the second-level list.
  1926.   :li.Second Item in the second-level list.
  1927.   :eol.
  1928.   :li.Third item in the first-level list.
  1929.   :eol.
  1930.  
  1931.  Formatted Output 
  1932.  
  1933.    1. First item in the first-level list. 
  1934.  
  1935.    2. Second item in the first-level list. This item has a nested list within 
  1936.       it. 
  1937.  
  1938.         a. First item in the second-level list. 
  1939.  
  1940.         b. Second Item in the second-level list. 
  1941.  
  1942.    3. Third item in the first-level list. 
  1943.  
  1944.  When nesting lists, make sure you end each list with an end-list tag. 
  1945.  
  1946.  
  1947. ΓòÉΓòÉΓòÉ 4.7. Definition List ΓòÉΓòÉΓòÉ
  1948.  
  1949. A definition list is a special list that pairs a term and its description. 
  1950.  
  1951. To create a definition list, use the definition-list tag (:dl.) to begin the 
  1952. list and :edl. to end it.  Identify each term in the list with a 
  1953. definition-term tag (:dt.) and each description with a definition-description 
  1954. tag (:dd.). 
  1955.  
  1956. Column Width for Definition Terms:  :dl. has several attributes that let you 
  1957. control the appearance of definition lists.  The tsize= attribute specifies the 
  1958. width, in character spaces, for the term column. If tsize= is not specified, 
  1959. the default width for the term column is 10 character spaces. 
  1960.  
  1961. Definition-List Headings:  If you want headings for the columns of terms and 
  1962. definitions, use the definition-term heading tag (:dthd.) to identify the 
  1963. heading for the terms and the definition-description tag (:ddhd.) to identify 
  1964. the heading for the definition descriptions. 
  1965.  
  1966. Compact Definition List:  The compact attribute produces a list with no blank 
  1967. lines. 
  1968.  
  1969. The following example shows the tagging for a compact definition list with 
  1970. headings for the terms and descriptions.  It also shows the use of the tsize= 
  1971. attribute. 
  1972.  
  1973. Input Example 
  1974.  
  1975. :dl compact tsize=13.
  1976. :dthd.:hp2.Key:ehp2.
  1977. :ddhd.:hp2.Purpose:ehp2.
  1978. :dt.Insert key
  1979. :dd.Switches between insert and replace modes.
  1980. :dt.Home key
  1981. :dd.Moves the cursor to the beginning of the current line.
  1982. :dt.End key
  1983. :dd.Moves the cursor to the end of the current line.
  1984. :edl.
  1985.  
  1986. Formatted Output 
  1987.  
  1988.  Key          Purpose 
  1989.  Insert key   Switches between insert and replace modes. 
  1990.  Home key     Moves the cursor to the beginning of the current line. 
  1991.  End key      Moves the cursor to the end of the current line. 
  1992.  
  1993.  Specifying where the Definition Descriptions Start:  The break= attribute 
  1994.  defines where the descriptions appear in relation to their terms: 
  1995.  
  1996.  break=none     Places the description on the same line as the term.  This is 
  1997.                 the default.  If the term is longer than the specified or 
  1998.                 default tsize= value, the term extends into the description 
  1999.                 column. 
  2000.  
  2001.  break=all      Places the description on the line below the term. 
  2002.  
  2003.  break=fit      Places the description on the line below the term only when the 
  2004.                 term is longer than the tsize= value. 
  2005.  
  2006.  The following example shows the tagging that starts the definition 
  2007.  descriptions on the line below the term. 
  2008.  
  2009.  Input Example 
  2010.  
  2011.   :dl break=all tsize=3.
  2012.   :dt.:hp2.Insert key:ehp2.
  2013.   :dd.Switches between insert and replace modes.
  2014.   :dt.:hp2.Home key:ehp2.
  2015.   :dd.Moves the cursor to the beginning of the current line.
  2016.   :dt.:hp2.End key:ehp2.
  2017.   :dd.Moves the cursor to the end of the current line.
  2018.   :edl.
  2019.  
  2020.  Formatted Output 
  2021.  
  2022.  Insert key 
  2023.     Switches between insert and replace modes. 
  2024.  
  2025.  Home key 
  2026.     Moves the cursor to the beginning of the current line. 
  2027.  
  2028.  End key 
  2029.     Moves the cursor to the end of the current line. 
  2030.  
  2031.  A definition description can apply to more than one definition term; that is, 
  2032.  you can specify more than one :dt. in the sequence before specifying a 
  2033.  matching :dd.. 
  2034.  
  2035.  The following example shows the tagging for a definition list with 
  2036.  descriptions that apply to more than one term. 
  2037.  
  2038.  Input Example 
  2039.  
  2040.   :dl compact break=fit tsize=20.
  2041.   :dthd.:hp2.Grocery Item:ehp2.
  2042.   :ddhd.:hp2.Type:ehp2.
  2043.   :dt.:hp2.Orange:ehp2.
  2044.   :dt.:hp2.Apple:ehp2.
  2045.   :dd.A fruit.
  2046.   :dt.:hp2.Carrot:ehp2.
  2047.   :dt.:hp2.Celery:ehp2.
  2048.   :dd.A vegetable.
  2049.   :edl.
  2050.  
  2051.  Formatted Output 
  2052.  
  2053.  Grocery Item        Type 
  2054.  Orange 
  2055.  Apple               A fruit. 
  2056.  Carrot 
  2057.  Celery              A vegetable. 
  2058.  
  2059.  
  2060. ΓòÉΓòÉΓòÉ 4.8. Parameter List ΓòÉΓòÉΓòÉ
  2061.  
  2062. Parameter lists are similar to definition lists in appearance and the way you 
  2063. use tags to create them.  The only difference between the two types of lists is 
  2064. that a parameter list cannot have headings. 
  2065.  
  2066. The parameter-list tag (:parml.) begins the list; its corresponding :eparml. 
  2067. ends it.  Identify each term in the list with a parameter-term tag (:pt.) and 
  2068. each description with a parameter-description tag (:pd.). 
  2069.  
  2070. :parml. has the same attributes as :dl..  The tsize= attribute specifies the 
  2071. width for the term column.  If tsize= is not specified, the default width is 10 
  2072. character spaces. 
  2073.  
  2074. Compact Parameter List:  The compact attribute produces a list with no blank 
  2075. lines. 
  2076.  
  2077. Specifying where the Parameter Descriptions Start:  The break= attribute 
  2078. defines where the descriptions appear in relation to their terms: 
  2079.  
  2080.  break=none     Places the description on the same line as the term.  This is 
  2081.                 the default.  If the term is longer than the specified or 
  2082.                 default tsize= value, the term extends into the description 
  2083.                 column. 
  2084.  
  2085.  break=all      Places the description on the line below the term. 
  2086.  
  2087.  break=fit      Places the description on the line below the term only when the 
  2088.                 term is longer than the tsize= value. 
  2089.  
  2090.  Nested Parameter Lists:  Like simple, unordered, and ordered lists, parameter 
  2091.  lists can be nested. 
  2092.  
  2093.  Input Example 
  2094.  
  2095.   :parml compact tsize=3.
  2096.   :pt.:hp2.KEYWORD-1:ehp2.
  2097.   :pd.Is explained here.
  2098.   :pt.:hp2.KEYWORD-2:ehp2.
  2099.   :pd.Is explained here, and its nested subparameters:
  2100.   :parml compact.
  2101.   :pt.:hp2.SUBPARM1:ehp2.
  2102.   :pt.:hp2.SUBPARM2:ehp2.
  2103.   :pd.Are explained here.
  2104.   :eparml.
  2105.   :pt.:hp2.KEYWORD-3:ehp2.
  2106.   :pd.Is explained here.
  2107.   :eparml.
  2108.  
  2109.  Formatted Output 
  2110.  
  2111.  KEYWORD-1 
  2112.     Is explained here. 
  2113.  KEYWORD-2 
  2114.     Is explained here, and its nested subparameters: 
  2115.     SUBPARM1 
  2116.     SUBPARM2 
  2117.                    Are explained here. 
  2118.  KEYWORD-3 
  2119.     Is explained here. 
  2120.  
  2121.  A parameter description can apply to more than one parameter; that is, you can 
  2122.  specify more than one :pt. in the sequence before specifying a matching :pd.. 
  2123.  
  2124.  The following example shows the tagging for a parameter list with descriptions 
  2125.  that apply to more than one term. 
  2126.  
  2127.  Input Example 
  2128.  
  2129.   :parml compact tsize=3.
  2130.   :pt.:hp2.KEYWORD-1:ehp2.
  2131.   :pt.:hp2.KEYWORD-2:ehp2.
  2132.   :pd.Is explained here.
  2133.   :pt.:hp2.KEYWORD-3:ehp2.
  2134.   :pd.Is not explained here.
  2135.   :eparml.
  2136.  
  2137.  Formatted Output 
  2138.  
  2139.  KEYWORD-1 
  2140.  KEYWORD-2 
  2141.     Is explained here. 
  2142.  KEYWORD-3 
  2143.     Is not explained here. 
  2144.  
  2145.  
  2146. ΓòÉΓòÉΓòÉ 4.9. Tables ΓòÉΓòÉΓòÉ
  2147.  
  2148. Table tags enable you to display text in an arrangement of rows and columns. 
  2149. The system font used to create tables is the monospace font. 
  2150.  
  2151. The table tag (:table.) signals the start of the table.  It requires a 
  2152. corresponding :etable. at the end of the table. 
  2153.  
  2154. The row tag (:row.) specifies the start of each row in the table.  Each row 
  2155. must have at least one column-entry tag (:c.).  This tag specifies the text for 
  2156. each column in the table. 
  2157.  
  2158. The cols=' ' attribute of :table. specifies numeric values that represent the 
  2159. column widths, in character spaces, of each column in the table.  The combined 
  2160. values cannot exceed 250 characters. 
  2161.  
  2162. The number of columns in your table is determined by the number of column width 
  2163. values you have specified with the cols=' ' attribute.  For example, if you 
  2164. enter the values shown in the following, your table will have three columns, 
  2165. each of which will be eleven characters spaces wide. 
  2166.  
  2167.       cols='11 11 11' 
  2168.  
  2169.  A Table with Three Columns:  The following is a simple example of a table with 
  2170.  two rows and three columns: 
  2171.  
  2172.  Input Example 
  2173.  
  2174.   :table cols='13 13 13'.
  2175.   :row.
  2176.   :c.Column 1
  2177.   :c.Column 2
  2178.   :c.Column 3
  2179.   :row.
  2180.   :c.Row 1 Col 1
  2181.   :c.Row 1 Col 2
  2182.   :c.Row 1 Col 3
  2183.   :row.
  2184.   :c.Row 2 Col 1
  2185.   :c.Row 2 Col 2
  2186.   :c.Row 2 Col 3
  2187.   :etable.
  2188.  
  2189.  Formatted Output 
  2190.  
  2191.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2192.   ΓöéColumn 1   ΓöéColumn 2   ΓöéColumn 3   Γöé
  2193.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2194.   ΓöéRow 1 Col 1ΓöéRow 1 Col 2ΓöéRow 1 Col 3Γöé
  2195.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2196.   ΓöéRow 2 Col 1ΓöéRow 2 Col 2ΓöéRow 2 Col 3Γöé
  2197.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2198.  
  2199.  If you have more :c. tags following a :row. tag than you have column-width 
  2200.  values, the extra column entries are placed in a new row, and the compiler 
  2201.  returns an error message. 
  2202.  
  2203.  If you have fewer :c. tags than column-width values, the compiler does not 
  2204.  consider this an error.  Space is still allocated for the specified columns; 
  2205.  however, only the columns for which you have provided entries will be filled. 
  2206.  
  2207.  Table Rules and Frames:  The rules= attribute of :table. specifies whether the 
  2208.  table will have vertical rules, horizontal rules, a combination of both, or no 
  2209.  rules at all to delineate the items in the table. The values that you can 
  2210.  specify for rules= are: 
  2211.  
  2212.       rules=both 
  2213.       rules=none 
  2214.       rules=horiz 
  2215.       rules=vert 
  2216.  
  2217.  A Table with Horizontal Rules: 
  2218.  
  2219.  Input Example 
  2220.  
  2221.   :table rules=horiz cols='10 15 15'.
  2222.   :row.
  2223.   :c.SYMBOL
  2224.   :c.ELEMENT
  2225.   :c.CHARACTER
  2226.   :row.
  2227.   :c.&.bxas.
  2228.   :c.box ascender
  2229.   :c.&bxas.
  2230.   :row.
  2231.   :c.&.bxcr.
  2232.   :c.box cross
  2233.   :c.&bxcr.
  2234.   :row.
  2235.   :c.&.bxde.
  2236.   :c.box descender
  2237.   :c.&bxde.
  2238.   :etable.
  2239.  
  2240.  Formatted Output 
  2241.  
  2242.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2243.   Γöé SYMBOL                ELEMENT                 CHARACTER  Γöé
  2244.   ΓöéΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöé
  2245.   Γöé &bxas.                box ascender            Γö┤          Γöé
  2246.   ΓöéΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöé
  2247.   Γöé &bxcr.                box cross               Γö╝          Γöé
  2248.   ΓöéΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöé
  2249.   Γöé &bxde.                box descender           Γö¼          Γöé
  2250.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2251.  
  2252.  If you do not specify the rules= attribute, your table will contain both 
  2253.  vertical and horizontal rules (the default). 
  2254.  
  2255.  The frame= attribute of :table. specifies whether the table will have borders. 
  2256.  The values that you can specify are: 
  2257.  
  2258.       frame=none 
  2259.       frame=rules 
  2260.       frame=box 
  2261.  
  2262.  If you specify frame=none, there will be no borders. 
  2263.  
  2264.  Specifying frame=rules results in a horizontal line at the top and bottom of 
  2265.  the table. 
  2266.  
  2267.  If you specify frame=box, or do not specify the frame= attribute, the table is 
  2268.  enclosed in a box. 
  2269.  
  2270.  A Table without a Frame:  Here is the same table without a frame. 
  2271.  
  2272.  Input Example 
  2273.  
  2274.   :table rules=horiz frame=none cols='10 15 15'.
  2275.   :row.
  2276.   :c.SYMBOL
  2277.   :c.ELEMENT
  2278.   :c.CHARACTER
  2279.   :row.
  2280.   :c.&.bxas.
  2281.   :c.box ascender
  2282.   :c.&bxas.
  2283.   :row.
  2284.   :c.&.bxcr.
  2285.   :c.box cross
  2286.   :c.&bxcr.
  2287.   :row.
  2288.   :c.&.bxde.
  2289.   :c.box descender
  2290.   :c.&bxde.
  2291.   :etable.
  2292.  
  2293.  Formatted Output 
  2294.  
  2295.   SYMBOL              ELEMENT             CHARACTER
  2296.   ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  2297.   &bxas.              box ascender        "
  2298.   ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  2299.   &bxcr.              box cross           Γö╝
  2300.   ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  2301.   &bxde.              box descender       "
  2302.  
  2303.  Special Considerations:  None of the text-formatting tags (for example, list 
  2304.  tags) can be used in a table.  You can use character-graphic symbols and 
  2305.  highlighted-phrase tags.  However, boldface and italic highlighting can cause 
  2306.  vertical misalignment of column text and rules.  To use boldface highlighting 
  2307.  in tables and avoid word alignment problems, place the highlighted-phrase tags 
  2308.  (:hp2. and :ehp2.) as shown in the example.  The table rules as well as the 
  2309.  text will be displayed in boldface. 
  2310.  
  2311.  Input Example 
  2312.  
  2313.   :hp2.
  2314.   :table cols='11 11 11'.
  2315.   :row.
  2316.   :c.Row 1 Col 1
  2317.   :c.Row 1 Col 2
  2318.   :c.Row 1 Col 3
  2319.   :row.
  2320.   :c.Row 2 Col 1
  2321.   :c.Row 2 Col 2
  2322.   :c.Row 2 Col 3
  2323.   :etable.
  2324.   :ehp2.
  2325.  
  2326.  Formatted Output 
  2327.  
  2328.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2329.   ΓöéRow 1 Col 1ΓöéRow 1 Col 2ΓöéRow 1 Col 3Γöé
  2330.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2331.   ΓöéRow 2 Col 1ΓöéRow 2 Col 2ΓöéRow 2 Col 3Γöé
  2332.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2333.  
  2334.  The above technique is practical only with :hp2. and does not work for :hp1. 
  2335.  or for the highlighted-phrase tags that change the color of text. 
  2336.  
  2337.  Unformatted Text in a Table Column:  The text in table columns is formatted 
  2338.  only once-at compile time. If you do not want the compiler to format the text 
  2339.  in a column, enclose it with :lines. and :elines., as shown in the following 
  2340.  example. 
  2341.  
  2342.  Input Example 
  2343.  
  2344.   :table cols='10 10 15 10'.
  2345.   :row.
  2346.   :c.Spacecraft
  2347.   :c.Date
  2348.   :c.Astronauts
  2349.   :c.Mission
  2350.   :row.
  2351.   :c.Apollo 11
  2352.   :c.7-16-1969
  2353.   :c.
  2354.   :lines.
  2355.   Neil Armstrong
  2356.   Edwin Aldrin
  2357.   Michael Collins
  2358.   :elines.
  2359.   :c.
  2360.   First landing on the moon.
  2361.   :etable.
  2362.  
  2363.  Formatted Output 
  2364.  
  2365.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2366.   ΓöéSpacecraftΓöéDate      ΓöéAstronauts     ΓöéMission   Γöé
  2367.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2368.   ΓöéApollo 11 Γöé7-16-1969 ΓöéNeil Armstrong ΓöéFirst     Γöé
  2369.   Γöé          Γöé          ΓöéEdwin Aldrin   Γöélanding onΓöé
  2370.   Γöé          Γöé          ΓöéMichael CollinsΓöéthe moon. Γöé
  2371.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2372.  
  2373.  
  2374. ΓòÉΓòÉΓòÉ 4.10. Plain Lines ΓòÉΓòÉΓòÉ
  2375.  
  2376. Normally, lines of text that have no formatting tags are wrapped by IPF; that 
  2377. is, irregular lines in the source file become a continuous string, and one word 
  2378. follows another on a line until the line width of the current window is filled, 
  2379. a formatting tag is encountered, or the end of the window is reached. 
  2380.  
  2381. The :lines. tag and its corresponding end tag, :elines., enable you to control 
  2382. where lines break. 
  2383.  
  2384. The following example shows how the :lines. tag prevents wrapping of text. 
  2385.  
  2386. Input Example 
  2387.  
  2388. Here is how IPF normally wraps lines to fit the window width&colon. 
  2389.  
  2390. :p.&odq.Normally, lines of text that have no formatting tags are wrapped by 
  2391. IPF; that is, irregular lines in the source file become a continuous string, 
  2392. and one word follows another on a line until the line width of the current 
  2393. window is filled, a formatting tag is encountered, or the end of the window is 
  2394. reached.&cdq. 
  2395.  
  2396. In the following example, IPF will not wrap the lines, because we used the 
  2397. :hp2.&colon.lines&per.:ehp2. tag to prevent the lines from being formatted. 
  2398.  
  2399. :lines.
  2400. &odq.Normally, lines of text that have no
  2401. formatting tags are wrapped by IPF;
  2402. that is, irregular lines in the source
  2403. file become a continuous string, and
  2404. one word follows another on a line
  2405. until the line width of the current
  2406. window is filled, a formatting tag
  2407. is encountered, or the end of the
  2408. window is reached.&cdq.
  2409. :elines.
  2410.  
  2411. The quotation appears in two forms. 
  2412.  
  2413. Plain Lines Example 
  2414.  
  2415. Here is how IPF normally wraps lines to fit the window width: 
  2416.  
  2417. "Normally, lines of text that have no formatting tags are wrapped by IPF; that 
  2418. is, irregular lines in the source file become a continuous string, and one word 
  2419. follows another on a line until the line width of the current window is filled, 
  2420. a formatting tag is encountered, or the end of the window is reached." 
  2421.  
  2422. In the following example, IPF will not wrap the lines, because we used the 
  2423. :lines. tag to prevent the lines from being formatted. 
  2424.  
  2425. "Normally, lines of text that have no
  2426. formatting tags are wrapped by IPF;
  2427. that is, irregular lines in the source
  2428. file become a continuous string, and
  2429. one word follows another on a line
  2430. until the line width of the current
  2431. window is filled, a formatting tag
  2432. is encountered, or the end of the
  2433. window is reached."
  2434.  
  2435. In the first case, IPF wraps the lines to fit the window width. In the second, 
  2436. IPF does not wrap the lines, because :lines. prevents them from being 
  2437. formatted. If a line of text were to exceed the width of the current window, it 
  2438. would be clipped.  Also, when IPF encounters other tags between :lines. and 
  2439. :elines., such as quotation tags, the tags are processed. 
  2440.  
  2441. Aligned Lines:  :lines. has an align= attribute, which you use to align text to 
  2442. the left, right, or center of the window. 
  2443.  
  2444. Assume that in the previous example, the tag was: 
  2445.  
  2446. :lines align=center.
  2447.  
  2448. The output would be as shown here. 
  2449.  
  2450.               Normally, lines of text that have no formatting tags
  2451.               are "wrapped" by IPF; that is, irregular lines in the
  2452.               source file become a continuous string, and one word
  2453.               follows another on a line until the line width of the
  2454.                   current window is filled, a formatting tag is
  2455.                 encountered, or the end of the window is reached.
  2456.  
  2457. Text aligned in the center of the window. 
  2458.  
  2459.  
  2460. ΓòÉΓòÉΓòÉ 4.11. Figures and Captions ΓòÉΓòÉΓòÉ
  2461.  
  2462. The figure tag (:fig.) is similar to :lines..  Both convey the same message: 
  2463. "Do not format the text that follows."  Also, both tags have end tags. 
  2464.  
  2465. A Captioned Figure:  Associated with :fig. is :figcap., which enables you to 
  2466. place a descriptive sentence or caption above or below the text. 
  2467.  
  2468. Input Example 
  2469.  
  2470. :h4.Example 1:  A Captioned Figure
  2471. :fig.
  2472. ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  2473.  Bat
  2474.  Black Bear
  2475.  Bobcat
  2476.  Coyote
  2477.  Mink
  2478.  Florida Panther
  2479.  Key Deer
  2480.  Oppossum
  2481.  West Indian Manatee
  2482.  Whitetail Deer
  2483. ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  2484. :figcap.Major Species of Mammals in Florida
  2485. :efig.
  2486.  
  2487. The formatted output looks like this: 
  2488.  
  2489. Example 1:  A Captioned Figure
  2490. ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  2491.  Bat
  2492.  Black Bear
  2493.  Bobcat
  2494.  Coyote
  2495.  Mink
  2496.  Florida Panther
  2497.  Key Deer
  2498.  Oppossum
  2499.  West Indian Manatee
  2500.  Whitetail Deer
  2501. ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  2502. Major Species of Mammals in Florida
  2503.  
  2504. Figure and Figure Caption 
  2505.  
  2506.  
  2507. ΓòÉΓòÉΓòÉ 4.12. Textual Examples ΓòÉΓòÉΓòÉ
  2508.  
  2509. One way of helping readers understand information is to use examples. The 
  2510. example tag (:xmp.) and its corresponding end tag (:exmp.) enable you to 
  2511. illustrate your information with textual examples by turning formatting off so 
  2512. that you can arrange text any way you want it. The text will be displayed in a 
  2513. monospace font.  To change the monospace font, use :font. within :xmp..  For 
  2514. more information about :font., see Changing Fonts. 
  2515.  
  2516. Input Example 
  2517.  
  2518. :xmp.
  2519. File   Edit   View   Options   Help
  2520.  
  2521.                  All
  2522.                  Some . . .
  2523.                  By . . .
  2524. :exmp.
  2525.  
  2526. Formatted Output 
  2527.  
  2528. File   Edit   View   Options   Help
  2529.  
  2530.                  All
  2531.                  Some . . .
  2532.                  By . . .
  2533.  
  2534. Restriction:  You cannot nest :xmp. within another :xmp.. 
  2535.  
  2536.  
  2537. ΓòÉΓòÉΓòÉ 4.13. Character Graphics ΓòÉΓòÉΓòÉ
  2538.  
  2539. If you want to include simple line drawings, use the character graphics tag 
  2540. (:cgraphic.) and its corresponding end tag (:ecgraphic.). Text within this tag 
  2541. is displayed in a monospace font.  To change the monospace font, use :font. 
  2542. within :cgraphic..  For more information about :font., see Changing Fonts. If 
  2543. text does not fit within the boundaries of a window, it is clipped, not 
  2544. wrapped. 
  2545.  
  2546. Place the tags before and after the character graphic, as shown in the 
  2547. following example. 
  2548.  
  2549. Input Example 
  2550.  
  2551. :cgraphic.
  2552.  
  2553. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2554. ΓöéFile   Edit  Γöé View Γöé Options   Help Γöé
  2555. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÿ
  2556.               Γöé All                Γöé
  2557.               Γöé Some . . .         Γöé
  2558.               Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2559.               Γöé By . . .           Γöé
  2560.               ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2561. :ecgraphic.
  2562.  
  2563. Formatted Output 
  2564.  
  2565. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2566. ΓöéFile   Edit  Γöé View Γöé Options   Help Γöé
  2567. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÿ
  2568.               Γöé All                Γöé
  2569.               Γöé Some . . .         Γöé
  2570.               Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2571.               Γöé By . . .           Γöé
  2572.               ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2573.  
  2574. Restriction:  You cannot nest :cgraphic. within another :cgraphic.. 
  2575.  
  2576.  
  2577. ΓòÉΓòÉΓòÉ 4.14. Changing Fonts ΓòÉΓòÉΓòÉ
  2578.  
  2579. The :font. tag is used to change the current font within the text of the 
  2580. current window.  When a heading tag that defines a new window is encountered, 
  2581. the font is reset to the system default font. 
  2582.  
  2583. The font tag has three attributes:  facename= and size= are required; 
  2584. codepage= is optional. If a code page value is not specified, the code page of 
  2585. the active system is used. 
  2586.  
  2587. facename= specifies the name of the font you want to change to.  Some of the 
  2588. common values for this attribute are: 
  2589.  
  2590.       Helv 
  2591.       Courier 
  2592.       default 
  2593.  
  2594.  size= specifies the height and width, in points, of the font you have 
  2595.  selected.  (A point is a typesetting measure equal to approximately 1/72 of an 
  2596.  inch.) The value is expressed in the form, HxW.  For example, suppose you want 
  2597.  to change the current font to an 18-point-high by 10-point-wide Helvetica 
  2598.  font.  You would specify: 
  2599.  
  2600.   :font facename=Helv size=18x10.
  2601.  
  2602.  You do not have to know exact point values.  IPF uses a "best fit" method to 
  2603.  select the font.  If, in the example above, you had specified 20x12 as the 
  2604.  size value, IPF would have selected Helv 18x10 because it is the closest size 
  2605.  to the one you specified. 
  2606.  
  2607.  Using :font., you can make as many font changes within a window as you want. 
  2608.  You can define highlighted phrases while a font tag is in effect, and the 
  2609.  tagged text will be displayed in the font style corresponding to that 
  2610.  typeface. 
  2611.  
  2612.  You can use :font. within the :xmp. and :cgraphic. tags to change the default 
  2613.  system monospace font.  To change the default system monospace font, specify 
  2614.  the desired facename= and size= attribute. 
  2615.  
  2616.  The following resets the font to the default system proportional font. 
  2617.  
  2618.   :font facename=default size=0x0.
  2619.  
  2620.  In the following example, the font style is reset for each list item in the 
  2621.  simple list. 
  2622.  
  2623.  Input Example 
  2624.  
  2625.   :p.The following illustrate available fonts:
  2626.   :sl.
  2627.   :font facename=Courier size=13x8.
  2628.   :li.This sentence is in Courier 13 by 8 font.
  2629.   .*
  2630.   :font facename='Tms Rmn' size=18x14.
  2631.   :li.This sentence is in 'Tms Rmn' 18 by 14 font.
  2632.   .*
  2633.   :font facename=Helv size=28x18.
  2634.   :li.This sentence is in Helvetica 28 by 18 font.
  2635.   .*
  2636.   :font facename=default size=0x0.
  2637.   :li.This sentence is in the default system font.
  2638.   :esl.
  2639.  
  2640.  Here is the formatted output. 
  2641.  
  2642.  Example of the Font Tag 
  2643.  
  2644.       This sentence is in Courier 13 by 8 font. 
  2645.  
  2646.       This sentence is in 'Tms Rmn' 18 by 14 font. 
  2647.  
  2648.       This sentence is in Helvetica 28 by 18 font. 
  2649.  
  2650.       This sentence is in the default system font. 
  2651.  
  2652.  
  2653. ΓòÉΓòÉΓòÉ 4.15. Changing Color ΓòÉΓòÉΓòÉ
  2654.  
  2655. The color tag (:color.), with its attributes fc= and bc=, enables you to change 
  2656. the color of the text (foreground color) and the color of the area behind the 
  2657. text characters (background color). 
  2658.  
  2659. Colors set with this tag remain in effect until others are specified, or until 
  2660. a heading definition is encountered. 
  2661.  
  2662. To return to the system colors, specify: 
  2663.  
  2664. :color fc=default bc=default.
  2665.  
  2666. In the following example, each of the first three color tags specifies 
  2667. different foreground and background colors.  The last color tag returns the 
  2668. colors to the system colors. 
  2669.  
  2670. Input Example 
  2671.  
  2672. :ol.
  2673. :color fc=green bc=blue.
  2674. :li.Color the foreground green; color the background blue.
  2675. .*
  2676. :color fc=blue bc=red.
  2677. :li.Color the foreground blue; color the background red.
  2678. .*
  2679. :color fc=cyan bc=yellow.
  2680. :li.Color the foreground cyan; color the background yellow.
  2681. .*
  2682. :color fc=default bc=default.
  2683. :li.Return to the system colors.
  2684. :eol.
  2685.  
  2686. Output Example:  Color the Foreground and Background 
  2687.  
  2688.       Color the foreground green; color the background blue. 
  2689.  
  2690.       Color the foreground blue; color the background red. 
  2691.  
  2692.       Color the foreground cyan; color the background yellow. 
  2693.  
  2694.       Return to the system colors. 
  2695.  
  2696.  
  2697. ΓòÉΓòÉΓòÉ 4.16. Margins ΓòÉΓòÉΓòÉ
  2698.  
  2699. You can specify the boundaries of text in a window by using the margin tags. 
  2700. The left-margin tag (:lm.) specifies how many character spaces from the left 
  2701. border of the window the text is to start.  The right-margin tag (:rm.) 
  2702. specifies how many character spaces from the right border the text is to end. 
  2703.  
  2704. The margin= attribute sets the margin for the text. If none is specified on the 
  2705. :lm. or :rm. tag, the default is 1. 
  2706.  
  2707. If the margin tag in a line begins beyond the specified boundary, the new 
  2708. margin becomes effective on the next line. 
  2709.  
  2710. You can have multiple margin tags in your file. The specified margins remain in 
  2711. effect until they are reset. 
  2712.  
  2713. Input Example 
  2714.  
  2715. :p.
  2716. :rm margin=10.
  2717. :lm margin=20.This text begins 20 spaces to the right
  2718. of the left window border and ends 10 spaces to the
  2719. left of the right window border.
  2720. All text is aligned as specified
  2721. by the margin values. :lm margin=5.Here the left margin
  2722. is changed to 5.  Because this margin tag begins
  2723. more than 5 spaces on the line, the margin specified
  2724. becomes effective on the following line, and the text
  2725. begins 5 spaces from the left window border.
  2726. The right margin remains unchanged.
  2727.  
  2728. Here is how the window looks: 
  2729.  
  2730.                     This text begins 20 spaces to the right of the left window 
  2731.                     border and ends 10 spaces to the left of the right window 
  2732.                     border. All text is aligned as specified by the margin 
  2733.                     values. Here the left margin is changed to 5.  Because this 
  2734.      margin tag begins more than 5 spaces on the line, the margin specified 
  2735.      becomes effective on the following line, and the text begins 5 spaces from 
  2736.      the left window border. The right margin remains unchanged. 
  2737.  
  2738.      Example of the Margin Tag 
  2739.  
  2740.  
  2741. ΓòÉΓòÉΓòÉ 4.17. Bit Map and Metafile Graphics ΓòÉΓòÉΓòÉ
  2742.  
  2743. In a previous topic, we discussed how you can use :cgraphic. to illustrate your 
  2744. text with character graphics.  With :artwork., you can illustrate your text 
  2745. with bit-map or metafile graphics.  A bit map is a representation of an image, 
  2746. and can be created with such tools as the Icon Editor, which is available with 
  2747. the IBM Developer. Metafiles provide device independence; bit maps do not. The 
  2748. bit map or metafile graphics reside in a file that must be specified with the 
  2749. name=' ' attribute of :artwork.. This file is then loaded when you compile your 
  2750. source file with the IPF compiler. The OS/2 2.0 compress bit map format is not 
  2751. supported by the IPF compiler.  The IPF compiler compresses the bit maps. 
  2752.  
  2753. The artwork tag has other attributes as well: 
  2754.  
  2755.      The align= attribute enables you to position the graphic. The values are 
  2756.       left, right, and center, and are with respect to the current margins. 
  2757.  
  2758.      The fit attribute causes a bit map to be redrawn and scaled to fit the 
  2759.       window. 
  2760.  
  2761.       The ratio between the width and height of the window should be the ratio 
  2762.       of the original width and height of the bit map or metafile; otherwise, 
  2763.       the graphic might appear distorted. 
  2764.  
  2765.      The runin attribute enables you to place a graphic within a line of text. 
  2766.       For example, to include an icon within a line of text, the text and tag 
  2767.       would be as follows: 
  2768.  
  2769.  Input Example 
  2770.  
  2771.   :p.This is an example of artwork displayed within the
  2772.   :artwork runin name='BOOK.BMP'.
  2773.   text of a sentence.
  2774.   .**
  2775.   :p.You can also align the artwork to appear on the
  2776.   :lines align=left.
  2777.   left,
  2778.   :elines.
  2779.   :artwork align=left name='BOOK.BMP'.
  2780.   :lines align=right.
  2781.   right,
  2782.   :elines.
  2783.   :artwork align=right name='BOOK.BMP'.
  2784.   :lines align=center.
  2785.   or center of the window.
  2786.   :elines.
  2787.   :artwork align=center name='BOOK.BMP'.
  2788.  
  2789.  It would bring the artwork into the screen like this. 
  2790.  
  2791.  This is an example of artwork displayed within the text of a sentence. 
  2792.  
  2793.  You also can align the artwork to appear on the 
  2794.  
  2795.   left,
  2796.  
  2797.                                                                           right,
  2798.  
  2799.                              or center of the window.
  2800.  
  2801.  Example of the Artwork Tag 
  2802.  
  2803.  
  2804. ΓòÉΓòÉΓòÉ 5. Linking ΓòÉΓòÉΓòÉ
  2805.  
  2806. Today, the computer's ability to link pieces of information gives the author 
  2807. flexibility in layering and structuring documents, and at the same time, 
  2808. provides cohesive information. 
  2809.  
  2810. This chapter describes the tags that identify, associate, and link one window 
  2811. to another window.  This chapter also describes the different types of linking 
  2812. available with IPF, and what to expect when using them. 
  2813.  
  2814.  
  2815. ΓòÉΓòÉΓòÉ 5.1. Window Identifiers ΓòÉΓòÉΓòÉ
  2816.  
  2817. The link tag (:link.) allows you to link to a heading, a footnote, an external 
  2818. database, or another application. The reftype=  attribute is required with each 
  2819. link tag description.  This attribute identifies the type of link you are 
  2820. defining. 
  2821.  
  2822. The res= attribute and the value specified identify the window you are linking 
  2823. to.  This attribute is the window identifier. A res= number must be in the 
  2824. range 1 through 64 000. The same window identifier must be specified in the 
  2825. tagging of the window you are linking to in order for a hypertext link to exist 
  2826. (see Hypertext Links). 
  2827.  
  2828. The IPF compiler recognizes links to headings (including hidden headings) only 
  2829. when the heading level is within the default range (toc=123) or specified range 
  2830. of heading levels.  If you specify a window identifier for a level that is 
  2831. lower in the hierarchy than that recognized for contents entries, and then 
  2832. attempt to link to it, the compiler returns an error message.  For example, 
  2833. suppose the default is in effect for contents entries; that is, only heading 
  2834. levels 1 through 3 cause entries in the Contents window.  Also suppose your 
  2835. file contains the following heading definition: 
  2836.  
  2837. :h4 res=050.Copy File
  2838.  
  2839. The heading "Copy File"  appears in the same window as the preceding heading 
  2840. level 3.  If you use this window identifier in a link definition to link to the 
  2841. heading from another window, the IPF compiler returns the error message, No res 
  2842. for this reference. 
  2843.  
  2844. If you are creating windows for an online document (a .INF file), you can use 
  2845. the res=, id=, or name= attribute of the heading tag to specify window 
  2846. identifiers. An advantage of using either id= or name= is that you can specify 
  2847. both alphabetic and numeric characters, which can make the job of assigning and 
  2848. remembering window IDs easier.  If you use one of these attributes, you must 
  2849. use the refid= attribute of :link. when defining a hypertext cross-reference to 
  2850. the window. 
  2851.  
  2852. If you need to use both res= numbers and id= values, you can specify both in a 
  2853. window heading. For simplicity, you can assign the same number to both 
  2854. identifiers. 
  2855.  
  2856. Note:  If an OS/2 application needs to communicate with an IPF window, you must 
  2857.        use the res= attribute as a window identifier. 
  2858.  
  2859.  
  2860. ΓòÉΓòÉΓòÉ 5.2. Types of Links ΓòÉΓòÉΓòÉ
  2861.  
  2862. Links are electronic connections between one online element and another.  With 
  2863. IPF, the user can be linked from one window to another by means of selectable 
  2864. text and graphic areas that the author defines.  The user also can be linked to 
  2865. information in another IPF database. 
  2866.  
  2867. Different types of links support document designs and information 
  2868. retrievability in various ways: 
  2869.  
  2870.  Hypertext Links Selectable words or phrases that connect related information. 
  2871.  
  2872.  Hypergraphic Links Selectable graphics that connect related information. 
  2873.  
  2874.  Automatic Links Links that begin a chain reaction at the primary window. When 
  2875.          the user selects the primary window, an automatic link is activated to 
  2876.          display secondary windows. 
  2877.  
  2878.  External Links Links that connect external online document files. 
  2879.  
  2880.  
  2881. ΓòÉΓòÉΓòÉ 5.2.1. Hypertext Links ΓòÉΓòÉΓòÉ
  2882.  
  2883. Hypertext is the linking of online information so the user can navigate from 
  2884. selectable text to related information. A hypertext link is the association 
  2885. between two topics. The origin of the link is the source topic; the destination 
  2886. is the target topic. 
  2887.  
  2888. In the following example, the DIR command is the source topic; it describes the 
  2889. directory command. Within the DIR topic is a reference to the MKDIR command - 
  2890. the target topic. 
  2891.  
  2892.  
  2893.        Source Topic                      Target Topic
  2894. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ      ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2895. ΓöéDIR - Display files in ... Γöé ΓöîΓöÇΓöÇ Γöé MKDIR - Make a new ... Γöé
  2896. Γöé                           Γöé Γöé    Γöé                        Γöé
  2897. Γöé                           Γöé Γöé    Γöé                        Γöé
  2898. Γöé                           Γöé Γöé    Γöé                        Γöé
  2899. Γöé Related command: MKDIR ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÿ    Γöé  Related command: DIR  Γöé
  2900. Γöé                           Γöé      Γöé                        Γöé
  2901. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ      ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2902.  
  2903. You use :link. to establish a hypertext link between a topic in the 
  2904. source-topic window and a topic in the target-topic window.  :link. enables you 
  2905. to create selectable, highlighted text in the source-topic window.  When users 
  2906. select this text, they are linked to the window containing the target topic, 
  2907. and the linked window appears. 
  2908.  
  2909. Consider the following example: 
  2910.  
  2911. :link reftype=hd res=123.MKDIR:elink.
  2912.  
  2913.      reftype=hd indicates the hypertext phrase MKDIR is being linked to a 
  2914.       heading in the target-topic window. 
  2915.  
  2916.       Notice MKDIR is delimited by the period of the :link. tag and the colon 
  2917.       of the :elink. tag. 
  2918.  
  2919.      res=123 is the identifier of the target-topic window. 
  2920.  
  2921.       The heading tag of the target-topic window must contain this identifier. 
  2922.       The following is an example: 
  2923.  
  2924.                 :h2 res=123.MKDIR
  2925.  
  2926.  For more information about hypertext links, see Display Another Window of the 
  2927.  Same Library. 
  2928.  
  2929.  
  2930. ΓòÉΓòÉΓòÉ 5.2.2. Hypergraphic Links ΓòÉΓòÉΓòÉ
  2931.  
  2932. A hypergraphic link is similar to a hypertext link except that the user 
  2933. navigates from a selectable graphic instead of selectable text. 
  2934.  
  2935.  
  2936. ΓòÉΓòÉΓòÉ 5.2.2.1. Bit Maps ΓòÉΓòÉΓòÉ
  2937.  
  2938. Graphic illustrations are usually bit maps.  Bit maps can be monochrome or 
  2939. color and can be created with the Presentation Manager Icon Editor, which is 
  2940. available in the IBM Developer. The bit map resides in a separate file called 
  2941. by IPF at compile time. 
  2942.  
  2943. The artwork tag (:artwork.) identifies the name of the bit-map; for example: 
  2944.  
  2945. :artwork name='mybitmap.bmp'.
  2946.  
  2947. The :artlink. and :eartlink. tags define areas of the bit map that are 
  2948. selectable hypergraphic. This means the user can link from the artwork to 
  2949. additional information. If no :artlink. tag is used, no hypergraphic areas are 
  2950. defined. 
  2951.  
  2952. If you want the entire bit map to be hypergraphic, the tagging is simple.  You 
  2953. have only one art link, and you do not have to define the area.  The following 
  2954. shows the tagging required to establish a link: 
  2955.  
  2956. Input Example 
  2957.  
  2958. :p.This is an example of a hypergraphic.
  2959. Select the Shuttle graphic and get ready for a walk on
  2960. the moon.
  2961. :artwork name='shuttle.bmp'.
  2962. :artlink.
  2963. :link reftype=hd res=001.
  2964. :eartlink.
  2965.  
  2966.  Notice there is no :elink. tag.  Instead, there is an :eartlink. tag.  An 
  2967. :elink. tag is required only to denote the end of a hypertext link. 
  2968.  
  2969. You also need to specify the identifier in the tagging for the window you are 
  2970. linking to.  For example: 
  2971.  
  2972. :h1 res=001.Apollo 11
  2973.  
  2974. The entire bit map as a selectable hypergraphic area. 
  2975.  
  2976. When the user double-clicks on the hypergraphic area, the window whose 
  2977. identifier is 001 ("Apollo 11") appears. 
  2978.  
  2979.  
  2980. ΓòÉΓòÉΓòÉ 5.2.2.2. Metafiles ΓòÉΓòÉΓòÉ
  2981.  
  2982. A metafile is another type of file in which graphics are stored. However, a 
  2983. metafile contains data generated from the Presentation Manager graphics (GPI) 
  2984. functions only. (For information about graphics functions, see the OS/2 2.0 
  2985. Programming Guide, Volume 3.)  IPF supports a metafile as a hypergraphic link 
  2986. only when the entire metafile is defined as a hypergraphic area. 
  2987.  
  2988. The artwork tag identifies the file name of a metafile as follows: 
  2989.  
  2990. :artwork name='myfile.met'.
  2991.  
  2992.  
  2993. ΓòÉΓòÉΓòÉ 5.2.2.3. Segmented Hypergraphics ΓòÉΓòÉΓòÉ
  2994.  
  2995. You can divide your bit map into rectangular segments, make each segment 
  2996. selectable, and have each segment link to different information. You must 
  2997. define each segment in terms of values along the x and y axes. Values for x and 
  2998. y define the origin of the segment. The changes in x and y are given as values 
  2999. for cx and cy. The following is an example of a segmented bit map: 
  3000.  
  3001.     0,16                                32,16
  3002.     | ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3003.     | Γöé                Γöé                  Γöé
  3004.     | Γöé                Γöé                  Γöé
  3005.     y Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3006.     | Γöé                Γöé                  Γöé
  3007.     | Γöé                Γöé                  Γöé
  3008.     | ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3009.     0,0 ---------------x--------------- 32,0
  3010.  
  3011. The following shows the tagging to establish a bit-map segment as a 
  3012. hypergraphic area: 
  3013.  
  3014. :artwork name='show2.bmp'.
  3015. :artlink.
  3016. :link reftype=hd res=001 x=0 y=0 cx=16 cy=8.
  3017. :eartlink.
  3018.  
  3019.  
  3020. ΓòÉΓòÉΓòÉ 5.2.3. Automatic Links ΓòÉΓòÉΓòÉ
  3021.  
  3022. Links also can be made automatically.  An automatic link occurs when the user 
  3023. performs an action that selects a window in which a link is defined. For 
  3024. automatic links to occur, the reftype= attribute of the :link. tag must have a 
  3025. value of hd, inform, or launch. Automatic links allow you to: 
  3026.  
  3027.      Display multiple windows when a heading or link definition is selected 
  3028.       (hd attribute). 
  3029.  
  3030.      Display multiple secondary windows within the coverpage of a primary 
  3031.       window (hd attribute). 
  3032.  
  3033.      Send a message to the application when a window is displayed (inform 
  3034.       attribute). 
  3035.  
  3036.      Start a Presentation Manager program when a window is displayed (launch 
  3037.       attribute). 
  3038.  
  3039.  Automatic links can be associated with selectable links so that another action 
  3040.  occurs in addition to the display of a linked window.  For example, a 
  3041.  Presentation Manager program can be started, or a message can be sent to the 
  3042.  application program. 
  3043.  
  3044.  Restriction: Linking automatically to an external database is not possible. 
  3045.  
  3046.  
  3047. ΓòÉΓòÉΓòÉ 5.2.4. External Links ΓòÉΓòÉΓòÉ
  3048.  
  3049. An external link is a link from a .HLP file to another .HLP file or from a .INF 
  3050. file to another .INF file. 
  3051.  
  3052. If you are linking from one internal database to another, use the res= 
  3053. attribute. If you want to allow external databases to link to a window in your 
  3054. file, the window heading must contain the global attribute, and you must use 
  3055. the id= attribute as a window identifier. 
  3056.  
  3057. Restriction: Linking automatically to an external database is not possible. 
  3058.  
  3059. For more information about external links, see Display a Help Window from 
  3060. Another Help Library. 
  3061.  
  3062.  
  3063. ΓòÉΓòÉΓòÉ 5.3. What Linking Can Do ΓòÉΓòÉΓòÉ
  3064.  
  3065. You now know that :link. makes text phrases and hypergraphic areas within a 
  3066. window selectable. When the user selects a hypertext or hypergraphic area, the 
  3067. following occurs, depending on the content of the :link. tag: 
  3068.  
  3069.      Another window of the same library is displayed. 
  3070.      Another window of a different library is displayed. 
  3071.      A footnote window is displayed. 
  3072.      A message is sent to the application program. 
  3073.      Another application is started. 
  3074.  
  3075.  
  3076. ΓòÉΓòÉΓòÉ 5.3.1. Display Another Window of the Same Library ΓòÉΓòÉΓòÉ
  3077.  
  3078. When you want the user to link to another window in the current library, use 
  3079. the reftype=hd attribute with :link.. For example: 
  3080.  
  3081. :link
  3082. reftype=hd res=21084.What Are Libraries For?
  3083. :elink.
  3084.  
  3085. The hd attribute tells the compiler to link to a heading in another window. The 
  3086. res= attribute value specifies the identification of the window being linked 
  3087. to. 
  3088.  
  3089. The text "What Are Libraries For?" is uniquely highlighted in the window so 
  3090. that the user knows it is selectable. If the user selects it, the window 
  3091. containing the heading defined by res= 21084 appears. 
  3092.  
  3093. Note:  The highlighting of a hypertext phrase is done with a color selected by 
  3094.        IPF and should not be confused with highlighted-phrase tags, which are 
  3095.        used to change the type font. (See Highlighted Phrases for an 
  3096.        explanation of these tags.) 
  3097.  
  3098.  The tagging shown in the following figure contains an example of the link tag. 
  3099.  Also included is the tagging for the window being linked to. 
  3100.  
  3101.   :************************************************
  3102.   :* In the following source, the text of the window
  3103.   :* contains a heading tag with a window
  3104.   :* identifier, a paragraph tag, and a hypertext
  3105.   :* link to another window.
  3106.   :************************************************
  3107.   :h1 res=21083.The Library Manager
  3108.   :i1.object code libraries
  3109.   :p.
  3110.   The Library Manager (LIB) lets you create and maintain
  3111.   libraries of object code.  A library is an organized
  3112.   collection
  3113.   of object code; that is, a library contains functions and data
  3114.   that are already assembled or compiled and ready for linking
  3115.   with your programs. See:
  3116.   :link
  3117.   reftype=hd res=21084.What Are Libraries For?
  3118.   :elink.
  3119.   :p.
  3120.   LIB works with both DOS and OS/2 files.
  3121.   :************************************************
  3122.   :* The following contains a heading tag with a
  3123.   :* window identifier that matches the link-tag
  3124.   :* res= attribute above.
  3125.   :* This file also contains an unordered list.
  3126.   :************************************************
  3127.   :h2 res=21084.What Are Libraries For?
  3128.   :p.Programming libraries of object code are used:
  3129.   :ul.
  3130.   :li.To support high-level languages.
  3131.   :p.Most compilers include libraries to perform standard
  3132.   operations, such as input/output and floating-point mathematics.
  3133.   :p.
  3134.   When your program refers to a library routine, the
  3135.   compiler and linker combine the library routine with your
  3136.   program.
  3137.   :li.To perform complex and specialized activities, such
  3138.   as database management or advanced graphics.
  3139.   :p.Compilers include libraries for specialized tasks. You
  3140.   also can use a library from a third party software vendor.
  3141.   :li.To support your own work.
  3142.   :p.If you have created routines that you use with a
  3143.   variety of programs, you might want to consolidate these routines
  3144.   into a library.  You then can link to one library object module
  3145.   rather than to a large group of object files.
  3146.   :eul.
  3147.  
  3148.  
  3149. ΓòÉΓòÉΓòÉ 5.3.2. Display a Window Linked to Another Database ΓòÉΓòÉΓòÉ
  3150.  
  3151. You also can link a user to a window in another IPF .HLP or .INF file.  You 
  3152. must specify the file name with the database= attribute. If the following were 
  3153. in the source file, selection of the hypertext link would cause the file, 
  3154. EDITOR.HLP to be loaded, and the window whose ID is 001 to be displayed. 
  3155.  
  3156. :link reftype=hd database='editor.hlp' refid=001.
  3157. Editing Functions
  3158. :elink.
  3159.  
  3160. The heading definition in the other file must contain the global attribute.  If 
  3161. the link to the file cannot be resolved, the hypertext phrase in the link is 
  3162. not highlighted.  For example, if the .INF or .HLP file is not available, IPF 
  3163. will not highlight the linked phrase.  If the .INF or .HLP file becomes 
  3164. available, IPF will dynamically highlight the phrase. 
  3165.  
  3166.  
  3167. ΓòÉΓòÉΓòÉ 5.3.3. Display a Help Window from Another Help Library ΓòÉΓòÉΓòÉ
  3168.  
  3169.  If you are creating a window for a help library (a .HLP file), you must use 
  3170. the res= attribute to assign an identifier to each window.  For example: 
  3171.  
  3172. :h1 res=2001 id=2001 global.
  3173. Help for Copy
  3174.  
  3175. IPF uses the value specified for res= (any integer from 1 through 64 000) to 
  3176. associate a window with a user's request for help on a field or window of the 
  3177. application. If you use the res= attribute in a heading tag, you must also use 
  3178. it in a link tag when defining a hypertext cross-reference to the window.  For 
  3179. example: 
  3180.  
  3181. :link reftype=hd res=2001.
  3182. Help for Copy
  3183. :elink.
  3184.  
  3185.  
  3186. ΓòÉΓòÉΓòÉ 5.3.4. Display a Footnote Window ΓòÉΓòÉΓòÉ
  3187.  
  3188. A footnote window results when the user selects a hypertext phrase that is 
  3189. linked to a footnote tag (:fn.).  The text between :fn. and :efn. is what 
  3190. appears in the footnote window.  The following is an example of the tagging for 
  3191. the footnote text: 
  3192.  
  3193. Input Example 
  3194.  
  3195. :fn id=drive.
  3196. :p.The text you enclose in footnote tags appears in a
  3197. small window when the user selects a hypertext or hypergraphic
  3198. link to the footnote.  Notice that
  3199. the title of the window is the same as the hypertext
  3200. phrase "disk drives" that links to the window.
  3201. :efn.
  3202.  
  3203.  The id= attribute identifies the footnote for linking purposes. 
  3204.  
  3205. In the :link tag, use refid= to refer to the footnote identifier (in this case, 
  3206. "drive"), and reftype=fn to indicate that the link is to a footnote, and to 
  3207. specify the title of the footnote window. The following is an example of the 
  3208. tagging for a link to the footnote: 
  3209.  
  3210. :p.Additional information about
  3211. :link refid=drive reftype=fn.disk drives:elink.
  3212. is available.
  3213.  
  3214. The following figure shows the resulting footnote window. 
  3215.  
  3216. Footnote Window 
  3217.  
  3218. The following are some important points to remember about footnotes: 
  3219.  
  3220.      A footnote can be placed anywhere in your source file, as long as it 
  3221.       follows the first heading tag. 
  3222.  
  3223.      Footnotes cannot contain index entries. 
  3224.  
  3225.      Information in a footnote cannot be detected by a search. 
  3226.  
  3227.      A footnote cannot be in a window that has a split attribute in its 
  3228.       heading or link definition. 
  3229.  
  3230.  
  3231. ΓòÉΓòÉΓòÉ 5.3.5. Send a Message to the Application ΓòÉΓòÉΓòÉ
  3232.  
  3233. When the reftype=inform attribute is specified with :link., a message is sent 
  3234. to the application. The res= attribute, instead of being a resource identifier 
  3235. for IPF (a window ID), is a resource identifier for the application. The value 
  3236. specified must be an integer. When the application receives the message, it can 
  3237. then perform an application-specific function. 
  3238.  
  3239. For more information about how messages are sent to application windows using 
  3240. the reftype=inform attribute see Using Communication Windows. 
  3241.  
  3242.  
  3243. ΓòÉΓòÉΓòÉ 5.3.6. Start an Application ΓòÉΓòÉΓòÉ
  3244.  
  3245. The reftype=launch attribute of :link. causes IPF to start another Presentation 
  3246. Manager application. The object= attribute indicates the file specification of 
  3247. the application. The data= attribute specifies parameters associated with the 
  3248. application to be started. 
  3249.  
  3250. You can use the reftype=launch attribute with :link. to start a tutorial. 
  3251.  
  3252.  
  3253. ΓòÉΓòÉΓòÉ 6. Customizing Windows ΓòÉΓòÉΓòÉ
  3254.  
  3255. A window is an area of the screen with visible boundaries within which 
  3256. information is displayed.  Often a single window uses the entire screen for its 
  3257. information. Because online information is best presented in small pieces, or 
  3258. units, most designs call for a multiple window format. This chapter explains 
  3259. how to size and position more than one window on a screen, and how to use 
  3260. attributes that enable IPF to open and close those windows. Before you begin 
  3261. this chapter, make sure you read about the OS/2 standard windows described in 
  3262. IPF User Interface. 
  3263.  
  3264. For a summary of attributes described in this chapter, see Summary Tables of 
  3265. Attribute Values for Origin and Size, Summary Table for Heading Attributes, and 
  3266. Summary Table for Link Attributes. 
  3267.  
  3268.  
  3269. ΓòÉΓòÉΓòÉ 6.1. The Default Window ΓòÉΓòÉΓòÉ
  3270.  
  3271. Both the heading tags (:hn.) and the link tag (:link.) have attributes that 
  3272. affect how windows look on a screen.  For example, the attributes define: 
  3273.  
  3274.      Window size and position 
  3275.      Which window controls are provided to the user 
  3276.      What windows are displayed. 
  3277.  
  3278.  You do not have to use all the attributes provided by a heading tag to define 
  3279.  a window.  The following is an example of the minimum tagging required for a 
  3280.  window: 
  3281.  
  3282.   :h1 res=001.My First Window
  3283.   :p.
  3284.   Here is the text for the first window.
  3285.  
  3286.  In this example, :h1. creates a level-1 entry in the Contents window and the 
  3287.  title, "My First Window," in the title bar of the default window. 
  3288.  
  3289.  The following figure shows the tagging to produce the two default windows 
  3290.  shown in the example that follows the tagging. 
  3291.  
  3292.   :h1 res=001.My First Window
  3293.   :p.
  3294.   Here is the text for the first window.
  3295.   This is a
  3296.   :link reftype=hd res=002.
  3297.   hypertext link
  3298.   :elink.
  3299.   to the second window.
  3300.   :h1 res=002.My Second Window
  3301.   :p.
  3302.   Here is the text for the second window.
  3303.   This is a
  3304.   :link reftype=hd res=001.
  3305.   hypertext link
  3306.   :elink. to the first window.
  3307.  
  3308.  The following figure shows the compiled version of the tagging shown in the 
  3309.  previous figure. "My First Window" is one of the default windows and is 
  3310.  bounded by the window "Default Window Example."  This window is called a 
  3311.  coverpage and provides window controls for the user. 
  3312.  
  3313.  Example of an IPF Default Window 
  3314.  
  3315.  The two windows each have a hypertext link.  Selection of the hypertext link 
  3316.  in "My First Window" causes the other default window "My Second Window" to 
  3317.  display. Each default window has the same characteristics: 
  3318.  
  3319.      Its size is 100% of the coverpage window. 
  3320.      It provides window controls for the user: 
  3321.         -  Title bar with a title bar icon 
  3322.         -  Maximize and hide buttons 
  3323.         -  Vertical and horizontal scroll bars 
  3324.         -  Sizing borders 
  3325.         -  Push buttons. 
  3326.  
  3327.  
  3328. ΓòÉΓòÉΓòÉ 6.1.1. Attribute Values for Window Controls ΓòÉΓòÉΓòÉ
  3329.  
  3330. Both the heading tag and :link. have attributes that define window controls. 
  3331. Following are the names of the window-control attributes, and values you can 
  3332. specify (defaults are underscored): 
  3333.  
  3334.       titlebar=yes|sysmenu|minmax|both|none 
  3335.  
  3336.       scroll=horizontal|vertical|both|none 
  3337.  
  3338.       rules=border|sizeborder|none 
  3339.  
  3340.  You can eliminate window controls altogether by specifying: 
  3341.  
  3342.       titlebar=none scroll=none rules=none 
  3343.  
  3344.  You then can substitute controls of your own.  By eliminating borders around 
  3345.  windows and using :font. to specify fonts, you can design a more sophisticated 
  3346.  layout of text and graphics. The OS/2 system tutorial is an example of this. 
  3347.  
  3348.  For information about the tags that control the display of push buttons, see 
  3349.  Attribute Values for the Control Area of a Window. 
  3350.  
  3351.  
  3352. ΓòÉΓòÉΓòÉ 6.2. Multiple Windows ΓòÉΓòÉΓòÉ
  3353.  
  3354. Windows can be considered to be subdivisions of the screen. They can be either 
  3355. primary or secondary windows. A primary window is where the main topic appears, 
  3356. or where the interaction between a user and an object or application takes 
  3357. place. A secondary window usually supplements the information in the primary 
  3358. window. It is closed when its primary window is closed. The following figure 
  3359. shows a simple multiple-window design with a primary and secondary window. 
  3360.  
  3361. A Primary and Secondary Window Arrangement 
  3362.  
  3363. To create the two-window format shown in the figure, you must define the size 
  3364. of each window, then position them within the boundaries of the coverpage 
  3365. window. When defining window size, you specify horizontal and vertical areas of 
  3366. the window, using window coordinates. 
  3367.  
  3368.  
  3369. ΓòÉΓòÉΓòÉ 6.2.1. Defining Window Origin and Size ΓòÉΓòÉΓòÉ
  3370.  
  3371. Each window represents a rectangle with x and y coordinates. The x-axis is 
  3372. always horizontal; the y-axis is always vertical. The position where the values 
  3373. specified for x and y intersect is the window's origin.  From this position, 
  3374. width and height are measured. The following figure shows the window 
  3375. coordinates of a primary and secondary window. 
  3376.  
  3377. A Window in Relationship to Its Coordinates 
  3378.  
  3379.  
  3380. ΓòÉΓòÉΓòÉ 6.2.2. Attribute Values for Window Origin and Size ΓòÉΓòÉΓòÉ
  3381.  
  3382. Both the heading tags and :link. have attributes that define window origin and 
  3383. size. The heading tag has four attributes: 
  3384.  
  3385.  x=          Specifies a point on the x-axis. The x-axis runs horizontally from 
  3386.              left to right. 
  3387.  y=          Specifies a point on the y-axis. The y-axis runs vertically from 
  3388.              bottom to top. 
  3389.  width=      Specifies the width (horizontal space) of the window. 
  3390.  height=     Specifies the height (vertical space) of the window. 
  3391.  
  3392.  The :link. tag also has four attributes: 
  3393.  
  3394.  vpx=        Specifies a point on the x-axis. The x-axis runs horizontally from 
  3395.              left to right. 
  3396.  vpy=        Specifies a point on the y-axis. The y-axis runs vertically from 
  3397.              bottom to top. 
  3398.  vpcx=       Specifies the width (horizontal space) of the window. 
  3399.  vpcy=       Specifies the height (vertical space) of the window. 
  3400.  
  3401.  Origin and size attributes also can be assigned values of the following types: 
  3402.  
  3403.      Absolute 
  3404.      Relative 
  3405.      Dynamic 
  3406.  
  3407.  
  3408. ΓòÉΓòÉΓòÉ 6.2.2.1. Absolute Values ΓòÉΓòÉΓòÉ
  3409.  
  3410. Absolute values are specified in characters, pixels, or points. The format for 
  3411. an absolute value is an integer followed by one of these letters: 
  3412.  
  3413.  c (characters) 
  3414.     Average character width of the default system font. 
  3415.  x (pixels) 
  3416.     Pixel size, dependent on the display adapter in use. 
  3417.  p (points) 
  3418.     Typesetting measure, equal to approximately 1/72 inch. 
  3419.  
  3420.  
  3421. ΓòÉΓòÉΓòÉ 6.2.2.2. Relative Values ΓòÉΓòÉΓòÉ
  3422.  
  3423. Relative values are specified as percentages of the display area of the 
  3424. coverpage window. The format for a relative value is an integer followed by the 
  3425. percent sign (%). 
  3426.  
  3427.  
  3428. ΓòÉΓòÉΓòÉ 6.2.2.3. Dynamic Values ΓòÉΓòÉΓòÉ
  3429.  
  3430. Dynamic values for x- and y-coordinates identify locations on the 
  3431. coverpage-window perimeter or its center. Values are left and right for x, top 
  3432. and bottom for y, and center for both. 
  3433.  
  3434.  
  3435. ΓòÉΓòÉΓòÉ 6.2.2.4. Heading Definition Example ΓòÉΓòÉΓòÉ
  3436.  
  3437. The window defined in the following example is a primary window; its origin is 
  3438. specified using dynamic values, and its width and height are specified as 
  3439. percentages of its coverpage window. 
  3440.  
  3441. :h1 res=001
  3442.     x=left y=bottom width=50% height=100%
  3443.     group=1.Primary Window
  3444.  
  3445. For now, ignore "group=1."  We will explain it later. 
  3446.  
  3447. The most practical values to use for window size and position are a combination 
  3448. of relative and dynamic values. Then, if the user resizes the coverpage window, 
  3449. IPF automatically resizes and repositions the windows relative to the new size 
  3450. and position of the coverpage window. If you use absolute values, the window 
  3451. might be clipped when the user resizes the coverpage window. 
  3452.  
  3453. When defining window position and size, you cannot mix absolute values with 
  3454. dynamic or relative values for either of the following combinations of 
  3455. attributes: 
  3456.  
  3457.       x= and width= 
  3458.       y= and height= 
  3459.  
  3460.  If no values for x and y are specified, the origin of the window is 0,0. If 
  3461.  you specify an origin other than 0,0, you also must specify width and height 
  3462.  values.  Negative values for these attributes are not allowed. 
  3463.  
  3464.  
  3465. ΓòÉΓòÉΓòÉ 6.2.2.5. Origin and Size Example ΓòÉΓòÉΓòÉ
  3466.  
  3467. The example of a source file shown in the following figure defines two windows. 
  3468. The origin and size attributes specified with the heading definitions place the 
  3469. windows adjacent to one another on the screen. 
  3470.  
  3471. :h1.Origin and Size Window Example
  3472. :h2 res=003
  3473.     x=left y=bottom
  3474.     width=50% height=100%.
  3475. Primary Window
  3476. :p.
  3477. Here is the text for the primary window.  This is a
  3478. :link reftype=hd res=004.
  3479. hypertext link
  3480. :elink.
  3481. to the secondary window.
  3482. :h2 res=004
  3483.     x=right y=bottom
  3484.     width=50% height=100%.
  3485. Secondary Window
  3486. :p.
  3487. Here is the text for the secondary window.  This is a
  3488. :link reftype=hd res=003.
  3489. hypertext link
  3490. :elink.
  3491. to the primary window.
  3492.  
  3493. The origin of the first window is the lower left-hand corner of the coverpage 
  3494. window.  It occupies 50% of the width, but 100% of the height of the coverpage 
  3495. window on the left-hand side. 
  3496.  
  3497. The origin of the second window is the lower right-hand corner of the coverpage 
  3498. window.  It occupies 50% of the width, but 100% of the height of the coverpage 
  3499. window on the right-hand side. 
  3500.  
  3501.  Although these two windows occupy adjacent positions on the screen, you cannot 
  3502. display them both at the same time. To define separate windows, you must 
  3503. specify a group number in the heading definition. 
  3504.  
  3505.  
  3506. ΓòÉΓòÉΓòÉ 6.2.3. Displaying Multiple Windows ΓòÉΓòÉΓòÉ
  3507.  
  3508. To display more than one window on the screen, you must assign a unique group 
  3509. number to each window with the group= attribute. This attribute can be 
  3510. specified with :link. or the heading tag. 
  3511.  
  3512. If you do not specify a group number, a value of 0 is assigned. (This is the 
  3513. default value and is reserved for use by IPF.) If another window is already 
  3514. opened with the number specified for group=, IPF swaps its image (places the 
  3515. image in the same window) for the one defined by the heading or link tag. 
  3516.  
  3517. Note:  If a group number is assigned in both a heading and a hypertext or an 
  3518.        automatic link, the link group number overrides the heading group 
  3519.        number. The numbers you can assign to group= are integers from 1 to 
  3520.        64 000. 
  3521.  
  3522.  Compare the three heading definitions in the following figure. Notice that: 
  3523.  
  3524.      The first and second windows have different group numbers and different 
  3525.       positions. 
  3526.      The second and third windows have the same group number. 
  3527.      The second and third windows have the same size and position. 
  3528.  Source File for Window Group Number 
  3529.  
  3530.   :h1 res=005
  3531.       x=left y=bottom
  3532.       width=50% height=100%
  3533.       group=1.
  3534.   My First Window
  3535.   :p.
  3536.   Here is the text for the first window.
  3537.   This is a
  3538.   :link reftype=hd res=006.
  3539.   hypertext link
  3540.   :elink.
  3541.   to the second window.
  3542.   :p.
  3543.   This is a
  3544.   :link reftype=hd res=007.
  3545.   hypertext link
  3546.   :elink.
  3547.   to the third window.
  3548.   :h1 res=006
  3549.       x=right y=top
  3550.       width=50% height=100%
  3551.       group=2.
  3552.   My Second Window
  3553.   :p.
  3554.   Here is the text for the second window.
  3555.   This is a
  3556.   :link reftype=hd res=005.
  3557.   hypertext link
  3558.   :elink.
  3559.   to the first window.
  3560.   :p.
  3561.   This is a
  3562.   :link reftype=hd res=007.
  3563.   hypertext link
  3564.   :elink.
  3565.   to the third window.
  3566.   :h1 res=007
  3567.       x=right y=top
  3568.       width=50% height=100%
  3569.       group=2.
  3570.   My Third Window
  3571.   :p.
  3572.   Here is the text for the third window.
  3573.   This is a
  3574.   :link reftype=hd res=005.
  3575.   hypertext link
  3576.   :elink.
  3577.   to the first window.
  3578.   :p.
  3579.   This is a
  3580.   :link reftype=hd res=006.
  3581.   hypertext link
  3582.   :elink.
  3583.   to the second window.
  3584.  
  3585.  Now assume that the source file shown in the previous figure is compiled, and 
  3586.  the user selects "My First Window" from the Contents window. The window in the 
  3587.  following figure displays. 
  3588.  
  3589.  Multiple windows display with different group numbers. 
  3590.  
  3591.  If the user selects the hypertext link in this window, "My Second Window" will 
  3592.  appear, as shown in the following figure. 
  3593.  
  3594.  Multiple windows display with same group numbers. 
  3595.  
  3596.  The windows appear next to each other because their heading definitions 
  3597.  specify different group numbers.  If the user now selects the hypertext link 
  3598.  in "My Second Window," the resulting screen will be as shown in the following 
  3599.  figure. 
  3600.  
  3601.  Compiled Output of Third Window from Group Number. "My Third Window" replaced 
  3602.  "My Second Window" because it has the same group number as "My Second Window." 
  3603.  
  3604.  
  3605. ΓòÉΓòÉΓòÉ 6.2.3.1. Preventing Image Swapping in Windows ΓòÉΓòÉΓòÉ
  3606.  
  3607. The group= attribute opens a new window only if no other window with the same 
  3608. group number is already displayed.  When a window is opened and a user selects 
  3609. another window with the same group number, IPF swaps its image in the already 
  3610. opened window. To prevent this, use the viewport attribute; it always opens a 
  3611. window. 
  3612.  
  3613. Suppose you have defined the following hypertext link to a window: 
  3614.  
  3615. :link reftype=hd res=001.
  3616.       vpx=25% vpy=bottom
  3617.       vpcx=75% vpcy=100%
  3618.       viewport group=2.
  3619. Guidance
  3620. :elink.
  3621.  
  3622. When this window is displayed, if the user selects the same hypertext link, the 
  3623. same window will open. You cannot control how many times the user will select a 
  3624. hypertext link. If you do not want another window opened each time the user 
  3625. selects the same hypertext link, use the group= attribute instead of the 
  3626. viewport attribute.  This eliminates the potential for the user to open 
  3627. multiple windows containing the same information. 
  3628.  
  3629.  
  3630. ΓòÉΓòÉΓòÉ 6.2.4. Linking to a Window Automatically ΓòÉΓòÉΓòÉ
  3631.  
  3632. As we have seen, one way to display a secondary window is to enable the user to 
  3633. select a hypertext link from one window to another. Another way is to link the 
  3634. user to the secondary window automatically. For example, in the following 
  3635. figure the window on the right is displayed automatically when the user selects 
  3636. the window on the left (perhaps from the Contents window). 
  3637.  
  3638. Example of a window displayed automatically. The window on the right was 
  3639. displayed automatically. 
  3640.  
  3641.  
  3642. ΓòÉΓòÉΓòÉ 6.2.4.1. Auto Attribute ΓòÉΓòÉΓòÉ
  3643.  
  3644. A window that starts the concurrent display of one or more other windows by 
  3645. automatic or hypertext links is referred to as the owner of the window chain. 
  3646. The auto attribute and the reftype=hd attribute indicate that a window is to be 
  3647. opened automatically whenever the owner window is opened. The group= attribute 
  3648. specifies the number of the window. (For more information about group numbers, 
  3649. see Displaying Multiple Windows.) 
  3650.  
  3651. The vpx, vpy, vpcx, and vpcy attributes indicate the size and position of the 
  3652. window in relation to its coverpage window. 
  3653.  
  3654. Caution: 
  3655.  
  3656. When defining automatic links, you do not want to create an "infinite loop" by 
  3657. linking to the same window or group number more than once in a chain of links. 
  3658.  
  3659. For example, suppose you create three windows, A, B, and C, that contain the 
  3660. following automatic links. 
  3661.  
  3662.    ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3663.    Γöé Window A     Γöé   Γöé Window B     Γöé   Γöé  Window C    Γöé
  3664.    Γöé              Γöé   Γöé              Γöé   Γöé              Γöé
  3665.  Γöî>Γöé Link to B    Γö£ΓöÇΓöÇ>Γöé Link to C    Γö£ΓöÇΓöÇ>Γöé  Link to A   Γö£ΓöÇΓöÉ
  3666.  Γöé ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ Γöé
  3667.  ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3668.  
  3669. When the file containing these links is compiled, the IPF compiler does not 
  3670. return an error message because of the loop.  Now suppose Window A is an entry 
  3671. in the Contents window and the user selects it.  Windows A, B, and C open and 
  3672. close uncontrollably until an error occurs and the process is terminated by the 
  3673. system. 
  3674.  
  3675.  
  3676. ΓòÉΓòÉΓòÉ 6.2.5. Closing a Window Automatically ΓòÉΓòÉΓòÉ
  3677.  
  3678. The dependent attribute causes the window to close automatically when the owner 
  3679. window is closed. 
  3680.  
  3681. In the following example, the link at the end of the heading definition defines 
  3682. the owner window on the left.  It links to the window on the right.  Notice the 
  3683. link tag defining the automatic link does not require :elink.. 
  3684.  
  3685. :h1 res=421
  3686.        x=left y=bottom
  3687.         width=25% height=100%
  3688.        group=1.
  3689. Developing Online Information
  3690. :link reftype=hd res=422
  3691.       vpx=right vpy=bottom
  3692.       vpcx=75% vpcy=100%
  3693.       auto dependent group=2.
  3694. .
  3695. .
  3696. .
  3697. :h1 res=422.Developing Online Information
  3698.  
  3699.  
  3700. ΓòÉΓòÉΓòÉ 6.2.6. Tagging Example for Automatic Windows ΓòÉΓòÉΓòÉ
  3701.  
  3702. The following tagging example defines two automatic window chains.  A window 
  3703. chain has at least one owner window, and an owner window has one or more 
  3704. automatic or hypertext links to other windows in the chain. When an owner 
  3705. window closes, the windows in its chain that have specified the dependent 
  3706. attribute also close. 
  3707.  
  3708. In "Example 1," the only owner window in the chain is the first window 
  3709. (res=008).  It contains links to three other automatic windows, which are 
  3710. referred to as sibling windows of the owner window. 
  3711.  
  3712. In "Example 2," Windows 1 through 3 in the chain are owner windows.  Window 1 
  3713. owns all the windows in the chain and can close all of them.  Window 2 also 
  3714. owns Windows 3 and 4.  Window 3 also owns Window 4, the last window in the 
  3715. chain, which is displayed by means of a hypertext link in the text. 
  3716.  
  3717. :h1.Automatic Windows
  3718. :h2 res=008
  3719.     x=left y=top width=25% height=100%
  3720.     scroll=none group=1 clear.
  3721. Example 1
  3722. :link reftype=hd res=009
  3723.       vpx=25% vpy=top vpcx=25% vpcy=100%
  3724.       group=2 auto dependent.
  3725. :link reftype=hd res=010
  3726.       vpx=50% vpy=top vpcx=25% vpcy=100%
  3727.       group=3 auto dependent.
  3728. :link reftype=hd res=011
  3729.       vpx=75% vpy=top vpcx=25% vpcy=100%
  3730.       group=4 auto dependent.
  3731. :p.
  3732. This is Window 1.
  3733. :p.
  3734. This window has three automatic links to
  3735. Windows 2, 3, and 4.
  3736. :h2 res=009
  3737.     x=25% y=top width=25% height=100%
  3738.     scroll=none hide.
  3739. Window 2
  3740. :p.
  3741. This is Window 2.
  3742. :h2 res=010
  3743.     x=50% y=top width=25% height=100%
  3744.     scroll=none hide.
  3745. Window 3
  3746. :p.
  3747. This is Window 3.
  3748. :h2 res=011
  3749.     x=75% y=top width=25% height=100%
  3750.     scroll=none hide.
  3751. Window 4
  3752. :p.
  3753. This is Window 4.
  3754.  
  3755. :h2 res=012
  3756.     x=left y=top width=25% height=100%
  3757.     scroll=none group=1 clear.
  3758. Example 2
  3759. :link reftype=hd res=013
  3760.       vpx=25% vpy=top vpcx=25% vpcy=100%
  3761.       group=2 auto dependent.
  3762. :p.
  3763. This is Window 1.
  3764. :p.
  3765. This window has an automatic link to
  3766. Window 2.
  3767. :h1 res=013
  3768.     x=25% y=top width=25% height=100%
  3769.     scroll=none hide.
  3770. Window 2
  3771. :link reftype=hd res=014
  3772.       vpx=50% vpy=top vpcx=25% vpcy=100%
  3773.       group=3 auto dependent.
  3774. :p.
  3775. This is Window 2.
  3776. :p.
  3777. This window has an automatic link to
  3778. Window 3.
  3779. :h1 res=014
  3780.     x=50% y=top width=25% height=100%
  3781.     scroll=none hide.
  3782. Window 3
  3783. :p.
  3784. This is Window 3.
  3785. :p.
  3786. This paragraph contains a
  3787. :link reftype=hd res=015
  3788.       vpx=75% vpy=top vpcx=25% vpcy=100%
  3789.       group=4 dependent.
  3790. hypertext link
  3791. :elink.
  3792. to Window 4.
  3793. :h1 res=015
  3794.     x=75% y=top width=25% height=100%
  3795.     scroll=none hide.
  3796. Window 4
  3797. :p.
  3798. This is Window 4.
  3799.  
  3800. Example of four automatic windows. 
  3801.  
  3802. When "Example 1" is selected from the Contents window, four windows are 
  3803. displayed in rapid succession.  When Window 1 is closed, all four windows 
  3804. close. 
  3805.  
  3806. The following figure shows the windows that are displayed when "Example 2" is 
  3807. selected from the Contents window. 
  3808.  
  3809. Example of three automatic windows. 
  3810.  
  3811. Notice Window 4 is not displayed. To display Window 4, you must select the 
  3812. hypertext link in Window 3. 
  3813.  
  3814. Note:  You can use the viewport attribute on an automatic link, because an 
  3815.        automatic link is made only once. 
  3816.  
  3817.  
  3818. ΓòÉΓòÉΓòÉ 6.3. Split Windows ΓòÉΓòÉΓòÉ
  3819.  
  3820. A group of windows can be given the semblance of one window and yet offer the 
  3821. advantage of different windows; for example, text can be displayed next to an 
  3822. object the text describes. The author creates this effect by defining a window 
  3823. that consists of: 
  3824.  
  3825.      :h1. or :h2. primary-window heading tags, followed by automatic links to 
  3826.       secondary windows.  (Text is not allowed.) 
  3827.      :h2. secondary-window heading tags, each followed by text. 
  3828.  
  3829.  The primary window and its secondary windows must reside in the same file. 
  3830.  
  3831.  The position and size of the primary window determines the boundaries for its 
  3832.  secondary windows. If the position and size of a secondary window are defined 
  3833.  in absolute values that exceed the perimeter of the primary window, the 
  3834.  secondary window is clipped.  (When a window is clipped, part of it lies 
  3835.  outside the window boundary and cannot be viewed.) 
  3836.  
  3837.  Sizes of secondary windows can be defined as percentages of the primary-window 
  3838.  size. The minimum size of a secondary window (expressed in percentages) is 
  3839.  zero height by zero width.  Negative values for origin and position are not 
  3840.  allowed. 
  3841.  
  3842.  
  3843. ΓòÉΓòÉΓòÉ 6.3.1. Defining Split Windows ΓòÉΓòÉΓòÉ
  3844.  
  3845. The primary window cannot have any text or graphics, only automatic links to 
  3846. each of its secondary windows.  Each automatic link to a secondary window 
  3847. requires the auto and split attributes.  The following is an example of the 
  3848. tagging for a primary window that contains a split window: 
  3849.  
  3850. :h1 res=001 scroll=none.Primary Window A
  3851. :link reftype=hd res=002 auto split group=10
  3852.       vpx=left vpy=top vpcx=50% vpcy=100%
  3853.       scroll=none titlebar=none.
  3854. :link reftype=hd res=003 auto split group=11
  3855.       vpx=right vpy=top vpcx=50% vpcy=100%
  3856.       scroll=vertical titlebar=none.
  3857.  
  3858. The primary window does not have text and does not need a scroll bar; thus, the 
  3859. heading tag attribute is scroll=none. The primary window can define an overall 
  3860. title bar and disable the title bars in the secondary windows. 
  3861.  
  3862. Caution: 
  3863.  
  3864. When defining split windows, do not link to a footnote from a secondary window. 
  3865.  
  3866. For example, the text of a secondary window cannot have a link such as the 
  3867. following: 
  3868.  
  3869. :link reftype=fn
  3870.       refid=001.
  3871. Display Pop-Up Window
  3872. :elink.
  3873.  
  3874.  
  3875. ΓòÉΓòÉΓòÉ 6.3.2. Tagging Example for Split Windows ΓòÉΓòÉΓòÉ
  3876.  
  3877. The following tagging examples show the tagging for two different split-window 
  3878. arrangements. 
  3879.  
  3880. In the first example, "Primary Window A" (res=016) has automatic links to two 
  3881. secondary windows, (res=017 and res=018).  The tagging for res=017 has two list 
  3882. items, each of which is a hypertext link.  The first list item, "Ducks," links 
  3883. to res=018; the second item, "World," links to res=019. 
  3884.  
  3885. The tagging for both res=018 and res=019 refer to bit-map files. 
  3886.  
  3887. Notice that in "Primary Window A" the link tags for the secondary windows 
  3888. specify titlebar=none, but the heading tags for the secondary windows specify 
  3889. "Dummy" as title text.  You must always provide IPF with a title string in a 
  3890. heading tag, even when you specify that the window will not have a title bar 
  3891. and will not have an entry in the Contents window because you have specified 
  3892. the hide attribute. The link tags for a hypertext link to a secondary window 
  3893. must specify the split attribute. If the split attribute is omitted, the window 
  3894. will not behave as a secondary window; that is, it will not close when the 
  3895. primary window is closed, and instead of moving when the primary window is 
  3896. moved, it will become obscured. 
  3897.  
  3898.  
  3899. ΓòÉΓòÉΓòÉ 6.3.2.1. Hide, Noprint, and Nosearch Attributes ΓòÉΓòÉΓòÉ
  3900.  
  3901. In the examples, each secondary window heading has the hide, noprint, and 
  3902. nosearch attributes.  The hide attribute prevents an entry from appearing in 
  3903. the Contents window.  You do not want a secondary window (in a split-window 
  3904. arrangement) to be displayed by itself; you want it displayed only when the 
  3905. Contents entry for its primary window is selected. 
  3906.  
  3907. The nosearch attribute prevents the title string of the secondary window from 
  3908. being listed as an entry in the Search Results window. The Search option of IPF 
  3909. also searches the secondary window (for a word or phrase) because of the link 
  3910. definition in the primary window; however, only the title string of the primary 
  3911. window is returned in the Search Results window. 
  3912.  
  3913. The Print option of IPF enables the user to print one or more topics, the 
  3914. index, or the table of contents. The noprint attribute in a primary-window 
  3915. heading prevents the contents of a secondary window from being printed. 
  3916. Secondary windows are printed as part of their primary window. The contents of 
  3917. secondary windows are printed only in the order in which the link definitions 
  3918. appear in the primary-window definition. 
  3919.  
  3920. None of the primary-window heading tags specifies a group number with the 
  3921. group= attribute, so IPF assigns 0 (the default) as the group number of each. 
  3922. The clear attribute causes the screen to be cleared of windows before each 
  3923. split window is displayed. 
  3924.  
  3925. :h1 res=016 scroll=none clear.
  3926. Primary Window A
  3927. :link reftype=hd res=017 auto split group=10
  3928.       vpx=left vpy=top vpcx=50% vpcy=100%
  3929.       rules=border scroll=none titlebar=none.
  3930. :link reftype=hd res=018 auto split group=11
  3931.       vpx=right vpy=top vpcx=50% vpcy=100%
  3932.       rules=border scroll=none titlebar=none.
  3933. :h2 res=017 hide nosearch noprint.Dummy
  3934. :p.
  3935. This secondary window contains hypertext links
  3936. to the adjacent secondary window.
  3937. :p.
  3938. Select one:
  3939. :sl compact.
  3940. :li.:link reftype=hd res=018 split group=11
  3941.           vpx=right vpy=top vpcx=50% vpcy=100%
  3942.           rules=border scroll=none titlebar=none.
  3943. Ducks
  3944. :elink.
  3945. :li.:link reftype=hd res=019 split group=11
  3946.           vpx=right vpy=top vpcx=50% vpcy=100%
  3947.           rules=border scroll=none titlebar=none.
  3948. World
  3949. :elink.
  3950. :esl.
  3951. :h2 res=018 hide nosearch noprint.Dummy
  3952. :artwork name='ducks.bmp' fit.
  3953. :h2 res=019 hide nosearch noprint.Dummy
  3954. :p.
  3955. :artwork name='world.bmp' fit.
  3956.  
  3957. Here are both views of the compiled version of Primary Window A. 
  3958.  
  3959. Example of a split window with an automatic link. The window on the right is 
  3960. displayed automatically when "Primary Window A" is selected from the Contents 
  3961. window. 
  3962.  
  3963. Example of a split window with hypertext link. The window on the right is 
  3964. displayed when the second hypertext link is selected. 
  3965.  
  3966. :h1 res=022 scroll=none titlebar=none rules=none clear.
  3967. Primary Window B
  3968. :link reftype=hd res=023 auto split group=10
  3969.       vpx=left vpy=top vpcx=40% vpcy=100%
  3970.       scroll=none titlebar=none rules=none.
  3971. :link reftype=hd res=024 auto split group=11
  3972.       vpx=right vpy=top vpcx=60% vpcy=20%
  3973.       scroll=none titlebar=none rules=none.
  3974. :link reftype=hd res=025 auto split group=12
  3975.       vpx=right vpy=bottom vpcx=60% vpcy=80%
  3976.       scroll=none titlebar=none rules=none.
  3977. :h2 res=023 hide nosearch noprint.Dummy
  3978. :lm margin=5.
  3979. :rm margin=2.
  3980. :p.
  3981. :font facename='Tms Rmn' size=24x12.
  3982. :color bc=green.:hp2.TREES LOVE IPF:ehp2.
  3983. :color bc=cyan.:hp3.TREES LOVE IPF:ehp3.
  3984. :color bc=green.:hp4.TREES LOVE IPF:ehp4.
  3985. :color bc=cyan.:hp5.TREES LOVE IPF:ehp5.
  3986. :color bc=green.:hp6.TREES LOVE IPF:ehp6.
  3987. :color bc=cyan.:hp7.TREES LOVE IPF:ehp7.
  3988. :color bc=green.:hp4.TREES LOVE IPF:ehp4.
  3989. :color bc=cyan.:hp3.TREES LOVE IPF:ehp3.
  3990. :color bc=green.:hp2.TREES LOVE IPF:ehp2.
  3991. :h2 res=024 hide nosearch noprint.Dummy
  3992. :p.
  3993. :h2 res=025 hide rules=none nosearch noprint.Dummy
  3994. :rm margin=3.
  3995. :font facename='Helv' size=18x9.
  3996. :p.
  3997. The Information Presentation Facility (IPF) is a set of tools
  3998. that supports the design and development of an online help
  3999. facility that is accessed by users of your application.
  4000. :p.
  4001. IPF also supports the design and development of online
  4002. information that may be viewed independently of an application.
  4003. These files are compiled with the /INF parameter of the IPF
  4004. compiler, and they are viewed by entering the name of
  4005. the compiled file as a parameter of the VIEW program.
  4006.  
  4007. Here is the compiled version of Primary Window B. 
  4008.  
  4009. Example of a split window without window controls. You cannot see the 
  4010. boundaries of the three windows because the window controls were eliminated. 
  4011.  
  4012.  
  4013. ΓòÉΓòÉΓòÉ 6.3.2.2. Push Buttons for Split Windows ΓòÉΓòÉΓòÉ
  4014.  
  4015. Be careful when using heading tags to define a control area for split windows. 
  4016. A control area cannot be defined in the secondary window heading tag of a split 
  4017. window. You must define the control area (the coverpage window) in the primary 
  4018. window heading tag.  In the previous examples of split windows, the push button 
  4019. feature of IPF was disabled (see Disabling the Display of Push Buttons). 
  4020.  
  4021.  
  4022. ΓòÉΓòÉΓòÉ 6.4. Summary Tables of Attribute Values for Origin and Size ΓòÉΓòÉΓòÉ
  4023.  
  4024. The following tables summarize the attribute values that define a window's 
  4025. origin and size. Values shown in uppercase are keywords (words with special 
  4026. significance to IPF).  Values shown in lowercase italics are to be substituted 
  4027. with your own values.  Values are stacked when more than one value can be used 
  4028. with the attribute. 
  4029.  
  4030. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4031. ΓöéAttribute=Value     ΓöéDescription                             Γöé
  4032. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4033. ΓöéX=CENTER            ΓöéSpecifies the location of the x-axis.   Γöé
  4034. Γöé  LEFT              ΓöéThe x-axis runs horizontally from left  Γöé
  4035. Γöé  RIGHT             Γöéto right.                               Γöé
  4036. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4037. ΓöéY=CENTER            ΓöéSpecifies the location of the y-axis.   Γöé
  4038. Γöé  TOP               ΓöéThe y-axis runs vertically from bottom  Γöé
  4039. Γöé  BOTTOM            Γöéto top.                                 Γöé
  4040. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4041. ΓöéWIDTH=an integer    ΓöéSpecifies the width (horizontal space)  Γöé
  4042. Γöéfollowed by the     Γöéof a window.                            Γöé
  4043. Γöépercent sign (%)    Γöé                                        Γöé
  4044. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4045. ΓöéHEIGHT=an integer   ΓöéSpecifies the height (vertical space) ofΓöé
  4046. Γöéfollowed by the     Γöéa window.                               Γöé
  4047. Γöépercent sign (%)    Γöé                                        Γöé
  4048. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4049.  
  4050. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4051. ΓöéAttribute=Value     ΓöéDescription                             Γöé
  4052. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4053. ΓöéVPX=CENTER          ΓöéSpecifies the location of the x-axis.   Γöé
  4054. Γöé  LEFT              ΓöéThe x-axis runs horizontally from left  Γöé
  4055. Γöé  RIGHT             Γöéto right. Overrides the x-axis attributeΓöé
  4056. Γöé                    Γöévalue specified by the heading tag.     Γöé
  4057. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4058. ΓöéVPY=CENTER          ΓöéSpecifies the location of the y-axis.   Γöé
  4059. Γöé  TOP               ΓöéThe y-axis runs vertically from bottom  Γöé
  4060. Γöé  BOTTOM            Γöéto top. Overrides the y-axis attribute  Γöé
  4061. Γöé                    Γöévalue specified by the heading tag.     Γöé
  4062. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4063. ΓöéVPCX=an integer     ΓöéSpecifies the width (horizontal space)  Γöé
  4064. Γöéfollowed by the     Γöéof a window. Overrides the width        Γöé
  4065. Γöépercent sign (%)    Γöéattribute value specified by the headingΓöé
  4066. Γöé                    Γöétag.                                    Γöé
  4067. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4068. ΓöéVPCY=an integer     ΓöéSpecifies the height (vertical space) ofΓöé
  4069. Γöéfollowed by the     Γöéa window. Overrides the height attributeΓöé
  4070. Γöépercent sign (%)    Γöévalue specified by the heading tag.     Γöé
  4071. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4072.  
  4073. Point to Remember  Origin and size attributes in a link tag override the origin 
  4074. and size attributes in a heading tag. 
  4075.  
  4076.  
  4077. ΓòÉΓòÉΓòÉ 6.5. Summary Table for Heading Attributes ΓòÉΓòÉΓòÉ
  4078.  
  4079. This table summarizes the heading attributes that support a multiple-window 
  4080. format. 
  4081.  
  4082. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4083. ΓöéAttribute=Value     ΓöéFunction                                Γöé
  4084. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4085. Γöéres=                ΓöéDefine references to internal and       Γöé
  4086. Γöéid=                 Γöéexternal sources.                       Γöé
  4087. Γöéname=               Γöé                                        Γöé
  4088. Γöéglobal              Γöé                                        Γöé
  4089. Γöétutorial            Γöé                                        Γöé
  4090. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4091. Γöéx=                  ΓöéDefine the origin and size of a window  Γöé
  4092. Γöéy=                  Γöéin relation to its coverpage or primary Γöé
  4093. Γöéwidth=              Γöéwindow.                                 Γöé
  4094. Γöéheight=             Γöé                                        Γöé
  4095. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4096. Γöétitlebar=           ΓöéDefine the control the user has over theΓöé
  4097. Γöéscroll=             Γöéwindow.                                 Γöé
  4098. Γöérules=              Γöé                                        Γöé
  4099. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4100. Γöéviewport            ΓöéManage the display of information in    Γöé
  4101. Γöégroup=              Γöémultiple windows.                       Γöé
  4102. Γöéclear               Γöé                                        Γöé
  4103. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4104. Γöéhide                ΓöéRestrict user retrieval of information. Γöé
  4105. Γöénosearch            Γöé                                        Γöé
  4106. Γöénoprint             Γöé                                        Γöé
  4107. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4108. Γöétoc=                ΓöéChange heading levels appearing in the  Γöé
  4109. Γöé                    ΓöéContents window.                        Γöé
  4110. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4111.  
  4112.  
  4113. ΓòÉΓòÉΓòÉ 6.6. Summary Table for Link Attributes ΓòÉΓòÉΓòÉ
  4114.  
  4115. This table summarizes the link attributes that support a multiple-window 
  4116. format. 
  4117.  
  4118. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4119. ΓöéAttribute=Value     ΓöéFunction                                Γöé
  4120. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4121. Γöéreftype=            ΓöéDefine references to internal and       Γöé
  4122. Γöéres=                Γöéexternal sources.                       Γöé
  4123. Γöérefid=              Γöé                                        Γöé
  4124. Γöédatabase=           Γöé                                        Γöé
  4125. Γöéobject=             Γöé                                        Γöé
  4126. Γöédata=               Γöé                                        Γöé
  4127. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4128. Γöévpx=                ΓöéDefine the origin and size of a window  Γöé
  4129. Γöévpy=                Γöéin relation to its coverpage or primary Γöé
  4130. Γöévpcx=               Γöéwindow.                                 Γöé
  4131. Γöévpcy=               Γöé                                        Γöé
  4132. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4133. Γöétitlebar=           ΓöéDefine the control the user has over theΓöé
  4134. Γöéscroll=             Γöéwindow.                                 Γöé
  4135. Γöérules=              Γöé                                        Γöé
  4136. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4137. Γöéviewport            ΓöéManage the display of information in    Γöé
  4138. Γöégroup=              Γöémultiple windows.                       Γöé
  4139. Γöédependent           Γöé                                        Γöé
  4140. Γöéauto                Γöé                                        Γöé
  4141. Γöésplit               Γöé                                        Γöé
  4142. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4143.  
  4144. Points to Remember  Link-tag attributes that have the same functions as those 
  4145. specified in a heading tag will override the heading-tag attributes. Although 
  4146. link-tag attributes have different names for x- and y-coordinates and window 
  4147. width and height, they provide the same functions. 
  4148.  
  4149.  
  4150. ΓòÉΓòÉΓòÉ 7. Compiling Source Files ΓòÉΓòÉΓòÉ
  4151.  
  4152. This chapter explains how to prepare your source files so that they will be 
  4153. recognized by the IPF compiler. This chapter also shows you how to enter the 
  4154. compile command, how to interpret error messages, and how to view the compiled 
  4155. document.  A section on national language support (NLS) is also provided. 
  4156.  
  4157.  
  4158. ΓòÉΓòÉΓòÉ 7.1. Source File Requirements ΓòÉΓòÉΓòÉ
  4159.  
  4160. Using a single source file, you can produce a successful display of information 
  4161. with a limited number of tags.  These tags are: 
  4162.  
  4163.             :userdoc.
  4164.  
  4165.             :docprof.
  4166.  
  4167.             :title.
  4168.  
  4169.             :h1.
  4170.  
  4171.             :p.
  4172.  
  4173.             :euserdoc.
  4174.  
  4175.  The :userdoc. tag is always the first item in your source file.  It identifies 
  4176.  the beginning of an IPF file. This tag is a signal to the IPF compiler to 
  4177.  begin translating the tag language. 
  4178.  
  4179.  The :euserdoc. tag is required as the last line of the file to signal the end 
  4180.  of the tagged document. 
  4181.  
  4182.  Place the :docprof. tag at the beginning of your source file after the 
  4183.  :userdoc. tag and before any heading definitions.  Use the function of the toc 
  4184.  (table of contents) attribute of the :docprof. tag to control the heading 
  4185.  levels displayed in the Content window.  For example, if you want only heading 
  4186.  levels 1 and 2 to appear, the tagging is: 
  4187.  
  4188.             :docprof toc=12.
  4189.  
  4190.  If no toc= value is specified, heading level 1 through 3 appear in the 
  4191.  Contents window. 
  4192.  
  4193.  Not to be confused with window titles, the text string specified with a 
  4194.  :title. tag is placed into the title bar of an online document. When the 
  4195.  online document is displayed, the title appears on the title line of the main 
  4196.  window.  The tagging looks like this: 
  4197.  
  4198.             :title.Endangered Mammals
  4199.  
  4200.  The maximum length of a title string specified with a :title. tag is 47 
  4201.  characters, including spaces and blanks. 
  4202.  
  4203.  The title tag provides a name for the online document but is also used for 
  4204.  titles of Help windows.  The title appears in the title bar of the main 
  4205.  window.  You usually place the title tag after the :docprof. tag. 
  4206.  
  4207.  Every file must start with a :h1. tag.  Heading level sequences must not skip 
  4208.  a level in the heading hierarchy.  For example, you cannot have a heading 
  4209.  level 1 tag (:h1.) followed by a heading level 3 tag (:h3.). 
  4210.  
  4211.  You must have at least one paragraph tag (:p.) and associated text to display 
  4212.  a window. 
  4213.  
  4214.  The following figure shows an IPF source file. 
  4215.  
  4216.  The source file contains a :userdoc. tag, a :title. tag, a heading tag with a 
  4217.  window identifier, a :p. tag, and the :euserdoc. tag. 
  4218.  
  4219.   .*
  4220.   :userdoc.
  4221.   :title.Endangered Mammals
  4222.   :h1 res=001.The Manatee
  4223.   .*
  4224.   :p.
  4225.   The Manatee has a broad flat tail and two flipper
  4226.   like forelegs.  There are no back legs.
  4227.   The Manatee's large upper lip is split in two and
  4228.   can be used like fingers to place food into the
  4229.   mouth.  Bristly hair protrudes from its lips,
  4230.   and almost buried in its hide are small eyes, with
  4231.   which it can barely see.
  4232.   .*
  4233.   :euserdoc.
  4234.  
  4235.  Source File Structure 
  4236.  
  4237.  
  4238. ΓòÉΓòÉΓòÉ 7.1.1. Source File Limits ΓòÉΓòÉΓòÉ
  4239.  
  4240.      The maximum size of a line in an IPF source file is 255 characters. 
  4241.  
  4242.      The maximum number of fonts in a source file is 16. 
  4243.  
  4244.      The maximum number of unique words in a compiled file is 64 000. 
  4245.  
  4246.      The maximum number of unique words in a panel is 64 000. 
  4247.  
  4248.      The maximum number of panels is 64 000. 
  4249.  
  4250.      The maximum number of external databases is 255. 
  4251.  
  4252.  These maximum limits are not absolute. Activity in the operating system can 
  4253.  cause them to vary. 
  4254.  
  4255.  
  4256. ΓòÉΓòÉΓòÉ 7.2. Naming Conventions ΓòÉΓòÉΓòÉ
  4257.  
  4258. It is a good idea to give your source files an extension of IPF, so they can be 
  4259. distinguished from your other files. For example: 
  4260.  
  4261.   MYHELP.IPF
  4262.  
  4263. The IPF compiler does not require an IPF file-name extension; however, if your 
  4264. file has an IPF file-name extension, you will not have to type the extension at 
  4265. compile time. 
  4266.  
  4267.  
  4268. ΓòÉΓòÉΓòÉ 7.2.1. Naming Restriction ΓòÉΓòÉΓòÉ
  4269.  
  4270. During the compilation process, IPF creates some files to hold data 
  4271. temporarily, and erases the files when it no longer needs them.  The names of 
  4272. these files are: 
  4273.  
  4274.             filename.clf
  4275.  
  4276.             $0000$ (footnotes)
  4277.  
  4278.             $1111$ (cross references)
  4279.  
  4280.             $2222$ (tables)
  4281.  
  4282.             $3333$ (bit maps)
  4283.  
  4284.  where filename is the name of your source file. Do not give your source file a 
  4285.  CLF extension.  Also, do not give your source file a name of $0000$, $1111$, 
  4286.  $2222$, or $3333$. 
  4287.  
  4288.  Do not use the name of any of the OS/2 environment variables for your file 
  4289.  name.  VIEW checks for an environment variable that matches its first argument 
  4290.  and, if it finds one, such as CPREF, it will take the value of that 
  4291.  environment variable and use the value as the name of the file or files to 
  4292.  open. 
  4293.  
  4294.  
  4295. ΓòÉΓòÉΓòÉ 7.3. Using a Base Source File ΓòÉΓòÉΓòÉ
  4296.  
  4297. The IPF compiler can produce a single output document by processing multiple 
  4298. input files through one base source file. This process is most often associated 
  4299. with online documents.  For example, the online Information Presentation 
  4300. Facility Reference has more than ten separate source files, but all the files 
  4301. were processed through one base file. 
  4302.  
  4303. The .im (imbed) control word sends a signal to the compiler and tells it to 
  4304. process each file in the sequence listed in the base file. 
  4305.  
  4306. A portion of the base file IPFCBASE.IPF for the online Information Presentation 
  4307. Facility Reference looks like this: 
  4308.  
  4309. :userdoc.
  4310. .
  4311. .
  4312. .
  4313. .im ipfcch01.ipf
  4314. .im ipfcch02.ipf
  4315. .im ipfcch03.ipf
  4316. .
  4317. .
  4318. .
  4319.  
  4320. The placement of an imbedded file determines the order of entries in the table 
  4321. of contents. 
  4322.  
  4323. Imbedded files cannot use the :userdoc. or :euserdoc. tags. 
  4324.  
  4325. Note:  When using a base source file to process multiple files, enter the base 
  4326.        file name as the filename parameter of the IPFC command. 
  4327.  
  4328.  
  4329. ΓòÉΓòÉΓòÉ 7.4. Starting the IPF Compiler ΓòÉΓòÉΓòÉ
  4330.  
  4331. You can start the IPF compiler and specify all input from the command line.  A 
  4332. new command-line interface has been introduced. To view it, type IPFC with no 
  4333. parameters. 
  4334. The syntax is: 
  4335.  
  4336. Usage: 
  4337.  
  4338. IPFC [-switch]┬╖┬╖┬╖  [-option]┬╖┬╖┬╖ filename [outfile]
  4339.  
  4340. The switches perform the functions in the following list: 
  4341.  
  4342.  Switches: i - Compiles the source file as an online document 
  4343.  
  4344.            s - Suppresses the performance of the search function 
  4345.  
  4346.            x - Generates and displays a cross-reference list 
  4347.  
  4348.  The options perform the functions in the following list: 
  4349.  
  4350.  Options:  W:level - Warning level 
  4351.  
  4352.            D:dbcscode - Country code 
  4353.  
  4354.            C:codepage - Character code page 
  4355.  
  4356.            L:language - Language ID 
  4357.  
  4358.  The following parameters provide international language support: 
  4359.  
  4360.  -d: nnn     The nnn is the 3-digit country code. 
  4361.  
  4362.  -c: nnnn    The nnnn is the 4-digit code page. 
  4363.  
  4364.  -l: xxx     The xxx is a 3-letter identifier that indicates the language file 
  4365.              to be used. 
  4366.  
  4367.  See Country Code, Code Pages, and Language Parameters for the tables with the 
  4368.  NLS values. 
  4369.  
  4370.  For example: 
  4371.  
  4372.   IPFC myfile.txt /INF -d:033 -c:0437 -l:FRA
  4373.  
  4374.  If you do not specify these parameters, the default for -d: nnn and -c: nnnn 
  4375.  are the values specified in your CONFIG.SYS file. 
  4376.  
  4377.  For help on any of the options, type 
  4378.  
  4379.   IPFC -X:?
  4380.  
  4381.  where "X" is one of the options. 
  4382.  
  4383.  The outfile parameter is used to specify the name of the output file. If this 
  4384.  parameter is not used, the output file will have the same filename as the 
  4385.  input file and an extension of either INF or HLP. For example: 
  4386.  
  4387.   IPFC TEST┬╖IPF C:\FILE┬╖HLP
  4388.  
  4389.  Command Line Interfaces For Previous Versions of the IPF Compiler 
  4390.  The interface from earlier levels of the compiler is still supported. The 
  4391.  syntax is: 
  4392.  
  4393.   IPFC filename [/INF] [/S] [/X] [/W] [> messageoutputfilename] [/COUNTRY] [/CODEPAGE] [/LANGUAGE]
  4394.  
  4395.  where: 
  4396.  
  4397.  filename    Specifies the name of your IPF source file or base file. 
  4398.  
  4399.              If you do not give a file-name extension, the IPF compiler uses 
  4400.              .IPF by default. If your file has a file-name extension other than 
  4401.              IPF, include that file-name extension in the command line. 
  4402.  
  4403.  /INF        Compiles the source file as an online document. 
  4404.  
  4405.              If this parameter is not included, the default is to compile the 
  4406.              source file as a help library, whose extension is .HLP. 
  4407.  
  4408.  /S          Suppresses the performance of the Search function.  This parameter 
  4409.              increases compression of compiled data by about 10% to further 
  4410.              reduce the storage it requires. 
  4411.  
  4412.  /X          Generates and displays a cross-reference list. 
  4413.  
  4414.  /Wn         Generates and displays a list of error messages.  The n indicates 
  4415.              the level of error messages you want to receive.  Values you can 
  4416.              specify for n are 1, 2, or 3.  The default is W3. For more 
  4417.              information, see Interpreting IPFC Error Messages. 
  4418.  
  4419.  messageoutputfilename Specifies the name of the file where error and cross 
  4420.              reference messages are sent. If you do not specify this parameter, 
  4421.              messages generated by /X and /Wn are sent to the display screen. 
  4422.  
  4423.  The following parameters provide international language support (NLS): 
  4424.  
  4425.  /COUNTRY=nnn The nnn is the 3-digit country code. 
  4426.  
  4427.  /CODEPAGE=nnnn The nnnn is the 4-digit code page. 
  4428.  
  4429.  /LANGUAGE=xxx The xxx is a 3-letter identifier that indicates the language 
  4430.              file to be used. 
  4431.  
  4432.  See Country Code, Code Pages, and Language Parameters for the tables with the 
  4433.  NLS values. 
  4434.  
  4435.  For example: 
  4436.  
  4437.   IPFC myfile.txt /INF /COUNTRY=033 /CODEPAGE=437 /LANGUAGE=FRA
  4438.  
  4439.  If you do not specify these parameters, the default for /COUNTRY and /CODEPAGE 
  4440.  are the values specified in your CONFIG.SYS file. 
  4441.  
  4442.  
  4443. ΓòÉΓòÉΓòÉ 7.4.1. Compiling Help Files ΓòÉΓòÉΓòÉ
  4444.  
  4445. To compile a source file that is intended as a help-text window, use the IPFC 
  4446. command without the -i switch or /INF option. For example: 
  4447.  
  4448. IPFC myhelp.txt
  4449.  
  4450.  
  4451. ΓòÉΓòÉΓòÉ 7.4.2. Environment Variables ΓòÉΓòÉΓòÉ
  4452.  
  4453. There are four environment variables that can be used to specify the location 
  4454. of source files. The IPFC environment variable is used to specify where the IPF 
  4455. support files (such as the *.NLS files) are stored. The IPFCIMBED environment 
  4456. variable is used to search for files imbedded with the .im macro.  The 
  4457. IPFCARTWORK environment variable is used to specify the location of artwork 
  4458. files and artlink files.  The TMP environment variable is used to indicate 
  4459. where the compiler should store the intermediate files it creates during the 
  4460. compilation. 
  4461.  
  4462. The IPFC environment variable has been enhanced to allow multiple paths. 
  4463.  
  4464. Note:  IPFCARTWORK=artwork and linkfile path (used for :artwork.) 
  4465.        IPFCIMBED=imbed file path (used for .im) 
  4466.        IPFC=IPFC file path (location of APSYxxxx.APS, IPF*.NLS) 
  4467.        TMP=temporary file path 
  4468.  
  4469.  
  4470. ΓòÉΓòÉΓòÉ 7.5. Viewing an Online Document ΓòÉΓòÉΓòÉ
  4471.  
  4472. If you want to see your formatted online document, you can use the VIEW command 
  4473. to display it. 
  4474.  
  4475. An online document has an extension of INF.  It can be viewed by entering its 
  4476. name as a parameter to the VIEW command; for example: 
  4477.  
  4478. VIEW myfile
  4479.  
  4480. You do not need to include the INF file extension. 
  4481.  
  4482. You cannot use VIEW to display help-text windows for application programs. 
  4483.  
  4484.  
  4485. ΓòÉΓòÉΓòÉ 7.6. Where IPFC Files are Stored ΓòÉΓòÉΓòÉ
  4486.  
  4487. When you first install the Toolkit, the following environment variable is 
  4488. placed into the CONFIG.SYS file: 
  4489.  
  4490. IPFC=C:\TOOLKIT\IPFC
  4491.  
  4492. The IPFC environment variable identifies the directory in which data files 
  4493. needed by the IPF compiler are stored. 
  4494.  
  4495. When you first install the system, the following environment variables are 
  4496. placed into the CONFIG.SYS file: 
  4497.  
  4498. The HELP environment variable identifies the location of .HLP libraries. 
  4499.  
  4500. Help=C:\OS2\HELP
  4501.  
  4502. The BOOKSHELF environment variable identifies the location of online documents 
  4503. and is used by VIEW. 
  4504.  
  4505. BOOKSHELF=C:\OS2\BOOK
  4506.  
  4507.  
  4508. ΓòÉΓòÉΓòÉ 7.7. Concatenating .INF Files ΓòÉΓòÉΓòÉ
  4509.  
  4510. Concatenation of .INF files is useful when you have a large amount of 
  4511. information that cannot be compiled as one file that fits on a diskette. If you 
  4512. want to concatenate files, you must use the res= attribute for window 
  4513. identifiers. 
  4514.  
  4515. After you have created your .INF files, use the SET command to set an 
  4516. environment variable equal to a string that consists of the .INF file names, 
  4517. for example: 
  4518.  
  4519. SET PROGREF=PRINTRO.INF+PRCP.INF+PRWIN.INF+PRDATA.INF
  4520.  
  4521. When you specify the environment value as a parameter to the VIEW program, VIEW 
  4522. displays the online information. Headings from the different files are 
  4523. displayed in the contents window in the order the files are concatenated for 
  4524. the environment variable. 
  4525.  
  4526.  
  4527. ΓòÉΓòÉΓòÉ 7.8. Interpreting IPFC Error Messages ΓòÉΓòÉΓòÉ
  4528.  
  4529. The -W:n or /Wn option of the IPFC command determines the levels of error 
  4530. messages that will be displayed. Following are the values that you can specify 
  4531. for n: 
  4532.  
  4533.  Value   Meaning 
  4534.  
  4535.  1       Returns only warning level 1 messages.  Warning level 1 messages are 
  4536.          the most severe. 
  4537.  
  4538.  2       Returns warning level 1 and 2 messages. 
  4539.  
  4540.  3       Returns all three warning levels of messages.  This is the default. 
  4541.          Warning level 3 messages are the least severe. 
  4542.  
  4543.  When IPF compiles your file, it generates and displays the error messages.  If 
  4544.  no errors are found, IPF tells you that compiling has been completed and no 
  4545.  errors were found. 
  4546.  
  4547.  You may prefer to redirect error messages from the screen to an error file. 
  4548.  You could enter the IPFC command like this: 
  4549.  
  4550.   IPFC myhelp -w:3 > myhelp.err
  4551.  
  4552.  If you have also requested that a cross-reference list be created by 
  4553.  specifying the -X switch, it will be included in the MYHELP.ERR file. 
  4554.  
  4555.  For a list of error messages that the IPF compiler returns, see Compiler Error 
  4556.  Messages. 
  4557.  
  4558.  
  4559. ΓòÉΓòÉΓòÉ 7.9. Differences between .HLP and .INF Files ΓòÉΓòÉΓòÉ
  4560.  
  4561. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4562. Γöé                    ΓöéHelp Libraries                ΓöéOnline Documents    Γöé
  4563. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4564. ΓöéIPFC Command Syntax ΓöéIPFC filename                 ΓöéIPFC filename.INF -iΓöé
  4565. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4566. ΓöéCompiled File       Γöé.HLP                          Γöé.INF                Γöé
  4567. ΓöéExtensions          Γöé                              Γöé                    Γöé
  4568. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4569. ΓöéEnvironment         Γöé                              ΓöéBOOKSHELF= defines  Γöé
  4570. ΓöéVariables Used by   Γöé                              Γöéthe location of .INFΓöé
  4571. Γöéthe VIEW Program    Γöé                              Γöéfiles               Γöé
  4572. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4573. ΓöéEnvironment         ΓöéHELP= defines the location of Γöé                    Γöé
  4574. ΓöéVariables Used by   Γöé.HLP libraries.               Γöé                    Γöé
  4575. ΓöéHelp Manager for    Γöé                              Γöé                    Γöé
  4576. ΓöéHelp Windows        Γöé                              Γöé                    Γöé
  4577. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4578. ΓöéCause of Interface  ΓöéAn application user's request ΓöéEntering the file   Γöé
  4579. ΓöéDisplay             Γöéfor help.                     Γöéname as a parameter Γöé
  4580. Γöé                    Γöé                              Γöéto the VIEW utility.Γöé
  4581. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4582. ΓöéInitial Size of MainΓöé35% of screen (default)       Γöé85% of screen       Γöé
  4583. ΓöéWindow              Γöé                              Γöé(default)           Γöé
  4584. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4585. ΓöéInitial Contents of ΓöéResponse to help request      ΓöéContents window     Γöé
  4586. ΓöéMain Window         Γöé                              Γöé(default)           Γöé
  4587. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4588. ΓöéMain Window Title   ΓöéDefined by the programmer in  ΓöéDefined by the      Γöé
  4589. Γöé                    Γöéthe HELPINIT structure.       Γöé:title. tag, which  Γöé
  4590. Γöé                    Γöé                              Γöéis placed on the    Γöé
  4591. Γöé                    Γöé                              Γöéline following the  Γöé
  4592. Γöé                    Γöé                              Γöé:userdoc. tag.      Γöé
  4593. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4594. ΓöéExternal Links (see Γöé.HLP files can link to other  Γöé.INF files can link Γöé
  4595. Γöéglobal attribute of Γöé.HLP files and to .INF files  Γöéonly to other .INF  Γöé
  4596. Γöéheading tag and     Γöéby launching VIEW.            Γöéfiles.              Γöé
  4597. Γöédatabase attribute  Γöé                              Γöé                    Γöé
  4598. Γöéof :link. tag.)     Γöé                              Γöé                    Γöé
  4599. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4600. ΓöéTo View ConcatenatedΓöéSpecify a string of .HLP filesΓöéSet an environment  Γöé
  4601. ΓöéFiles               Γöéin the HELPINIT structure or  Γöévariable equal to a Γöé
  4602. Γöé                    Γöésend the                      Γöéstring of .INF file Γöé
  4603. Γöé                    ΓöéHM_SET_HELP_LIBRARY_NAMES     Γöénames.              Γöé
  4604. Γöé                    Γöémessage.                      Γöé                    Γöé
  4605. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4606.  
  4607. Note:  Defaults may be overridden by objects that are displayed in 
  4608.        application-controlled windows. 
  4609.  
  4610.  
  4611. ΓòÉΓòÉΓòÉ 7.10. National Language Support (NLS) ΓòÉΓòÉΓòÉ
  4612.  
  4613. The following parameters provide national language support (NLS). These 
  4614. parameters were updated between Version 2.1 and 3.0 of OS/2. All of the 
  4615. parameters shown in the following table are supported in the current IPF 
  4616. compiler. 
  4617.  
  4618. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4619. Γöéup to Version 2.1        ΓöéVersion 3.0 and higher                            Γöé
  4620. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4621. Γöé/COUNTRY = nnn           Γöé-d: nnn (nnn = a numeric value)                   Γöé
  4622. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4623. Γöé/CODEPAGE = nnnn         Γöé-c: nnnn (nnnn = a numeric value)                 Γöé
  4624. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4625. Γöé/LANGUAGE = xxx          Γöé-l: xxx (xxx = alphabetic letters)                Γöé
  4626. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4627.  
  4628. If you do not specify these parameters, the default for /COUNTRY or -d: nnn and 
  4629. /CODEPAGE or -c: nnnn are the values specified in your CONFIG.SYS file. 
  4630.  
  4631. Refer to the "Information Presentation Facility" chapter in the OS/2 
  4632. Bidirectional Language Support Developer's Guide and Reference. 
  4633.  
  4634.  
  4635. ΓòÉΓòÉΓòÉ 7.10.1. Country Code, Code Pages, and Language Parameters ΓòÉΓòÉΓòÉ
  4636.  
  4637. The following table lists the 3-digit country code for the /COUNTRY or -d: nnn 
  4638. parameter, the numeric identifiers of code pages, and the APS filename of the 
  4639. IPFC command supported. 
  4640.  
  4641. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4642. ΓöéCountry               ΓöéCountry CodeΓöéCode Pages        ΓöéAPS File          Γöé
  4643. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4644. ΓöéArabic                Γöé785         Γöé0864              ΓöéAPSY0864.APS      Γöé
  4645. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4646. ΓöéAustralia             Γöé061         Γöé0437, 0850        ΓöéAPSYMBOL.APS      Γöé
  4647. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4648. ΓöéBelgium               Γöé032         Γöé0437, 0850        ΓöéAPSYMBOL.APS      Γöé
  4649. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4650. ΓöéBrazil                Γöé055         Γöé0850, 0437        ΓöéAPSYMBOL.APS      Γöé
  4651. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4652. ΓöéCanadian English      Γöé001         Γöé0437, 0850        ΓöéAPSYMBOL.APS      Γöé
  4653. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4654. ΓöéCanadian French       Γöé002         Γöé0863, 0850        ΓöéAPSYMBOL.APS      Γöé
  4655. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4656. ΓöéChinese (Simplified)  Γöé086         Γöé1381              ΓöéAPSY1381.APS      Γöé
  4657. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4658. ΓöéChinese (Traditional) Γöé088         Γöé0950              ΓöéAPSY0950.APS      Γöé
  4659. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4660. ΓöéCzech                 Γöé421         Γöé0852              ΓöéAPSY0852.APS      Γöé
  4661. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4662. ΓöéDenmark               Γöé045         Γöé0865, 0850        ΓöéAPSYMBOL.APS      Γöé
  4663. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4664. ΓöéFinland               Γöé358         Γöé0437, 0850        ΓöéAPSYMBOL.APS      Γöé
  4665. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4666. ΓöéFrance                Γöé033         Γöé0437, 0850        ΓöéAPSYMBOL.APS      Γöé
  4667. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4668. ΓöéGermany               Γöé049         Γöé0437, 0850        ΓöéAPSYMBOL.APS      Γöé
  4669. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4670. ΓöéGreece                Γöé030         Γöé0869              ΓöéAPSY0869.APS      Γöé
  4671. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4672. ΓöéGreece                Γöé030         Γöé0813              ΓöéAPSY0813.APS      Γöé
  4673. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4674. ΓöéHebrew                Γöé972         Γöé0862              ΓöéAPSY0862.APS      Γöé
  4675. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4676. ΓöéHungary               Γöé036         Γöé0852              ΓöéAPSY0852.APS      Γöé
  4677. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4678. ΓöéItaly                 Γöé039         Γöé0437, 0850        ΓöéAPSYMBOL.APS      Γöé
  4679. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4680. ΓöéJapan                 Γöé081         Γöé0932, 0437, 0850  ΓöéAPSY0932.APS      Γöé
  4681. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4682. ΓöéKorea                 Γöé082         Γöé0949, 0934        ΓöéAPSY0949.APS      Γöé
  4683. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4684. ΓöéLatin America         Γöé003         Γöé0437, 0850        ΓöéAPSYMBOL.APS      Γöé
  4685. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4686. ΓöéNetherlands           Γöé031         Γöé0437, 0850        ΓöéAPSYMBOL.APS      Γöé
  4687. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4688. ΓöéNorway                Γöé047         Γöé0865, 0850        ΓöéAPSYMBOL.APS      Γöé
  4689. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4690. ΓöéPoland                Γöé048         Γöé0852              ΓöéAPSY0852.APS      Γöé
  4691. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4692. ΓöéPortugal              Γöé351         Γöé0860, 0850        ΓöéAPSYMBOL.APS      Γöé
  4693. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4694. ΓöéRussia                Γöé007         Γöé0866              ΓöéAPSY0866.APS      Γöé
  4695. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4696. ΓöéSpain                 Γöé034         Γöé0437, 0850        ΓöéAPSYMBOL.APS      Γöé
  4697. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4698. ΓöéSweden                Γöé046         Γöé0437, 0850        ΓöéAPSYMBOL.APS      Γöé
  4699. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4700. ΓöéSwitzerland           Γöé041         Γöé0437, 0850        ΓöéAPSYMBOL.APS      Γöé
  4701. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4702. ΓöéThailand              Γöé066         Γöé0874              ΓöéAPSY0874.APS      Γöé
  4703. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4704. ΓöéTurkey                Γöé090         Γöé0857              ΓöéAPSY0857.APS      Γöé
  4705. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4706. ΓöéUnited Kingdom        Γöé044         Γöé0437, 0850        ΓöéAPSYMBOL.APS      Γöé
  4707. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4708. ΓöéUnited States         Γöé001         Γöé0437, 0850        ΓöéAPSYMBOL.APS      Γöé
  4709. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4710.  
  4711. The following table lists the 3-letter identifier for the /LANGUAGE and -l: xxx 
  4712. parameter of the IPFC command: 
  4713.  
  4714. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4715. ΓöéID        ΓöéLanguage                      ΓöéNLS File                      Γöé
  4716. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4717. ΓöéARA       ΓöéArabic                        ΓöéIPFARA.NLS                    Γöé
  4718. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4719. ΓöéCHT       ΓöéChinese (Traditional)         ΓöéIPFCHT.NLS                    Γöé
  4720. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4721. ΓöéCZE       ΓöéCzech                         ΓöéIPFCZE.NLS                    Γöé
  4722. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4723. ΓöéDAN       ΓöéDanish                        ΓöéIPFDAN.NLS                    Γöé
  4724. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4725. ΓöéDEU       ΓöéGerman                        ΓöéIPFDEU.NLS                    Γöé
  4726. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4727. ΓöéELL       ΓöéGreek 813                     ΓöéIPFELL.NLS                    Γöé
  4728. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4729. ΓöéENG       ΓöéEnglish UP                    ΓöéIPFENG.NLS                    Γöé
  4730. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4731. ΓöéENU       ΓöéEnglish US                    ΓöéIPFENU.NLS                    Γöé
  4732. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4733. ΓöéESP       ΓöéSpanish                       ΓöéIPFESP.NLS                    Γöé
  4734. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4735. ΓöéFIN       ΓöéFinnish                       ΓöéIPFFIN.NLS                    Γöé
  4736. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4737. ΓöéFRA       ΓöéFrench                        ΓöéIPFFRA.NLS                    Γöé
  4738. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4739. ΓöéFRC       ΓöéCanadian French               ΓöéIPFFRC.NLS                    Γöé
  4740. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4741. ΓöéGRK       ΓöéGreek 869                     ΓöéIPFGRK.NLS                    Γöé
  4742. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4743. ΓöéHEB       ΓöéHebrew                        ΓöéIPFHEB.NLS                    Γöé
  4744. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4745. ΓöéHUN       ΓöéHungarian                     ΓöéIPFHUN.NLS                    Γöé
  4746. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4747. ΓöéITA       ΓöéItalian                       ΓöéIPFITA.NLS                    Γöé
  4748. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4749. ΓöéJPN       ΓöéJapanese                      ΓöéIPFJPN.NLS                    Γöé
  4750. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4751. ΓöéKOR       ΓöéKorean                        ΓöéIPFKOR.NLS                    Γöé
  4752. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4753. ΓöéNLD       ΓöéDutch                         ΓöéIPFNLD.NLS                    Γöé
  4754. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4755. ΓöéNOR       ΓöéNorwegian                     ΓöéIPFNOR.NLS                    Γöé
  4756. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4757. ΓöéPOL       ΓöéPolish                        ΓöéIPFPOL.NLS                    Γöé
  4758. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4759. ΓöéPRC       ΓöéChinese (Simplified)          ΓöéIPFPRC.NLS                    Γöé
  4760. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4761. ΓöéPTB       ΓöéBrazilian/Portuguese          ΓöéIPFPTB.NLS                    Γöé
  4762. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4763. ΓöéPTG       ΓöéPortuguese                    ΓöéIPFPTG.NLS                    Γöé
  4764. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4765. ΓöéRUS       ΓöéRussian                       ΓöéIPFRUS.NLS                    Γöé
  4766. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4767. ΓöéSVE       ΓöéSwedish                       ΓöéIPFSVE.NLS                    Γöé
  4768. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4769. ΓöéTHI       ΓöéThai                          ΓöéIPFTHI.NLS                    Γöé
  4770. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4771. ΓöéTRK       ΓöéTurkish                       ΓöéIPFTRK.NLS                    Γöé
  4772. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4773. ΓöéUND       ΓöéUser defined                  ΓöéIPFUND.NLS                    Γöé
  4774. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4775.  
  4776. Note:  If there is an APSYxxxx.APS file that matches the code page you are 
  4777.        using to compile your IPF file (either specified or default), the IPFC 
  4778.        will use that file. Otherwise, it will use APSYMBOL.APS file that is 
  4779.        suitable for code page 437 or 850. 
  4780.  
  4781.  
  4782. ΓòÉΓòÉΓòÉ 7.10.2. Creating New Code Pages ΓòÉΓòÉΓòÉ
  4783.  
  4784. The following information tells you how to create an APSYxxxx.APS file and add 
  4785. it to the IPFC directory which allows you to add support for new code pages 
  4786. that you create. 
  4787.  
  4788.  
  4789. ΓòÉΓòÉΓòÉ 7.10.2.1. Creating the Contents of a Code Page File ΓòÉΓòÉΓòÉ
  4790.  
  4791. You can specify a symbol and associate a character with that symbol in a code 
  4792. page file as follows: 
  4793.  
  4794.    1. In the first column, place a character that you want to substitute with 
  4795.       the symbol; for example, +. 
  4796.  
  4797.    2. Define a symbol with text placed between a character ampersand (&) and a 
  4798.       period (.); for example, &plus.. 
  4799.  
  4800.  Following are some examples for defining symbols: 
  4801.  
  4802.       *&asterisk. 
  4803.       .&period. 
  4804.       +&plus. 
  4805.       ,&comma. 
  4806.       -&dash. 
  4807.  Each line in a file must not contain more than one symbol - enter the next 
  4808.  symbol on a new line. 
  4809.  
  4810.  The symbol character must be in the first column of your file and its 
  4811.  associated symbol must start in the second column. 
  4812.  
  4813.  The text in the symbols you define are case sensitive; for example, :&colon. 
  4814.  and :&Colon. are two different symbols. The symbol defined for :&colon. cannot 
  4815.  be used as :&Colon.. If you attempt to use them as two symbols, the compiler 
  4816.  generates a warning message that a symbol is not found. 
  4817.  
  4818.  
  4819. ΓòÉΓòÉΓòÉ 7.10.2.2. Naming the Code Page File ΓòÉΓòÉΓòÉ
  4820.  
  4821. You name a new code page file APSYxxxx.APS where xxxx is a unique four-digit 
  4822. number. You can also use a four-digit number from the "Code Pages" column in 
  4823. the table "NLS Country, Code Page, and Language Parameters for IPF Compiler" 
  4824. for the country you want to use. You substitute your new code page for that 
  4825. code page. For example, to create a new code page for a language called 
  4826. Pidgeon, an appropriate APS filename could be APSY0222.APS or APSYMBOL.APS. 
  4827.  
  4828. Ensure that your APSYxxxx.APS file is located in the following directory: 
  4829.  
  4830. \TOOLKIT\IPFC
  4831.  
  4832.  
  4833. ΓòÉΓòÉΓòÉ 7.10.3. Creating Files for Adding New Languages ΓòÉΓòÉΓòÉ
  4834.  
  4835. You create an IPFxxx.NLS file when you want to add a new language to the 
  4836. compiler. 
  4837.  
  4838. Note:  Not all languages are supported - only use those that are similar to 
  4839.        those already supported by IPFC. 
  4840.  
  4841.  
  4842. ΓòÉΓòÉΓòÉ 7.10.3.1. Creating the Contents of a Language File ΓòÉΓòÉΓòÉ
  4843.  
  4844. You can specify the following attributes in an IPFxxx.NLS file as follows: 
  4845.  
  4846.  Attribute      Description 
  4847.  
  4848.  REM            Use this attribute to specify comments in an IPFxxx.NLS file. 
  4849.                 To enter multiple comments, specify REM on each new line 
  4850.                 followed by the text of the comment. For example: 
  4851.  
  4852.                                 REM This is a comment.
  4853.                                 REM This is another comment.
  4854.  
  4855.  NOTE           Use this attribute to translate the default text of the :note. 
  4856.                 tag. The text specified between the quotation marks is used 
  4857.                 instead of the default word Note. For example, to replace the 
  4858.                 default of Note: with Nota:, enter the following: 
  4859.  
  4860.                                 NOTE="Nota:"
  4861.  
  4862.  CAUTION        Use this attribute to translate the default text of the 
  4863.                 :caution. tag. The text specified between the quotation marks 
  4864.                 is used instead of the default word CAUTION. For example, to 
  4865.                 replace the default of CAUTION: with ATTENZIONE:, enter the 
  4866.                 following: 
  4867.  
  4868.                                 CAUTION="ATTENZIONE:"
  4869.  
  4870.  WARNING        Use this attribute to translate the default text of the 
  4871.                 :warning. tag. The text specified between the quotation marks 
  4872.                 is used instead of the default word Warning. For example, to 
  4873.                 replace the default of Warning: with Avvertenza:, enter the 
  4874.                 following: 
  4875.  
  4876.                                 WARNING="Avvertenza:"
  4877.  
  4878.  DANGER         Use this attribute to translate the default text of the 
  4879.                 :danger. tag. The text specified between the quotation marks is 
  4880.                 used instead of the default word Danger. For example, to 
  4881.                 replace the default of Danger: with Unsafe:, enter the 
  4882.                 following: 
  4883.  
  4884.                                 DANGER="Unsafe:"
  4885.  
  4886.  OLCHARS="single character or a string" Use this attribute to specify the 
  4887.                 ordered list characters you want to use for secondary list 
  4888.                 entries. For example, to use the US alphabetic characters, 
  4889.                 specify the following: 
  4890.  
  4891.                                 OLCHARS="abcdefghijklmnopqrstuvwxyz"
  4892.  
  4893.                 The result is: 
  4894.  
  4895.                                 1.  Entry one.
  4896.                                     a. Line 1 of the secondary entry
  4897.                                     b. Line 2 of the secondary entry
  4898.                                     .
  4899.                                     .
  4900.                                     .
  4901.  
  4902.                 OLCHARS="abcdefghijklmnopqrstuvwxyz" is the default value. 
  4903.  
  4904.  OLCLOSE1="single character or a string" Use this attribute to specify the 
  4905.                 character displayed after the number associated with each list 
  4906.                 item. For example, to use the character ")" after a number in 
  4907.                 the list entry, specify the following: 
  4908.  
  4909.                                 OLCLOSE1=")"
  4910.  
  4911.                 The result is: 
  4912.  
  4913.                                 1)  Entry one.
  4914.                                     a. Line 1 of the secondary entry
  4915.                                     b. Line 2 of the secondary entry
  4916.                                 2)  Entry two.
  4917.                                     .
  4918.                                     .
  4919.                                     .
  4920.  
  4921.                 OLCLOSE1=. is the default value. 
  4922.  
  4923.  OLCLOSE2="single character or a string" Use this attribute to specify the 
  4924.                 character displayed after the value associated with each 
  4925.                 secondary list item. For example, to use the character "-" 
  4926.                 after a number in the secondary list entry, specify the 
  4927.                 following: 
  4928.  
  4929.                                 OLCLOSE2="-"
  4930.  
  4931.                 The result is: 
  4932.  
  4933.                                 1)  Entry one.
  4934.                                     a- Line 1 of the secondary entry
  4935.                                     b- Line 2 of the secondary entry
  4936.                                 2)  Entry two.
  4937.                                     .
  4938.                                     .
  4939.                                     .
  4940.  
  4941.                 OLCLOSE2=. is the default value. 
  4942.  
  4943.  ULITEMID1="single character or a string" Use this attribute to specify the 
  4944.                 first level entries of an unordered list. For example, to use 
  4945.                 the character "-" for first level entries, specify the 
  4946.                 following: 
  4947.  
  4948.                                 ULITEMID1="-"
  4949.  
  4950.                 The result is: 
  4951.  
  4952.                                 - Line 1 of the first level
  4953.                                 - Line 2 of the first level
  4954.                                   .
  4955.                                   .
  4956.                                   .
  4957.                 ULITEMID1=ΓêÖ (Alt 249 in code page 437) is the default value. 
  4958.  
  4959.  ULITEMID2="single character or a string" Use this attribute to specify the 
  4960.                 secondary level entries of an unordered list. For example, to 
  4961.                 use the character "+" for secondary level entries, specify the 
  4962.                 following: 
  4963.  
  4964.                                 ULITEMID2="+"
  4965.  
  4966.                 The result is: 
  4967.  
  4968.                                 - Line 1 of the first level
  4969.                                     + Line 1 of the second level
  4970.                                     + Line 2 of the second level
  4971.                                 - Line 2 of the first level
  4972.                                   .
  4973.                                   .
  4974.                                   .
  4975.  
  4976.                 ULITEMID2=- is the default value. 
  4977.  
  4978.  ULITEMID3="single character or a string" Use this attribute to specify the 
  4979.                 third level entries of an unordered list. For example, to use 
  4980.                 the character "oo" for third level entries, specify the 
  4981.                 following: 
  4982.  
  4983.                                 ULITEMID3="oo"
  4984.  
  4985.                 The result is: 
  4986.  
  4987.                                 - Line 1 of the first level
  4988.                                     + Line 1 of the second level
  4989.                                        oo Line 1 of third level
  4990.                                        oo Line 2 of third level
  4991.                                   .
  4992.                                   .
  4993.                                   .
  4994.  
  4995.                 ULITEMID3=o is the default value. 
  4996.  
  4997.  GRAMMAR        Use this attribute to indicate the beginning of the grammar 
  4998.                 rules. 
  4999.  
  5000.  WORDS          Use this attribute to specify the set of characters that can 
  5001.                 make up a word. For example, to specify that a word can be made 
  5002.                 of alphanumeric characters, specify: 
  5003.  
  5004.                                 WORDS=0 - 9 + A - Z + a - z
  5005.  
  5006.                 WORDS=0 - 9 + A - Z + a - z is the default value for this 
  5007.                 attribute. 
  5008.  
  5009.  GRAPHCS        Use this attribute to specify the range of graphics characters 
  5010.                 that make up a graphic word. 
  5011.  
  5012.                 GRAPHICS="\x01 - \x1F + \x80 - \xFF" is the default value for 
  5013.                 this attribute. 
  5014.  
  5015.  EGRAMMAR       Use this attribute to indicate the end of the grammar rules. 
  5016.  
  5017.  
  5018. ΓòÉΓòÉΓòÉ 7.10.3.2. Naming the Language File ΓòÉΓòÉΓòÉ
  5019.  
  5020. You name a new language file IPFxxx.NLS where xxx is unique for the language 
  5021. you want to use. Name your new file with xxx as different letters than any of 
  5022. the three-letters used in the "ID" column in the table "The 3-Letter Identifier 
  5023. for the /LANGUAGE and -l: xxx Parameter". For example, to create a new language 
  5024. called Pidgeon, an appropriate NLS filename could be IPFPID.NLS. 
  5025.  
  5026. Ensure that your IPFxxx.NLS file is located in the following directory: 
  5027.  
  5028. \TOOLKIT\IPFC
  5029.  
  5030.  
  5031. ΓòÉΓòÉΓòÉ 8. IPF Tag Reference ΓòÉΓòÉΓòÉ
  5032.  
  5033. This section contains an alphabetic listing of the tags used by the IPF 
  5034. compiler to create online documents and help windows. An IPF tag controls the 
  5035. format of the displayed output. 
  5036.  
  5037. The syntax description of each tag includes the tag name, the element that the 
  5038. tag describes, the attributes of the tag, and the end tag. A tag begins with a 
  5039. colon (:) and ends with a period (.). Most tags have an end tag associated with 
  5040. them. An end tag has the same name as the tag, preceded by the letter "e."  For 
  5041. example, the end tag for the :userdoc. tag is the :euserdoc. tag. 
  5042.  
  5043. A tag can have one or more attributes associated with it. An attribute provides 
  5044. additional control information for the tag. Some attributes are followed by an 
  5045. equal sign and a value. If the value contains blanks or special characters, it 
  5046. must be enclosed in apostrophes or single quotation marks. For example: 
  5047.  
  5048. :font facename='Tms Rmn'.
  5049.  
  5050. Notice that the period that ends the tag follows the attributes specified for 
  5051. the tag. If no attributes are specified, the period immediately follows the tag 
  5052. name. For example, when the :note. tag does not have the text=' ' attribute 
  5053. specified, the period immediately follows the word :note.. 
  5054.  
  5055. Some tags are required to be in a specific order before the file can be 
  5056. compiled by the IPF compiler. The following example shows the minimum tags 
  5057. required to compile a file: 
  5058.  
  5059. :userdoc.
  5060. :h1 id=example1.Tag Example 1
  5061. :p.This is the first tag example.
  5062. :euserdoc.
  5063.  
  5064. This section also describes control words used by the IPF compiler.  Control 
  5065. words start with a period (.). A control word tells the IPF compiler about the 
  5066. statement that it is part of. For example, the imbed (.im) control word tells 
  5067. the IPF Compiler to include the specified file in the source file at this 
  5068. point. 
  5069.  
  5070.  
  5071. ΓòÉΓòÉΓòÉ 8.1. .br  (Break) ΓòÉΓòÉΓòÉ
  5072.  
  5073. Purpose 
  5074.  
  5075. Causes a break in a line of text. 
  5076.  
  5077. Syntax 
  5078.  
  5079. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5080. ΓöéControl Word   ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  5081. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5082. Γöé.br            ΓöéBreak          Γöé               Γöé               Γöé
  5083. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5084.  
  5085. Attributes 
  5086.  
  5087. None 
  5088.  
  5089. Description 
  5090.  
  5091. Use the .br control word to stop the display of text on a line, and continue it 
  5092. on the next line. The break control word must be the only statement on the 
  5093. line. If you enter text on the same line as the break control word, the IPF 
  5094. compiler ignores the break control word. 
  5095.  
  5096. The break control word is especially useful before a line of text that contains 
  5097. a symbol. 
  5098.  
  5099. Conditions 
  5100.  
  5101. The .br control word must start in column 1, and be the only statement on the 
  5102. line. 
  5103.  
  5104. Example 
  5105.  
  5106. :p.These words
  5107. appear on
  5108. the same line.
  5109. .br
  5110. These words
  5111. .br
  5112. do not.
  5113.  
  5114. Output 
  5115.  
  5116. These words appear on the same line.
  5117. These words
  5118. do not.
  5119.  
  5120. For more information, see Break. 
  5121.  
  5122.  
  5123. ΓòÉΓòÉΓòÉ 8.2. .ce (Center Text) ΓòÉΓòÉΓòÉ
  5124.  
  5125. Purpose 
  5126.  
  5127. Centers text. 
  5128.  
  5129. Syntax 
  5130.  
  5131. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5132. ΓöéControl Word   ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  5133. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5134. Γöé.ce            ΓöéText           Γöé               Γöé               Γöé
  5135. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5136.  
  5137. Attributes 
  5138.  
  5139. None 
  5140.  
  5141. Description 
  5142.  
  5143. The .ce control word allows you to center text on a line. 
  5144.  
  5145. Conditions 
  5146.  
  5147. The text cannot contain any IPF tags. It can, however, contain nameit symbols 
  5148. and IPFC symbols. 
  5149.  
  5150. The .ce control word's centering effect is limited to text on the same line 
  5151. with the control word. 
  5152.  
  5153. The line will remain centered as you resize the window unless the window 
  5154. becomes so small that the line must be broken, at which point centering 
  5155. justification is lost (when you resize the window to be large enough to hold 
  5156. the line again, centering is restored). 
  5157.  
  5158. The control word must start in column 1. 
  5159.  
  5160. Example 
  5161.  
  5162. .ce The centered text must not contain any IPF tags.
  5163.  
  5164. Output 
  5165.  
  5166. The centered text must not contain any IPF tags.
  5167.  
  5168.  
  5169. ΓòÉΓòÉΓòÉ 8.3. .* (Comment) ΓòÉΓòÉΓòÉ
  5170.  
  5171. Purpose 
  5172.  
  5173. Places a comment into a file. 
  5174.  
  5175. Syntax 
  5176.  
  5177. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5178. ΓöéControl Word   ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  5179. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5180. Γöé.*             ΓöéComment        Γöé               Γöé               Γöé
  5181. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5182.  
  5183. Attributes 
  5184.  
  5185. None 
  5186.  
  5187. Description 
  5188.  
  5189. The .* control word allows you to place a comment line into your file. The IPF 
  5190. compiler ignores any text on the same line as the comment control word, and 
  5191. does not display this text. 
  5192.  
  5193. The comment control word must be the first statement on the line of text that 
  5194. you do not want displayed. Each comment control word must begin on a new line. 
  5195.  
  5196. You can use comment control words to refer to items, to place notes into your 
  5197. file, or to prevent the display of an item. 
  5198.  
  5199. No space is required between the comment control word and the text that follows 
  5200. it. Comment control words are used independently of IPF tags. They are not used 
  5201. between any IPF tags or with any IPF tag and its accompanying text or 
  5202. attributes. 
  5203.  
  5204. Conditions 
  5205.  
  5206. Do not use the comment control word: 
  5207.  
  5208.      Within the IPF tag, that is, between the colon that starts the tag and 
  5209.       the period that ends the tag. 
  5210.  
  5211.      Between an IPF tag and its accompanying text or attributes. 
  5212.  
  5213.  Always start the comment control word in column 1. 
  5214.  
  5215.  Example 
  5216.  
  5217.   .* The comment control word must be the first statement on the line.
  5218.   .* When the source file is compiled, the text on the
  5219.   .* comment line is not displayed.
  5220.  
  5221.  Output 
  5222.  
  5223.  When the file is compiled, the comment control word and the information 
  5224.  following it on the comment line are not displayed. 
  5225.  
  5226.  
  5227. ΓòÉΓòÉΓòÉ 8.4. .im  (Imbed) ΓòÉΓòÉΓòÉ
  5228.  
  5229. Purpose 
  5230.  
  5231. Specifies that text files are to be included at process time. 
  5232.  
  5233. Syntax 
  5234.  
  5235. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5236. ΓöéControl Word   ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  5237. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5238. Γöé.im            ΓöéImbed          Γöé               Γöé               Γöé
  5239. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5240.  
  5241. Attributes 
  5242.  
  5243. None 
  5244.  
  5245. Description 
  5246.  
  5247. The .im control word enables you to include text files when you are ready to 
  5248. compile your file. 
  5249.  
  5250. Conditions 
  5251.  
  5252.      If the file to be included is not in the current directory, you must 
  5253.       enter a complete file name. 
  5254.  
  5255.      Imbedded files must not use the :userdoc. or :euserdoc. tag. 
  5256.  
  5257.  Always start the .im control word in column 1. 
  5258.  
  5259.  Example 
  5260.  
  5261.   :userdoc.
  5262.   .im filename.ext
  5263.   .im c:\main\filename.ext
  5264.   :euserdoc.
  5265.  
  5266.  Output 
  5267.  
  5268.  The text and art in the imbedded files are displayed when you access the 
  5269.  compiled file. 
  5270.  
  5271.  
  5272. ΓòÉΓòÉΓòÉ 8.5. .nameit (Nameit) ΓòÉΓòÉΓòÉ
  5273.  
  5274. Purpose 
  5275.  
  5276. Defines symbols in a document. 
  5277.  
  5278. Syntax 
  5279.  
  5280. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5281. ΓöéControl Word   ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  5282. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5283. Γöé.nameit        ΓöéNameit         Γöésymbol=        Γöé               Γöé
  5284. Γöé               Γöé               Γöétext='string'  Γöé               Γöé
  5285. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5286.  
  5287. Attributes 
  5288.  
  5289.  symbol=name 
  5290.     Identifies a name for the symbol you want to create. It can be up to 10 
  5291.     characters long (A-Z, 0-9), with no blanks or special characters; the first 
  5292.     character must be a letter. The & character cannot be used in the name. 
  5293.  
  5294.  text='string' 
  5295.     Identifies the content of the value to be assigned to the symbol and is 
  5296.     what is displayed. In addition to text, the text string can contain other 
  5297.     nameit symbols, IPFC symbols, and IPFC tags. 
  5298.  
  5299.  Description 
  5300.  
  5301.  The .nameit control word enables you to create symbols. 
  5302.  
  5303.  Conditions 
  5304.  
  5305.  Do not use the & character as part of the name of the symbol. You must use the 
  5306.  & character when you actually use the symbol. 
  5307.  
  5308.  Always start the nameit control word in column 1. 
  5309.  
  5310.  Example 
  5311.  
  5312.   .nameit symbol=os text='operating system'
  5313.   .
  5314.   .
  5315.   :p.The &os. supports multitasking.
  5316.  
  5317.  The output looks like this: 
  5318.  
  5319.   The operating system supports multitasking.
  5320.  
  5321.  
  5322. ΓòÉΓòÉΓòÉ 8.6. :acviewport. (Application-Controlled Window) ΓòÉΓòÉΓòÉ
  5323.  
  5324. Purpose 
  5325.  
  5326. Enables an application to dynamically control what is displayed in an IPF 
  5327. window. 
  5328.  
  5329. Syntax 
  5330.  
  5331. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5332. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  5333. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5334. Γöé:acviewport.   ΓöéHave IPF call aΓöédll=' '        Γöé               Γöé
  5335. Γöé               Γöéfunction in a  Γöéobjectname=' ' Γöé               Γöé
  5336. Γöé               Γöédynamic-link   Γöéobjectinfo=' ' Γöé               Γöé
  5337. Γöé               Γöémodule.        Γöéobjectid=' '   Γöé               Γöé
  5338. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5339. Γöé               ΓöéDefine the     Γöévpx=           Γöé               Γöé
  5340. Γöé               Γöéwindow in whichΓöévpy=           Γöé               Γöé
  5341. Γöé               Γöéthe function   Γöévpcx=          Γöé               Γöé
  5342. Γöé               Γöéruns.          Γöévpcy=          Γöé               Γöé
  5343. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5344.  
  5345. Attributes 
  5346.  
  5347.  dll=' ' 
  5348.     Specifies a dynamic-link module for IPF to load so that a communication 
  5349.     object (a function) in the module can be run in a window (an 
  5350.     application-controlled window). 
  5351.  
  5352.  objectname=' ' 
  5353.     Identifies the entry point of the communication object in the dynamic-link 
  5354.     module.  The value specified for this attribute is case sensitive. 
  5355.  
  5356.  objectinfo=' ' 
  5357.     Identifies parameters to be passed to the object. 
  5358.  
  5359.  objectid=' ' 
  5360.     Specifies an identifier that will associate the window with the object. The 
  5361.     application or communication object can get this value from the Object ID 
  5362.     field in the ACVP data structure and use it to determine the panel that 
  5363.     activated the viewport. 
  5364.  
  5365.   vpx=
  5366.   vpy=
  5367.   vpcx=
  5368.   vpcy=
  5369.     Define the location and size of the window. vpx= and vpy= are positions 
  5370.     along the x (horizontal) and y (vertical) axes.  The point where the values 
  5371.     intersect represents the origin of the window.  vpcx= and vpcy= represent 
  5372.     changes along the x and y axes with respect to the origin. 
  5373.  
  5374.     These attributes can be expressed as absolute values, relative values, or 
  5375.     dynamic values: 
  5376.  
  5377.     Absolute value: 
  5378.             A number followed by a letter, which indicates the unit of measure: 
  5379.  
  5380.             c           (Characters):  Average character width of the default 
  5381.                         system font. 
  5382.             x           (Pixels):  Dependent on the display adapter in use. 
  5383.             p           (Points):  Typesetting measure; equal to approximately 
  5384.                         1/72 inch. 
  5385.  
  5386.     Relative value: 
  5387.             A number followed by the percent sign (%), indicating a percentage 
  5388.             of the parent-window width or height. 
  5389.  
  5390.     Dynamic value: 
  5391.             A term indicating a window coordinate location that is dependent on 
  5392.             the current size and position of the parent window: 
  5393.  
  5394.             left | center | right 
  5395.                     For x values, flush left with, in the center of, or flush 
  5396.                     right with the parent window. 
  5397.             top | center | bottom 
  5398.                     For y values, at the top, center, or bottom of the parent 
  5399.                     window. 
  5400.  
  5401.  Description 
  5402.  
  5403.  :acviewport. is used in either a help file or an online document file to 
  5404.  specify that a window will be under the control of a routine that was written 
  5405.  and compiled as part of a dynamic-link module. When an IPF window is selected 
  5406.  for display at run time, and :acviewport. is encountered, IPF passes control 
  5407.  to the entry point (objectname=) in the dynamic-link module. At this point, 
  5408.  the routine in the module takes control. For more information, see Customizing 
  5409.  IPF with Communication Objects. 
  5410.  
  5411.  The definition for :acviewport. must follow a primary heading; for example: 
  5412.  
  5413.   :h2 res=2000
  5414.       x=left y=top width=100% height=100%
  5415.       scroll=none titlebar=both clear group=1.Information Windows
  5416.   :acviewport dll='My_DLL' objectname='My_Routine' objectid='1'
  5417.       vpx=right vpy=top vpcx=50% vpcy=100%
  5418.  
  5419.  In the example, a window is displayed within the primary window indicated by 
  5420.  the heading tag (:h2.) and its attributes. The contents of the window are 
  5421.  controlled by the communication object, My_Routine, in the dynamic-link 
  5422.  module, My_DLL. 
  5423.  
  5424.  When the user selects the primary window and :acviewport. tag is encountered, 
  5425.  IPF calls the communication object in the dynamic-link module and sizes the 
  5426.  child window. 
  5427.  
  5428.  
  5429. ΓòÉΓòÉΓòÉ 8.7. :artlink.  (Art Link) ΓòÉΓòÉΓòÉ
  5430.  
  5431. Purpose 
  5432.  
  5433. Identifies link definitions for hypergraphic areas of a bit map, metafiles are 
  5434. not supported. 
  5435.  
  5436. Syntax 
  5437.  
  5438. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5439. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  5440. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5441. Γöé:artlink.      Γöé               Γöé               Γöé:eartlink.     Γöé
  5442. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5443.  
  5444. Attributes 
  5445.  
  5446. None 
  5447.  
  5448. Description 
  5449.  
  5450. Use :artlink. in conjunction with the artwork tag (:artwork.) to indicate links 
  5451. to a bit map or segments of a bit map.  The link definitions are specified by 
  5452. link tags (:link.) and follow :artlink., as in Example 1. 
  5453.  
  5454. Example 1 
  5455.  
  5456. :artlink..
  5457. :link reftype=hd res=001 x=0 y=0 cx=16 cy=8.
  5458. :link reftype=fn refid=afnr x=16 y=8 cx=16 cy=8.
  5459. :link reftype=inform res=0345 x=0 y=8 cx=16 cy=8.
  5460. :eartlink.
  5461.  
  5462. (For more information, see :link.  (Link).) 
  5463.  
  5464. All of the above could be in a separate file, which would be identified by the 
  5465. linkfile. attribute of the artwork tag, as in Example 2. 
  5466.  
  5467. Example 2 
  5468.  
  5469. :artwork name='mybitmap.bmp' linkfile='mylinks'.
  5470.  
  5471. In this example, MYBITMAP.BMP is the name of the file containing the bit map, 
  5472. and MYLINKS is the file consisting of the entries shown in Example 1. 
  5473.  
  5474. If the artwork tag does not specify the attribute linkfile=, IPF looks for 
  5475. :artlink. on the line immediately following :artwork., as shown in Example 3. 
  5476.  
  5477. Example 3 
  5478.  
  5479. :artwork name='mybitmap.bmp'.
  5480. :artlink.
  5481. :link reftype=hd res=001.
  5482. :eartlink.
  5483.  
  5484. In this example, if the user clicks on the bit map associated with this art 
  5485. link, the window with the identifier, 001 is displayed. 
  5486.  
  5487. If no :artlink. tag is found, no hypergraphic areas for the bit map are 
  5488. defined. 
  5489.  
  5490. You can divide a bit map into rectangular segments, each of which is selectable 
  5491. and links to different information. For each segment, you need to define values 
  5492. for x, y, cx, and cy, which represent pixel values on the x and y axes. The x 
  5493. axis is always horizontal, and the y axis is always vertical; x and y define 
  5494. the origin of the segment, while cx and cy identify the changes in x and y. The 
  5495. value 0,0 indicates the origin of the bit map and is always the bottom-left 
  5496. corner. 
  5497.  
  5498. Following is an example of a segmented bit map. 
  5499.  
  5500.     0,16                                32,16
  5501.     | ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5502.     | Γöé                Γöé                  Γöé
  5503.     | Γöé                Γöé                  Γöé
  5504.     y Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5505.     | Γöé                Γöé                  Γöé
  5506.     | Γöé                Γöé                  Γöé
  5507.     | ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5508.      0,0  --------------x--------------- 32,0
  5509.  
  5510. Example 4 shows the tagging when the link is from a segmented bit map. The name 
  5511. of the segmented bit-map file is show2.bmp; the name of the file with the link 
  5512. information is link.dat. 
  5513.  
  5514. Example 4 
  5515.  
  5516. :artwork name='show2.bmp' linkfile='link.dat'.
  5517.  
  5518. The following information could be placed into LINK.DAT. 
  5519.  
  5520. :artlink.
  5521. :link reftype=hd res=001 x=0 y=0 cx=16 cy=8.
  5522. :link reftype=fn refid=afnr x=16 y=8 cx=16 cy=8.
  5523. :link reftype=inform res=0345 x=0 y=8 cx=16 cy=8.
  5524. :link reftype=launch object='c:\os2\e.exe'
  5525.         data='c:\appsdir\tutor.dat' x=16 y=0 cx=16 cy=8.
  5526. :eartlink.
  5527.  
  5528.  
  5529. ΓòÉΓòÉΓòÉ 8.8. :artwork. (Artwork) ΓòÉΓòÉΓòÉ
  5530.  
  5531. Purpose 
  5532.  
  5533. Identifies a bit map to be placed into the user's file. 
  5534.  
  5535. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5536. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  5537. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5538. Γöé:artwork.      ΓöéArtwork        Γöéname=' '       Γöé               Γöé
  5539. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5540. Γöé               Γöé               Γöéalign=         Γöé               Γöé
  5541. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5542. Γöé               Γöé               Γöélinkfile=' '   Γöé               Γöé
  5543. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5544. Γöé               Γöé               Γöérunin          Γöé               Γöé
  5545. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5546. Γöé               Γöé               Γöéfit            Γöé               Γöé
  5547. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5548.  
  5549. Attributes 
  5550.  
  5551.  name='filename.ext' 
  5552.     Identifies the file containing the bit map (artwork). This attribute is 
  5553.     required and must specify a complete file name. 
  5554.  
  5555.  align=leftΓöérightΓöécenter 
  5556.     Specifies how the artwork is to align with the current margins. It can be 
  5557.     to the left, to the right, or centered. 
  5558.  
  5559.  linkfile='filename.ext' 
  5560.     Identifies the file with the link definitions. This file begins with 
  5561.     :artlink. and ends with :eartlink.. The linkfile= attribute enables you to 
  5562.     link from whole or segmented bit maps. It can be omitted if the artwork 
  5563.     file does not require links, or if the links are enclosed by :artlink. and 
  5564.     :eartlink. immediately following the artwork tag. 
  5565.  
  5566.  runin 
  5567.     Specifies that the artwork is to be placed within the line of text.  You 
  5568.     enter :artwork. and its attributes in the line of text where you want the 
  5569.     artwork to appear. 
  5570.  
  5571.  fit 
  5572.     Causes the artwork to fill the window in which it is displayed. If the user 
  5573.     resizes the window, IPF redisplays the graphic so that it fits the new 
  5574.     window size. 
  5575.  
  5576.     When the initial size of the window is specified, the ratio between its 
  5577.     width and height should be approximately the same as that of the graphic; 
  5578.     otherwise, the artwork may appear distorted. 
  5579.  
  5580.     The fit attribute is most often used when artwork is to be displayed in a 
  5581.     split window, where one window contains a bit map, and another contains 
  5582.     text that is displayed beside the graphic. 
  5583.  
  5584.     If the artwork tag has fit, and you include text in the same window, the 
  5585.     text will be displayed briefly, but will then be covered by the painting of 
  5586.     the bit map in the window. 
  5587.  
  5588.  Description 
  5589.  
  5590.  Use :artwork. to include bit maps such as vectors and scanned images, in the 
  5591.  text file. The artwork tag and its attributes enable you to merge whole or 
  5592.  segmented bit maps and position them in the window. A bit map can be created 
  5593.  by an application or by a bit-map editing tool, such as the Presentation 
  5594.  Manager Icon Editor. A metafile can be created using a GPI function. 
  5595.  
  5596.  Conditions 
  5597.  
  5598.      If a path name is not specified for either name= or linkfile=, IPF looks 
  5599.       for the file in the current directory. 
  5600.  
  5601.      If linkfile= is not specified, IPF looks for the artlink tag on the line 
  5602.       immediately following the artwork tag. 
  5603.  
  5604.      The artwork tag requires the name= attribute. 
  5605.  
  5606.  Example 1 
  5607.  
  5608.  This example shows how to include artwork that does not require a hypergraphic 
  5609.  link.  The artwork is to be placed within the line of text that contains the 
  5610.  artwork tag. 
  5611.  
  5612.   Click on the :artwork name='gopi.art' runin. symbol to close the file.
  5613.  
  5614.  Example 2 
  5615.  
  5616.  This example shows how to include artwork that fills the window in which it is 
  5617.  displayed. 
  5618.  
  5619.   :artwork name='c:\main\world.bmp' fit.
  5620.  
  5621.  
  5622. ΓòÉΓòÉΓòÉ 8.9. :caution.  (Caution) ΓòÉΓòÉΓòÉ
  5623.  
  5624. Purpose 
  5625.  
  5626. Alerts the user to a risk. 
  5627.  
  5628. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5629. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  5630. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5631. Γöé:caution.      ΓöéCaution        Γöétext=' '       Γöé:ecaution.     Γöé
  5632. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5633.  
  5634. Attributes 
  5635.  
  5636.  text=' ' 
  5637.     Enables you to change CAUTION to different text. 
  5638.  
  5639.  Description 
  5640.  
  5641.  A caution message notifies the user of possible risks.  It should precede the 
  5642.  text to which it pertains so the user will see it first. 
  5643.  
  5644.  When :caution. is encountered, CAUTION appears on the screen, and the caution 
  5645.  text is displayed on the next line.  A blank line is inserted before the 
  5646.  caution message. 
  5647.  
  5648.  Conditions 
  5649.  
  5650.  None 
  5651.  
  5652.  Example 1 
  5653.  
  5654.   :caution.
  5655.   These berries are wild.  Do not eat.
  5656.   :ecaution.
  5657.  
  5658.  Output 
  5659.  
  5660.   CAUTION:
  5661.   These berries are wild.  Do not eat.
  5662.  
  5663.  Example 2 
  5664.  
  5665.   :caution text='Wild Berries:'.
  5666.   These berries are wild.  Do not eat.
  5667.   :ecaution.
  5668.  
  5669.  Output 
  5670.  
  5671.   Wild Berries:
  5672.   These berries are wild.  Do not eat.
  5673.  
  5674.  
  5675. ΓòÉΓòÉΓòÉ 8.10. :cgraphic. (Character Graphic) ΓòÉΓòÉΓòÉ
  5676.  
  5677. Purpose 
  5678. Defines a character graphic. 
  5679.  
  5680. Syntax 
  5681.  
  5682. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5683. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  5684. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5685. Γöé:cgraphic.     ΓöéCharacter      Γöé               Γöé:ecgraphic.    Γöé
  5686. Γöé               Γöégraphic        Γöé               Γöé               Γöé
  5687. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5688.  
  5689. Attributes 
  5690.  
  5691. None 
  5692.  
  5693. Description 
  5694.  
  5695. Character graphics are those you create with an ASCII editor. The :cgraphic. 
  5696. tag indicates that a character graphic is to follow. Everything after the tag 
  5697. and before :ecgraphic. will be in a monospace font. A blank line is inserted 
  5698. before and after the graphic. 
  5699.  
  5700. Conditions 
  5701. Text that does not fit in the display area of a window is clipped. 
  5702.  
  5703. Example 
  5704.  
  5705. :cgraphic.
  5706. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÉ       ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5707. Γöé     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉΓö£Γö¼Γöñ       Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ           Γöé
  5708. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÉ ΓöéΓöéΓöéΓö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÉ    Γöé           Γöé
  5709. Γöé     Γöé    Γöé ΓööΓöÿΓöéΓöé         Γöé    ΓööΓöÇΓöÇ One ΓöÇΓöÇΓöÇΓöÇΓöñ
  5710. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓö┤Γöÿ         ΓööΓöÇΓöÇΓöÇΓöÇ :hp4.Two:ehp4. ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5711. :ecgraphic.
  5712.  
  5713. Output 
  5714.  
  5715. The following output is provided. 
  5716.  
  5717. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÉ       ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5718. Γöé     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉΓö£Γö¼Γöñ       Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ           Γöé
  5719. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÉ ΓöéΓöéΓöéΓö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÉ    Γöé           Γöé
  5720. Γöé     Γöé    Γöé ΓööΓöÿΓöéΓöé         Γöé    ΓööΓöÇΓöÇ One ΓöÇΓöÇΓöÇΓöÇΓöñ
  5721. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓö┤Γöÿ         ΓööΓöÇΓöÇΓöÇΓöÇ Two ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5722.  
  5723.  
  5724. ΓòÉΓòÉΓòÉ 8.11. :color.  (Color) ΓòÉΓòÉΓòÉ
  5725.  
  5726. Purpose 
  5727.  
  5728. Changes the colors of the text and text background. 
  5729.  
  5730. Syntax 
  5731.  
  5732. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5733. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  5734. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5735. Γöé:color.        ΓöéColor          Γöéfc=            Γöé               Γöé
  5736. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5737. Γöé               Γöé               Γöébc=            Γöé               Γöé
  5738. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5739.  
  5740. Attributes 
  5741.  
  5742.  fc= 
  5743.     Enables you to change the color of the text. Text following this attribute 
  5744.     appears in the color specified. The values that can be specified are: 
  5745.          default 
  5746.          black 
  5747.          blue 
  5748.          red 
  5749.          pink 
  5750.          green 
  5751.          cyan 
  5752.          yellow 
  5753.          neutral 
  5754.          brown 
  5755.          darkgray 
  5756.          darkblue 
  5757.          darkred 
  5758.          darkpink 
  5759.          darkgreen 
  5760.          darkcyan 
  5761.          palegray 
  5762.  
  5763.  
  5764.  bc= 
  5765.     Enables you to change the background color of the text.  The screen colors 
  5766.     remain the same. The values that can be specified are the same as those for 
  5767.     fc=. 
  5768.  
  5769.  Description 
  5770.  
  5771.  :color. and its attributes enable you to change the color of the text and the 
  5772.  color of the text background. Colors set with this tag remain in effect until 
  5773.  another color is specified or a heading definition is encountered. 
  5774.  
  5775.  To return to the system colors, use fc=default and bc=default. 
  5776.  
  5777.  Conditions 
  5778.  
  5779.  None 
  5780.  
  5781.  Example 
  5782.  
  5783.   :sl.
  5784.   :color fc=green bc=blue.
  5785.   :li.Color the foreground green; color the background blue.
  5786.   .*
  5787.   :color fc=blue bc=red.
  5788.   :li.Color the foreground blue; color the background red.
  5789.   .*
  5790.   :color fc=cyan bc=yellow.
  5791.   :li.Color the foreground cyan; color the background yellow.
  5792.   .*
  5793.   :color fc=default bc=default.
  5794.   :li.Return to the system colors.
  5795.   :esl.
  5796.  
  5797.  Output 
  5798.  
  5799.       Color the foreground green; color the background blue. 
  5800.  
  5801.       Color the foreground blue; color the background red. 
  5802.  
  5803.       Color the foreground cyan; color the background yellow. 
  5804.  
  5805.       Return to the system colors. 
  5806.  
  5807.  
  5808. ΓòÉΓòÉΓòÉ 8.12. :ctrl.  (Control Area) ΓòÉΓòÉΓòÉ
  5809.  
  5810. Purpose 
  5811.  
  5812. Defines the contents of the control area. 
  5813.  
  5814. Syntax 
  5815.  
  5816. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5817. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  5818. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5819. Γöé:ctrl          ΓöéControl area   Γöéctrlid=        Γöé               Γöé
  5820. Γöé               Γöé               Γöécontrols=' '   Γöé               Γöé
  5821. Γöé               Γöé               Γöépage           Γöé               Γöé
  5822. Γöé               Γöé               Γöécoverpage      Γöé               Γöé
  5823. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5824.  
  5825. Attributes 
  5826.  
  5827.  ctrlid= 
  5828.     Specifies the identification value for the control area.  The 
  5829.     identification value can be either alpha or alphanumeric, and is referenced 
  5830.     by the heading tag. 
  5831.  
  5832.  controls=' ' 
  5833.     Specifies the identification values of the push buttons that you want 
  5834.     included in the control area of a window.  Push buttons are displayed in 
  5835.     the order in which they are defined. The values that can be specified are: 
  5836.  
  5837.     Search              Specifies the Search push button.  This push button 
  5838.                         displays a window that lets the user search for a word 
  5839.                         or phrase. 
  5840.  
  5841.     Print               Specifies the Print push button.  This push button 
  5842.                         displays a window that lets the user print one or more 
  5843.                         topics. 
  5844.  
  5845.     Index               Specifies the Index push button.  This push button 
  5846.                         displays an alphabetic list to the topics in the 
  5847.                         document. 
  5848.  
  5849.     Contents            Specifies the Contents push button.  This push button 
  5850.                         displays the Contents window. 
  5851.  
  5852.     Esc                 Specifies the Previous push button.  This push button 
  5853.                         lets the user see information from an earlier request. 
  5854.  
  5855.     Back                Specifies the Back push button.  This push button 
  5856.                         displays the previous page in the table of contents 
  5857.                         hierarchy. 
  5858.  
  5859.     Forward             Specifies the Forward push button.  This push button 
  5860.                         displays the next page in the table of contents 
  5861.                         hierarchy. 
  5862.  
  5863.     Note:  An identification value for the Tutorial push button is not provided 
  5864.            because it is displayed automatically if a tutorial exists. 
  5865.  
  5866.     If you are defining your own push buttons, use id= attribute of the push 
  5867.     button tag (:pbutton.). See :pbutton. (Push Button). 
  5868.  
  5869.     The identification values for the predefined push buttons are defined in 
  5870.     the PMHELP.H file. 
  5871.  
  5872.  page 
  5873.     Specifies that a set of push buttons is displayed in the control area of an 
  5874.     IPF text window . You can use this attribute to override the default set of 
  5875.     push buttons that is displayed in the control area of an IPF text window. 
  5876.  
  5877.  coverpage 
  5878.     Specifies the set of push buttons that is displayed in the control area of 
  5879.     the coverpage window . The control area in the coverpage window is at the 
  5880.     very bottom of a window.  You can use this attribute to override the 
  5881.     default set of push buttons that is displayed in the coverpage window. 
  5882.  
  5883.  Example:  The following tagging specifies the Previous, Forward, and Back push 
  5884.  buttons display in the coverpage window: 
  5885.  
  5886.   :ctrl ctrlid=new1 controls='ESC FORWARD BACK' coverpage.
  5887.  
  5888.  Description 
  5889.  
  5890.  The control area tag (:ctrl.) specifies where push buttons are displayed, and 
  5891.  which push buttons you want displayed. You can display push buttons in the 
  5892.  control areas of coverpage window or an IPF text window. 
  5893.  
  5894.  The default control area for online documents and Help windows is the coverage 
  5895.  page window, and the default push buttons that display are: 
  5896.  
  5897.  Online documents 
  5898.  
  5899.         Previous 
  5900.         Search 
  5901.         Print 
  5902.         Index 
  5903.         Contents 
  5904.         Back 
  5905.         Forward 
  5906.         Tutorial (only if a tutorial is available). 
  5907.  
  5908.  Help windows 
  5909.  
  5910.         Previous 
  5911.         Search 
  5912.         Print 
  5913.         Index 
  5914.         Tutorial (only if a tutorial is available). 
  5915.  
  5916.  You can define more than one control area with different sets of push button 
  5917.  for an IPF text window; however, only one set of push buttons can be defined 
  5918.  for the coverpage window. 
  5919.  
  5920.  The default set of push buttons for an IPF text window can be overridden by 
  5921.  defining a new default or by referring to the control area definition with the 
  5922.  heading tag (see :h1. through :h6.  (Headings)).  For more information about 
  5923.  push buttons, see Push Buttons. 
  5924.  
  5925.  Conditions 
  5926.  
  5927.      The control area tag (:ctrl.) must be enclosed within the control area 
  5928.       definition tag (:ctrldef.) and associated end tag (:ectrldef.) (see 
  5929.       :ctrldef  (Control Area Definition)). 
  5930.  
  5931.      The :ctrl. tag must follow all push button tags (:pbutton.) (see 
  5932.       :pbutton. (Push Button)). 
  5933.  
  5934.  
  5935. ΓòÉΓòÉΓòÉ 8.13. :ctrldef  (Control Area Definition) ΓòÉΓòÉΓòÉ
  5936.  
  5937. Purpose 
  5938.  
  5939. Defines a control area. 
  5940.  
  5941. Syntax 
  5942.  
  5943. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5944. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  5945. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5946. Γöé:ctrldef.      ΓöéControl area   ΓöéNONE           Γöé:ectrldef.     Γöé
  5947. Γöé               Γöédefinition     Γöé               Γöé               Γöé
  5948. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5949.  
  5950. Attributes 
  5951.  
  5952. None 
  5953.  
  5954. Description 
  5955.  
  5956. Use the :ctrldef. tag to define a control area and the contents of the control 
  5957. area.  For tagging information about the control area of a window, see :ctrl. 
  5958. (Control Area). 
  5959.  
  5960. Conditions 
  5961.  
  5962.      This tag should follow the :docprof. tag. 
  5963.      The following tags are embedded within the :ctrldef. and :ectrldef. tags. 
  5964.         -  :pbutton. 
  5965.         -  :ctrl. 
  5966.  
  5967.  
  5968. ΓòÉΓòÉΓòÉ 8.14. :ddf. (Dynamic Data Formatting) ΓòÉΓòÉΓòÉ
  5969.  
  5970. Purpose 
  5971.  
  5972. Display dynamically formatted text in an application-controlled window. 
  5973.  
  5974. Syntax 
  5975.  
  5976. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5977. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  5978. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5979. Γöé:ddf.          ΓöéDynamic data   Γöéres=           Γöé               Γöé
  5980. Γöé               Γöéformatting     Γöé               Γöé               Γöé
  5981. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5982.  
  5983. Attributes 
  5984.  
  5985.  res= 
  5986.     Associates a location in a window with a request for specific information. 
  5987.     The value is an integer from 1 to 64 000. 
  5988.  
  5989.  Description 
  5990.  
  5991.  :ddf. indicates that the application will provide dynamically formatted data. 
  5992.  
  5993.  When IPF encounters :ddf., it sends the message HM_QUERY_DDF_DATA to the 
  5994.  OBJCOM window,  and specifies the res= value. (The application identified the 
  5995.  OBJCOM window by sending HM_SET_OBJCOM_WINDOW to IPF.) The OBJCOM code 
  5996.  responds by initializing for dynamic data formatting and proceeding with a 
  5997.  dynamic data-formatting routine, using dynamic data-formatting functions. For 
  5998.  more information, see Changing Help Information at Run Time (DDF). 
  5999.  
  6000.  
  6001. ΓòÉΓòÉΓòÉ 8.15. :dl. (Definition List) ΓòÉΓòÉΓòÉ
  6002.  
  6003. Purpose 
  6004.  
  6005. Identifies a list of terms and definitions. 
  6006.  
  6007. Syntax 
  6008.  
  6009. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6010. ΓöéTag          ΓöéElement                    ΓöéAttributes     ΓöéEnd            Γöé
  6011. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6012. Γöé:dl.         ΓöéDefinition list            Γöécompact        Γöé:edl.          Γöé
  6013. Γöé             Γöé                           Γöétsize=         Γöé               Γöé
  6014. Γöé             Γöé                           Γöébreak=         Γöé               Γöé
  6015. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6016. Γöé:dthd.       ΓöéDefinition-term heading    Γöé               Γöé               Γöé
  6017. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6018. Γöé:ddhd.       ΓöéDefinition-description     Γöé               Γöé               Γöé
  6019. Γöé             Γöéheading                    Γöé               Γöé               Γöé
  6020. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6021. Γöé:dt.         ΓöéDefinition term            Γöé               Γöé               Γöé
  6022. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6023. Γöé:dd.         ΓöéDefinition description     Γöé               Γöé               Γöé
  6024. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6025.  
  6026. Attributes 
  6027.  
  6028.  compact 
  6029.     Causes the list to be formatted without a blank line between each term and 
  6030.     description. If you omit this attribute, a blank line is inserted. 
  6031.  
  6032.  tsize=10 | n 
  6033.     Defines the amount of space to allot for the terms and term headings. The 
  6034.     default is 10 character units. If the value of tsize= exceeds the current 
  6035.     size of the formatting area (the space between the current margins), the 
  6036.     current formatting area size is assigned, and a warning message is issued. 
  6037.  
  6038.  break=none | fit | all 
  6039.     Controls the formatting of the terms and descriptions: 
  6040.  
  6041.     none         The description is on the same line as the term. If the length 
  6042.                  of the term exceeds the value specified by tsize=, the term 
  6043.                  extends into the description column, and the description 
  6044.                  starts one space after the term. 
  6045.  
  6046.     fit          The description is placed on the line below the term if the 
  6047.                  term is longer than the value specified by tsize=. 
  6048.  
  6049.     all          All descriptions are placed on the line below the term. 
  6050.  
  6051.  Conditions 
  6052.  
  6053.      The term-heading tag (:dthd.) is paired with the description-heading tag 
  6054.       (:ddhd.) and precedes the term and description tags (:dt. and :dd.). 
  6055.  
  6056.      The term tag requires a description tag. 
  6057.  
  6058.  Example 
  6059.  
  6060.   :dl compact tsize=20.
  6061.   :dthd.:hp2.Mammal:ehp2.
  6062.   :ddhd.:hp2.Description:ehp2.
  6063.   :dt.Florida Panther
  6064.   :dd.Relative of the mountain lion or puma.
  6065.   :dt.Key Deer
  6066.   :dd.&odq.Toy&cdq. member of the whitetail deer family.
  6067.   :dt.Manatee
  6068.   :dd.Gentle giant sea cow.
  6069.   :edl.
  6070.  
  6071.  Output 
  6072.  
  6073.  Mammal              Description 
  6074.  Florida Panther     Relative of the mountain lion or puma. 
  6075.  Key Deer            "Toy" member of the whitetail deer family. 
  6076.  Manatee             Gentle giant sea cow. 
  6077.  
  6078.  
  6079. ΓòÉΓòÉΓòÉ 8.16. :docprof.  (Document Profile) ΓòÉΓòÉΓòÉ
  6080.  
  6081. Purpose 
  6082.  
  6083. Specifies the heading-level entries to be displayed in the Contents window. 
  6084.  
  6085. Syntax 
  6086.  
  6087. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6088. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  6089. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6090. Γöé:docprof.      ΓöéContents windowΓöétoc=           Γöé               Γöé
  6091. Γöé               Γöéentries        Γöé               Γöé               Γöé
  6092. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6093. Γöé               ΓöéGlobal         Γöédll=' '        Γöé               Γöé
  6094. Γöé               Γöécommunications Γöéobjectname=' ' Γöé               Γöé
  6095. Γöé               Γöédynamic-link   Γöéobjectinfo=' ' Γöé               Γöé
  6096. Γöé               Γöélibrary        Γöé               Γöé               Γöé
  6097. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6098. Γöé               ΓöéPush button    Γöéctrlarea=      Γöé               Γöé
  6099. Γöé               Γöésupport        Γöé               Γöé               Γöé
  6100. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6101.  
  6102. Attributes 
  6103.  
  6104.  toc= 
  6105.     Enables you to control the heading levels displayed in the table of 
  6106.     contents. For example, if you want only heading levels 1 and 2 to appear, 
  6107.     the tagging is: 
  6108.  
  6109.         :docprof toc=12.
  6110.  
  6111.     If no toc= value is specified, heading levels 1 through 3 appear in the 
  6112.     Contents window. Heading levels 4 through 6 appear as part of the text when 
  6113.     the window is displayed. 
  6114.  
  6115.     If a heading tag also specifies a value for toc=, the heading-tag value 
  6116.     overrides the :docprof. value until either the end of the file is reached, 
  6117.     or another heading toc= value is encountered. 
  6118.  
  6119.  dll=' ' 
  6120.     Specifies the communication dynamic-link library that IPF loads so that a 
  6121.     communication object in the library can be used to alter the behavior of 
  6122.     IPF. For author-defined push buttons, this is the communication object that 
  6123.     will receive the HM_NOTIFY message.  For a Tutorial push button, this is 
  6124.     the communication object that will receive the HM_TUTORIAL message. 
  6125.  
  6126.  objectname=' ' 
  6127.     Identifies the entry point of the communication object in the dynamic-link 
  6128.     library.  The value for this attribute is case sensitive. 
  6129.  
  6130.  objectinfo=' ' 
  6131.     Identifies parameters to be passed to the object. 
  6132.  
  6133.  ctrlarea= 
  6134.     Defines the control areas in a window where you want to display push 
  6135.     buttons. For more information on control areas in a window, see Push 
  6136.     Buttons. 
  6137.  
  6138.     Possible values are: 
  6139.  
  6140.     page               Identifies the control area within the IPF text window. 
  6141.  
  6142.     coverpage          Identifies the control area as the bottom of the 
  6143.                        coverpage window.  This is the default value. 
  6144.  
  6145.     both               Specifies that you want a control area in both the IPF 
  6146.                        text window, and the coverpage window. 
  6147.  
  6148.     none               Specifies that you do not want a control area (that is, 
  6149.                        you do not want push buttons). 
  6150.  
  6151.  Description 
  6152.  
  6153.  :docprof. is placed at the beginning of the file. It follows the title tag 
  6154.  (:title.), if a title is specified; otherwise, it follows the user-document 
  6155.  tag (:userdoc.). 
  6156.  
  6157.  The :docprof. tag also provides the ability to alter the behavior of IPF by 
  6158.  loading any dynamic-link modules specified in the dll= attribute. It is 
  6159.  possible to have multiple windows and multiple entry points within a 
  6160.  dynamic-link module.  There is no guarantee that the ACVP structure that is 
  6161.  passed into the object will be maintained across multiple calls. 
  6162.  
  6163.  You also can use this tag to change the size and function of the coverpage and 
  6164.  its client and control windows. 
  6165.  
  6166.  The :docprof. tag can be used to define the control area in a window where you 
  6167.  want to display push buttons. 
  6168.  
  6169.  Conditions 
  6170.  
  6171.  None 
  6172.  
  6173.  Example 
  6174.  
  6175.   :userdoc.
  6176.   :title.
  6177.   :docprof toc=123 ctrlarea=none.
  6178.   :euserdoc.
  6179.  
  6180.  Output 
  6181.  
  6182.  When the user selects the "+" icon in the Contents window, heading levels 1 
  6183.  through 4 are displayed in a tree-structured format.  There are no push 
  6184.  buttons because of ctrlarea=none. 
  6185.  
  6186.  
  6187. ΓòÉΓòÉΓòÉ 8.17. :fig. (Figure) ΓòÉΓòÉΓòÉ
  6188.  
  6189. Purpose 
  6190.  
  6191. Identifies a figure. 
  6192.  
  6193. Syntax 
  6194.  
  6195. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6196. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  6197. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6198. Γöé:fig.          ΓöéAny text       Γöé               Γöé:efig.         Γöé
  6199. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6200.  
  6201. Attributes 
  6202.  
  6203. None 
  6204.  
  6205. Description 
  6206.  
  6207. :fig. indicates that what follows is to be formatted exactly as it is entered. 
  6208. Text that exceeds the window area will be clipped. 
  6209.  
  6210. The figure is displayed in proportional font, with a blank line preceding the 
  6211. text. Because proportional font is used, words will align, but letters and 
  6212. numbers may not. 
  6213.  
  6214. Conditions 
  6215.  
  6216. None 
  6217.  
  6218. Example 
  6219.  
  6220. :fig.
  6221.  Area   Number  Classification         Code
  6222. ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  6223.  JOB1
  6224.  
  6225.           2      Full-time exempt        1A
  6226.           4      Part-time exempt        1B
  6227.           4      Full-time nonexempt     2A
  6228.           1      Part-time nonexempt     2B
  6229.           2      Supplemental            3A
  6230.  
  6231. ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  6232. :efig.
  6233.  
  6234. Output 
  6235.  
  6236.  Area   Number  Classification         Code
  6237. ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  6238.  JOB1
  6239.  
  6240.           2      Full-time exempt        1A
  6241.           4      Part-time exempt        1B
  6242.           4      Full-time nonexempt     2A
  6243.           1      Part-time nonexempt     2B
  6244.           2      Supplemental            3A
  6245.  
  6246. ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  6247.  
  6248.  
  6249. ΓòÉΓòÉΓòÉ 8.18. :figcap.  (Figure Caption) ΓòÉΓòÉΓòÉ
  6250.  
  6251. Purpose 
  6252.  
  6253. Specifies a figure title. 
  6254.  
  6255. Syntax 
  6256.  
  6257. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6258. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  6259. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6260. Γöé:figcap.       ΓöéAny text       Γöé               Γöé               Γöé
  6261. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6262.  
  6263. Attributes 
  6264.  
  6265. None 
  6266.  
  6267. Description 
  6268.  
  6269. :figcap. is placed between :fig. and :efig.. The text of the caption goes on 
  6270. the same line as the tag, or on the next line. 
  6271.  
  6272. Conditions 
  6273.  
  6274.      Use :figcap. either immediately after :fig. or immediately before :efig.. 
  6275.      The text of the figure caption cannot contain tags or semicolons. 
  6276.  
  6277.  Example 
  6278.  
  6279.   :fig.
  6280.    Area   Number  Classification         Code
  6281.   ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  6282.    JOB2
  6283.  
  6284.            5      Full-time exempt        1A
  6285.            1      Part-time exempt        1B
  6286.            3      Full-time non-exempt    2A
  6287.            1      Part-time non-exempt    2B
  6288.            1      Supplemental            3A
  6289.  
  6290.   ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  6291.   :figcap.Payroll Codes for Area JOB2
  6292.   :efig.
  6293.  
  6294.  Output 
  6295.  
  6296.    Area   Number  Classification         Code
  6297.   ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  6298.    JOB2
  6299.  
  6300.            5      Full-time exempt        1A
  6301.            1      Part-time exempt        1B
  6302.            3      Full-time non-exempt    2A
  6303.            1      Part-time non-exempt    2B
  6304.            1      Supplemental            3A
  6305.  
  6306.   ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  6307.  
  6308.  Payroll Codes for Area JOB2 
  6309.  
  6310.  
  6311. ΓòÉΓòÉΓòÉ 8.19. :font. (Font) ΓòÉΓòÉΓòÉ
  6312.  
  6313. Purpose 
  6314.  
  6315. Changes the font to the specified typeface, size, and code page. 
  6316.  
  6317. Syntax 
  6318.  
  6319. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6320. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  6321. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6322. Γöé:font.         ΓöéFonts          Γöéfacename=      ΓöéNone           Γöé
  6323. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6324. Γöé               Γöé               Γöésize=          Γöé               Γöé
  6325. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6326. Γöé               Γöé               Γöécodepage=      Γöé               Γöé
  6327. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6328.  
  6329. Attributes 
  6330.  
  6331.  facename= 
  6332.     Defines the typeface name of the font. You can use any bit map font in the 
  6333.     system. 
  6334.  
  6335.     This attribute is required. If default is specified, the font is reset to 
  6336.     the default system font. 
  6337.  
  6338.     Notice that facename= values have initial capitals. These are required; 
  6339.     otherwise, the IPF compiler will not recognize them as valid values. No 
  6340.     error message is returned when an invalid value for facename= is 
  6341.     encountered. 
  6342.  
  6343.  
  6344.  size=hxw 
  6345.     Defines the average character height and width, in points, of the 
  6346.     Presentation Manager image font. (A point is a typesetting measure that is 
  6347.     equal to approximately 1/72 of an inch.) 
  6348.  
  6349.  
  6350.     Following are the Presentation Manager image fonts available on all 
  6351.     system-supported display adapters: 
  6352.  
  6353.         ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6354.         ΓöéFace           Γöé
  6355.         Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6356.         ΓöéCourier        Γöé
  6357.         Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6358.         ΓöéHelv           Γöé
  6359.         Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6360.         ΓöéTms Rmn        Γöé
  6361.         Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6362.         ΓöéSystem         Γöé
  6363.         ΓöéMonospaced     Γöé
  6364.         Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6365.         ΓöéSystem         Γöé
  6366.         ΓöéProportional   Γöé
  6367.         ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6368.  
  6369.     The size= attribute is required. If the value is set to 0x0, the font is 
  6370.     reset to the default system font. 
  6371.  
  6372.  
  6373.  codepage= 
  6374.     Specifies the code page to be used.  This is a three-digit number. Possible 
  6375.     values are: 
  6376.          437 - U.S. IBM PC 
  6377.          850 - Multilingual 
  6378.          860 - Portuguese 
  6379.          863 - Canadian French 
  6380.          865 - Nordic 
  6381.  
  6382.     See Country Code, Code Pages, and Language Parameters for a list of 
  6383.     countries and their code pages. 
  6384.  
  6385.     The codepage= attribute is optional.  If no code-page value is specified, 
  6386.     the code page of the active system process is used. 
  6387.  
  6388.  Description 
  6389.  
  6390.  :font changes the current font for the text within the current window. When a 
  6391.  heading tag defining a new window is encountered, the font resets to the 
  6392.  default system font. 
  6393.  
  6394.  You can make as many font changes within a window as you want. If you define 
  6395.  highlighted phrases while a font tag is in effect, the highlighted text will 
  6396.  be displayed in the font style corresponding to the specified typeface. 
  6397.  
  6398.  When you specify height and width values for a valid font name, you do not 
  6399.  have to know the exact point values.  If no match is found for a specified 
  6400.  font size, IPF uses a "best fit" method to select the font.  For example, 
  6401.  suppose you specify: 
  6402.  
  6403.   :font facename=Helv size=20x12.
  6404.  
  6405.  IPF selects "Helv 18x10" because it is the closest match. 
  6406.  
  6407.  
  6408. ΓòÉΓòÉΓòÉ 8.20. :fn. (Footnote) ΓòÉΓòÉΓòÉ
  6409.  
  6410. Purpose 
  6411.  
  6412. Identifies a pop-up window. 
  6413.  
  6414. Syntax 
  6415.  
  6416. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6417. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  6418. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6419. Γöé:fn.           ΓöéPop-up         Γöéid=            Γöé:efn.          Γöé
  6420. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6421.  
  6422. Attributes 
  6423.  
  6424.  id= 
  6425.     Specifies the ID of the footnote.  It is used in conjunction with the link 
  6426.     tag (see :link.  (Link)). 
  6427.  
  6428.  Description 
  6429.  
  6430.  The footnote tag encloses information that will be displayed in a pop-up 
  6431.  window when the user selects a hypertext link to the information. Footnotes 
  6432.  can appear within paragraphs, lists, highlighted phrases, and artwork. 
  6433.  
  6434.  Conditions 
  6435.  
  6436.      Index entries are not valid within a footnote. 
  6437.      The id= attribute is required. 
  6438.      One footnote must end before another begins. 
  6439.      A footnote cannot be linked from a child window. 
  6440.      Information in a footnote cannot be returned as the result of a search. 
  6441.  
  6442.  Example 
  6443.  
  6444.  The following shows how to enter the footnote ID (here "ddrive") and provide a 
  6445.  link to the footnote. 
  6446.  
  6447.   :fn id=ddrive.
  6448.   The information you place here appears in the pop-up window as a
  6449.   footnote.  For example, you could enter additional information
  6450.   about the disk drive in a footnote.
  6451.   :efn.
  6452.  
  6453.  To provide the link that allows the user to view the footnote pop-up, you 
  6454.  could enter: 
  6455.  
  6456.   :p.Additional information about
  6457.   :link refid=ddrive reftype=fn.disk drives:elink.
  6458.   is available.
  6459.  
  6460.  Output 
  6461.  
  6462.  When the information is displayed, disk drives is highlighted and clicking on 
  6463.  disk drives pops up the footnote window. 
  6464.  
  6465.  
  6466. ΓòÉΓòÉΓòÉ 8.21. :h1. through :h6.  (Headings) ΓòÉΓòÉΓòÉ
  6467.  
  6468. Purpose 
  6469.  
  6470. Define window characteristics. 
  6471.  
  6472. Syntax 
  6473.  
  6474. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6475. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  6476. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6477. Γöé:h1.-:h6.      ΓöéDefine cross   Γöéres=           Γöé               Γöé
  6478. Γöé               Γöéreferences to  Γöéid=            Γöé               Γöé
  6479. Γöé               Γöéinternal and   Γöéname=          Γöé               Γöé
  6480. Γöé               Γöéexternal       Γöéglobal         Γöé               Γöé
  6481. Γöé               Γöésources.       Γöétutorial=' '   Γöé               Γöé
  6482. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6483. Γöé               ΓöéDefine origin  Γöéx=             Γöé               Γöé
  6484. Γöé               Γöéand size of    Γöéy=             Γöé               Γöé
  6485. Γöé               Γöéwindows with   Γöéwidth=         Γöé               Γöé
  6486. Γöé               Γöérelation the   Γöéheight=        Γöé               Γöé
  6487. Γöé               Γöéprimary window.Γöé               Γöé               Γöé
  6488. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6489. Γöé               ΓöéManage the     Γöégroup=         Γöé               Γöé
  6490. Γöé               Γöédisplay of     Γöéviewport       Γöé               Γöé
  6491. Γöé               Γöéinformation in Γöéclear          Γöé               Γöé
  6492. Γöé               Γöémultiple       Γöé               Γöé               Γöé
  6493. Γöé               Γöéwindows.       Γöé               Γöé               Γöé
  6494. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6495. Γöé               ΓöéDefine the     Γöétitlebar=      Γöé               Γöé
  6496. Γöé               Γöéuser's control Γöéscroll=        Γöé               Γöé
  6497. Γöé               Γöéover the       Γöérules=         Γöé               Γöé
  6498. Γöé               Γöéwindow.        Γöé               Γöé               Γöé
  6499. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6500. Γöé               ΓöéRestrict user  Γöénosearch       Γöé               Γöé
  6501. Γöé               Γöéretrieval of   Γöénoprint        Γöé               Γöé
  6502. Γöé               Γöéinformation.   Γöéhide           Γöé               Γöé
  6503. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6504. Γöé               ΓöéChange heading Γöétoc=           Γöé               Γöé
  6505. Γöé               Γöélevels that    Γöé               Γöé               Γöé
  6506. Γöé               Γöéappear in the  Γöé               Γöé               Γöé
  6507. Γöé               ΓöéContents       Γöé               Γöé               Γöé
  6508. Γöé               Γöéwindow.        Γöé               Γöé               Γöé
  6509. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6510. Γöé               ΓöéDefine the     Γöéctrlarea=      Γöé               Γöé
  6511. Γöé               Γöécontrol area ofΓöéctrlrefid=     Γöé               Γöé
  6512. Γöé               Γöéa window for   Γöé               Γöé               Γöé
  6513. Γöé               Γöédisplaying pushΓöé               Γöé               Γöé
  6514. Γöé               Γöébuttons.       Γöé               Γöé               Γöé
  6515. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6516.  
  6517. Attributes 
  6518.  
  6519.   res=
  6520.   id=
  6521.   name=
  6522.     Specify window identifiers. 
  6523.  
  6524.     If you are creating an .HLP file, res= is required and can be any integer 
  6525.     from 1 through 64 000. However, if you are creating an .INF file (compiled 
  6526.     by specifying the /INF parameter with the IPFC command), you can use res=, 
  6527.     name= or id=. With name= and id=, you can include alphabetic characters. 
  6528.     You cannot use these attributes if you plan to concatenate .INF files. 
  6529.     Instead, you must use res=. For more information see Concatenating .INF 
  6530.     Files. 
  6531.  
  6532.  global 
  6533.     Indicates to IPF that the window can be a reference in an external database 
  6534.     (another IPF .HLP or .INF file). A reference from one IPF database to 
  6535.     another is made by specifying reftype=hd and database='filename' with the 
  6536.     link tag. 
  6537.  
  6538.  tutorial=' ' 
  6539.     Specifies the file name of the tutorial and causes the tutorial choice to 
  6540.     be added to the help pull-down when the window is displayed.  When the user 
  6541.     selects Tutorial, the HM_TUTORIAL message specifying the file name of the 
  6542.     tutorial is sent to the application. An example of the tagging follows: 
  6543.  
  6544.         :h1 tutorial='example.exe'.Test Window
  6545.  
  6546.   x=
  6547.   y=
  6548.   width=
  6549.   height=
  6550.     Define the size and position of a window. The x= and y= attributes are 
  6551.     values along the x and y axes; they define the origin of the window. The x 
  6552.     axis runs horizontally from left to right, and the y axis runs vertically 
  6553.     from bottom to top. The position where the values specified for x= and y= 
  6554.     intersect is the the origin of the window. (The 0,0 intersection is the 
  6555.     bottom left corner of the parent window.) From this location, width and 
  6556.     height are measured. For more information about window coordinates, see 
  6557.     Defining Window Origin and Size. 
  6558.  
  6559.     Size and position attributes can be given in absolute, dynamic, or relative 
  6560.     values: 
  6561.  
  6562.     Absolute value: 
  6563.             A number followed by a letter, which indicates the unit of measure: 
  6564.  
  6565.             c           (Characters):  Average character width of the default 
  6566.                         system font. 
  6567.             x           (Pixels):  Dependent on the display adapter in use. 
  6568.             p           ( Points):  Typesetting measure; equal to approximately 
  6569.                         1/72 inch. 
  6570.  
  6571.     Relative value: 
  6572.             A number followed by the percent sign (%), indicating a percentage 
  6573.             of the parent-window width or height. 
  6574.  
  6575.     Dynamic value: 
  6576.             A term indicating a window coordinate location that is dependent on 
  6577.             the current size and position of the primary window: 
  6578.  
  6579.             center | left | right 
  6580.                      For x= values:  In the center of, flush left in, or flush 
  6581.                      right in the parent window. 
  6582.  
  6583.             center | top | bottom 
  6584.                      For y= values:  In the center of, at the top of, or at the 
  6585.                      bottom of the parent window. 
  6586.  
  6587.     Restrictions: 
  6588.             When defining window position and size, you cannot mix absolute 
  6589.             values with dynamic or relative values for either of the following 
  6590.             combinations of attributes: 
  6591.  
  6592.                 The x coordinate and the width 
  6593.                 The y coordinate and the height. 
  6594.  
  6595.             If no values for x= and y= are specified, the origin of the window 
  6596.             is 0,0. If you specify values other than 0,0, you also must specify 
  6597.             width and height values.  Negative values for these attributes are 
  6598.             not allowed. 
  6599.  
  6600.   group=
  6601.   viewport
  6602.   clear
  6603.     The group= attribute enables you to assign the window a number from 1 
  6604.     through 64 000. This associates the window with a heading definition and 
  6605.     the IPFC information that follows it. If you do not provide a number with 
  6606.     group=, IPF assigns the number 0. 
  6607.  
  6608.     A group number can be assigned to a viewport by a heading or link 
  6609.     definition. For example, suppose you have a group number specified in a 
  6610.     link definition, and another in the heading that the link refers to. If a 
  6611.     user action causes the link definition to be selected, the link group 
  6612.     number overrides the heading group number.  However, if the user selects 
  6613.     the heading from either the Contents window or the Index window, the 
  6614.     heading group number takes effect. 
  6615.  
  6616.     IPF searches among the open windows to find one with a number matching the 
  6617.     one specified with group=. If no match is found, IPF opens a new window. If 
  6618.     a match is found, the information associated with the group number is 
  6619.     swapped with the information in the matched window. 
  6620.  
  6621.     The viewport attribute always opens a window.  If you specify both viewport 
  6622.     and group=, and a window with the specified group number is already open, 
  6623.     IPF opens another window with the same group number. Thus, it is better 
  6624.     that you do not specify the viewport attribute in a heading that will 
  6625.     appear in the Contents window, unless you want your contents entries to 
  6626.     always open separate windows. 
  6627.  
  6628.     The clear attribute causes IPF to close any open windows before opening a 
  6629.     window to display the current window. 
  6630.  
  6631.   titlebar=yes | sysmenu | minmax | both | none
  6632.   rules=border | sizeborder | none
  6633.   scroll=horizontal | vertical | both | none
  6634.     These attributes define Presentation Manager window controls and are used 
  6635.     primarily when defining secondary windows. If none of these attributes are 
  6636.     specified, the default is to open a window that has a title bar with title 
  6637.     bar icon, hide button, maximize button; a sizing border; and vertical and 
  6638.     horizontal scroll bars. 
  6639.  
  6640.   nosearch
  6641.   noprint
  6642.   hide
  6643.     These attributes restrict information retrieval and are most often used in 
  6644.     heading definitions for secondary windows. 
  6645.  
  6646.     The nosearch attribute in a secondary heading definition prevents the 
  6647.     heading from being returned as an entry in the search-results window. This 
  6648.     does not mean the secondary window is not searched.  It is, however, only 
  6649.     the primary heading definition that is returned. When the user selects the 
  6650.     primary heading definition, the contents of the second window are displayed 
  6651.     as part of the primary-window composition. 
  6652.  
  6653.     The noprint attribute in a secondary heading definition prevents the 
  6654.     contents of a secondary window from being printed as a separate entity. 
  6655.     Instead, secondary windows are printed as part of their primary window. The 
  6656.     contents of secondary windows are printed in the order in which the link 
  6657.     definitions are listed in the primary window. 
  6658.  
  6659.     When used in secondary heading definitions, nosearch and noprint merely 
  6660.     prevent duplication of output (search results or printed copy). When used 
  6661.     in regular heading definitions, they prevent retrieval of the information 
  6662.     by the user.  The only exception to this condition is if the user selects 
  6663.     This section for either printing or searching. 
  6664.  
  6665.     The hide attribute prevents a heading level from appearing in the Contents 
  6666.     window; however, there must be at least one heading level that is not 
  6667.     hidden. 
  6668.  
  6669.  toc= 
  6670.     Specifies heading levels that are to be entries in the Contents window. 
  6671.     When this attribute is encountered in a heading tag, the specified heading 
  6672.     levels override any levels specified by toc= of the document-profile tag 
  6673.     (:docprof.) until either the end-of-file is reached or another toc= 
  6674.     attribute is encountered in a heading tag.  If no document-profile tag 
  6675.     exists, the heading levels that appear in the Contents window are levels 1, 
  6676.     2, and 3. The toc= attribute must be greater than zero. 
  6677.  
  6678.  ctrlarea= 
  6679.     Specifies which control area in a window you want to display push buttons. 
  6680.     When this attribute is encountered in a heading tag, it overrides the 
  6681.     ctrlarea attribute specified by :docprof..  Possible values are: 
  6682.  
  6683.     page         Identifies the control area as the IPF text window. 
  6684.     none         Specifies that you do not want a control area. 
  6685.  
  6686.     For example, if your document consisted of 100 windows, and you wanted only 
  6687.     one window to display push buttons in the IPF text window, you would tag 
  6688.     your source file as follows: 
  6689.  
  6690.         :docprof ctrlarea=none.
  6691.         .
  6692.         .
  6693.         .
  6694.         :h1 ctrlarea=page.One Window
  6695.  
  6696.  ctrlrefid= 
  6697.     Refers to the identification value (id=) specified by the control area tag 
  6698.     (:ctrl.).  This attribute specifies which control area you want to display 
  6699.     for this heading.  This attribute is used to override the default control 
  6700.     area (the coverpage window). 
  6701.  
  6702.  Note:  Be careful when using heading tags to define a control area for split 
  6703.         windows. A control area cannot be defined in the secondary window 
  6704.         heading tag of a split window. You must define the control area (the 
  6705.         coverpage window) in the primary window heading tag. 
  6706.  
  6707.  
  6708. ΓòÉΓòÉΓòÉ 8.22. :hdref. (Heading Reference) ΓòÉΓòÉΓòÉ
  6709.  
  6710. Purpose 
  6711.  
  6712. Places a hypertext link to a heading.  The text displayed within the link is 
  6713. the word "Reference". 
  6714.  
  6715. Syntax 
  6716.  
  6717. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6718. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  6719. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6720. Γöé:hdref.        ΓöéHeading        Γöéres=           Γöé               Γöé
  6721. Γöé               ΓöéReference      Γöé               Γöé               Γöé
  6722. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6723. Γöé               Γöé               Γöérefid=         Γöé               Γöé
  6724. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6725.  
  6726. Attributes 
  6727.  
  6728.  res= 
  6729.     Resource identification number of the heading to link to. 
  6730.  
  6731.  
  6732.  refid= 
  6733.     ID of the heading to link to. 
  6734.  
  6735.  
  6736. ΓòÉΓòÉΓòÉ 8.23. :hide.  (Hide) ΓòÉΓòÉΓòÉ
  6737.  
  6738. Purpose 
  6739.  
  6740. Controls display of IPF text and graphics to meet conditions set by the 
  6741. IPF_KEYS= environment variable. 
  6742.  
  6743. Syntax 
  6744.  
  6745. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6746. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  6747. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6748. Γöé:hide.         ΓöéHide           Γöékey=           Γöé:ehide.        Γöé
  6749. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6750.  
  6751. Attributes 
  6752.  
  6753.  key=' ' 
  6754.     Defines the key that enables a user to view hidden information. You can 
  6755.     specify one or more key names.  Enclose each key name within apostrophes. 
  6756.     When specifying more than one key name, insert a plus (+) sign after each 
  6757.     name. 
  6758.  
  6759.     Text entered between the :hide. and :ehide. tags is only displayed when the 
  6760.     key='' attribute matches the entry specified by the user.  Use the OS/2 
  6761.     environment variable SET IPF_KEYS= to specify the key name identified for 
  6762.     the hidden information.                          set in 
  6763.  
  6764.     If this attribute is not specified, the information identified by the hide 
  6765.     tag is displayed. 
  6766.  
  6767.  
  6768.  Description 
  6769.  
  6770.  :hide. enables you to determine what text and graphics will be displayed 
  6771.  within a window. This function is useful when you want to tailor the 
  6772.  information you give to users; for example, if you want to display levels of 
  6773.  information on the basis of a user's system configuration, you assign each 
  6774.  level a value with the key= attribute. When a topic containing hide tags is 
  6775.  selected for viewing, IPF will look for an environment variable called 
  6776.  IPF_KEYS= to determine what level of information to show the user. If a match 
  6777.  is found, the information within the hide tags is displayed; otherwise, the 
  6778.  information is hidden from view. 
  6779.  
  6780.  The hide tag affects the display of compiled information. You can hide lines 
  6781.  of text within the window, a word or a phrase within a line, or you can hide 
  6782.  an instruction to display a bit map, as in the following example. 
  6783.  
  6784.   :hide key='level1'.
  6785.   :artwork name='mybitmap.bmp'.
  6786.   :ehide.
  6787.  
  6788.  If the user's environment does not contain the key to display the hidden 
  6789.  information, IPF wraps the text from the last character or formatting 
  6790.  instruction on the line preceding :hide. to the line following :ehide.. 
  6791.  
  6792.  In some situations, the same user may need to view more than one level of 
  6793.  hidden information.  This can be accomplished by setting the IPF_KEYS= to 
  6794.  concatenated values; for example: 
  6795.  
  6796.   SET IPF_KEYS=LEVEL1+LEVEL2
  6797.  
  6798.  Take care that a window view does not contain an orphan tag. For example, you 
  6799.  do not want to hide the information following a list item, unless you have 
  6800.  alternate information to display, based on the setting of a key. In the case 
  6801.  of an ordered list, which generates sequential numbers, you would not include 
  6802.  a list item in the hidden information, unless it is the last item in the list. 
  6803.  
  6804.  Conditions 
  6805.  
  6806.      You cannot nest one set of hide tags within another. 
  6807.      You cannot include a heading tag that has a res= attribute within a set 
  6808.       of hide tags. 
  6809.      You cannot set IPF_KEYS= on a session basis. 
  6810.  
  6811.  Example 
  6812.  
  6813.  Suppose the following source has been compiled as part of a help library file: 
  6814.  
  6815.   :h1 res=001.Installation Procedure
  6816.   :ol.
  6817.   :li.
  6818.   :hide key='usera'.
  6819.   Instruction for User A.
  6820.   :ehide.
  6821.   :hide key='userb'.
  6822.   Instruction for User B.
  6823.   :ehide.
  6824.   :li.
  6825.   Shut down the system from the Desktop.
  6826.   :li.
  6827.   Press Ctl+Alt+Del to restart the system.
  6828.   :eol.
  6829.  
  6830.  If the user's environment includes the setting, IPF_KEYS=USERA, the following 
  6831.  is displayed: 
  6832.  
  6833.    1. Instruction for User A. 
  6834.  
  6835.    2. Shut down the system from the desk top. 
  6836.  
  6837.    3. Press Ctl+Alt+Del to restart the system. 
  6838.  
  6839.  
  6840. ΓòÉΓòÉΓòÉ 8.24. :hp1. through :hp9.  (Highlighted Phrase) ΓòÉΓòÉΓòÉ
  6841.  
  6842. Purpose 
  6843.  
  6844. Emphasize text by changing the font style or foreground color. 
  6845.  
  6846. Syntax 
  6847.  
  6848. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6849. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  6850. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6851. Γöé:hpn.          ΓöéHighlighting   ΓöéNone           Γöé:ehpn.         Γöé
  6852. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6853.  
  6854. Description 
  6855.  
  6856. Highlighted-phrase tags are useful for emphasizing words and phrases within 
  6857. text. 
  6858.  
  6859. Font styles that are displayed for highlighted phrases correspond to the 
  6860. typeface currently being used by IPF.  To change from the default system 
  6861. typeface to other typefaces, use :font. When you use either the example tag 
  6862. (:xmp.), the character-graphics tag (:cgraphic.) or the table tag (:table.), 
  6863. the system monospace typeface is displayed. 
  6864.  
  6865. Input 
  6866.  
  6867. :sl compact.
  6868. :li.:hp1.Highlighted phrase 1 looks like this.:ehp1.
  6869. :li.:hp2.Highlighted phrase 2 looks like this.:ehp2.
  6870. :li.:hp3.Highlighted phrase 3 looks like this.:ehp3.
  6871. :li.:hp4.Highlighted phrase 4 looks like BLUE.:ehp4.
  6872. :li.:hp5.Highlighted phrase 5 looks like this.:ehp5.
  6873. :li.:hp6.Highlighted phrase 6 looks like this.:ehp6.
  6874. :li.:hp7.Highlighted phrase 7 looks like this.:ehp7.
  6875. :li.:hp8.Highlighted phrase 8 looks like RED.:ehp8.
  6876. :li.:hp9.Highlighted phrase 9 looks like PINK.:ehp9.
  6877. :esl.
  6878.  
  6879. System Default Font Output 
  6880.  
  6881.       Highlighted phrase 1 looks like this. 
  6882.       Highlighted phrase 2 looks like this. 
  6883.       Highlighted phrase 3 looks like this. 
  6884.       Highlighted phrase 4 looks like this. 
  6885.       Highlighted phrase 5 looks like this. 
  6886.       Highlighted phrase 6 looks like this. 
  6887.       Highlighted phrase 7 looks like this. 
  6888.       Highlighted phrase 8 looks like this. 
  6889.       Highlighted phrase 9 looks like this. 
  6890.  
  6891.  Conditions 
  6892.  
  6893.  You cannot nest highlighted-phrase tags. 
  6894.  
  6895.  
  6896. ΓòÉΓòÉΓòÉ 8.25. :i1. and :i2.  (Index) ΓòÉΓòÉΓòÉ
  6897.  
  6898. Purpose 
  6899.  
  6900. Place topics into the index. 
  6901.  
  6902. Syntax 
  6903.  
  6904. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6905. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  6906. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6907. Γöé:i1.           ΓöéPrimary entry  Γöéid=            Γöé               Γöé
  6908. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6909. Γöé               Γöé               Γöéglobal         Γöé               Γöé
  6910. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6911. Γöé               Γöé               Γöéroots=' '      Γöé               Γöé
  6912. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6913. Γöé               Γöé               Γöésortkey=' '    Γöé               Γöé
  6914. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6915. Γöé:i2.           ΓöéSecondary entryΓöérefid=         Γöé               Γöé
  6916. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6917. Γöé               Γöé               Γöéglobal         Γöé               Γöé
  6918. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6919. Γöé               Γöé               Γöésortkey=' '    Γöé               Γöé
  6920. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6921.  
  6922. Attributes 
  6923.  
  6924.  id= 
  6925.     Provides a cross-reference identifier for the secondary index tag (:i2.). 
  6926.     This attribute is optional and only valid when used with the primary index 
  6927.     tag (:i1.). 
  6928.  
  6929.  global 
  6930.     Specifies that the index entry can appear in any MIndex Object depending on 
  6931.     where you install the file and how each MIndex Object is set up.  Entries 
  6932.     also appear in the component index. This attribute is only used in Help 
  6933.     windows.  Online document cannot use this attribute. 
  6934.  
  6935.  roots='root words' 
  6936.     Specifies a list of root words that act as index entries to specified 
  6937.     topics. These root words are associated with words defined with the 
  6938.     index-synonym tag (:isyn.). Root words can contain alphabetic and numeric 
  6939.     characters, which can be entered in uppercase or lowercase. When entering a 
  6940.     string of words, insert a blank space between each word, and enclose the 
  6941.     string within apostrophes. 
  6942.  
  6943.     Root words do not appear in the index, so are not viewed by the user, and 
  6944.     need not be translated. They are used to create a link between the primary 
  6945.     index tag and the index-synonym tag. To enable the user to search for an 
  6946.     index entry, use the index-synonym tag to map the root words associated 
  6947.     with the entry to synonyms. 
  6948.  
  6949.  sortkey='sortkey-text'.index-text 
  6950.     Specifies a character string that is used for sorting the entry in the 
  6951.     index, and another character string that is displayed for the index entry. 
  6952.  
  6953.     The sortkey-text character string determines where this entry is placed in 
  6954.     the index. The index-text character string is displayed for the index 
  6955.     entry. 
  6956.  
  6957.  refid= 
  6958.     Provides a reference to the text associated with the primary index tag. 
  6959.  
  6960.  Description 
  6961.  
  6962.  You use the primary and secondary index tags to provide index entries to the 
  6963.  information. The attributes associated with each index tag enable you to 
  6964.  define related information.  Index entries can be used throughout the file, 
  6965.  but cannot be placed within a footnote. 
  6966.  
  6967.  The text of the index entry must be on the same line as the tag, and cannot 
  6968.  contain other tags.  The entry for each primary index entry within the window 
  6969.  must be unique.  That is, you cannot provide duplicate index entries within 
  6970.  the same window. Secondary index entries must refer to an identifier specified 
  6971.  for a primary index entry. 
  6972.  
  6973.  When the user selects Help index from the Help menu, an Index window is 
  6974.  displayed for the help interface. When the user selects Index from the Options 
  6975.  menu, an Index window is displayed for the online information interface. If 
  6976.  the user enters a synonym that matches a root word, the index topics listed 
  6977.  for the root word are displayed. When the user selects the Master Help Index 
  6978.  object from the Desktop, it opens to display an alphabetic list of entries 
  6979.  within a spiral bound notebook.  For more information, see Master Help Index 
  6980.  and Glossary 
  6981.  
  6982.  Conditions 
  6983.  
  6984.      Index entries cannot appear in a footnote. 
  6985.      When referencing the :i1. tag, use the global attribute on both the :i1. 
  6986.       and :i2. tag. 
  6987.  
  6988.  Example 1 
  6989.  
  6990.  This example shows how to tag your file to include primary and secondary index 
  6991.  entries. 
  6992.  
  6993.   :i1 id=del.delete
  6994.   :i2 refid=del.directories
  6995.   :i2 refid=del.files
  6996.  
  6997.  Output 
  6998.  
  6999.  The index will include the following entry: 
  7000.  
  7001.    delete
  7002.      directories
  7003.      files
  7004.  
  7005.  Example 2 
  7006.  
  7007.  This example shows a file with the index-synonym tag (:isyn.) and the roots= 
  7008.  attribute. 
  7009.  
  7010.   :h1 id=copy03.Help for Copying
  7011.   :isyn root=copy.copy copying duplicate duplicating
  7012.   :isyn root=book.book manual draft manuscript
  7013.   :isyn root=folder.folder folders document documents
  7014.   :i1 roots='copy folder'.Copying a document
  7015.   :i1 roots='book folder'.Test procedures
  7016.   :p.When copying a file from the current directory to a new
  7017.   directory, specify the following:
  7018.   :ul.
  7019.   :li.The file name
  7020.   :li.The target directory
  7021.   :li.The new file name and extension.
  7022.   :eul.
  7023.  
  7024.  Output 
  7025.  
  7026.  The index-synonym tag creates the following synonym table: 
  7027.  
  7028.  Root word     Synonym words 
  7029.  
  7030.  copy          copy copying duplicate duplicating 
  7031.  
  7032.  book          book manual draft manuscript 
  7033.  
  7034.  folder        folder folders document documents 
  7035.  
  7036.  The roots= attribute points to the root words, "copy" and "folder," and the 
  7037.  list of associated synonyms.  For example, if the user searches for "copy" or 
  7038.  "folder," the "Copying a document" entry appears because "copy" and "folder," 
  7039.  identified by the index roots= attribute, match the entries listed for the 
  7040.  index synonym root= attribute. 
  7041.  
  7042.  A search for the synonym "duplicate" lists "Copying a document" as one of the 
  7043.  index choices. A search for the synonym "manual" lists "Test procedures" as an 
  7044.  index choice, and a search for "document" lists both "Copying a document" and 
  7045.  "Test procedures." 
  7046.  
  7047.  Example 3 
  7048.  
  7049.  This example shows how to specify a sort key to change the location of the 
  7050.  entry in the index. 
  7051.  
  7052.   :i1 sortkey='point sizes'.changing fonts
  7053.   :i1.program header
  7054.   :i1.parameter list
  7055.   :i1.preface
  7056.  
  7057.  Output 
  7058.  
  7059.  The index will include the entry "changing fonts" at the location where the 
  7060.  term "point sizes" would appear in the sorting sequence of the index, as 
  7061.  follows: 
  7062.  
  7063.   parameter list
  7064.   changing fonts
  7065.   preface
  7066.   program header
  7067.  
  7068.  Example 4 
  7069.  
  7070.  This example is for a simple Master Help Index object entry for conceptual 
  7071.  information about batch files. 
  7072.  
  7073.       :i1 global.batch files, creating 
  7074.  When referring to an :i1. tag, use the global attribute in both the :i1. and 
  7075.  :i2. tags.  For example: 
  7076.  
  7077.             :i1 id=copy global.copying
  7078.  
  7079.             :i2 refid=copy global.help topics
  7080.  
  7081.             :i2 refid=copy global.document topics
  7082.  
  7083.  When the IPF compiler encounters global attributes, it creates an alphabetic 
  7084.  list, which can then be accessed by selecting Master Help Index object from 
  7085.  the Desktop. 
  7086.  
  7087.  
  7088. ΓòÉΓòÉΓòÉ 8.26. :icmd.  (Index Command) ΓòÉΓòÉΓòÉ
  7089.  
  7090. Purpose 
  7091.  
  7092. Identifies the help window that describes a command. 
  7093.  
  7094. Syntax 
  7095.  
  7096. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7097. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  7098. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7099. Γöé:icmd.         ΓöéIndex command  Γöéexternal       Γöé               Γöé
  7100. Γöé               Γöé               Γöécommand string Γöé               Γöé
  7101. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7102.  
  7103. Attributes 
  7104.  
  7105.  external-command-string 
  7106.     Specifies the command for which help is being defined. The text can contain 
  7107.     no other tags. 
  7108.  
  7109.  Description 
  7110.  
  7111.  The help information for a command is assumed to be in the help window in 
  7112.  which the index-command tag (:icmd.) is defined.  If the help window provides 
  7113.  help for more than one command, an index-command tag should be defined within 
  7114.  the heading tag for each command. 
  7115.  
  7116.  The same external command string cannot be specified in more than one 
  7117.  index-command tag of an index file; that is, only one help window can be 
  7118.  designated as describing a command. 
  7119.  
  7120.  If the compiler finds the same external command string more than once (either 
  7121.  from the same or different help windows), the duplicate occurrences are 
  7122.  discarded, and a warning message is issued. 
  7123.  
  7124.  Note:  The association with entry field and command names is a programming 
  7125.         task.  In addition, the application developer must define the field 
  7126.         with which command windows are to be associated as a command entry 
  7127.         field.  For more information about programming a command entry field, 
  7128.         see Command Entry Field. 
  7129.  
  7130.  Conditions 
  7131.  
  7132.  :icmd. must follow a heading tag or another index tag. 
  7133.  
  7134.  Example 
  7135.  
  7136.   :h1 id=xhlp.Help for Copying
  7137.   :icmd.Copying
  7138.   :h1 res=129.Deleting Files
  7139.   :icmd.Delete
  7140.  
  7141.  Output 
  7142.  
  7143.  At execution time, the index entries enable the compiler to process command 
  7144.  helps, create a list of commands for which help is available, and display the 
  7145.  help window defined for any of those commands. 
  7146.  
  7147.  
  7148. ΓòÉΓòÉΓòÉ 8.27. :isyn.  (Index Synonym) ΓòÉΓòÉΓòÉ
  7149.  
  7150. Purpose 
  7151.  
  7152. Identifies synonyms and word variations for the help keywords. 
  7153.  
  7154. Syntax 
  7155.  
  7156. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7157. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  7158. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7159. Γöé:isyn.         ΓöéIndex synonyms Γöéroot=          Γöé               Γöé
  7160. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7161.  
  7162. Attributes 
  7163.  
  7164.  root= 
  7165.     Links synonyms and variations of words specified in a primary index tag. 
  7166.  
  7167.     To establish a link, specify the same word as specified in the roots= 
  7168.     attribute of the primary index tag.  Then add a period, repeat the root 
  7169.     word, and add the list of synonyms and variations, separated by blanks. 
  7170.     For example, assume that the value specified for the roots= attribute of 
  7171.     the primary index tag is "copy."  The entry for the index-synonym tag could 
  7172.     be: 
  7173.  
  7174.         :isyn root=copy.copy copying duplicate duplicating
  7175.  
  7176.     The words entered in the synonym list enable the user to search for terms 
  7177.     that may not be in the Index list, and still receive the appropriate help. 
  7178.     Lowercase and uppercase characters are treated the same. 
  7179.  
  7180.  Description 
  7181.  
  7182.  :isyn. begins a list of synonyms or variations of a word specified by a 
  7183.  primary index tag. The compiler uses this list to build a table that serves as 
  7184.  a link to the primary index tags. Synonyms determine the topic entries 
  7185.  displayed when the user enters words for a search of the index. The compiler 
  7186.  matches the entered words with words in the table and links to the topics to 
  7187.  be displayed. 
  7188.  
  7189.  The index-synonym tag can be placed within any window that contains related 
  7190.  index entries identified by the index tag. The synonyms defined in a window 
  7191.  can relate to many topics, and thus to many windows. 
  7192.  
  7193.  Synonyms defined with this tag do not appear in the index. 
  7194.  
  7195.  Conditions 
  7196.  
  7197.  A root word can contain only alphabetic and numeric characters. 
  7198.  
  7199.  Example 
  7200.  
  7201.   :h1 id=copy03.Help for Copying
  7202.   :isyn root=copy.copy copying duplicate duplicating
  7203.   :isyn root=folder.folder folders document documents
  7204.   :i1 roots='copy folder'.Copying a document
  7205.   :p.When copying a file from the current directory to a new
  7206.   directory, specify the following:
  7207.   :ul.
  7208.   :li.The file name
  7209.   :li.The target directory
  7210.   :li.The new file name and extension
  7211.   :eul.
  7212.  
  7213.  Output 
  7214.  
  7215.  The index-synonym tag creates the following synonym table: 
  7216.  
  7217.  Root word      Synonym words 
  7218.  
  7219.  copy           copy copying duplicate duplicating 
  7220.  
  7221.  folder         folder folders document documents 
  7222.  
  7223.  The roots= attribute points to the root words, "copy" and "folder," and the 
  7224.  list of associated synonyms.  If the user searches for "copy" or "folder," the 
  7225.  words will be displayed because of the matches between the roots= attribute of 
  7226.  the primary index tag and the root= attribute of the index-synonym tag. 
  7227.  However, a search for the synonym "duplicate" returns "Copying a document" as 
  7228.  an index choice. 
  7229.  
  7230.  
  7231. ΓòÉΓòÉΓòÉ 8.28. :li.  (List Item) ΓòÉΓòÉΓòÉ
  7232.  
  7233. Purpose 
  7234.  
  7235. Identifies an item within a list. 
  7236.  
  7237. Syntax 
  7238.  
  7239. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7240. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  7241. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7242. Γöé:li.           ΓöéList item      Γöé               Γöé               Γöé
  7243. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7244.  
  7245. Attributes 
  7246.  
  7247. None 
  7248.  
  7249. Description 
  7250.  
  7251. The format of the list items depends on the type of list:  ordered, unordered, 
  7252. or simple.  For example, if the list is an ordered list, a number precedes each 
  7253. list item.  If the list is an unordered list, a bullet precedes each item. See 
  7254. :ol.  (Ordered List), :sl.  (Simple List), and :ul.  (Unordered List) for more 
  7255. information. 
  7256.  
  7257. Conditions 
  7258.  
  7259. None 
  7260.  
  7261. Example 
  7262.  
  7263. :p.To remove a diskette&colon.
  7264. :ol.
  7265. :li.Open the drive door.
  7266. :li.Remove the diskette.
  7267. :li.Put the diskette in a safe place.
  7268. :eol.
  7269.  
  7270. Output 
  7271.  
  7272. To remove a diskette: 
  7273.  
  7274.    1. Open the drive door. 
  7275.  
  7276.    2. Remove the diskette. 
  7277.  
  7278.    3. Put the diskette in a safe place. 
  7279.  
  7280.  
  7281. ΓòÉΓòÉΓòÉ 8.29. :lines.  (Lines) ΓòÉΓòÉΓòÉ
  7282.  
  7283. Purpose 
  7284.  
  7285. Turns formatting off. 
  7286.  
  7287. Syntax 
  7288.  
  7289. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7290. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  7291. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7292. Γöé:lines.        ΓöéLines          Γöéalign=         Γöé:elines.       Γöé
  7293. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7294.  
  7295. Attributes 
  7296.  
  7297.  align=leftΓöérightΓöécenter 
  7298.     Places the entered lines to the left in the window, to the right, or in the 
  7299.     center. 
  7300.  
  7301.  Description 
  7302.  
  7303.  :lines. specifies that the following text is to be formatted exactly as it is 
  7304.  entered. The attributes enable you to align the text within the window. Text 
  7305.  that is too long for the window is clipped. 
  7306.  
  7307.  Proportional fonts are used for formatting, so the text may not be displayed 
  7308.  exactly as entered. 
  7309.  
  7310.  Conditions 
  7311.  
  7312.  None 
  7313.  
  7314.  Example 1 
  7315.  
  7316.  This example aligns text to the left. 
  7317.  
  7318.   :lines align=left.
  7319.   The warehouse contained:
  7320.     12  desks
  7321.     28  chairs
  7322.     15  lamps
  7323.     39  typewriters
  7324.     11  pictures
  7325.   :elines.
  7326.  
  7327.  Example 2 
  7328.  
  7329.  This example aligns text to the right. 
  7330.  
  7331.   :lines align=right.
  7332.   The warehouse contained:
  7333.     12  desks
  7334.     28  chairs
  7335.     15  lamps
  7336.     39  typewriters
  7337.     11  pictures
  7338.   :elines.
  7339.  
  7340.  Output 
  7341.  
  7342.  The following output is provided. 
  7343.  
  7344.  Example 1 
  7345.  
  7346.   The warehouse contained:
  7347.    12  desks
  7348.    28  chairs
  7349.    15  lamps
  7350.    39  typewriters
  7351.    11  pictures
  7352.  
  7353.  Example 2 
  7354.  
  7355.                                                         The warehouse contained:
  7356.                                                                        12  desks
  7357.                                                                       28  chairs
  7358.                                                                        15  lamps
  7359.                                                                  39  typewriters
  7360.                                                                     11  pictures
  7361.  
  7362.  
  7363. ΓòÉΓòÉΓòÉ 8.30. :link.  (Link) ΓòÉΓòÉΓòÉ
  7364.  
  7365. Purpose 
  7366.  
  7367. Activates a link to additional information. 
  7368.  
  7369. Syntax 
  7370.  
  7371. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7372. ΓöéTag            ΓöéElements       ΓöéAttributes     ΓöéEnd            Γöé
  7373. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7374. Γöé:link.         ΓöéLink to more   Γöéreftype=       Γöé:elink.        Γöé
  7375. Γöé               Γöéinformation    Γöéres=           Γöé               Γöé
  7376. Γöé               Γöé               Γöérefid=         Γöé               Γöé
  7377. Γöé               Γöé               Γöédatabase=' '   Γöé               Γöé
  7378. Γöé               Γöé               Γöéobject=' '     Γöé               Γöé
  7379. Γöé               Γöé               Γöédata=' '       Γöé               Γöé
  7380. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7381. Γöé               ΓöéAutomatic      Γöéauto           Γöé               Γöé
  7382. Γöé               Γöélinking        Γöéviewport       Γöé               Γöé
  7383. Γöé               Γöé               Γöédependent      Γöé               Γöé
  7384. Γöé               Γöé               Γöésplit          Γöé               Γöé
  7385. Γöé               Γöé               Γöéchild          Γöé               Γöé
  7386. Γöé               Γöé               Γöégroup=         Γöé               Γöé
  7387. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7388. Γöé               ΓöéDefine window  Γöévpx=           Γöé               Γöé
  7389. Γöé               Γöéposition and   Γöévpy=           Γöé               Γöé
  7390. Γöé               Γöésize           Γöévpcx=          Γöé               Γöé
  7391. Γöé               Γöé               Γöévpcy=          Γöé               Γöé
  7392. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7393. Γöé               ΓöéDefine window  Γöétitlebar=      Γöé               Γöé
  7394. Γöé               Γöécontrols       Γöéscroll=        Γöé               Γöé
  7395. Γöé               Γöé               Γöérules=         Γöé               Γöé
  7396. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7397.  
  7398. Attributes 
  7399.  
  7400.  reftype= 
  7401.     Defines the type of link.  Possible values are hd, fn, launch, and inform. 
  7402.     reftype=hd 
  7403.             Links to a heading.  The heading definition (or an overriding 
  7404.             definition in the link) causes its information to be displayed in 
  7405.             the current window or another window. The integer value of refid= 
  7406.             identifies the ID of the heading. If the heading is in an external 
  7407.             IPF database, its file name is specified with the database= 
  7408.             attribute. 
  7409.  
  7410.             In the following example, selection of the hypertext link causes 
  7411.             the external database, EDITOR.HLP, to be loaded, and the heading 
  7412.             with the ID of 001 to be displayed. 
  7413.  
  7414.                         :link reftype=hd refid=001.
  7415.                               database='editor.hlp'.
  7416.                         Editing Functions
  7417.                         :elink.
  7418.  
  7419.             The heading definition in the external database must contain the 
  7420.             global attribute.  If the link to the file cannot be resolved, the 
  7421.             hypertext phrase in the link will not be highlighted. 
  7422.  
  7423.     reftype=fn 
  7424.             Links to a footnote. Its contents are displayed in a pop-up window 
  7425.             in the current window.  The refid= attribute specifies the ID of 
  7426.             the footnote. 
  7427.  
  7428.             Restriction: A split window cannot contain a link to a footnote. 
  7429.  
  7430.     reftype=launch 
  7431.             Starts a Presentation Manager program.  The file name of the 
  7432.             program is specified with the object= attribute.  Any parameters to 
  7433.             the program are specified with data=.  In the following example, 
  7434.             the hypertext link starts the System Editor and opens the file, 
  7435.             MYFILE, for editing. 
  7436.  
  7437.                         :link reftype=launch
  7438.                               object='c:\os2\e.exe'
  7439.                               data='myfile'.
  7440.                         Start Editor
  7441.                         :elink.
  7442.  
  7443.             Restriction: You can only use alpha-numeric characters in the data= 
  7444.             field when using the reftype=launch attribute. 
  7445.  
  7446.     reftype=inform 
  7447.             Causes a message to be sent to the application. The res= attribute 
  7448.             is required and is an integer value that directs the application to 
  7449.             perform some application-specific function. When using this 
  7450.             attribute, do not use :elink..  For example: 
  7451.  
  7452.                         :link reftype=inform res=1000 auto.
  7453.  
  7454.   auto
  7455.   viewport
  7456.   dependent
  7457.   split
  7458.   child
  7459.   group=
  7460.     With the auto attribute, you can define any of the link types described 
  7461.     above, with the exception of a footnote link, as an automatic link. 
  7462.  
  7463.     The automatic-link definition follows a heading definition and is activated 
  7464.     as soon as a reference to the heading definition is made.  The reference 
  7465.     can be made by the user selecting an IPF window entry (for example, the 
  7466.     Contents window), or by a hypertext or hypergraphic link. 
  7467.  
  7468.     Restriction: Linking automatically to an external database is not possible. 
  7469.  
  7470.     Following are the automatic-link actions that can be specified, and the 
  7471.     attributes used: 
  7472.         Open a secondary window when the heading that contains the link is 
  7473.          referred to: 
  7474.  
  7475.                   auto reftype=hd viewport dependent res=
  7476.  
  7477.          Note the inclusion of the dependent attribute. Usually, the 
  7478.          information in an automatic window is dependent on the information in 
  7479.          its secondary window.  Specifying dependent causes an automatic window 
  7480.          to close when the user closes the window of the secondary that 
  7481.          contains the automatic link. 
  7482.  
  7483.         Open secondary windows when the heading of the primary window that 
  7484.          contains the links is referred to: 
  7485.  
  7486.                   auto reftype=hd split res=
  7487.  
  7488.          Restriction: The primary heading cannot contain text or graphics; only 
  7489.          links to its secondary headings.  For more information, see Split 
  7490.          Windows. 
  7491.  
  7492.         Start a Presentation Manager program when the heading that contains 
  7493.          the link is referred to: 
  7494.  
  7495.                   auto reftype=launch object= data=
  7496.  
  7497.         Send the application a message when the heading that contains the link 
  7498.          is referred to: 
  7499.  
  7500.                   auto reftype=inform res=
  7501.  
  7502.     To display more than one window on the screen, you must assign a unique 
  7503.     group number to each window with the group= attribute. This attribute can 
  7504.     be specified with :link. or the heading tag.  For more information about 
  7505.     group numbers, see Displaying Multiple Windows. 
  7506.  
  7507.     The child attribute opens the panel being linked to as a child of the panel 
  7508.     in which th elink is located.  This means: 
  7509.         The child panel is clipped to fit inside the parent paanel and cannot 
  7510.          be moved outside the parent panel. 
  7511.  
  7512.         The child panel is always "on top" of the parent panel and the parent 
  7513.          cannot be moved on top of the child (the parent can still receive 
  7514.          mouse clicks and keystrokes). 
  7515.  
  7516.         The child panel is closed when the parent panel is closed. 
  7517.  
  7518.         The child panel is minimized when the parent panel is minimized and 
  7519.          restored when the parent is restored. 
  7520.  
  7521.         When the child panel is minimized by itself, its minimized icon is 
  7522.          displayed inside the parent panel instead of on the coverpage. 
  7523.  
  7524.     The child attribute opens the help panel as a child. 
  7525.  
  7526.   vpx=
  7527.   vpy=
  7528.   vpcx=
  7529.   vpcy=
  7530.     Define the size and position of the window.  Any values specified by these 
  7531.     attributes override size and position values specified by the attributes in 
  7532.     a heading tag. (See :h1. through :h6.  (Headings) for details about these 
  7533.     attributes.) 
  7534.  
  7535.     Restriction: These attributes are not valid for positioning or sizing a 
  7536.     footnote (:fn) window. 
  7537.  
  7538.   titlebar=yes | sysmenu | minmax | both | none
  7539.   scroll=horizontal | vertical | both | none
  7540.   rules=border | sizeborder | none
  7541.     Define window controls.  Any values specified by these attributes override 
  7542.     window-control values specified by the attributes in a heading tag. (See 
  7543.     :h1. through :h6.  (Headings) for details about these attributes.) 
  7544.  
  7545.  When titlebar=yes is specified, the window displays a titlebar without the 
  7546.  system menu symbol, the hide button, and the maximize button. 
  7547.  
  7548.  
  7549. ΓòÉΓòÉΓòÉ 8.31. :lm.  (Left Margin) ΓòÉΓòÉΓòÉ
  7550.  
  7551. Purpose 
  7552.  
  7553. Sets the left margin of the text. 
  7554.  
  7555. Syntax 
  7556.  
  7557. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7558. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  7559. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7560. Γöé:lm.           ΓöéLeft margin    Γöémargin=        Γöé               Γöé
  7561. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7562.  
  7563. Attributes 
  7564.  
  7565.  margin= 
  7566.     Specifies where the left margin of the text is to begin. To set the margin 
  7567.     for the current line, specify a number greater than the position of the 
  7568.     cursor. For example, to set the left margin to 15, begin the left margin 
  7569.     tag before space 15. Otherwise, the margin becomes effective on the next 
  7570.     line. 
  7571.  
  7572.  Note:  When counting character spaces, you are actually counting average 
  7573.  character widths. 
  7574.  
  7575.  Description 
  7576.  
  7577.  Use the left-margin tag and the right-margin tag (:rm.) to specify the 
  7578.  boundaries of the text in the window. 
  7579.  
  7580.  When the text window is sized, the text area adjusts from the right to fit 
  7581.  within the specified margin boundaries; that is, the right margin adjusts to 
  7582.  the new window size. The left margin remains constant. If the window is sized 
  7583.  smaller than the specified margins, the margins remain the same, and the text 
  7584.  area is reduced to one character space. 
  7585.  
  7586.  You can place multiple margin tags in your file. The margins specified remain 
  7587.  effective until they are reset. If no margin value is specified, the default 
  7588.  is 1. 
  7589.  
  7590.  Conditions 
  7591.  
  7592.  None 
  7593.  
  7594.  Example 
  7595.  
  7596.  This example shows the use of both margin tags. 
  7597.  
  7598.   :p.
  7599.   :rm margin=10.
  7600.   :lm margin=20.This text begins 20 spaces to the
  7601.   right of the left window border and ends 10 spaces to the
  7602.   left of the right window border.
  7603.   All text is aligned as specified
  7604.   by the margin values. :lm margin=5.Here the left margin
  7605.   is changed to 5.  Because this margin tag begins
  7606.   more than 5 spaces on the line, the margin specified
  7607.   becomes effective on the following line, and the text
  7608.   begins 5 spaces from the left window border.
  7609.   The right margin remains unchanged.
  7610.  
  7611.  Output 
  7612.                     This text begins 20 spaces to the right of the left window 
  7613.                     border and ends 10 spaces to the left of the right window 
  7614.                     border. All text is aligned as specified by the margin 
  7615.                     values. Here the left margin is changed to 5.  Because this 
  7616.      margin tag begins more than 5 spaces on the line, the margin specified 
  7617.      becomes effective on the following line, and the text begins 5 spaces from 
  7618.      the left window border. The right margin remains unchanged. 
  7619.  
  7620.  
  7621. ΓòÉΓòÉΓòÉ 8.32. :lp.  (List Part) ΓòÉΓòÉΓòÉ
  7622.  
  7623. Purpose 
  7624.  
  7625. Identifies an explanation within a list. 
  7626.  
  7627. Syntax 
  7628.  
  7629. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7630. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  7631. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7632. Γöé:lp.           ΓöéList part      Γöé               Γöé               Γöé
  7633. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7634.  
  7635. Attributes 
  7636.  
  7637. None 
  7638.  
  7639. Description 
  7640.  
  7641. :lp. can be entered anywhere within the list.  The text following the tag 
  7642. starts at the left margin of the current list item.  It is not numbered or 
  7643. lettered.  Using the list-part tag does not interrupt the sequence of the list. 
  7644.  
  7645. Conditions 
  7646.  
  7647. None 
  7648.  
  7649. Example 
  7650.  
  7651. :p.To remove a diskette:
  7652. :ol.
  7653. :li.Open the drive door.
  7654. :lp.Before removing the diskette, make sure all drive activity
  7655. has stopped.
  7656. :li.Remove the diskette.
  7657. :li.Put the diskette in a safe place.
  7658. :eol.
  7659.  
  7660. Output 
  7661.  
  7662. To remove a diskette: 
  7663.  
  7664.    1. Open the drive door. 
  7665.  
  7666.  Before removing the diskette, make sure all drive activity has stopped. 
  7667.  
  7668.    2. Remove the diskette. 
  7669.  
  7670.    3. Put the diskette in a safe place. 
  7671.  
  7672.  
  7673. ΓòÉΓòÉΓòÉ 8.33. :note.  (Note) ΓòÉΓòÉΓòÉ
  7674.  
  7675. Purpose 
  7676.  
  7677. Starts a note. 
  7678.  
  7679. Syntax 
  7680.  
  7681. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7682. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  7683. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7684. Γöé:note.         ΓöéNote           Γöétext=' '       Γöé               Γöé
  7685. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7686.  
  7687. Attributes 
  7688.  
  7689.  text=' ' 
  7690.     Enables you to change the name of the note. 
  7691.  
  7692.  Description 
  7693.  
  7694.  :note. identifies a single-paragraph note. When the tag is encountered, a 
  7695.  blank line is inserted, and the note starts at the left margin with Note: 
  7696.  followed by two blank spaces. The start of another tag ends the note, so no 
  7697.  end tag is needed. 
  7698.  
  7699.  When the tag is used within a list, the note aligns with the text of the items 
  7700.  within the list. 
  7701.  
  7702.  Use the text=' ' attribute to give the note a specific name. 
  7703.  
  7704.  Conditions 
  7705.  
  7706.  None 
  7707.  
  7708.  Example 1 
  7709.  
  7710.   :note.
  7711.   This text appears within a note.
  7712.   The word :hp2.Note:ehp2. aligns
  7713.   with the text that precedes it.
  7714.  
  7715.  Output 
  7716.  
  7717.  The following output is provided. 
  7718.  
  7719.  Note:  This text appears within a note. The word Note aligns with the text 
  7720.  that precedes it. 
  7721.  
  7722.  Example 2 
  7723.  
  7724.   :note text='Text note:'.
  7725.   The name of this note is :hp2.Text note:ehp2..
  7726.   The name of the note replaces
  7727.   the word :hp2.Note:ehp2..  The name of the note
  7728.   aligns with the text that precedes it.
  7729.  
  7730.  Output 
  7731.  
  7732.  Text note:  The name of this note is Text note. The text for the note replaces 
  7733.  the word Note.  The name of the note aligns with the text that precedes it. 
  7734.  
  7735.  
  7736. ΓòÉΓòÉΓòÉ 8.34. :nt.  (Note) ΓòÉΓòÉΓòÉ
  7737.  
  7738. Purpose 
  7739.  
  7740. Starts a note that can have multiple paragraphs. 
  7741.  
  7742. Syntax 
  7743.  
  7744. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7745. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  7746. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7747. Γöé:nt.           ΓöéNote           Γöétext=' '       Γöé:ent.          Γöé
  7748. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7749.  
  7750. Attributes 
  7751.  
  7752.  text=' ' 
  7753.     Enables you to change the name of the note. 
  7754.  
  7755.  Description 
  7756.  
  7757.  :nt. starts a new paragraph with Note: followed by two blank spaces and the 
  7758.  first line of the text.  The second and succeeding lines of text align with 
  7759.  the first line, to the right of Note:. 
  7760.  
  7761.  Notes can be placed within lists and paragraphs; however, unlike the :note. 
  7762.  tag, :nt. requires an end tag. 
  7763.  
  7764.  You can use the text=' ' attribute to assign a specific name to the note. 
  7765.  
  7766.  Conditions 
  7767.  
  7768.  None 
  7769.  
  7770.  Example 
  7771.  
  7772.   :nt.
  7773.   Use this tag to include paragraphs in a note.
  7774.   You also can use it within paragraphs and lists.
  7775.   :p.End this tag before you begin another
  7776.   note tag.
  7777.   :ent.
  7778.  
  7779.  Output 
  7780.  
  7781.  Note:  Use this tag to include paragraphs in a note. You also can use it 
  7782.         within paragraphs and lists. 
  7783.  
  7784.  End this tag before you begin another note tag. 
  7785.  
  7786.  
  7787. ΓòÉΓòÉΓòÉ 8.35. :ol.  (Ordered List) ΓòÉΓòÉΓòÉ
  7788.  
  7789. Purpose 
  7790.  
  7791. Starts a sequential list of items or steps. 
  7792.  
  7793. Syntax 
  7794.  
  7795. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7796. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  7797. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7798. Γöé:ol.           ΓöéOrdered list   Γöécompact        Γöé:eol.          Γöé
  7799. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7800.  
  7801. Attributes 
  7802.  
  7803.  compact 
  7804.     Causes the list to be formatted without a blank line between each list 
  7805.     item. If you omit compact, a blank line appears between each list item. 
  7806.  
  7807.  Description 
  7808.  
  7809.  :ol. indicates the start of an ordered list. Items in the list are entered 
  7810.  with the list-item tag (:li.). The output is an indented list with each item 
  7811.  numbered. Use the list-part tag (:lp.) for paragraphs within the list. 
  7812.  
  7813.  Ordered lists can be nested or imbedded within other lists. When this is done, 
  7814.  the first list has sequential numbers at the left margin, and the nested list 
  7815.  has sequential letters indented two spaces. After the second list, the 
  7816.  number-letter sequence repeats for each successive ordered list. 
  7817.  
  7818.  Be sure to end each list with the end-list tag. 
  7819.  
  7820.  Example 
  7821.  
  7822.   :p.To remove a diskette:
  7823.   :ol.
  7824.   :li.Open the drive door:
  7825.   :ol compact.
  7826.   :li.Remove two screws.
  7827.   :li.Lift the door.
  7828.   :eol.
  7829.   :li.Remove the diskette.
  7830.   :li.Put the diskette in a safe place.
  7831.   :eol.
  7832.  
  7833.  Output 
  7834.  
  7835.  To remove a diskette: 
  7836.  
  7837.    1. Open the drive door: 
  7838.  
  7839.         a. Remove two screws. 
  7840.         b. Lift the door. 
  7841.  
  7842.    2. Remove the diskette. 
  7843.  
  7844.    3. Put the diskette in a safe place. 
  7845.  
  7846.  
  7847. ΓòÉΓòÉΓòÉ 8.36. :p.  (Paragraph) ΓòÉΓòÉΓòÉ
  7848.  
  7849. Purpose 
  7850.  
  7851. Starts a new paragraph. 
  7852.  
  7853. Syntax 
  7854.  
  7855. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7856. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  7857. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7858. Γöé:p.            ΓöéParagraph      Γöé               Γöé               Γöé
  7859. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7860.  
  7861. Attributes 
  7862.  
  7863. None 
  7864.  
  7865. Description 
  7866.  
  7867. Each paragraph identified by a paragraph tag formats as an unindented block of 
  7868. text. Paragraphs placed within a list align with the text of the list.  When 
  7869. paragraphs are placed within a note, the text of the paragraph aligns with the 
  7870. text of the note. 
  7871.  
  7872. Conditions 
  7873.  
  7874. None 
  7875.  
  7876. Example 
  7877.  
  7878. :p.Paragraph tags cause a blank line before the text.
  7879. When placed within a list or note, the text of the paragraph
  7880. aligns with the text of the list or note.
  7881. :ul.
  7882. :li.Paragraph tags
  7883. :p.Paragraph tags are flexible and can be used
  7884. with most tags.
  7885. :li.Note tags
  7886. :p.Note tags can include paragraphs.
  7887. :eul.
  7888.  
  7889. Output 
  7890.  
  7891. Paragraph tags cause a blank line before the text. When placed within a list or 
  7892. note, the text of the paragraph aligns with the text of the list or note. 
  7893.  
  7894.      Paragraph tags 
  7895.  
  7896.       Paragraph tags are flexible and can be used with most tags. 
  7897.  
  7898.      Note tags 
  7899.  
  7900.       Note tags can include paragraphs. 
  7901.  
  7902.  
  7903. ΓòÉΓòÉΓòÉ 8.37. :parml.  (Parameter List) ΓòÉΓòÉΓòÉ
  7904.  
  7905. Purpose 
  7906.  
  7907. Starts a two-column list of parameter terms and descriptions. 
  7908.  
  7909. Syntax 
  7910.  
  7911. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7912. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  7913. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7914. Γöé:parml.        ΓöéParameter list Γöétsize=         Γöé:eparml.       Γöé
  7915. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7916. Γöé               Γöé               Γöébreak=         Γöé               Γöé
  7917. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7918. Γöé               Γöé               Γöécompact        Γöé               Γöé
  7919. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7920. Γöé:pt.           ΓöéParameter term Γöé               Γöé               Γöé
  7921. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7922. Γöé:pd.           ΓöéParameter      Γöé               Γöé               Γöé
  7923. Γöé               Γöédefinition     Γöé               Γöé               Γöé
  7924. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7925.  
  7926. Attributes 
  7927.  
  7928.  tsize= 
  7929.            Specifies the space allocated for the parameter term. The default is 
  7930.            10 character units. 
  7931.  
  7932.  break=all | fit | none 
  7933.            Controls the formatting of the parameter terms and descriptions: 
  7934.  
  7935.            break=all 
  7936.                    Causes the description to begin on the line below the 
  7937.                    parameter term, next to the space allocated by tsize=. This 
  7938.                    is the default. 
  7939.  
  7940.            break=fit 
  7941.                    Causes the parameter description to begin on the same line 
  7942.                    as the term, if the term has fewer characters than specified 
  7943.                    by tsize=.  If the term has more characters, the description 
  7944.                    begins on the line below the term. 
  7945.  
  7946.            break=none 
  7947.                    Causes the description to begin on the same line as the 
  7948.                    term.  If the term has more characters than specified by 
  7949.                    tsize=, it continues into the description area.  The 
  7950.                    description starts one space after the end of the term. 
  7951.  
  7952.  compact 
  7953.            Causes the list to be formatted without a blank line between each 
  7954.            list item.  If you omit compact, a blank line appears between each 
  7955.            item. 
  7956.  
  7957.  Description 
  7958.  
  7959.  Parameter lists are similar to definition lists; they define terms and 
  7960.  descriptions that format in two columns. The elements of the parameter-list 
  7961.  tag are the parameter-term tag (:pt.) and the parameter-description tag 
  7962.  (:pd.).  The term tag identifies the term, and the definition tag identifies 
  7963.  the description. 
  7964.  
  7965.  Parameter lists can occur anywhere in text; you can nest them within other 
  7966.  lists, and you can nest other lists within parameter lists. 
  7967.  
  7968.  Conditions 
  7969.  
  7970.      Each parameter-term tag requires a parameter-description tag. 
  7971.      Each parameter list requires an end-parameter-list tag. 
  7972.  
  7973.  Example 
  7974.  
  7975.   :parml compact tsize=10 break=none.
  7976.   :pt.Tree
  7977.   :pd.Plant life in forest
  7978.   :pt.Orange
  7979.   :pd.Fruit on tree
  7980.   :pt.Cow
  7981.   :pd.Animal on farm
  7982.   :eparml.
  7983.  
  7984.  Output 
  7985.  
  7986.  Tree      Plant life in forest 
  7987.  Orange    Fruit on tree 
  7988.  Cow       Animal on farm 
  7989.  
  7990.  
  7991. ΓòÉΓòÉΓòÉ 8.38. :pbutton. (Push Button) ΓòÉΓòÉΓòÉ
  7992.  
  7993. Purpose 
  7994.  
  7995. Defines author-defined push buttons. 
  7996.  
  7997. Syntax 
  7998.  
  7999. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8000. ΓöéTags           ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  8001. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8002. Γöé:pbutton.      ΓöéAuthor-defined Γöéid=            Γöé               Γöé
  8003. Γöé               Γöépush buttons   Γöéres=           Γöé               Γöé
  8004. Γöé               Γöé               Γöétext=' '       Γöé               Γöé
  8005. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8006.  
  8007. Attributes 
  8008.  
  8009.  id= 
  8010.     Specifies the identification value for a push button that you define.  The 
  8011.     identification value can be alpha or alphanumeric.  This identification 
  8012.     value is referenced by the control area tag (:ctrl.). 
  8013.  
  8014.  res= 
  8015.     Specifies the resource identification value for a push button that you 
  8016.     define.  This value is returned with the HM_NOTIFY and HM_CONTROL messages 
  8017.     and can be any integer greater than 256 (0 to 256 are reserved for use by 
  8018.     IPF). 
  8019.  
  8020.  text= ' ' 
  8021.     Specifies the text for the push button that you define. Define the mnemonic 
  8022.     for the push button by placing the tilde (~) character before the mnemonic 
  8023.     character.  For example: 
  8024.  
  8025.          :pbutton id=xmp res=300 text='~Example'.
  8026.  
  8027.     Note:  Make sure the mnemonic you specify for author-defined push buttons 
  8028.     does not conflict with the mnemonics of the predefined set of push buttons, 
  8029.     or with any of IPF's shortcut keys. See :ctrl.  (Control Area) for a 
  8030.     description of the control area tag (:ctrl.) and a list of the predefined 
  8031.     push buttons and their associated mnemonics. 
  8032.  
  8033.  Description 
  8034.  
  8035.  Use the push button tag (:pbutton.) to define author-defined push buttons. 
  8036.  For more information, see Author-Defined Push Buttons. 
  8037.  
  8038.  
  8039. ΓòÉΓòÉΓòÉ 8.39. :pd.  (Parameter Description) ΓòÉΓòÉΓòÉ
  8040.  
  8041. Purpose 
  8042.  
  8043. Starts the description for a parameter term in a parameter list. 
  8044.  
  8045. Syntax 
  8046.  
  8047. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8048. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  8049. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8050. Γöé:pd.           ΓöéParameter      Γöé               Γöé               Γöé
  8051. Γöé               Γöédescription    Γöé               Γöé               Γöé
  8052. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8053.  
  8054. Attributes 
  8055.  
  8056. None 
  8057.  
  8058. Description 
  8059.  
  8060. The text that follows :pd. describes the term identified by :pt..  The 
  8061. description formats in the right column, as defined by the values of tsize= and 
  8062. break=. For a description of :parml., see :parml.  (Parameter List). 
  8063.  
  8064. A parameter list can have multiple parameter-term and parameter-description 
  8065. tags; however, each term tag requires a description tag. 
  8066.  
  8067. Conditions 
  8068.  
  8069.      The parameter-description tag follows the parameter-term tag. 
  8070.      The parameter-description tag is valid only within a parameter list. 
  8071.  
  8072.  Example 
  8073.  
  8074.   :parml compact tsize=15 break=all.
  8075.   :pt.Tree
  8076.   :pd.Plant life in forest
  8077.   :pt.Orange
  8078.   :pd.Fruit on tree
  8079.   :pt.Cow
  8080.   :pd.Animal on farm
  8081.   :eparml.
  8082.  
  8083.  Output 
  8084.  
  8085.  Tree 
  8086.                 Plant life in forest 
  8087.  Orange 
  8088.                 Fruit on tree 
  8089.  Cow 
  8090.                 Animal on farm 
  8091.  
  8092.  
  8093. ΓòÉΓòÉΓòÉ 8.40. :pt.  (Parameter Term) ΓòÉΓòÉΓòÉ
  8094.  
  8095. Purpose 
  8096.  
  8097. Identifies a term in a parameter list. 
  8098.  
  8099. Syntax 
  8100.  
  8101. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8102. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  8103. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8104. Γöé:pt.           ΓöéParameter      Γöé               Γöé               Γöé
  8105. Γöé               Γöédescription    Γöé               Γöé               Γöé
  8106. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8107.  
  8108. Attributes 
  8109.  
  8110. None 
  8111.  
  8112. Description 
  8113.  
  8114. The term identified by :pt. formats in the left column.  The :pt. tag requires 
  8115. a parameter-description tag (:pd.); the description formats in the right 
  8116. column. 
  8117.  
  8118. Conditions 
  8119.  
  8120.      The parameter-term tag requires a parameter-description tag. 
  8121.      The parameter-term tag precedes the parameter-description tag. 
  8122.      The parameter-term tag is valid only within a parameter list (for a 
  8123.       description of :parml., see :parml.  (Parameter List)). 
  8124.  
  8125.  Example 
  8126.  
  8127.   :parml compact tsize=15 break=all.
  8128.   :pt.Tree
  8129.   :pd.Plant life in forest
  8130.   :pt.Orange
  8131.   :pd.Fruit on tree
  8132.   :pt.Cow
  8133.   :pd.Animal on farm
  8134.   :eparml.
  8135.  
  8136.  Output 
  8137.  
  8138.  Tree 
  8139.                 Plant life in forest 
  8140.  Orange 
  8141.                 Fruit on tree 
  8142.  Cow 
  8143.                 Animal on farm 
  8144.  
  8145.  
  8146. ΓòÉΓòÉΓòÉ 8.41. :rm.  (Right Margin) ΓòÉΓòÉΓòÉ
  8147.  
  8148. Purpose 
  8149.  
  8150. Sets the right margin of the text. 
  8151.  
  8152. Syntax 
  8153.  
  8154. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8155. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  8156. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8157. Γöé:rm.           ΓöéRight margin   Γöémargin=        Γöé               Γöé
  8158. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8159.  
  8160. Attributes 
  8161.  
  8162.  margin= 
  8163.     Enables you to indicate the number of character spaces from the right 
  8164.     border of the window the text is to end. For example, margin=60 means that 
  8165.     the text is to end 60 spaces from the right border. 
  8166.  
  8167.     Note:  When counting character spaces, you are actually counting average 
  8168.     character widths. 
  8169.  
  8170.  Description 
  8171.  
  8172.  Use :rm. with the left-margin tag (:lm.) to specify the boundaries of the text 
  8173.  in the window. The left-margin tag specifies where the text is to start, and 
  8174.  the right-margin tag specifies where it is to end. 
  8175.  
  8176.  You can enter margin tags at the beginning of the line of text or while you 
  8177.  are entering the text. Margin tags that begin the line of text cause text on 
  8178.  that line and the following lines to align with the values specified. Margins 
  8179.  set while you enter text become effective on the current line or on the next 
  8180.  line, depending on where the margin tag begins. For example, to set the right 
  8181.  margin to 60 (that is, 60 spaces before the right border of the window), begin 
  8182.  the right-margin tag at least 60 spaces to the left of the right border. When 
  8183.  the file is displayed, the text entered after the margin tag aligns to the 
  8184.  value specified on that line. 
  8185.  
  8186.  If the margin tag is started after the specified boundary, the margin becomes 
  8187.  effective on the next line. 
  8188.  
  8189.  When the text window is sized, the text area adjusts from the right to fit 
  8190.  within the specified margin boundaries; that is, the right margin adjusts to 
  8191.  the window size. The left margin stays the same. If the window is sized 
  8192.  smaller than the specified margins, the margins remain the same, and the text 
  8193.  area is reduced to one character space. If no value is specified for margin=, 
  8194.  the default for the right margin is 1. 
  8195.  
  8196.  You can place multiple margin tags in your file. The specified margins remain 
  8197.  effective until they are reset. 
  8198.  
  8199.  Example 
  8200.  
  8201.   :lm margin=1.
  8202.   :rm margin=44.
  8203.   :p.In this example, the left margin is 1.  The right
  8204.   margin is 44.  The margins are set before the text;
  8205.   therefore, when the file is displayed, the text
  8206.   formats according to the margins set.
  8207.   The text begins at space 2 and ends 44 spaces before
  8208.   the right window border.  If the margin specified is
  8209.   less than the current cursor position on the screen,
  8210.   the margins set become effective on the following
  8211.   line.  For example, if the current cursor position is
  8212.   60 spaces to the left of the right window border and
  8213.   you set the right margin to 50, the margin is
  8214.   effective on the current line.  However, if the right
  8215.   margin is set to 65, the margin becomes effective
  8216.   on the next line.
  8217.   :p.
  8218.   :lm margin=5.
  8219.   :rm margin=60.Here the left margin is set to 5
  8220.   and the right margin is set to 60.  This means that
  8221.   the left margin begins 5 spaces to the right of the
  8222.   left border.  The right margin ends 60 spaces to the
  8223.   left of the right border.
  8224.  
  8225.  Output 
  8226.  
  8227.   In this example, the left margin is 1.  The right
  8228.   margin is 44.  The margins are set before the
  8229.   text; therefore, when the file is displayed, the text
  8230.   formats according to the margins set.  The text
  8231.   begins at space 2 and ends 44 spaces before the
  8232.   right window border.  If the margin specified is
  8233.   less than the current cursor position on the
  8234.   screen, the margins set become effective on the
  8235.   following line.  For example, if the current cursor
  8236.   position is 60 spaces to the left of the right
  8237.   window border and you set the right margin to 50,
  8238.   the margin is effective on the current line.
  8239.   However, if the right margin is set to 65, the
  8240.   margin becomes effective on the next line.
  8241.  
  8242.  
  8243.      Here the left margin is set to 5
  8244.      and the right margin is set to
  8245.      60.  This means that the left
  8246.      margin begins 5 spaces to the
  8247.      right of the left border.  The
  8248.      right margin ends 60 spaces to
  8249.      the left of the right border.
  8250.  
  8251.  
  8252. ΓòÉΓòÉΓòÉ 8.42. :sl.   (Simple List) ΓòÉΓòÉΓòÉ
  8253.  
  8254. Purpose 
  8255.  
  8256. Starts a nonsequential list of items. 
  8257.  
  8258. Syntax 
  8259.  
  8260. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8261. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  8262. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8263. Γöé:sl.           ΓöéSimple list    Γöécompact        Γöé:esl.          Γöé
  8264. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8265.  
  8266. Attributes 
  8267.  
  8268.  compact 
  8269.     Causes the list to be formatted without a blank line between each list 
  8270.     item. If you omit compact, a blank line appears between each item. 
  8271.  
  8272.  Description 
  8273.  
  8274.  :sl. identifies items that do not require a sequential listing.  Items in a 
  8275.  simple list are not indented and do not have bullets, hyphens, or dashes 
  8276.  preceding them.  Simple lists can be nested within other lists.  When nested, 
  8277.  a simple list is indented four spaces to the right of the left margin of the 
  8278.  list that contains it.  Each list requires an end-list tag. 
  8279.  
  8280.  The simple-list tag requires the list-item tag (:li.) to identify items in the 
  8281.  list. You can use the list-part tag (:lp.) to include paragraphs in the list. 
  8282.  
  8283.  Conditions 
  8284.  
  8285.  None 
  8286.  
  8287.  Example 
  8288.  
  8289.   :p.Bring the following for lunch:
  8290.   :sl.
  8291.   :li.Fruit, for example:
  8292.   :sl compact.
  8293.   :li.An apple
  8294.   :li.An orange
  8295.   :li.A pear
  8296.   :li.A banana
  8297.   :esl.
  8298.   :li.Sandwich
  8299.   :li.A drink, for example:
  8300.   :sl compact.
  8301.   :li.A soda
  8302.   :li.Juice
  8303.   :li.Milk.
  8304.   :esl.
  8305.   :esl.
  8306.  
  8307.  Output 
  8308.  
  8309.  Bring the following for lunch: 
  8310.  
  8311.       Fruit, for example: 
  8312.  
  8313.            An apple 
  8314.            An orange 
  8315.            A pear 
  8316.            A banana 
  8317.  
  8318.       Sandwich 
  8319.  
  8320.       A drink, for example: 
  8321.  
  8322.            A soda 
  8323.            Juice 
  8324.            Milk. 
  8325.  
  8326.  
  8327. ΓòÉΓòÉΓòÉ 8.43. :table.  (Table) ΓòÉΓòÉΓòÉ
  8328.  
  8329. Purpose 
  8330.  
  8331. Formats information as a table. 
  8332.  
  8333. Syntax 
  8334.  
  8335. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8336. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  8337. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8338. Γöé:table.        ΓöéTables         Γöécols=' '       Γöé:etable.       Γöé
  8339. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8340. Γöé               Γöé               Γöérules=         Γöé               Γöé
  8341. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8342. Γöé               Γöé               Γöéframe=         Γöé               Γöé
  8343. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8344. Γöé:row.          ΓöéRows           ΓöéNone           ΓöéNone           Γöé
  8345. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8346. Γöé:c.            ΓöéColumns        ΓöéNone           ΓöéNone           Γöé
  8347. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8348.  
  8349. Attributes 
  8350.  
  8351.  cols=' ' 
  8352.     Specifies the width, in character spaces, of each column; for example: 
  8353.     cols='10 15 20'. 
  8354.  
  8355.  rules= 
  8356.     Specifies whether the table will have horizontal and vertical rules. 
  8357.     Following are the possible values and meanings: 
  8358.  
  8359.     both           Horizontal and vertical rules 
  8360.     horiz          Horizontal rules only 
  8361.     vert           Vertical rules only 
  8362.     none           No rules 
  8363.  
  8364.     Note:  The default is both. 
  8365.  
  8366.  frame= 
  8367.     Specifies whether the table will have borders. Following are the possible 
  8368.     values and meanings: 
  8369.  
  8370.     rules          A horizontal line at the top and bottom of the table 
  8371.     box            A box around the table 
  8372.     none           No borders. 
  8373.  
  8374.     Note:  The default is box. 
  8375.  
  8376.  The :row. tag specifies the start of each row in the table. The :c. tag 
  8377.  specifies the text for each column entry in the table. The text provided with 
  8378.  the :c. tag is formatted within the column.  However, if a single word is 
  8379.  longer than the specified width of the column, the word will be clipped. 
  8380.  
  8381.  Example 
  8382.  
  8383.  The following defines a table with three columns and two rows. The width of 
  8384.  each column is 15, 20, and 25 character spaces. 
  8385.  
  8386.   :table cols='15 20 25' rules=both frame=box.
  8387.   :row.
  8388.   :c.Row 1 Col 1
  8389.   :c.Row 1 Col 2
  8390.   :c.Row 1 Col 3
  8391.   :row.
  8392.   :c.Row 2 Col 1
  8393.   :c.Row 2 Col 2
  8394.   :c.Row 2 Col 3
  8395.   :etable.
  8396.  
  8397.  Output 
  8398.  
  8399.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8400.   ΓöéRow 1 Col 1    ΓöéRow 1 Col 2         ΓöéRow 1 Col 3              Γöé
  8401.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8402.   ΓöéRow 2 Col 1    ΓöéRow 2 Col 2         ΓöéRow 2 Col 3              Γöé
  8403.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8404.  
  8405.  
  8406. ΓòÉΓòÉΓòÉ 8.44. :title.  (Title) ΓòÉΓòÉΓòÉ
  8407.  
  8408. Purpose 
  8409.  
  8410. Provides a name for the online document. 
  8411.  
  8412. Syntax 
  8413.  
  8414. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8415. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  8416. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8417. Γöé:title.        ΓöéTitle          Γöé               Γöé               Γöé
  8418. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8419.  
  8420. Attributes 
  8421.  
  8422. None 
  8423.  
  8424. Description 
  8425.  
  8426. The text that follows :title. provides a name for the online document. The 
  8427. title of an online document can contain up to 47 characters, including spaces 
  8428. and blanks. If the title exceeds 47 characters, the IPF Compiler displays an 
  8429. error message. 
  8430.  
  8431. When you display the online document, the title appears on the title line of 
  8432. the main window. The title is limited to one line. Word wrapping does not occur 
  8433. in the title of an online document. 
  8434.  
  8435. Conditions 
  8436.  
  8437. Use the :title. tag only for the title of an online document.  Do not use it 
  8438. for online help windows. 
  8439.  
  8440. Example 
  8441.  
  8442. :userdoc.
  8443. :title.Using the Information Presentation Facility
  8444. :h1 res=100.Creating an Index
  8445. :p.This section shows you how to create index entries.
  8446. :euserdoc.
  8447.  
  8448. Output 
  8449.  
  8450. When you compile this file, "Using the Information Presentation Facility" is 
  8451. displayed on the title line of the main window of the online document. 
  8452.  
  8453. "Creating an Index" is listed as an entry in the contents window. If you select 
  8454. "Creating an Index," the window with this heading and the accompanying text is 
  8455. displayed in the text information area, overlaying the contents window. 
  8456.  
  8457.  
  8458. ΓòÉΓòÉΓòÉ 8.45. :ul.  (Unordered List) ΓòÉΓòÉΓòÉ
  8459.  
  8460. Purpose 
  8461.  
  8462. Starts a list of nonsequential items. 
  8463.  
  8464. Syntax 
  8465.  
  8466. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8467. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  8468. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8469. Γöé:ul.           ΓöéUnordered list ΓöéCompact        Γöé:eul.          Γöé
  8470. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8471.  
  8472. Attributes 
  8473.  
  8474.  compact 
  8475.     Causes the list to be formatted without a blank line between each list 
  8476.     item. If you omit compact, a blank line appears between each item. 
  8477.  
  8478.  Description 
  8479.  
  8480.  :ul. indicates the start of a list of items that do not require sequential 
  8481.  listing. The list-item tag (:li.) identifies the items within the list. The 
  8482.  list-part tag (:lp.) is used to include paragraphs within the list. 
  8483.  
  8484.  Unordered list items are indented, and a bullet (lowercase "o") precedes each 
  8485.  item. Unordered lists can be nested within other lists. If placed within an 
  8486.  ordered list or a simple list, the nested list will be indented four spaces, 
  8487.  and each item will be preceded by a bullet. If placed within another unordered 
  8488.  list, the nested list will be indented four spaces, and each item will be 
  8489.  preceded by a dash. 
  8490.  
  8491.  Conditions 
  8492.  
  8493.  None 
  8494.  
  8495.  Example 
  8496.  
  8497.   :p.Before leaving for the day, remember to:
  8498.   :ul.
  8499.   :li.Turn off the computer.
  8500.   :li.Turn off the lights:
  8501.   :ul compact.
  8502.   :li.Ceiling
  8503.   :li.Desk
  8504.   :eul.
  8505.   :li.Secure all equipment.
  8506.   :eul.
  8507.  
  8508.  Output 
  8509.  
  8510.  Before leaving for the day, remember to: 
  8511.  
  8512.      Turn off the computer. 
  8513.  
  8514.      Turn off the lights: 
  8515.  
  8516.         -  Ceiling 
  8517.         -  Desk 
  8518.  
  8519.      Secure all equipment. 
  8520.  
  8521.  
  8522. ΓòÉΓòÉΓòÉ 8.46. :userdoc.  (User Document) ΓòÉΓòÉΓòÉ
  8523.  
  8524. Purpose 
  8525.  
  8526. Identifies the source file that is to be compiled. 
  8527.  
  8528. Syntax 
  8529.  
  8530. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8531. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  8532. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8533. Γöé:userdoc.      ΓöéUser document  Γöé               Γöé:euserdoc.     Γöé
  8534. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8535.  
  8536. Attributes 
  8537.  
  8538. None 
  8539.  
  8540. Description 
  8541.  
  8542. :userdoc. must be the first tag in the source file. It signals the compiler to 
  8543. begin compiling the tagged text that follows. All other tags that define how 
  8544. the text is to be formatted follow this tag. 
  8545.  
  8546. The end-user-document tag (:euserdoc.) identifies the end of the tagged text 
  8547. and the end of the source file. It must be the last tag in the source file. 
  8548.  
  8549. Conditions 
  8550.  
  8551. None 
  8552.  
  8553. Example 
  8554.  
  8555. :userdoc.
  8556. .
  8557. .
  8558. .
  8559. :euserdoc.
  8560.  
  8561.  
  8562. ΓòÉΓòÉΓòÉ 8.47. :warning.  (Warning) ΓòÉΓòÉΓòÉ
  8563.  
  8564. Purpose 
  8565.  
  8566. Alerts the user of a risk or possible error condition. 
  8567.  
  8568. Syntax 
  8569.  
  8570. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8571. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  8572. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8573. Γöé:warning.      ΓöéWarning        Γöétext=' '       Γöé:ewarning.     Γöé
  8574. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8575.  
  8576. Attributes 
  8577.  
  8578.  text=' ' 
  8579.     Enables you to give a specific name to the warning notice. 
  8580.  
  8581.  Description 
  8582.  
  8583.  A warning notice alerts the user to a possible risk, such as an error 
  8584.  condition in the system. It should appear before the text that it discusses. 
  8585.  Use the text=' ' attribute to provide a specific name for the warning notice. 
  8586.  
  8587.  Conditions 
  8588.  
  8589.  None 
  8590.  
  8591.  Example 1 
  8592.  
  8593.   :warning.
  8594.   The disk contains bad sectors.
  8595.   :ewarning.
  8596.  
  8597.  Output 
  8598.  
  8599.  The following output is provided. 
  8600.  
  8601.  Warning: The disk contains bad sectors. 
  8602.  
  8603.  Example 2 
  8604.  
  8605.   :warning text='Bad disk:'.
  8606.   The disk contains bad sectors.
  8607.   :ewarning.
  8608.  
  8609.  Output 
  8610.  
  8611.  Bad disk  The disk contains bad sectors. 
  8612.  
  8613.  
  8614. ΓòÉΓòÉΓòÉ 8.48. :xmp. (Example) ΓòÉΓòÉΓòÉ
  8615.  
  8616. Purpose 
  8617.  
  8618. Turns formatting off. 
  8619.  
  8620. Syntax 
  8621.  
  8622. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8623. ΓöéTag            ΓöéElement        ΓöéAttributes     ΓöéEnd            Γöé
  8624. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8625. Γöé:xmp.          ΓöéExample        Γöé               Γöé:exmp.         Γöé
  8626. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8627.  
  8628. Attributes 
  8629.  
  8630. None 
  8631.  
  8632. Description 
  8633.  
  8634. Text entered between :xmp. and :exmp. is formatted as entered, in a monospace 
  8635. font. The text is indented two spaces from the left margin of the window. Lines 
  8636. that are too long to fit within the window are clipped. 
  8637.  
  8638. Conditions 
  8639.  
  8640.      An example cannot be placed within another example. 
  8641.      An end-example tag is required. 
  8642.  
  8643.  Example 
  8644.  
  8645.   :xmp.
  8646.    #define INCL_WIN
  8647.    #include <os2.h>
  8648.  
  8649.    MRESULT EXPENTRY MyObject(PACVP pACVP, PCH ObjectInfo)
  8650.    {
  8651.  
  8652.    HWND hwndMyACVP;            /* Handle to the application-controlled */
  8653.                                /* window that this procedure creates   */
  8654.         .
  8655.         .
  8656.         .
  8657.    }
  8658.   :exmp.
  8659.  
  8660.  Output 
  8661.  
  8662.    #define INCL_WIN
  8663.    #include <os2.h>
  8664.  
  8665.    MRESULT EXPENTRY MyObject(PACVP pACVP, PCH ObjectInfo)
  8666.    {
  8667.  
  8668.    HWND hwndMyACVP;            /* Handle to the application-controlled */
  8669.                                /* window that this procedure creates   */
  8670.         .
  8671.         .
  8672.         .
  8673.    }
  8674.  
  8675.  
  8676. ΓòÉΓòÉΓòÉ 9. Symbols ΓòÉΓòÉΓòÉ
  8677.  
  8678. This chapter discusses the symbols you can use to display special characters 
  8679. that you may want to include in your file.  Symbols can be used to specify 
  8680. characters that are not on the keyboard.  Each symbol represents a single 
  8681. character. When tagging your file to include symbols, begin each symbol with an 
  8682. ampersand (&) and end the symbol with a period (.). For example, to place a 
  8683. square bullet (Γûá) in a file, you would enter: 
  8684.  
  8685. &sqbul.
  8686.  
  8687. Symbols are case sensitive; that is, uppercase characters produce different 
  8688. symbols than lowercase characters.  Therefore, when tagging the file to include 
  8689. a symbol, enter the tag for the symbol exactly as it is shown in the symbols 
  8690. table. 
  8691.  
  8692. Note:  All symbols in the following table are also in the APSYMBOL.APS file. 
  8693. This file is in the \TOOLKIT\IPFC directory and can be edited with any text 
  8694. editor; however, some National Language code pages require a different symbols 
  8695. file. See National Language Support (NLS), for a list of these files. 
  8696.  
  8697. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8698. ΓöéSymbol              ΓöéSymbol Name         ΓöéCharacter           Γöé
  8699. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8700. Γöé&aa.                Γöéa acute             Γöé╨░                   Γöé
  8701. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8702. Γöé&ac.                Γöéa circumflex        Γöé╨ô                   Γöé
  8703. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8704. Γöé&ae.                Γöéa umlaut            Γöé╨ö                   Γöé
  8705. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8706. Γöé&Ae.                ΓöéA umlaut            Γöé╨₧                   Γöé
  8707. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8708. Γöé&ag.                Γöéa grave             Γöé╨ò                   Γöé
  8709. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8710. Γöéæ.             Γöéae ligature         Γöé╨í                   Γöé
  8711. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8712. ΓöéÆ.             ΓöéAE ligature         Γöé╨ó                   Γöé
  8713. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8714. Γöé&Alpha.             ΓöéAlpha               ΓöéA                   Γöé
  8715. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8716. Γöé&.               Γöéampersand           Γöé&                   Γöé
  8717. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8718. Γöé&and.               Γöéand                 Γöé^                   Γöé
  8719. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8720. Γöé&angstrom.          Γöéangstrom            Γöé╨ƒ                   Γöé
  8721. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8722. Γöé&ao.                Γöéa overcircle        Γöé╨û                   Γöé
  8723. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8724. Γöé&Ao.                ΓöéA overcircle        Γöé╨ƒ                   Γöé
  8725. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8726. Γöé&apos.              Γöéapostrophe          Γöé'                   Γöé
  8727. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8728. Γöé&bx2022.            ΓöéASCII code 185      ΓöéΓòú                   Γöé
  8729. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8730. Γöé&bx2020.            ΓöéASCII code 186      ΓöéΓòæ                   Γöé
  8731. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8732. Γöé&bx0022.            ΓöéASCII code 187      ΓöéΓòù                   Γöé
  8733. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8734. Γöé&bx2002.            ΓöéASCII code 188      ΓöéΓò¥                   Γöé
  8735. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8736. Γöé&bx2200.            ΓöéASCII code 200      ΓöéΓòÜ                   Γöé
  8737. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8738. Γöé&bx0220.            ΓöéASCII code 201      ΓöéΓòö                   Γöé
  8739. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8740. Γöé&bx2202.            ΓöéASCII code 202      ΓöéΓò⌐                   Γöé
  8741. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8742. Γöé&bx0222.            ΓöéASCII code 203      ΓöéΓòª                   Γöé
  8743. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8744. Γöé&bx2220.            ΓöéASCII code 204      ΓöéΓòá                   Γöé
  8745. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8746. Γöé&bx0202.            ΓöéASCII code 205      ΓöéΓòÉ                   Γöé
  8747. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8748. Γöé&bx2222.            ΓöéASCII code 206      ΓöéΓò¼                   Γöé
  8749. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8750. Γöé&asterisk.          Γöéasterisk            Γöé*                   Γöé
  8751. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8752. Γöé&atsign.            Γöéat sign             Γöé@                   Γöé
  8753. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8754. Γöé&bslash., &bsl.     Γöéback slash          Γöé\                   Γöé
  8755. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8756. Γöé&Beta.              ΓöéBeta                Γöé╤ü                   Γöé
  8757. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8758. Γöé&bxas., &bxbj.      Γöébox ascender        ΓöéΓö┤                   Γöé
  8759. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8760. Γöé&bxcr., &bxcj.      Γöébox cross           ΓöéΓö╝                   Γöé
  8761. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8762. Γöé&bxde., &bxtj.      Γöébox descender       ΓöéΓö¼                   Γöé
  8763. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8764. Γöé&bxh.               Γöébox horizontal      ΓöéΓöÇ                   Γöé
  8765. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8766. Γöé&bxle., &bxlj.      Γöébox left junction   ΓöéΓö£                   Γöé
  8767. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8768. Γöé&bxll.              Γöébox lower-left      ΓöéΓöö                   Γöé
  8769. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8770. Γöé&bxlr.              Γöébox lower-right     ΓöéΓöÿ                   Γöé
  8771. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8772. Γöé&bxri., &bxrj.      Γöébox right junction  ΓöéΓöñ                   Γöé
  8773. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8774. Γöé&bxul.              Γöébox upper-left      ΓöéΓöî                   Γöé
  8775. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8776. Γöé&bxur.              Γöébox upper-right     ΓöéΓöÉ                   Γöé
  8777. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8778. Γöé&bxv.               Γöébox vertical        ΓöéΓöé                   Γöé
  8779. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8780. Γöé&cc.                Γöéc cedilla           Γöé╨ù                   Γöé
  8781. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8782. Γöé&Cc.                ΓöéC cedilla           Γöé╨É                   Γöé
  8783. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8784. Γöé&caret.             Γöécaret symbol        Γöé^                   Γöé
  8785. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8786. Γöé&cdq.               Γöéclose double quote  Γöé"                   Γöé
  8787. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8788. Γöé&cdqf.              Γöéclose French double Γöé╨┐                   Γöé
  8789. Γöé                    Γöéquote               Γöé                    Γöé
  8790. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8791. Γöé&csq.               Γöéclose single quote  Γöé'                   Γöé
  8792. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8793. Γöé&comma.             Γöécomma               Γöé,                   Γöé
  8794. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8795. Γöé&colon.             Γöécolon               Γöé:                   Γöé
  8796. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8797. Γöé&dash.              Γöédash                Γöé-                   Γöé
  8798. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8799. Γöé°ree., °.     Γöédegree              Γöé┬░                   Γöé
  8800. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8801. Γöé÷             Γöédivide              Γöé╨Ä                   Γöé
  8802. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8803. Γöé&dollar.            Γöédollar sign         Γöé$                   Γöé
  8804. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8805. Γöé&dot.               Γöédot                 Γöé┬╖                   Γöé
  8806. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8807. Γöé&darrow.            Γöédown arrow          Γöé                   Γöé
  8808. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8809. Γöé&ea.                Γöée acute             Γöé╨Æ                   Γöé
  8810. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8811. Γöé&Ea                 ΓöéE acute             Γöé╨á                   Γöé
  8812. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8813. Γöé&ec.                Γöée circumflex        Γöé╨ÿ                   Γöé
  8814. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8815. Γöé&ee.                Γöée umlaut            Γöé╨Ö                   Γöé
  8816. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8817. Γöé&eg.                Γöée grave             Γöé╨Ü                   Γöé
  8818. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8819. Γöé&emdash.            Γöéem dash             Γöé-                   Γöé
  8820. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8821. Γöé&endash.            Γöéen dash             Γöé-                   Γöé
  8822. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8823. Γöé&eq., &equals.,     Γöéequal sign          Γöé=                   Γöé
  8824. Γöé&eqsym.             Γöé                    Γöé                    Γöé
  8825. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8826. Γöé&xclm., &xclam.     Γöéexclamation point   Γöé!                   Γöé
  8827. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8828. Γöé&fnof.              Γöéfunction of         Γöé╨»                   Γöé
  8829. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8830. Γöé>sym., >.       Γöégreater than        Γöé>                   Γöé
  8831. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8832. Γöé&house.             Γöéhouse               Γöé                   Γöé
  8833. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8834. Γöé&hyphen.            Γöéhyphen              Γöé-                   Γöé
  8835. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8836. Γöé&ia.                Γöéi acute             Γöé╨▒                   Γöé
  8837. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8838. Γöé&ic.                Γöéi circumflex        Γöé╨£                   Γöé
  8839. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8840. Γöé&ie.                Γöéi umlaut            Γöé╨¢                   Γöé
  8841. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8842. Γöé&ig.                Γöéi grave             Γöé╨¥                   Γöé
  8843. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8844. Γöé&inve.              Γöéinverted exclamationΓöé╨╜                   Γöé
  8845. Γöé                    Γöémark                Γöé                    Γöé
  8846. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8847. Γöé&invq.              Γöéinverted question   Γöé╨╕                   Γöé
  8848. Γöé                    Γöémark                Γöé                    Γöé
  8849. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8850. Γöé&larrow.            Γöéleft arrow          Γöé                   Γöé
  8851. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8852. Γöé&lahead.            Γöéleft arrowhead      Γöé                   Γöé
  8853. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8854. Γöé&lbrace., &lbrc.    Γöéleft brace          Γöé{                   Γöé
  8855. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8856. Γöé&lbracket. &lbrk.   Γöéleft bracket        Γöé[                   Γöé
  8857. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8858. Γöé&lpar. , &lparen.   Γöéleft parenthesis    Γöé(                   Γöé
  8859. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8860. Γöé&lnot.              Γöélogical not         Γöé╨║                   Γöé
  8861. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8862. Γöé&mdash.             Γöéem dash             Γöé-                   Γöé
  8863. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8864. Γöé&minus.             Γöéminus sign          Γöé-                   Γöé
  8865. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8866. Γöé&mu.                Γöému                  Γöé╤å                   Γöé
  8867. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8868. Γöé&ndash.             Γöéen dash             Γöé-                   Γöé
  8869. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8870. Γöé&nt.                Γöén tilde             Γöé╨┤                   Γöé
  8871. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8872. Γöé&Nt.                ΓöéN tilde             Γöé╨╡                   Γöé
  8873. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8874. Γöé&lnot., ¬sym.    Γöénot symbol          Γöé╨║                   Γöé
  8875. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8876. Γöé&numsign.           Γöénumber sign         Γöé#                   Γöé
  8877. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8878. Γöé&oa.                Γöéo acute             Γöé╨▓                   Γöé
  8879. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8880. Γöé&oc.                Γöéo circumflex        Γöé╨ú                   Γöé
  8881. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8882. Γöé&og.                Γöéo grave             Γöé╨Ñ                   Γöé
  8883. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8884. Γöé&oe.                Γöéo umlaut            Γöé╨ñ                   Γöé
  8885. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8886. Γöé&Oe.                ΓöéO umlaut            Γöé╨⌐                   Γöé
  8887. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8888. Γöé¼.            Γöéone fourth          Γöé╨╝                   Γöé
  8889. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8890. Γöé½.            Γöéone half            Γöé╨╗                   Γöé
  8891. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8892. Γöé&odq.               Γöéopen double quote   Γöé"                   Γöé
  8893. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8894. Γöé&odqf.              Γöéopen French double  Γöé╨╛                   Γöé
  8895. Γöé                    Γöéquote               Γöé                    Γöé
  8896. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8897. Γöé&osq.               Γöéopen single quote   Γöé`                   Γöé
  8898. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8899. Γöé&percent.           Γöépercent             Γöé%                   Γöé
  8900. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8901. Γöé&per.               Γöéperiod              Γöé.                   Γöé
  8902. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8903. Γöé&plus.              Γöéplus sign           Γöé+                   Γöé
  8904. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8905. Γöé&plusmin., &pm.     Γöéplusminus           Γöé╤æ                   Γöé
  8906. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8907. Γöé&Lsterling.         Γöépound sterling      Γöé╨¼                   Γöé
  8908. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8909. Γöé&rbl.               Γöérequired blank      Γöé                    Γöé
  8910. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8911. Γöé&rarrow.            Γöéright arrow         Γöé"                   Γöé
  8912. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8913. Γöé&rahead.            Γöéright arrowhead     Γöé"                   Γöé
  8914. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8915. Γöé&rbrace., &rbrc.    Γöéright brace         Γöé}                   Γöé
  8916. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8917. Γöé&rbracket., &rbrk.  Γöéright bracket       Γöé]                   Γöé
  8918. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8919. Γöé&rpar., &rparen.    Γöéright parenthesis   Γöé)                   Γöé
  8920. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8921. Γöé&semi.              Γöésemicolon           Γöé;                   Γöé
  8922. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8923. Γöé&box14.             Γöéshaded box 1/4 dots ΓöéΓûæ                   Γöé
  8924. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8925. Γöé&box12.             Γöéshaded box 1/2 dots ΓöéΓûÆ                   Γöé
  8926. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8927. Γöé&box34.             Γöéshaded box 3/4 dots ΓöéΓûô                   Γöé
  8928. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8929. Γöé&slash., &slr.      Γöéslash               Γöé/                   Γöé
  8930. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8931. Γöé&BOX.               Γöésolid box           ΓöéΓûê                   Γöé
  8932. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8933. Γöé&BOXBOT.            Γöésolid box bottom    ΓöéΓûä                   Γöé
  8934. Γöé                    Γöéhalf                Γöé                    Γöé
  8935. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8936. Γöé&splitvbar.         Γöésplit vertical bar  Γöé|                   Γöé
  8937. Γöé                    Γöé(piping symbol)     Γöé                    Γöé
  8938. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8939. Γöé&sqbul.             Γöésquare bullet       ΓöéΓûá                   Γöé
  8940. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8941. Γöé².              Γöésuperscript 2       Γöé┬ñ                   Γöé
  8942. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8943. Γöé&tilde.             Γöétilde               Γöé~                   Γöé
  8944. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8945. Γöé&ua.                Γöéu acute             Γöé╨│                   Γöé
  8946. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8947. Γöé&uc.                Γöéu circumflex        Γöé╨ª                   Γöé
  8948. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8949. Γöé&ug.                Γöéu grave             Γöé╨º                   Γöé
  8950. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8951. Γöé&ue.                Γöéu umlaut            Γöé╨æ                   Γöé
  8952. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8953. Γöé&Ue.                ΓöéU umlaut            Γöé╨¬                   Γöé
  8954. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8955. Γöé&us.                Γöéunderscore          Γöé_                   Γöé
  8956. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8957. Γöé&aus.               Γöéunderscored a       Γöé╨╢                   Γöé
  8958. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8959. Γöé&ous.               Γöéunderscored o       Γöé╨╖                   Γöé
  8960. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8961. Γöé&ye.                Γöéy umlaut            Γöé╨¿                   Γöé
  8962. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8963.  
  8964. Note:  The left and right arrows appear as left and right arrowheads. The ASCII 
  8965. escape sequences do not permit true left and right arrows. 
  8966.  
  8967.  
  8968. ΓòÉΓòÉΓòÉ 10. Compiler Error Messages ΓòÉΓòÉΓòÉ
  8969.  
  8970. This chapter lists the error messages sent by the IPF compiler. 
  8971.  
  8972.  
  8973. ΓòÉΓòÉΓòÉ 10.1. Description and Format of Error Messages ΓòÉΓòÉΓòÉ
  8974.  
  8975. There are three types of error messages: 
  8976.  
  8977.      Warning Level 1.  They are the most severe. 
  8978.  
  8979.      Warning Level 2.  They are moderately severe. 
  8980.  
  8981.      Warning Level 3.  They are the least severe. 
  8982.  
  8983.  These error messages have the following format. 
  8984.  
  8985.  
  8986.   <C:\IPFC\YOURFILE.IPF:999> 124: Invalid tag in footnote [ ]
  8987.    ΓööΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÿΓööΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ ΓööΓö¼Γöÿ  ΓööΓö¼Γöÿ  ΓööΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ ΓööΓö¼Γöÿ
  8988.       Γöé         Γöé        Γöé    Γöé      Γöé                     Γöé
  8989.       Γöé         Γöé        Γöé    Γöé      Γöé              Optional error
  8990.       Γöé         Γöé        Γöé    Γöé      Γöé                information.
  8991.       Γöé         Γöé        Γöé    Γöé      Γöé              Tag, filename, etc.
  8992.       Γöé         Γöé        Γöé    Γöé      Γöé
  8993.       Γöé         Γöé        Γöé    Γöé      ΓööΓöÇΓöÇ Error message
  8994.       Γöé         Γöé        Γöé    Γöé
  8995.       Γöé         Γöé        Γöé    ΓööΓöÇΓöÇ Error code
  8996.       Γöé         Γöé        Γöé
  8997.       Γöé         Γöé        ΓööΓöÇΓöÇ Line number in source file
  8998.       Γöé         Γöé                where error occurred
  8999.       Γöé         Γöé
  9000.       Γöé         ΓööΓöÇΓöÇ Filename of source file
  9001.       Γöé
  9002.       ΓööΓöÇΓöÇ Drive and path of source file
  9003.  
  9004.  
  9005. ΓòÉΓòÉΓòÉ 10.1.1. Warning Level 1 Messages ΓòÉΓòÉΓòÉ
  9006.  
  9007.  101       Invalid document body 
  9008.  
  9009.             Explanation:  No :userdoc./:euserdoc. match. 
  9010.  
  9011.            This is a fatal error that will cause the compiler to stop 
  9012.            executing. 
  9013.  
  9014.  
  9015.  102       Invalid tag syntax 
  9016.  103       Missing hypertext information 
  9017.  104       Cannot hide parent head level 
  9018.  
  9019.            Explanation:  Preceding head level must be hidden. 
  9020.  
  9021.  
  9022.  105       Illegal context for tag 
  9023.  
  9024.            Explanation:  Tags are not properly matched, a tag is used 
  9025.            incorrectly, or a tag is placed incorrectly. 
  9026.  
  9027.  
  9028.  106       List start tag missing-tag ignored 
  9029.  107       List end tag not matched-tag ignored 
  9030.  108       Ignoring unmatched tag 
  9031.  109       Cannot open file 
  9032.  
  9033.            Explanation:  SYSTEM ERROR.  Filename or path is incorrect, file 
  9034.            doesn't exist, or other system problem. 
  9035.  
  9036.  
  9037.  110       No id for this reference 
  9038.  112       No id for this footnote 
  9039.  113       No text found in tag 
  9040.  114       Page is too big 
  9041.  
  9042.            Explanation:  Panel is too big.  Maximum size is 16 000 words and 
  9043.            punctuation marks. (Note maximum size is language dependent.) 
  9044.  
  9045.  
  9046.  116       Cannot create panel(s) 
  9047.  
  9048.            This is a fatal error that will cause the compiler to stop 
  9049.            executing. 
  9050.  
  9051.  
  9052.  117       Duplicate text in tag 
  9053.  118       Duplicate root word 
  9054.  119       Duplicate tag in tag file 
  9055.  120       Ignoring text before :h1. tag 
  9056.  121       Invalid head level 
  9057.  
  9058.            Explanation:  Head levels are not in consecutive order. 
  9059.  
  9060.            Example:  If :h1. and :h3. are used and :h2. is missing, this error 
  9061.            will occur. 
  9062.  
  9063.  
  9064.  122       Definition term or header not matched 
  9065.  123       Unexpected end of file 
  9066.  
  9067.            Explanation:  This may be caused by an ending tag not being found, a 
  9068.            corrupted or truncated source file, or a control-Z character found 
  9069.            before the true end of file. 
  9070.  
  9071.            This is a fatal error that will cause the compiler to stop 
  9072.            executing. 
  9073.  
  9074.  
  9075.  124       Invalid tag in footnote 
  9076.  125       Not enough memory 
  9077.  
  9078.            Explanation:  SYSTEM ERROR.  Close some applications to free some 
  9079.            memory. 
  9080.  
  9081.            This is a fatal error that will cause the compiler to stop 
  9082.            executing. 
  9083.  
  9084.  
  9085.  126       Cannot free memory 
  9086.  
  9087.            Explanation:  SYSTEM ERROR.  System could not free memory. 
  9088.  
  9089.            This is a fatal error that will cause the compiler to stop 
  9090.            executing. 
  9091.  
  9092.  
  9093.  127       Cannot read file 
  9094.  
  9095.            Explanation:  SYSTEM ERROR.  Source file may be corrupted. 
  9096.  
  9097.            This is a fatal error that will cause the compiler to stop 
  9098.            executing. 
  9099.  
  9100.  
  9101.  129       Document is too big - unique words exceed 16 000 
  9102.  
  9103.            This is a fatal error that will cause the compiler to stop 
  9104.            executing. 
  9105.  
  9106.  
  9107.  130       A DT tag is not defined 
  9108.  131       A PT tag is not defined 
  9109.  132       Cannot write to a file 
  9110.  
  9111.            Explanation:  SYSTEM ERROR.  File system is full, out of disk space, 
  9112.            diskette is write protected, etc. 
  9113.  
  9114.            This is a fatal error that will cause the compiler to stop 
  9115.            executing. 
  9116.  
  9117.  
  9118.  133       Attribute not defined 
  9119.  134       Tag not defined 
  9120.  135       Invalid bitmap format 
  9121.  
  9122.            Explanation:  File is not a valid PM format bitmap file. 
  9123.  
  9124.  
  9125.  140       Invalid country code, or codepage 
  9126.  
  9127.            This is a fatal error that will cause the compiler to stop 
  9128.            executing. 
  9129.  
  9130.  
  9131.  141       Invalid language code 
  9132.  
  9133.            This is a fatal error that will cause the compiler to stop 
  9134.            executing. 
  9135.  
  9136.  
  9137.  143       No valid COLS specification was given 
  9138.  144       Ignoring invalid tag in table cell 
  9139.  145       Ignoring text before :c. tag 
  9140.  146       Extra cells will be placed in next table row 
  9141.  147       Missing ELINK tag inserted at end of table cell 
  9142.  148       Total table width exceeds limit of 250 characters 
  9143.  149       Cannot reopen. File is already opened 
  9144.  
  9145.            Explanation:  SYSTEM ERROR. 
  9146.  
  9147.  
  9148.  150       Document has no vocabulary 
  9149.  
  9150.            This is a fatal error that will cause the compiler to stop 
  9151.            executing. 
  9152.  
  9153.  
  9154.  151       No res for this reference 
  9155.  152       Duplicate tag in source file 
  9156.  153       Document has no visible table of contents entry 
  9157.  
  9158.            This is a fatal error that will cause the compiler to stop 
  9159.            executing. 
  9160.  
  9161.  
  9162.  154       Truncating table entry 
  9163.  
  9164.            This is a warning to tell the user when the text for a table cell is 
  9165.            too long for the size of the cell. 
  9166.  
  9167.  
  9168. ΓòÉΓòÉΓòÉ 10.1.2. Warning Level 2 Messages ΓòÉΓòÉΓòÉ
  9169.  
  9170.  201       Invalid tag 
  9171.  202       Invalid attribute 
  9172.  203       Invalid symbol 
  9173.  
  9174.            Explanation:  Invalid APS symbol; period missing after the APS 
  9175.            symbol, symbol specified is not in the APSYMBOL.APS file, invalid 
  9176.            APSYMBOL.APS file. 
  9177.  
  9178.  
  9179.  204       Invalid macro 
  9180.  205       Text too long in tag 
  9181.  
  9182.            Explanation:  Heading and index tags have a maximum of 150 
  9183.            characters. 
  9184.  
  9185.  
  9186.  206       Token is bigger than expected. 
  9187.  
  9188.            Explanation:  Maximum length of token is 255 characters.  This error 
  9189.            could be caused by a missing end period or quote character. 
  9190.  
  9191.  
  9192.  207       Invalid attribute value 
  9193.  208       Missing tag 
  9194.  209       Attribute not matched 
  9195.  210       Text too long in macro expansion 
  9196.  
  9197.            Explanation:  Maximum 255 characters. 
  9198.  
  9199.  
  9200.  211       Total number of fonts exceeds the limit of 14 
  9201.  212       Sub index cannot be global without global main index 
  9202.  213       Invalid nest 
  9203.  
  9204.  
  9205. ΓòÉΓòÉΓòÉ 10.1.3. Warning Level 3 Messages ΓòÉΓòÉΓòÉ
  9206.  
  9207.  301       Ignoring attribute 
  9208.  302       Duplicate ID 
  9209.  
  9210.            Explanation:  Cannot specify the same ID in the same panel or index. 
  9211.  
  9212.  
  9213.  303       Duplicate symbol in symbol file 
  9214.  304       Duplicate res number 
  9215.  305       Parent panel cannot have its own text 
  9216.  306       Missing panel text in head level tag 
  9217.  307       Missing footnote text in :fn. tag 
  9218.  
  9219.  
  9220. ΓòÉΓòÉΓòÉ 11. Enabling Help for Applications ΓòÉΓòÉΓòÉ
  9221.  
  9222. While running an application the user sometimes requires help.  For example, 
  9223. the user may need assistance in making a choice, recalling the name of an 
  9224. application command or the use of a function key, or locating information. 
  9225.  
  9226. Using IPF, you can develop a user interface that provides general help for 
  9227. application windows, and contextual help for fields within windows. 
  9228.  
  9229. Implementing the IPF user interface when creating helps for an application 
  9230. requires two different development efforts: 
  9231.  
  9232.      Developing the programming code that communicates with IPF and the 
  9233.       Presentation Manager to display help windows. 
  9234.  
  9235.      Developing a library of help information that IPF refers to in response 
  9236.       to a user request. 
  9237.  
  9238.  This section will concentrate on the first development effort:  writing the 
  9239.  programming code that enables communication between IPF and the Presentation 
  9240.  Manager. 
  9241.  
  9242.  
  9243. ΓòÉΓòÉΓòÉ 11.1. Developing the Application Code ΓòÉΓòÉΓòÉ
  9244.  
  9245. Use the following steps to develop the application code that adds help to your 
  9246. application. 
  9247.  
  9248.    1. Set up the help table and help subtable, and include the help constants 
  9249.       defined in PMHELP.H. 
  9250.  
  9251.    2. Initialize the HELPINIT structure with a call to DosLoadModule. 
  9252.  
  9253.    3. Create a help instance. 
  9254.  
  9255.    4. Associate the help instance with the application window chain. 
  9256.  
  9257.    5. Respond to messages for menu bar choices. 
  9258.  
  9259.    6. End the help instance. 
  9260.  
  9261.  The following sections describe how to implement each of these steps. 
  9262.  
  9263.  
  9264. ΓòÉΓòÉΓòÉ 11.1.1. Setting Up the IPF Help Tables ΓòÉΓòÉΓòÉ
  9265.  
  9266. Two table structures in application memory or in resource files (.RC file-name 
  9267. extension), identify window resources in the IPF library.  The help table 
  9268. associates each application window with its corresponding help subtable and the 
  9269. window identifier of its extended help window.  The help subtable associates 
  9270. each entry field, menu item and push button within an application window with 
  9271. the window identifier (ID) of its help window.  The address of the help table 
  9272. is passed to the application during initialization of the IPF initializing 
  9273. structure (HELPINIT). 
  9274.  
  9275. When the user requests help on a field, menu bar, or push button in the 
  9276. application window, IPF uses the help subtable associated with the field to 
  9277. find the window ID of the contextual help window for the field.  The help 
  9278. subtable also can store optional entries relating to application-specific 
  9279. information. 
  9280.  
  9281. The maximum size of the help table is 64KB. The number of help subtables is 
  9282. limited to 16 000. 
  9283.  
  9284. IPF supports two methods of defining help tables and help subtables. They can 
  9285. be allocated in memory, or they can be defined as resources. In either case, 
  9286. the information passed to IPF is identical. 
  9287.  
  9288.  
  9289. ΓòÉΓòÉΓòÉ 11.1.1.1. Defining Help Tables in Memory ΓòÉΓòÉΓòÉ
  9290.  
  9291. By defining help tables and subtables in memory, you can dynamically change a 
  9292. single entry in the help table. You can add a new window ID to be associated 
  9293. with a field, or add fields that are to be associated with existing windows. 
  9294.  
  9295. After the help table structure is initialized, the application can pass IPF the 
  9296. address in memory of the new help table, either by sending the 
  9297. HM_CREATE_HELP_TABLE message from its window procedure, or by calling 
  9298. WinCreateHelpTable. 
  9299.  
  9300. When defining help tables in memory, the data structures in PMHELP.H are used. 
  9301. The help table contains the structure for each application window. This 
  9302. structure holds the following information: 
  9303.  
  9304.      Application window ID 
  9305.      Address of the window's subtable 
  9306.      Window ID of the window's extended help window 
  9307.  
  9308.  These entries are integers.  The last entry in the list contains a NULL for 
  9309.  each entry type, to indicate the end of the list.  The following is an example 
  9310.  of a help table for an application. 
  9311.  
  9312.   HELPSUBTABLE        table1, table2, table3,
  9313.                       table4, table5;
  9314.  
  9315.   HELPTABLE     helpTableEntry [] =
  9316.   {
  9317.     APP_WIND_1,  &table1, idExtHelp1,
  9318.     APP_WIND_2,  &table2, idExtHelp2,
  9319.     APP_WIND_3,  &table3, idExtHelp3,
  9320.     APP_WIND_4,  &table4, idExtHelp4,
  9321.     APP_WIND_5,  &table5, idExtHelp5,
  9322.     0,           NULL,    NULL
  9323.   };
  9324.  
  9325.  The help subtable contains the structure defined in the PMHELP.H file for each 
  9326.  application window. This structure holds the following information for each 
  9327.  field in the application window: 
  9328.  
  9329.      Field ID from which user requests help 
  9330.      Window ID of the contextual help window associated with the field 
  9331.      Optional, application-specific integers. 
  9332.  
  9333.  The last entry in the structure contains the word length for each field entry. 
  9334.  The minimum number of words is two, which is the default.  The following is an 
  9335.  example of a help subtable for an application window that has six fields. 
  9336.  
  9337.   HELPSUBTABLE        HelpSubTable [] =
  9338.   {
  9339.     2,
  9340.     FIELD_ID_1, IDRES_HELP1,
  9341.     FIELD_ID_2, IDRES_HELP2,
  9342.     FIELD_ID_3, IDRES_HELP3,
  9343.     FIELD_ID_4, IDRES_HELP4,
  9344.     FIELD_ID_5, IDRES_HELP5,
  9345.     FIELD_ID_6, IDRES_HELP6,
  9346.     0,          0
  9347.   };
  9348.  
  9349.  
  9350. ΓòÉΓòÉΓòÉ 11.1.1.2. Defining Help Tables as Resources ΓòÉΓòÉΓòÉ
  9351.  
  9352. If help tables are defined as resources, they can be bound to the application's 
  9353. executable file, or they can reside in a dynamic link library (DLL). 
  9354.  
  9355. If help tables are defined as resources in a dynamic link library, the 
  9356. application must call DosLoadModule to load the DLL before it calls 
  9357. WinCreateHelpInstance. When the application calls WinCreateHelpInstance, it 
  9358. passes the handle to the DLL and the resource ID of the help table in the 
  9359. HELPINIT structure. 
  9360.  
  9361. The application can load a new help table residing in the DLL by either sending 
  9362. the HM_LOAD_HELP_TABLE message from its window procedure, or by calling 
  9363. WinLoadHelpTable. The application passes the handle to the DLL and the resource 
  9364. ID of the new help table. 
  9365.  
  9366. A HELPTABLE resource contains a HELPITEM entry for each application window, 
  9367. dialog, and message box for which help is provided. 
  9368.  
  9369. Each entry of a HELPTABLE resource contains: 
  9370.  
  9371.      HELPITEM keyword 
  9372.      Application window ID 
  9373.      ID of the HELPSUBTABLE resource 
  9374.      Window ID of the extended help window. 
  9375.  
  9376.  A HELPSUBTABLE resource contains an entry for each item that can be selected 
  9377.  in an application window. Each of these items is assumed to be a child window 
  9378.  of the application window identified in the HELPTABLE resource. The 
  9379.  HELPSUBTABLE should contain a single SUBITEMSIZE and a HELPSUBITEM for each 
  9380.  control, child window, and menu item. 
  9381.  
  9382.  Each entry of a HELPSUBTABLE resource contains: 
  9383.  
  9384.      HELPSUBITEM keyword 
  9385.      Field ID 
  9386.      Window ID of the field's help window (corresponds to the resource number 
  9387.       specified in the heading tag of the help-text window) 
  9388.      Optional, application-defined integers. 
  9389.  
  9390.  The integer ID of the field can be a control, menu item, or message box ID. 
  9391.  The ID specified must be unique within the table. An ID of hex FFFF is 
  9392.  reserved for use by IPF. 
  9393.  
  9394.  The optional integers value allows the writer of the resource script file to 
  9395.  append additional integers to the end of each HELPSUBITEM for 
  9396.  application-specific use. 
  9397.  
  9398.  The SUBITEMSIZE keyword is used to identify the size in words of each 
  9399.  HELPSUBITEM.  All entries must be the same length. If this value is specified, 
  9400.  it must be greater than or equal to 2. If this value is not specified, it 
  9401.  defaults to 2. 
  9402.  
  9403.  All referenced HELPSUBTABLE resources must reside in the same .RES file as the 
  9404.  HELPTABLE resource. 
  9405.  
  9406.  Following is an example of .RC source file for defining a HELPTABLE and its 
  9407.  related HELPSUBTABLE resources. 
  9408.  
  9409.   HELPTABLE TABLE_1
  9410.   BEGIN
  9411.   HELPITEM parentwindow1, SUBTABLE_1,
  9412.     extendedhelppanel1
  9413.   HELPITEM parentwindow2, SUBTABLE_2,
  9414.     extendedhelppanel2
  9415.   END
  9416.  
  9417.   HELPSUBTABLE SUBTABLE_1
  9418.   [SUBITEMSIZE subitemsize1]
  9419.   BEGIN
  9420.     HELPSUBITEM FIELD_ID1, helppanel1 [,
  9421.       integer1, ...n]
  9422.     HELPSUBITEM FIELD_ID2, helppanel2 [,
  9423.       integer1, ...n]
  9424.   END
  9425.  
  9426.   HELPSUBTABLE SUBTABLE_2
  9427.   [SUBITEMSIZE subitemsize2]
  9428.   BEGIN
  9429.     HELPSUBITEM FIELD_ID3, helppanel3 [,
  9430.       integer1, ...n]
  9431.     HELPSUBITEM FIELD_ID4, helppanel4 [,
  9432.       integer1, ...n]
  9433.   END
  9434.  
  9435.  
  9436. ΓòÉΓòÉΓòÉ 11.1.2. Initializing the HELPINIT Structure ΓòÉΓòÉΓòÉ
  9437.  
  9438. Before you call WinCreateHelpInstance, you must allocate memory for and 
  9439. initialize the HELPINIT structure.  This structure defines values that IPF 
  9440. needs to create the help instance.  Some of the values can be changed by your 
  9441. application after initialization. 
  9442.  
  9443. The HELPINIT structure and the help table structures referred to by IPF during 
  9444. help processing are contained in the PMHELP.H file. The PMHELP.H file also 
  9445. contains the error codes returned in the event of an unsuccessful call. You 
  9446. include this file in your source code by using the INCL_WINHELP define 
  9447. statement. The following shows the HELPINIT structure. 
  9448.  
  9449. typedef struct _HELPINIT /* hinit */
  9450. {
  9451.  
  9452. ULONG          cb;
  9453. ULONG          ulReturnCode;
  9454. PSZ            pszTutorialName;
  9455. PHELPTABLE     phtHelpTable;
  9456. HMODULE        hmodHelpTableModule;
  9457. HMODULE        hmodAccelActionBarModule;
  9458. ULONG          idAccelTable;
  9459. ULONG          idActionBar;
  9460. PSZ            pszHelpWindowTitle;
  9461. ULONG          fShowPanelId;
  9462. PSZ            pszHelpLibraryName;
  9463. } HELPINIT;
  9464.  
  9465. Following are descriptions of the HELPINIT structure fields. 
  9466.  
  9467.  Field Name          Description 
  9468.  
  9469.  cb                  The length of the initialization structure.  This value 
  9470.                      can be use to identify the version of IPF being used. 
  9471.  
  9472.  ulReturnCode        The IPF return code 
  9473.  
  9474.  pszTutorialName     A pointer to a tutorial name, if one exists.  If this 
  9475.                      value is NULL, either the application help interface does 
  9476.                      not include a tutorial, or the tutorial is referenced from 
  9477.                      a help window.  If this value is not NULL, IPF provides a 
  9478.                      Tutorial choice in the help pull-down and adds a push 
  9479.                      button to the control area. 
  9480.  
  9481.                      If the user selects the Tutorial choice in the pull-down, 
  9482.                      IPF sends the HM_TUTORIAL message to the application so 
  9483.                      that it can start the tutorial. 
  9484.  
  9485.  phtHelpTable        If the help table is in memory this ia a pointer to the 
  9486.                      help table. If the help table is a resource, this is the 
  9487.                      resource ID ORed with 0xFFFF0000. 
  9488.  
  9489.  hmodHelpTableModule The name of the resource file that indexes the dynamic 
  9490.                      link library that contains the help table and its 
  9491.                      corresponding subtables.  If the help table is not being 
  9492.                      accessed through a dynamic link library, this value is 0. 
  9493.  
  9494.  hmodAccelActionBarModule The name of the dynamic link library that contains 
  9495.                      the modified menu bar. If you do not have a modified menu 
  9496.                      bar, this value is 0. 
  9497.  
  9498.  idAccelTable        The name of the accelerator table if you are using a 
  9499.                      modified menu bar; otherwise, this value is 0. 
  9500.  
  9501.  idActionBar         The identity of the menu bar (action bar) template.  If 
  9502.                      you are not modifying the menu bar, this value is 0. 
  9503.  
  9504.  pszHelpWindowTitle  A pointer to the name of the title for the main help 
  9505.                      window.  This name can be changed after initialization by 
  9506.                      sending the message HM_SET_HELP_WINDOW_TITLE. 
  9507.  
  9508.  fShowPanelId        A flag used to append the window ID to the beginning of 
  9509.                      the help window title in the title bar of the help window. 
  9510.                      If this flag is set to CMIC_SHOW_PANEL_ID, the window IDs 
  9511.                      are displayed. If this flag is set to CMIC_HIDE_PANEL_ID 
  9512.                      or to 0, the window IDs are not displayed. 
  9513.  
  9514.                      This flag is useful during the development stages of the 
  9515.                      help interface. 
  9516.  
  9517.                      After initialization, this flag can be toggled with the 
  9518.                      HM_SET_SHOW_PANEL_ID message. 
  9519.  
  9520.  pszHelpLibraryName  The help library names of the .HLP files containing the 
  9521.                      help windows. These .HLP files are created by the IPF 
  9522.                      compiler.  When IPF needs to search for a help window, it 
  9523.                      looks for these library names in the path set by the HELP 
  9524.                      environment variable.  If IPF cannot find a library name 
  9525.                      in this path, it then searches the current directory. 
  9526.  
  9527.                      After initialization, help library names can be specified 
  9528.                      with the HM_SET_HELP_LIBRARY_NAME message.  If multiple 
  9529.                      libraries are specified, library names must be separated 
  9530.                      by a blank space. 
  9531.  
  9532.  The following example shows a help facility being initialized.  Notice that 
  9533.  hmodAccelActionBarModule, idAccelTabl      e, and idActionBar have values set 
  9534.  to 0; this is because this example uses a standard menu bar. 
  9535.  
  9536.   VOID HelpInit (VOID)
  9537.   {
  9538.      HELPINIT hini;
  9539.  
  9540.      /* if we return because of an error, Help will be disabled */
  9541.      fHelpEnabled = FALSE;
  9542.  
  9543.      /* initialize help init structure */
  9544.      hini.cb = sizeof (HELPINIT)
  9545.      hini.ulReturnCode = 0L;
  9546.  
  9547.      hini.pszTutorialName = (PSZ)NULL /*if tutorial added, add name here*/
  9548.  
  9549.      hini.phtHelpTable = (PHELPTABLE)MAKELONG(JIGSAW_HELP_TABLE, 0xFFFF);
  9550.      hini.hmodHelpTableModule = (HMODULE)0;
  9551.      hini.hmodAccelActionBarModule = (HMODULE)0;
  9552.      hini.idAccelTable = 0;
  9553.      hini.idActionBar = 0;
  9554.  
  9555.      if (!WinLoadString (habMain,
  9556.               (HMODULE)0,
  9557.               IDS_HELPWINDOWTITLE,
  9558.               HELPLIBRARYNAMELEN,
  9559.               (PSZ)szWindowTitle))
  9560.  
  9561.      {
  9562.        MessageBox (habMain, IDS_CANNOTLOADSTRING, MB_OK | MB_ERROR, FALSE);
  9563.        return;
  9564.      }
  9565.  
  9566.      hini.pszHelpWindowTitle = (PSZ)szWindowTitle;
  9567.  
  9568.      /*  if debugging, show panel ids; else, don't   */
  9569.   #ifdef DEBUG
  9570.      hini.fShowPanelId = CMIC_SHOW_PANEL_ID;
  9571.   #else
  9572.      hini.fShowPanelId = CMIC_HIDE_PANEL_ID;
  9573.   #endif
  9574.  
  9575.      if (!WinLoadString (habMain,
  9576.               (HMODULE)0,
  9577.               IDS_HELPLIBRARYNAME,
  9578.               HELPLIBRARYNAMELEN,
  9579.               (PSZ)szLibName))
  9580.      {
  9581.      MessageBox (habMain, IDS_CANNOTLOADSTRING, MB_OK | MB_ERROR, FALSE);
  9582.      return;
  9583.      }
  9584.  
  9585.      hini.pszHelpLibraryName = (PSZ)szLibName;
  9586.  
  9587.  
  9588. ΓòÉΓòÉΓòÉ 11.1.3. Creating the Help Instance ΓòÉΓòÉΓòÉ
  9589.  
  9590. The WinCreateHelpInstance call passes the HELPINIT structure defined in the 
  9591. PMHELP.H include file to the Presentation Manager. WinCreateHelpInstance 
  9592. returns a handle to the help instance, which you must store in a HWND variable 
  9593. for use with the rest of the application programming interface (API) function 
  9594. calls associated with IPF. 
  9595.  
  9596. IPF responds to the WinCreateHelpInstance call by installing its help hook and 
  9597. initializing for help processing. 
  9598.  
  9599. The following shows how a help instance is created. 
  9600.  
  9601.    /*  Creating help instance */
  9602.    hwndHelpInstance = WinCreateHelpInstance (habMain, &hini);
  9603.  
  9604.    if (!hwndHelpInstance || hini.ulReturnCode)
  9605.    {
  9606.    MessageBox (hwndFrame,
  9607.          IDS_HELPLOADERROR,
  9608.          MB_OK | MB_ERROR,
  9609.          TRUE);
  9610.    return;
  9611.    }
  9612.  
  9613.  
  9614. ΓòÉΓòÉΓòÉ 11.1.4. Associating the Instance with the Window Chain ΓòÉΓòÉΓòÉ
  9615.  
  9616. After an application creates a help instance, it must associate the instance 
  9617. with the application window chain by calling WinAssociateHelpInstance. IPF uses 
  9618. the active window handle passed by this call to index into the help table to 
  9619. find the help window that should be displayed for the application window. 
  9620.  
  9621. An IPF instance can be associated with any application window that has a frame. 
  9622. Once the association of an IPF instance with the application window chain is 
  9623. made, help can be requested for any application window in the chain. 
  9624.  
  9625. The following shows how a help instance is associated with the application 
  9626. window chain. 
  9627.  
  9628.    /*  associate the help instance with the main frame  */
  9629.    if (!WinAssociateHelpInstance (hwndHelpInstance, hwndFrame))
  9630.    {
  9631.    MessageBox (hwndFrame,
  9632.          IDS_HELPLOADERROR,
  9633.          MB_OK | MB_ERROR,
  9634.          TRUE);
  9635.    return;
  9636.    }
  9637.  
  9638.    /*  IPF is successfully initialized; set flag to TRUE  */
  9639.    fHelpEnabled = TRUE;
  9640.  
  9641.  
  9642. ΓòÉΓòÉΓòÉ 11.1.5. Ending the Help Instance ΓòÉΓòÉΓòÉ
  9643.  
  9644. To end the current help instance, the application calls WinDestroyHelpInstance, 
  9645. passing the handle of the help instance that is to be ended. 
  9646.  
  9647. The parameter hwndHelpInstance is the handle to the IPF instance returned from 
  9648. the WinCreateHelpInstance call. 
  9649.  
  9650. The following shows how a help instance is terminated. 
  9651.  
  9652. VOID DestroyHelpInstance (VOID)
  9653. {
  9654.    if (hwndHelpInstance)
  9655.    {
  9656.      WinDestroyHelpInstance (hwndHelpInstance);
  9657.    }
  9658. }
  9659.  
  9660.  
  9661. ΓòÉΓòÉΓòÉ 11.2. Responding to Messages for Menu Bar Choices ΓòÉΓòÉΓòÉ
  9662.  
  9663. IPF communicates with the active window.  This communication is accomplished 
  9664. with messages.  The application may need to do some of its own processing in 
  9665. response to these messages. 
  9666.  
  9667.  
  9668. ΓòÉΓòÉΓòÉ 11.2.1. Processing "Using help" Requests ΓòÉΓòÉΓòÉ
  9669.  
  9670. When the user selects "Using help" from the help pull-down menu, a WM_COMMAND 
  9671. is sent to the application's window procedure. 
  9672.  
  9673. If the application has created its own "Using help" window, it responds by 
  9674. sending the HM_REPLACE_USING_HELP message with the help-window ID.  If the 
  9675. application chooses to use the "Using help" window provided by IPF, it responds 
  9676. by sending the HM_DISPLAY_HELP with NULL in both parameters. 
  9677.  
  9678. Current CUA guidelines recommend applications use "Using help"; however, IPF 
  9679. continues to support the "Help for help" window. 
  9680.  
  9681.  
  9682. ΓòÉΓòÉΓòÉ 11.2.2. Processing a "Keys Help" Request ΓòÉΓòÉΓòÉ
  9683.  
  9684. When the user selects "Keys help" from the help pull-down, an HM_KEYS_HELP 
  9685. message is sent by the application to IPF. In response, IPF sends an 
  9686. HM_QUERY_KEYS_HELP message to the application.  The application returns the 
  9687. window ID of the keys help window. 
  9688.  
  9689.  
  9690. ΓòÉΓòÉΓòÉ 11.2.3. Processing Help Requests for a Child Window ΓòÉΓòÉΓòÉ
  9691.  
  9692. In the Presentation Manager, parent and child windows are active at the same 
  9693. time.  Therefore, when a help instance is associated with a window, its 
  9694. descendants are included in the association.  However, only the parent window 
  9695. is the active help window. 
  9696.  
  9697. Note:  Do not confuse child windows with dialog, message boxes, and other 
  9698.        windows which the application may own but are actually children of the 
  9699.        desktop. 
  9700.  
  9701.  For IPF to process help requests for a child window, an application must send 
  9702.  IPF HM_SET_ACTIVE_WINDOW messages to set the active help window.  Until this 
  9703.  happens, IPF continues to satisfy help requests for the child window from the 
  9704.  help subtable for the parent window. 
  9705.  
  9706.  The HM_SET_ACTIVE_WINDOW message should be sent by ALL windows in response to 
  9707.  the WM_ACTIVATE and WM_INITMENU messages as shown in the following example. 
  9708.  
  9709.      switch( usMsg )
  9710.      {
  9711.                                  ┬╖
  9712.                                  ┬╖
  9713.                                  ┬╖
  9714.      case WM_ACTIVATE:
  9715.         if( SHORT1FROMMP( mp1 ) )
  9716.         {
  9717.            /*
  9718.             * Set active help window to this window's parent when
  9719.             * activated
  9720.             */
  9721.            WinSendMsg( WinQueryHelpInstance( hWnd ),
  9722.                        HM_SET_ACTIVE_WINDOW,
  9723.                        WinQueryWindow( hWnd, QW_PARENT ),
  9724.                        WinQueryWindow( hWnd, QW_PARENT ) );
  9725.         }
  9726.         else
  9727.         {
  9728.            /*
  9729.             * Clear active help window when this window is
  9730.             * deactivated - necessary for message box help, etc.
  9731.             * to work properly.
  9732.             */
  9733.            WinSendMsg( WinQueryHelpInstance( hWnd ),
  9734.                        HM_SET_ACTIVE_WINDOW,
  9735.                        NULL,
  9736.                        NULL );
  9737.         }
  9738.         break;
  9739.  
  9740.      case WM_INITMENU:
  9741.         /*
  9742.          * Set active window to this window's parent here so that
  9743.          * the menu id will be found in the proper subtable.
  9744.          * Activation and deactivation of the help window will
  9745.          * take care of setting the help window back to the
  9746.          * active window.
  9747.          */
  9748.         WinSendMsg( WinQueryHelpInstance( hWnd ),
  9749.                     HM_SET_ACTIVE_WINDOW,
  9750.                     WinQueryWindow( hWnd, QW_PARENT ),
  9751.                     WinQueryWindow( hWnd, QW_PARENT ) );
  9752.         break;
  9753.  
  9754.                                   ┬╖
  9755.                                   ┬╖
  9756.                                   ┬╖
  9757.      }
  9758.  
  9759.  
  9760. ΓòÉΓòÉΓòÉ 11.2.4. When No Help Is Available ΓòÉΓòÉΓòÉ
  9761.  
  9762. A user may request help by pressing F1 when the cursor is positioned on an item 
  9763. for which no field-level help is available. In such a case, IPF sends the 
  9764. HM_HELPSUBITEM_NOT_FOUND message to the application.  To display the extended 
  9765. help window, the application then can either return FALSE or ignore the 
  9766. message.  If the application returns TRUE, there is no response to the user 
  9767. request. 
  9768.  
  9769.  
  9770. ΓòÉΓòÉΓòÉ 11.2.5. Help Window Resources ΓòÉΓòÉΓòÉ
  9771.  
  9772. You can define the following window resources for the help interface: 
  9773.  
  9774.      Help pull-down 
  9775.  
  9776.      Help push button 
  9777.  
  9778.      Command entry field 
  9779.  
  9780.      Customized menu bar. 
  9781.  
  9782.  
  9783. ΓòÉΓòÉΓòÉ 11.2.6. Help Pull-Down ΓòÉΓòÉΓòÉ
  9784.  
  9785. CUA guidelines recommend that all application windows with menu bars include a 
  9786. help pull-down menu. The help application menu bar choice and corresponding 
  9787. pull-down menu is defined in your resource file. The following example shows 
  9788. how to define the help pulldown. 
  9789.  
  9790. MENU IDR_MAIN PRELOAD
  9791. BEGIN
  9792.     SUBMENU "~File",                           IDM_FILE
  9793.     BEGIN
  9794.         MENUITEM "~Open...",                   IDM_LOAD
  9795.     END
  9796.  
  9797.     SUBMENU "~Options",                        IDM_OPTIONS
  9798.     BEGIN
  9799.         SUBMENU "Size",                        IDM_SIZE_MENU
  9800.         BEGIN
  9801.             MENUITEM "Small",                  IDM_SIZE_SMALL,   0, MIS_TEXT
  9802.             MENUITEM "Medium",                 IDM_SIZE_MEDIUM,  0, MIS_TEXT
  9803.             MENUITEM "Large",                  IDM_SIZE_LARGE,   0, MIS_TEXT
  9804.             MENUITEM "Full Size",              IDM_SIZE_FULL,    0, MIA_CHECKED
  9805.         END
  9806.  
  9807.         MENUITEM "~Jumble!",                   IDM_JUMBLE
  9808.     END
  9809.  
  9810.     SUBMENU "~Help",                           IDM_HELP,            MIS_TEXT
  9811.     BEGIN
  9812.         MENUITEM "Help ~index",                IDM_HELPINDEX,       MIS_TEXT
  9813.         MENUITEM "~General help",              IDM_HELPEXTENDED,    MIS_TEXT
  9814.         MENUITEM "~Using help",                IDM_HELPHELPFORHELP, MIS_TEXT
  9815.         MENUITEM     SEPARATOR
  9816.         MENUITEM "~Product information",       IDM_HELPABOUT,       MIS_TEXT
  9817.     END
  9818. END
  9819.  
  9820.  
  9821. ΓòÉΓòÉΓòÉ 11.2.7. Help Push Button ΓòÉΓòÉΓòÉ
  9822.  
  9823. If your application has a dialog or message area, you may want to include the 
  9824. Help push button in the bottom area of the secondary application window (dialog 
  9825. box). To define the Help push button, use the Presentation Manager button style 
  9826. BS_HELP and BS_NOPOINTERFOCUS. 
  9827.  
  9828. The BS_HELP style causes the Presentation Manager to call IPF when the user 
  9829. selects this Help push button. The BS_NOPOINTERFOCUS style enables the 
  9830. Presentation Manager to determine the field for which the user requested help. 
  9831.  
  9832.  
  9833. ΓòÉΓòÉΓòÉ 11.2.8. Command Entry Field ΓòÉΓòÉΓòÉ
  9834.  
  9835. An entry field is a control window that enables users to enter text. A command 
  9836. entry field is used for typing commands, and may be programmed to accept 
  9837. entries recognized by the application. 
  9838.  
  9839. For example, a command entry field might be used in an interpreter with a 
  9840. Presentation Manager interface.  The field would accept a request from the user 
  9841. and execute it.  Similarly, a command entry field might be used in an editor in 
  9842. a "command mode" to accept advanced instructions not associated with any 
  9843. editing keys.  Any time the user has a limited number of correct responses, a 
  9844. command entry field may be appropriate. 
  9845.  
  9846. Help windows for application commands can be associated with a command entry 
  9847. field by imbedding the index command tag (:icmd.) with a command name in the 
  9848. window that describes the command. 
  9849.  
  9850. When the cursor is positioned in the associated entry field and the user 
  9851. presses F1 or selects the Help push button, titles of windows that contain 
  9852. these tags are displayed in alphabetic order in a list box window. 
  9853.  
  9854.  
  9855. ΓòÉΓòÉΓòÉ 11.2.9. A Customized Menu Bar ΓòÉΓòÉΓòÉ
  9856.  
  9857. A Help menu bar template is shipped with the IBM Developer. The template is in 
  9858. the HMTAILOR.RC file.  Included in the template is the Help menu pull-down. 
  9859. You can customize the menu bar by adding pull-downs and choices to the Help 
  9860. menu bar template. 
  9861.  
  9862. When a menu bar or pull-down choice you have added is selected by the 
  9863. application user, IPF sends the HM_ACTIONBAR_COMMAND message to the currently 
  9864. active application window.  The low-order word of param1 contains the command 
  9865. value of the selected item. The command values of the actions added by the 
  9866. application must be between hex 7F00 and hex 7FFF for its commands. 
  9867.  
  9868. The accelerator table maps function keys to commands on help windows.  This 
  9869. table is also contained in the HMTAILOR.RC file. If you add a choice to the 
  9870. menu bar that maps to a key on the keyboard, you must also add an entry to the 
  9871. accelerator table for that choice. IPF functions depend on the entries that 
  9872. already exist in the system accelerator table.  They must not be altered. The 
  9873. command value specified in the accelerator table entry must be the same command 
  9874. value that was specified for the associated action in the menu bar template. 
  9875.  
  9876. If the HMTAILOR.RC file is changed, you must compile it using the resource 
  9877. compiler and attach it to the executable file. If the executable file is a DLL, 
  9878. you must call DosLoadModule to load it before calling WinCreateHelpInstance. 
  9879. Identify the handle to IPF in the hmodAccelActionBarModule field in the 
  9880. initialization structure. When this field is 0, IPF uses the default menu bar. 
  9881.  
  9882. The HMTAILOR.RC file includes the HMTAILOR.H file. 
  9883.  
  9884. Note:  When modifying the menu bar, define IDM_HM_MENU and 
  9885.        IDD_COVERPAGE_HM_ACCEL in your help header (.H) file. Also, add the IDs 
  9886.        in the idActionBar and idAccelTable fields in the HELPINIT structure. 
  9887.  
  9888.  
  9889. ΓòÉΓòÉΓòÉ 12. Customizing IPF with Communication Objects ΓòÉΓòÉΓòÉ
  9890.  
  9891. The IPF online help interface and specific help information can be customized 
  9892. by hooking a piece of Presentation Manager code into the IPF help facility. 
  9893. This code, which is actually an entry point in a DLL file, is called a 
  9894. communication object. 
  9895.  
  9896.  
  9897. ΓòÉΓòÉΓòÉ 12.1. Useful Communication Object Terminology ΓòÉΓòÉΓòÉ
  9898.  
  9899. Before you begin reading about how to create IPF communication objects and 
  9900. related topics (such as application-controlled windows), you need to be 
  9901. familiar with the terms which will be used to describe them. 
  9902.  
  9903.  acviewport 
  9904.       The :acviewport. tag, which enables an application to control what is 
  9905.       displayed in an IPF window (see :acviewport. (Application-Controlled 
  9906.       Window)). 
  9907.  
  9908.  application-controlled window 
  9909.       The window that you create using a communication object that is loaded by 
  9910.       an :acviewport. tag. 
  9911.  
  9912.  communication object 
  9913.       A child window of the object window; this child window can handle and 
  9914.       respond to messages (particularly HM_ messages). 
  9915.  
  9916.  DLL 
  9917.       A dynamic link library (DLL) is a collection of executable programming 
  9918.       code and data that is bound to an application at load time or run time, 
  9919.       rather than during linking. The programming code and data in a DLL can be 
  9920.       shared by several applications simultaneously. 
  9921.  
  9922.  entry point 
  9923.       A function called in the DLL that contains your communication object. 
  9924.       Specified in the :acviewport. tag with the objectname option. 
  9925.  
  9926.  object 
  9927.       For the purposes of this discussion, synonymous with entry point. 
  9928.  
  9929.  window procedure 
  9930.       Code that is activated in response to a message. The window procedure 
  9931.       controls the behavior and appearance of its associated windows. 
  9932.  
  9933.  
  9934. ΓòÉΓòÉΓòÉ 12.2. Two Kinds of Communication Objects ΓòÉΓòÉΓòÉ
  9935.  
  9936. How the communication object is loaded into memory is an indication of the 
  9937. purpose of the communication object. A DLL containing a communication object 
  9938. can be loaded into memory in two ways: 
  9939.  
  9940.    1. Through use of the :docprof. tag's dll attribute (see :docprof. 
  9941.       (Document Profile)). A communication object loaded through the :docprof. 
  9942.       tag is considered a "global" communication object because it affects the 
  9943.       IPF coverpage window and all of its children IPF windows. Essentially, a 
  9944.       :docprof.-loaded communication object can alter the overall behavior and 
  9945.       appearance of IPF, such as providing author-defined buttons in the 
  9946.       control area or special message handling. You can load only one 
  9947.       communication object in this manner. 
  9948.  
  9949.    2. Through use of the :acviewport. tags (see :acviewport. 
  9950.       (Application-Controlled Window)). A communication object loaded in this 
  9951.       way will only affect the specific application-controlled window and only 
  9952.       when that window is open. Therefore, a communication object loaded 
  9953.       through an :acviewport. tag is useful for tasks such as displaying video 
  9954.       clips or bit maps associated with a given help panel. However, if you 
  9955.       want a communication object to affect the overall appearance or behavior 
  9956.       of the IPF interface for a given help session, you will want to use a 
  9957.       "global" communication object (one that is loaded through the :docprof. 
  9958.       tag). Unlike a global communication object, you can load multiple 
  9959.       :acviewport. communication objects or refer to the same communication 
  9960.       object from multiple :acviewport. tags. 
  9961.  
  9962.  An acviewport communication object is called each time a window is opened.  A 
  9963.  global communication object is called only once. 
  9964.  
  9965.  
  9966. ΓòÉΓòÉΓòÉ 12.3. Purpose of Communication Objects ΓòÉΓòÉΓòÉ
  9967.  
  9968. Communication objects can provide several powerful capabilities: 
  9969.  
  9970.      You can write PM code that handles and responds to help-related messages. 
  9971.       For this, you would use a :docprof.-loaded "global" communication object. 
  9972.  
  9973.      You can write PM code to override the default appearance of the IPF help 
  9974.       interface.  For example, you can provide custom push buttons in the 
  9975.       control area. For this, you would use a :docprof.-loaded "global" 
  9976.       communication object. 
  9977.  
  9978.      You can write PM code that allows help information to include function 
  9979.       simulation, user interaction, and audio and video presentations (see 
  9980.       Controlling Windows with Applications (ACVIEWPORTS)). For this, you would 
  9981.       use an :acviewport.-loaded communication object. 
  9982.  
  9983.      You can write PM code that changes help information (including .INF 
  9984.       files) dynamically, with help window contents generated and formatted at 
  9985.       the time when the information is displayed to the user. For this, you 
  9986.       would use a :docprof.-loaded or "global" communication object. For more 
  9987.       information about changing help information dynamically, see Changing 
  9988.       Help Information at Run Time (DDF). 
  9989.  
  9990.  Essentially, a communication object is intended to provide message processing 
  9991.  when no application is present to handle this message processing. In other 
  9992.  words, your stand-alone PM applications can provide the same functionality 
  9993.  that is supported by communication objects. 
  9994.  
  9995.  However, unlike a stand-alone application, a communication object that 
  9996.  properly handles message passing can be used by any stand-alone application 
  9997.  and can interact with other communication objects. For example, a 
  9998.  communication object that provides system call support (such as querying 
  9999.  specific details about the user's system) might be useful to a broad range of 
  10000.  applications in their online information. 
  10001.  
  10002.  
  10003. ΓòÉΓòÉΓòÉ 12.4. Understanding Communication Objects ΓòÉΓòÉΓòÉ
  10004.  
  10005. Before you begin coding, you should understand the general steps involved in 
  10006. the creation and function of a communication object. The steps are as follows: 
  10007.  
  10008.    1. IPF encounters a :docprof. or :acviewport. tag. 
  10009.  
  10010.    2. Based on the content of the tag, IPF loads a DLL and calls a function 
  10011.       that corresponds to a communication object. 
  10012.  
  10013.    3. IPF passes 2 items to the communication object: 
  10014.  
  10015.         a. A pointer to an ACVP data structure. This data structure includes 
  10016.            the following elements: 
  10017.  
  10018.  
  10019.                       ULONG  cb;         /* length of data structure              */
  10020.                       HAB    hAB;        /* anchor block handle                   */
  10021.                       HMQ    hmq;        /* handle to message queue               */
  10022.                       ULONG  ObjectID;   /* ObjectID attribute as specified in    */
  10023.                                          /* an acviewport tag                     */
  10024.                       HWND   hWndParent; /* handle to acviewport parent window    */
  10025.                       HWND   hWndOwner;  /* handle to acviewport owner window     */
  10026.                       HWND   hWndACVP;   /* handle to acviewport                  */
  10027.  
  10028.            IPF supplies all but the last piece of information in this data 
  10029.            structure for the communication object. If the communication object 
  10030.            creates an application-controlled window, it must place the handle 
  10031.            to that window in the last element of the data structure before 
  10032.            returning to IPF.  IPF uses the handle to size and position the 
  10033.            window. 
  10034.  
  10035.            If the communication object is global (loaded by means of a 
  10036.            :docprof. tag), the last 3 items are not needed and are set to null 
  10037.            by IPF. 
  10038.  
  10039.         b. A string identified in the :docprof. or :acviewport. tag as 
  10040.            objectinfo. This is simply a generic parameter passed to the 
  10041.            communication object. Your communication object may or may not use 
  10042.            this parameter, but it should process it. 
  10043.  
  10044.    4. The communication object begins execution. It must complete the following 
  10045.       three steps, sequentially: 
  10046.  
  10047.         a. Register a window class. 
  10048.  
  10049.         b. Create a window. 
  10050.  
  10051.         c. Insert the window in the communication chain (see The Communication 
  10052.            Chain). 
  10053.  
  10054.    5. The next step depends on whether or not the communication object DLL was 
  10055.       loaded through a :docprof. tag or an :acviewport. tag. 
  10056.  
  10057.           If the communication object DLL was loaded through a :docprof. tag, 
  10058.            it simply returns. 
  10059.  
  10060.           If the communication object DLL was loaded through an :acviewport. 
  10061.            tag, the communication object passes the window handle of the window 
  10062.            it created to IPF. 
  10063.  
  10064.    6. The communication object begins message processing: 
  10065.  
  10066.           If the communication object DLL was loaded through :docprof. tag, it 
  10067.            must process HM_ messages and the WM_CLOSE message. 
  10068.  
  10069.           If the communication object DLL was loaded through an :acviewport. 
  10070.            tag, it must process: 
  10071.  
  10072.              -  HM_ messages 
  10073.              -  Various WM_ messages 
  10074.              -  Optionally, other messages, dependent on the particular design 
  10075.                 of the communication object. 
  10076.  
  10077.  
  10078. ΓòÉΓòÉΓòÉ 12.4.1. Messages between IPF and the Communication Object ΓòÉΓòÉΓòÉ
  10079.  
  10080. IPF and its communication objects communicate through window and help manager 
  10081. messages. IPF communication objects, and windows that they create, can send 
  10082. messages to IPF and IPF windows for which the communication objects can get a 
  10083. handle.  Similarly, IPF can send messages to any window that a communication 
  10084. object creates. 
  10085.  
  10086. Any message that an application can send to IPF also can be sent by IPF 
  10087. communication objects. As a programmer working with communication objects, you 
  10088. will need to understand the following important help manager messages: 
  10089.  
  10090.      HM_CONTROL 
  10091.      HM_INFORM 
  10092.      HM_INVALIDATE_DDF_DATA 
  10093.      HM_NOTIFY 
  10094.      HM_QUERY 
  10095.      HM_QUERY_DDF_DATA 
  10096.      HM_SET_COVERPAGE_SIZE 
  10097.      HM_SET_OBJCOM_WINDOW 
  10098.      HM_SET_USERDATA 
  10099.      HM_UPDATE_OBJCOM_WINDOW_CHAIN 
  10100.  
  10101.  For a detailed description of these messages and other IPF messages, see Help 
  10102.  Manager Messages. 
  10103.  
  10104.  
  10105. ΓòÉΓòÉΓòÉ 12.4.2. The Communication Chain ΓòÉΓòÉΓòÉ
  10106.  
  10107. Communication objects, whether they are loaded by means of a :docprof. tag or 
  10108. an :acviewport. tag, function in a "communication chain." The chain is 
  10109. maintained through the passing of HM_ messages unidirectionally through the 
  10110. chain. 
  10111.  
  10112. IPF passes all messages to the active communication object (including, but not 
  10113. limited to, HM_ messages) as they are generated by the user's actions. The 
  10114. active communication object is then responsible for passing on any HM_ messages 
  10115. it receives through the chain to a neighboring communication object. The handle 
  10116. of the neighboring communication object window is returned by the 
  10117. HM_SET_OBJCOM_WINDOW (see Adding Your Communication Object to the Communication 
  10118. Chain). 
  10119.  
  10120. Even if you are certain that your communication object will not be used in 
  10121. combination with other communication objects, it is your responsibility to code 
  10122. your communication object contingent on the possibility that other 
  10123. communication objects may be present in the chain. Therefore, it is important 
  10124. for you to create communication objects that keep the communication chain 
  10125. intact through message passing. 
  10126.  
  10127.  
  10128. ΓòÉΓòÉΓòÉ 12.4.2.1. Making Your Communication Objects Function in the Chain ΓòÉΓòÉΓòÉ
  10129.  
  10130. As a programmer creating communication objects, you need to be certain that 
  10131. your communication object can successfully complete the following communication 
  10132. chain tasks: 
  10133.  
  10134.    1. Your communication object must add itself to the communication chain. 
  10135.  
  10136.    2. If a communication object that was added to the chain before your 
  10137.       communication object was added removes itself from the chain, your 
  10138.       communication object must respond to keep the chain intact. 
  10139.  
  10140.    3. Your communication object must be able to remove itself from the chain 
  10141.       and keep the chain intact. 
  10142.  
  10143.  
  10144. ΓòÉΓòÉΓòÉ 12.4.2.1.1. Adding Your Communication Object to the Communication Chain ΓòÉΓòÉΓòÉ
  10145.  
  10146. Even if your communication object is the only one in use, your communication 
  10147. object is still part of the communication chain. To add itself to the chain, 
  10148. your communication object must: 
  10149.  
  10150.    1. Send the help manager message HM_SET_OBJCOM_WINDOW to the window 
  10151.       PACVP->hWnd Parent. 
  10152.  
  10153.       Your communication object must pass its frame handle as the first 
  10154.       parameter. 
  10155.  
  10156.    2. Your communication object must receive and store the window handle it 
  10157.       receives in return. 
  10158.  
  10159.    3. Your communication object should pass all HM_ help manager messages to 
  10160.       that window handle. 
  10161.  
  10162.  The following code fragment illustrates this process. 
  10163.  
  10164.   #define INCL_WIN
  10165.   #define INCL_WINHELP
  10166.   #include <os2.h>
  10167.  
  10168.   #define HM_MSG_MAX (HM_MSG_BASE+0x0024)
  10169.  
  10170.   USHORT   IPFClassRegistered = 0;         /* IPF class registered flag        */
  10171.  
  10172.   /* Main Entry point */
  10173.   MRESULT EXPENTRY IPFMain (PACVP pACVP, PCH Parameter);
  10174.  
  10175.   /* Pop up error box */
  10176.   VOID Error (PCH str);
  10177.  
  10178.  
  10179.   MRESULT EXPENTRY IPFMain (PACVP pACVP, PCH Parameter)
  10180.   /* pACVP contains the following structure:
  10181.  
  10182.      typedef struct_ACVP
  10183.      {
  10184.         ULONG  cb;                   length
  10185.         HAB    hAB;                  anchor block handle
  10186.         HMQ    hmq;                  messge queue handle
  10187.         ULONG  ObjectID;             object identifier
  10188.         HWND   hWndParent;           IPF viewport client handle
  10189.         HWND   hWndOwner;            IPF viewport client handle
  10190.         HWND   hWndACVP;             applications frame window hwnd
  10191.      } ACVP, *PACVP;
  10192.  
  10193.   This structure is prefilled in except for hWndACVP.  You must put your
  10194.   window handle there if you are creating an application-controlled viewport.
  10195.   If this is just a generic communication object, you do not need to fill it in.
  10196.  
  10197.   Parameter is the information passed in with the objectinfo tag.
  10198.  
  10199.   Note: You can use ObjectID to have multiple acviewports and comm objects
  10200.   use the same entry point.  Check the ObjectID to find out where you were
  10201.   called from in the IPF file. */
  10202.  
  10203.   {
  10204.       HWND  hwndFrame, hwndPrevious, hwndLatest, hwndClient;
  10205.       ULONG CtrlData = 0;
  10206.  
  10207.       Error ( Parameter );
  10208.       /* Check global to see if our window class has been registered. */
  10209.       /* if not, register it.                                         */
  10210.       if (!IPFClassRegistered)
  10211.       {
  10212.           /* We will register our class with 4 extra bytes of information
  10213.              so that we can place the previous object comm window handle there.
  10214.              You might want to create a structure store here instead. */
  10215.           if (!WinRegisterClass( pACVP->hAB,
  10216.                                  "CLASS_IPF",
  10217.                                  (PFNWP) IPF_WinProc,
  10218.                                  CS_SYNCPAINT | CS_SIZEREDRAW | CS_MOVENOTIFY,
  10219.                                  4))
  10220.           {
  10221.               Error ("Can not register class");
  10222.               exit (TRUE);
  10223.           }
  10224.           IPFClassRegistered = 1;
  10225.       }
  10226.  
  10227.       /* Create window.  Visibility does not matter, as IPF will take care
  10228.          of it. */
  10229.       if (!(hwndFrame = WinCreateStdWindow (pACVP->hWndParent,
  10230.                                             WS_VISIBLE,
  10231.                                             &CtrlData,
  10232.                                             "CLASS_IPF",
  10233.                                             "IPF",
  10234.                                             0L,
  10235.                                             0L,
  10236.                                             0L,
  10237.                                             &hwndClient
  10238.                                             )))
  10239.       {
  10240.           Error ("Can not create window");
  10241.           return (MRESULT) TRUE;
  10242.       }
  10243.  
  10244.       /* Setup our window in the ACVP structure.  This is only necessary if
  10245.          you are creating an acviewport. */
  10246.       pACVP->hWndACVP = hwndFrame;
  10247.  
  10248.       /* Set the current comm object window to us */
  10249.       hwndPrevious = (HWND) WinSendMsg (pACVP->hWndParent,
  10250.                                         HM_SET_OBJCOM_WINDOW,
  10251.                                         (MPARAM) hwndFrame,
  10252.                                         (MPARAM)NULL);
  10253.  
  10254.       /* Query back the comm obj window */
  10255.       hwndLatest = (HWND) WinSendMsg (pACVP->hWndParent,
  10256.                                       HM_QUERY,
  10257.                                       MPFROM2SHORT ((USHORT)0, HMQW_OBJCOM_WINDOW),
  10258.                                       (MPARAM)NULL);
  10259.  
  10260.       /* double check to make sure we are in the comm chain */
  10261.       if (hwndFrame != hwndLatest)
  10262.       {
  10263.           Error ("Can not set object communication window");
  10264.           return (MRESULT) TRUE;
  10265.       }
  10266.  
  10267.       /* Store the previous commobj handle in window words */
  10268.       if (!WinSetWindowULong (hwndClient, QWL_USER, (ULONG) hwndPrevious))
  10269.       {
  10270.           Error ("Can not save handle into reserved memory");
  10271.           return (MRESULT) TRUE;
  10272.       }
  10273.       return (MRESULT) FALSE;
  10274.   }
  10275.  
  10276.   VOID Error (PCH str)
  10277.  
  10278.   {
  10279.       WinMessageBox (HWND_DESKTOP,
  10280.                      HWND_DESKTOP,
  10281.                      (PCH)str,
  10282.                      (PCH)"IPF Sample Error Message",
  10283.                      1,
  10284.                      MB_OK | MB_APPLMODAL |
  10285.                      MB_MOVEABLE | MB_ICONASTERISK);
  10286.   }
  10287.  
  10288.  
  10289. ΓòÉΓòÉΓòÉ 12.4.2.1.2. Responding to the Removal of Another Object in the Chain ΓòÉΓòÉΓòÉ
  10290.  
  10291. If a communication object that was added to the chain before your communication 
  10292. object removes itself from the chain, your communication object must respond to 
  10293. keep the chain intact. 
  10294.  
  10295. This involves several steps: 
  10296.  
  10297.    1. Your communication object must process the HM_UPDATE_OBJCOM_WINDOW_CHAIN 
  10298.       help manager message. This message provides your communication object 
  10299.       with: 
  10300.  
  10301.         a. The handle of the communication object that is removing itself from 
  10302.            the chain. 
  10303.  
  10304.         b. The window handle for the object to serve as a replacement in the 
  10305.            chain. 
  10306.  
  10307.       Your communication object does not need to respond unless the first 
  10308.       parameter, the handle of the communication object removing itself, is 
  10309.       identical to the handle returned to your communication object when it 
  10310.       initially sent a HM_SET_OBJCOM_WINDOW message to add itself to the chain 
  10311.       (see Adding Your Communication Object to the Communication Chain). Your 
  10312.       communication object should have stored this handle. 
  10313.  
  10314.    2. If the second parameter returned by HM_UPDATE_OBJCOM_WINDOW_CHAIN does 
  10315.       not match the handle previously returned by HM_SET_OBJCOM_WINDOW, your 
  10316.       communication object is not affected by the modification to the chain and 
  10317.       does not need to respond other than to pass on the message to the next 
  10318.       communication object in the chain. 
  10319.  
  10320.       However, if these handles are identical, your communication object has a 
  10321.       new "neighbor" in the chain, and should begin passing all HM_ help 
  10322.       manager messages to the object identified by the handle returned as the 
  10323.       first parameter of HM_UPDATE_OBJCOM_WINDOW_CHAIN. 
  10324.  
  10325.  The following code fragment illustrates this process. 
  10326.  
  10327.   #define INCL_WIN
  10328.   #define INCL_WINHELP
  10329.   #include <os2.h>
  10330.  
  10331.   #define HM_MSG_MAX (HM_MSG_BASE+0x0024)
  10332.  
  10333.   USHORT   IPFClassRegistered = 0;         /* IPF class registered flag        */
  10334.  
  10335.   /* Window procedure */
  10336.   MRESULT EXPENTRY IPFWinProc (HWND hwnd, USHORT msg, MPARAM mp1, MPARAM mp2);
  10337.  
  10338.  
  10339.   MRESULT EXPENTRY IPFWinProc (HWND hwnd, USHORT msg, MPARAM mp1, MPARAM mp2)
  10340.   /* The window procedure will handle deleting ourselves from the chain
  10341.      as well as forwarding all standard IPF message on the the next window in
  10342.      the chain */
  10343.   {
  10344.      HWND hwndPrevious, hwndLatest;
  10345.  
  10346.      /* Get previous comm obj */
  10347.      hwndPrevious = (HWND) WinQueryWindowULong (hwnd, QWL_USER);
  10348.      /* Handle the messages you want here, but do not return unless you
  10349.         now the message will not need to be handled by another comm obj.
  10350.         Let the the message be forwarded on to the next comm obj.  The
  10351.         only exception to this is if you change the cover page size.  You
  10352.         need to return TRUE to prevent the coverpage from being resized. */
  10353.      switch (msg)
  10354.      {
  10355.         case HM_UPDATE_OBJCOM_WINDOW_CHAIN:
  10356.            /* If another window is being inserted, replace previous with it */
  10357.            if (hwndPrevious == (HWND)mp1) {
  10358.               hwndPrevious = (HWND)mp2;
  10359.               if (!WinSetWindowULong (hwnd, QWL_USER, (ULONG) hwndPrevious)) {
  10360.                  /* Put up error message */
  10361.                  WinMessageBox (HWND_DESKTOP,
  10362.                                 HWND_DESKTOP,
  10363.                                 (PCH)"Can not save handle into reserved memory",
  10364.                                 (PCH)"IPF Sample Error Message",
  10365.                                 1,
  10366.                                 MB_OK | MB_APPLMODAL |
  10367.                                 MB_MOVEABLE | MB_ICONASTERISK);
  10368.                  break;
  10369.               }
  10370.  
  10371.            } else {
  10372.               /* Otherwise simply forward the message on */
  10373.               if (hwndPrevious != 0L) {
  10374.                  WinSendMsg (hwndPrevious, HM_UPDATE_BJCOM_WINDOW_CHAIN,
  10375.                              (MPARAM) mp1, (MPARAM) mp2);
  10376.               }
  10377.            }
  10378.            return (MPARAM) NULL;
  10379.            break;
  10380.         case WM_CLOSE:
  10381.            WinDestroyWindow (WinQueryWindow (hwnd, QW_PARENT));
  10382.            return (MPARAM) NULL;
  10383.            break;
  10384.         case WM_DESTROY:
  10385.            /* Take ourselves out of the chain */
  10386.            hwndLatest = (HWND)WinSendMsg (hwnd, HM_QUERY,
  10387.                                           MPFROM2SHORT (0, HMQW_OBJCOM_WINDOW),
  10388.                                           (MPARAM)NULL);
  10389.            WinSendMsg (hwndLatest, HM_UPDATE_OBJCOM_WINDOW_CHAIN,
  10390.                        (MPARAM) WinQueryWindow (hwnd, QW_PARENT),
  10391.                        (MPARAM) hwndPrevious );
  10392.            return (MPARAM) NULL;
  10393.            break;
  10394.      }
  10395.      if ((msg > HM_MSG_BASE) && (msg <= HM_MSG_MAX)) {
  10396.         return WinSendMsg( hwndPrevious, msg, mp1, mp2);
  10397.      } else {
  10398.         return WinDefWindowProc (hwnd, msg, mp1, mp2);
  10399.      } /* endif */
  10400.   }
  10401.  
  10402.  
  10403. ΓòÉΓòÉΓòÉ 12.4.2.1.3. Removing Your Communication Object from the Chain ΓòÉΓòÉΓòÉ
  10404.  
  10405. Your communication object must be able to remove itself from the chain and keep 
  10406. the chain intact. When the communication object does remove itself, it is no 
  10407. longer the active object. This can be carried out as follows: 
  10408.  
  10409.    1. Your communication object must process the WM_DESTROY message sent by IPF 
  10410.       that corresponds to the closure of a window with which your communication 
  10411.       object is associated. 
  10412.  
  10413.    2. Your communication object must query the current object window using 
  10414.       HM_QUERY. This returns the handle of the current object window. 
  10415.  
  10416.    3. Your communication object can then send the HM_UPDATE_OBJCOM_WINDOW_CHAIN 
  10417.       message to the handle of the current object window including the handle 
  10418.       of your communication object, which was returned when you added your 
  10419.       communication object to the chain (see Adding Your Communication Object 
  10420.       to the Communication Chain). 
  10421.  
  10422.  The following code fragment illustrates this process: 
  10423.  
  10424.  
  10425.           case WM_DESTROY:
  10426.  
  10427.               hwndPrevious = (HWND) WinQueryWindowULong (hwnd, COM_HWND);
  10428.  
  10429.               hwndLatest = (HWND) WinSendMsg (hwnd,
  10430.                                        HM_QUERY,
  10431.                                        MPFROM2SHORT ((USHORT)0, HMQW_OBJCOM_WINDOW),
  10432.                                        NULL);
  10433.  
  10434.               WinMessageBox (HWND_DESKTOP,
  10435.                              HWND_DESKTOP,
  10436.                              (PCH)str,
  10437.                              (PCH)"IPF Sample Error Message",
  10438.                              1,
  10439.                              MB_OK | MB_APPLMODAL |
  10440.                              MB_MOVEABLE | MB_ICONASTERISK);
  10441.               WinSendMsg (hwndLatest,
  10442.                           HM_UPDATE_OBJCOM_WINDOW_CHAIN,
  10443.                           (MPARAM) hwndPrevious,
  10444.                           (MPARAM) WinQueryWindow (hwnd, QW_PARENT));
  10445.  
  10446.               rValue = FALSE;
  10447.               break;
  10448.  
  10449.           default:
  10450.  
  10451.               rValue = TRUE;
  10452.               break;
  10453.  
  10454.       }
  10455.   }
  10456.  
  10457.  
  10458. ΓòÉΓòÉΓòÉ 12.5. Changing the Coverpage Window ΓòÉΓòÉΓòÉ
  10459.  
  10460. One of the IPF customizations you can do with your communication object is 
  10461. manipulating the IPF coverpage window. 
  10462.  
  10463. When an online book is opened or when an application requests that IPF create a 
  10464. help instance, IPF creates a coverpage frame window. The coverpage window is 
  10465. the window in which all other information is displayed. IPF-controlled windows 
  10466. are children of the coverpage window, as are application-controlled windows. 
  10467.  
  10468. IPF communication objects can change the look and functionality of the 
  10469. coverpage window. For example, a communication object can change the size or 
  10470. location of the coverpage, or remove its menu bar. 
  10471.  
  10472. For HLP files, applications can change only the size of a help window. The 
  10473. application would do this by sending HM_SET_COVERPAGE_SIZE to the help instance 
  10474. created with WinCreateHelpInstance. Note that applications must not move the 
  10475. help window. 
  10476.  
  10477. For INF files, the communication object must handle the OPEN_COVERPAGE event of 
  10478. the HM_NOTIFY message, then use WinSetWindowPos to set the size and position of 
  10479. the coverpage. The coverpage window's handle is in mp2. 
  10480.  
  10481. When using WinSetWindowPos to change the position and size of the coverpage 
  10482. window, you must OR SWP_SHOW with SWP_MOVE or SWP_SIZE, or both. 
  10483.  
  10484. You must return directly from your code when you handle this event. Do not pass 
  10485. the HM_NOTIFY message on to the default window procedure. 
  10486.  
  10487. In addition to the techniques specified here for resizing and positioning the 
  10488. coverpage, once you have the handle to the coverpage you can use any of the 
  10489. other PM window manipulation techniques, such as manipulating the frame 
  10490. controls or menus. For example, to remove the coverpage's menu bar, you would 
  10491. call WinDestroyWindow in response to an OPEN_COVERPAGE event, as in the 
  10492. following example: 
  10493.  
  10494. WinDestroyWindow(WinWindowFromID((HWND) mp2, FID_MENU));
  10495.  
  10496. Use other FID_* IDs to work with other parts of the coverpage window. 
  10497.  
  10498. The code fragment in the following figure illustrates these techniques by 
  10499. changing the size and location of the coverpage and removing the menu bar. 
  10500.  
  10501. HWND hwndCoverPage;
  10502.    .
  10503.    .
  10504.    .
  10505.    /* Inside the main switch statement in your window procedure... */
  10506.    case HM_NOTIFY:
  10507.  
  10508.       switch (SHORT1FROMMP(mp1)) {
  10509.  
  10510.          case OPEN_COVERPAGE:
  10511.             hwndCoverPage = (HWND) mp2;   /* Handle to coverpage is in mp2 */
  10512.  
  10513.             /* Remove the menu */
  10514.             WinDestroyWindow(WinWindowFromID(hwndCoverPage, FID_MENU));
  10515.  
  10516.             /* Change the size and location of coverpage */
  10517.             WinSetWindowPos(hwndCoverPage, 0, 10, 10, 200, 200,
  10518.                             SWP_SIZE | SWP_MOVE | SWP_SHOW);
  10519.  
  10520.             return TRUE;
  10521.  
  10522.       } /* endswitch */
  10523.  
  10524.       break;
  10525.  
  10526.  
  10527. ΓòÉΓòÉΓòÉ 13. Controlling Windows with Applications (ACVIEWPORTS) ΓòÉΓòÉΓòÉ
  10528.  
  10529. IPF handles the formatting and display of text and graphic information within 
  10530. its windows. IPF-controlled windows are defined in the tagged source file with 
  10531. a heading tag or :link.. These windows are IPF-controlled because IPF provides 
  10532. the window procedures that control them. The content and presentation of 
  10533. information in an IPF-controlled window is limited by the functions of a 
  10534. standard OS/2 window. 
  10535.  
  10536. To create IPF-controlled windows, an author requires only tagging skills; 
  10537. however, to create application-controlled windows, an author requires both 
  10538. tagging and programming skills. 
  10539.  
  10540. Application-controlled windows are defined in the tagged source file with the 
  10541. application-controlled window tag (:acviewport.). With this tag, a window is 
  10542. controlled by a communication object (see Customizing IPF with Communication 
  10543. Objects) that has been written and compiled into the form of a dynamic link 
  10544. library (DLL). When an IPF window is displayed at execution time and 
  10545. :acviewport. is encountered, IPF passes control to the entry point in the DLL 
  10546. specified by the objectname=' ' attribute of :acviewport.. This entry point is, 
  10547. in fact, a communication object. 
  10548.  
  10549. At this point, the communication object takes control and executes the 
  10550. instructions specified in the source file. When the call returns to IPF, IPF 
  10551. sizes and positions the window on the screen as defined in the heading tag or 
  10552. :link. (see Customizing Windows). 
  10553.  
  10554. The :acviewport tag can share a panel with text and, for that matter, you can 
  10555. have more than one :acviewport tag in the same panel. 
  10556.  
  10557. In addition, an acviewport communication object can be called from more than 
  10558. one panel. The objectid= attribute enables the communication object to 
  10559. determine which help panel called it. 
  10560.  
  10561. The following figure shows the tagging to produce a split window.  In this 
  10562. example, the contents of the left window are IPF-controlled.  The contents of 
  10563. the right window are defined and controlled by the IPF communication object 
  10564. IPFMain which resides in IPF.DLL. 
  10565.  
  10566. :userdoc.
  10567. :title.Information Presentation Facility
  10568. :docprof ctrlarea=none.
  10569. :h1 res=016 scroll=none clear.Using a Mouse
  10570. .*
  10571. :link reftype=hd res=017 auto split
  10572.       vpx=left vpy=top vpcx=50% vpcy=100%
  10573.       rules=border scroll=none titlebar=none.
  10574. .*
  10575. :acviewport dll='ipf'
  10576.             objectname='IPFMain' objectid=1
  10577.             vpx=right vpy=top vpcx=50% vpcy=100%.
  10578. .*
  10579. :h2 res=017.Using a Mouse
  10580. .*
  10581. :p.You move the pointer (usually an arrow) so that it
  10582. points at the objects and actions you want to select.
  10583. :p.If you run out of room to slide the mouse, lift it up, put it
  10584. back down, and slide it again.
  10585. :p.The left-hand mouse button (or mouse button 1) is
  10586. usually used to select objects on the screen.
  10587. :p.The right-hand mouse button (or mouse button 2) is
  10588. usually used to :hp1.drag:ehp1. or move
  10589. objects around the screen.
  10590. :euserdoc.
  10591.  
  10592. The following figure shows the compiled version of the tagging shown in the 
  10593. previous figure. 
  10594.  
  10595. The left window is IPF-controlled. The right window displays an animated mouse 
  10596. whose activity is controlled by a routine in a DLL. 
  10597.  
  10598. In the previous example, IPF processes :acviewport. as follows: 
  10599.  
  10600.    1. It loads IPF.DLL and calls the procedure IPFMain.  This object name is 
  10601.       case sensitive. 
  10602.  
  10603.    2. IPFMain creates a window and registers it with IPF as an object 
  10604.       communication window. 
  10605.  
  10606.    3. When the call to IPFMain returns to IPF, IPF gives instructions to 
  10607.       display the animated mouse. 
  10608.  
  10609.  IPFMain, IPF.DLL, and the bit maps used for the animated mouse are provided in 
  10610.  the IPF sample program available with the Toolkit. 
  10611.  
  10612.  
  10613. ΓòÉΓòÉΓòÉ 13.1. Writing the Communication Object Code ΓòÉΓòÉΓòÉ
  10614.  
  10615. An IPF communication object can be structured in many ways.  Its content 
  10616. depends on the function being implemented. Application-controlled windows 
  10617. typically simulate activity that might or might not require user interaction. 
  10618.  
  10619. An example of a communication object is provided in the IPF sample program 
  10620. (available in the Toolkit), and is shown in the previous IPF-controlled window 
  10621. example. The program contains two procedures: 
  10622.  
  10623. IPFMain registers a window class for the application-controlled window, creates 
  10624. an instance of the class, and registers it with IPF as a communication object. 
  10625.  
  10626. IPFWinProc provides the animation in the application-controlled window. 
  10627. IPFWinProc is called by IPFMain procedure. 
  10628.  
  10629. #define INCL_WIN
  10630. #define INCL_GPI
  10631. #define INCL_DOS
  10632. #define INCL_DOSMODULEMGR
  10633. #define LINT_ARGS
  10634. #define DINCL_32
  10635.  
  10636. #include <OS2.H>
  10637. #include "IPF.H"
  10638.  
  10639. #define COM_HWND             4  /* Used in WinSetWindowULong              */
  10640. #define FRAMES               5  /* Number of frames in animation sequence */
  10641. #define BEEP_WARN_FREQ      60  /* Frequency of warning beep              */
  10642. #define BEEP_WARN_DUR      100  /* Duration of warning beep               */
  10643.  
  10644. USHORT   IPFClassRegistered = 0;         /* IPF class registered flag     */
  10645. HWND     hwndClient;                     /* Handle to the client window   */
  10646. HWND     hwndPrevious;                   /* Handle to the previous active */
  10647.                                          /* object communication window   */
  10648. HWND     hwndLatest;                     /* Handle to the latest active   */
  10649.                                          /* object communication window   */
  10650.  
  10651. MRESULT EXPENTRY IPFMain (PACVP pACVP, PCH Parameter);
  10652. MRESULT EXPENTRY IPFWinProc (HWND hwnd, USHORT msg, MPARAM mp1, MPARAM mp2);
  10653. VOID Error (PCH str);
  10654.  
  10655. MRESULT EXPENTRY IPFMain (PACVP pACVP, PCH Parameter)
  10656. {
  10657.  
  10658.     HWND  hwndParent;         /* Handle of parent window in IPF             */
  10659.     HWND  hwndFrame;          /* Handle to the frame                        */
  10660.     ULONG WinStyle;           /* window style for creating frame            */
  10661.     ULONG CtrlData;           /* control data for creating frame            */
  10662.  
  10663.     Parameter; /* Warning Level 3 Avoidance */
  10664.  
  10665. /** 1) Initialize **/
  10666.     if (!IPFClassRegistered)
  10667.     {
  10668.         if (!WinRegisterClass (pACVP->hAB,
  10669.                                "CLASS_IPF",
  10670.                                (PFNWP) IPFWinProc,
  10671.                                CS_SYNCPAINT | CS_SIZEREDRAW | CS_MOVENOTIFY,
  10672.                                8))
  10673.         {
  10674.             DosBeep (BEEP_WARN_FREQ, BEEP_WARN_DUR);
  10675.             exit (TRUE);
  10676.         }
  10677.         IPFClassRegistered = 1;
  10678.     }
  10679.     WinStyle = 0L;
  10680.     CtrlData = 0L;
  10681.  
  10682.     if (!(hwndFrame = WinCreateStdWindow (pACVP->hWndParent,
  10683.                                           WinStyle,
  10684.                                           &CtrlData,
  10685.                                           "CLASS_IPF",
  10686.                                           "IPF",
  10687.                                           0L,
  10688.                                           0L,
  10689.                                           0L,
  10690.                                           &hwndClient
  10691.                                           )))
  10692.     {
  10693.         Error ("Cannot create window");
  10694.         return (MRESULT) TRUE;
  10695.     }
  10696.  
  10697. /** 2) Process **/
  10698.  
  10699.     pACVP->hWndACVP = hwndFrame;
  10700.  
  10701.     hwndParent = pACVP->hWndParent;
  10702.  
  10703.     hwndPrevious = WinSendMsg (pACVP->hWndParent,
  10704.                                HM_SET_OBJCOM_WINDOW,
  10705.                                (MPARAM) hwndFrame,
  10706.                                NULL);
  10707.  
  10708.     hwndLatest = WinSendMsg (pACVP->hWndParent,
  10709.                              HM_QUERY,
  10710.                              MPFROM2SHORT (NULL, HMQW_OBJCOM_WINDOW),
  10711.                              NULL);
  10712.  
  10713.     if (hwndFrame != hwndLatest)
  10714.     {
  10715.         Error ("Cannot set object communication window");
  10716.         return (MRESULT) TRUE;
  10717.     }
  10718.  
  10719. /** 3) Finish **/
  10720.  
  10721.     if (!WinSetWindowULong (hwndClient, COM_HWND, (ULONG) hwndPrevious))
  10722.     {
  10723.         Error ("Cannot save handle into reserved memory");
  10724.         return (MRESULT) TRUE;
  10725.     }
  10726.     return (MRESULT) FALSE;
  10727. }
  10728.  
  10729. MRESULT EXPENTRY IPFWinProc (HWND hwnd, USHORT msg, MPARAM mp1, MPARAM mp2)
  10730. {
  10731.  
  10732.     static HAB      Hhab;         /* anchor block handle                    */
  10733.     static HBITMAP  hbm [5];      /* array of bitmap handles                */
  10734.     static HPS      hps;          /* presentation space                     */
  10735.     static POINTL   ptl;          /* pointl                                 */
  10736.     static HMODULE  hModule;      /* to get bitmaps from DLL resource       */
  10737.     static SHORT    index;        /* index to current bitmap to display     */
  10738.     static LONG     cxClient,
  10739.                     cyClient;     /* window size                            */
  10740.            BOOL     rValue=TRUE;  /* FALSE if the message was acted         */
  10741.                                   /* upon successfully                      */
  10742.  
  10743. /** 1) Initialize **/
  10744.  
  10745.     switch (msg)
  10746.     {
  10747.         case HM_UPDATE_OBJCOM_WINDOW_CHAIN:
  10748.  
  10749.             hwndPrevious = (HWND) WinQueryWindowULong (hwnd, COM_HWND);
  10750.  
  10751.             if (hwndPrevious == mp2)
  10752.             {
  10753.                  hwndPrevious = mp1;
  10754.  
  10755.                if (!WinSetWindowULong (hwndClient,
  10756.                                         COM_HWND,
  10757.                                         (ULONG) hwndPrevious))
  10758.                 {
  10759.                     Error ("Cannot save handle into reserved memory");
  10760.                     break;
  10761.                 }
  10762.             }
  10763.             else
  10764.             {
  10765.                 if (hwndPrevious != NULL)
  10766.                 {
  10767.                     WinSendMsg (hwndPrevious,
  10768.                                 HM_UPDATE_OBJCOM_WINDOW_CHAIN,
  10769.                                 (MPARAM) mp1,
  10770.                                 (MPARAM) mp2);
  10771.                 }
  10772.             }
  10773.  
  10774.             rValue = FALSE;
  10775.             break;
  10776.  
  10777.         case WM_CREATE:
  10778.  
  10779.             if (DosLoadModule (NULL, 0L, "IPF", &hModule))
  10780.             {
  10781.                 Error ("Cannot load module");
  10782.                 break;
  10783.             }
  10784.  
  10785.             if (!(hps = WinGetPS(hwnd)))
  10786.             {
  10787.                 Error ("Cannot get presentation space");
  10788.                 break;
  10789.             }
  10790.  
  10791.             for (index = 0; index < FRAMES; index++)
  10792.             {
  10793.                 if (!(hbm [index] = GpiLoadBitmap (hps,
  10794.                                                    hModule,
  10795.                                                    (USHORT)(IDB_FRAME1+index),
  10796.                                                    cxClient,
  10797.                                                    cyClient)))
  10798.                 {
  10799.                     Error ("Cannot load bitmap");
  10800.                     return (MRESULT) rValue;
  10801.                 }
  10802.             }
  10803.  
  10804.             WinReleasePS (hps);
  10805.  
  10806.             index = 0;
  10807.  
  10808.             if (!(Hhab = WinQueryAnchorBlock (hwnd)))
  10809.             {
  10810.                 Error ("Cannot retrieve anchor block handle");
  10811.                 break;
  10812.             }
  10813.  
  10814.             if (!WinStartTimer (Hhab, hwnd, ID_TIMER, 150))
  10815.             {
  10816.                 Error ("Cannot start timer");
  10817.                 break;
  10818.             }
  10819.  
  10820.             rValue = FALSE;
  10821.             break;
  10822.  
  10823.         case WM_TIMER:
  10824.  
  10825.             if (index++ == FRAMES-1)
  10826.             {
  10827.                 index = 0;
  10828.             }
  10829.  
  10830.             WinInvalidateRect (hwnd, NULL, FALSE);
  10831.  
  10832.             rValue = FALSE;
  10833.             break;
  10834.  
  10835. /** 2) Process **/
  10836.  
  10837.         case WM_PAINT:
  10838.  
  10839.             if (!(hps = WinBeginPaint (hwnd, NULL, NULL)))
  10840.             {
  10841.                 Error ("Cannot set presentation space for drawing");
  10842.                 break;
  10843.             }
  10844.  
  10845.             if (!WinDrawBitmap (hps,
  10846.                                 hbm [index],
  10847.                                 NULL,
  10848.                                 &ptl,
  10849.                                 CLR_NEUTRAL,
  10850.                                 CLR_BACKGROUND,
  10851.                                 DBM_NORMAL))
  10852.             {
  10853.                 Error ("Cannot draw bitmap");
  10854.                 break;
  10855.             }
  10856.  
  10857.             WinEndPaint (hps);
  10858.  
  10859.             rValue = FALSE;
  10860.             break;
  10861.  
  10862.         case WM_SIZE:
  10863.  
  10864.             cxClient = SHORT1FROMMP (mp2);
  10865.             cyClient = SHORT2FROMMP (mp2);
  10866.  
  10867.             rValue = FALSE;
  10868.             break;
  10869.  
  10870. /** 3) Finish **/
  10871.  
  10872.         case WM_CLOSE:
  10873.  
  10874.             WinDestroyWindow (WinQueryWindow (hwnd, QW_PARENT));
  10875.  
  10876.             rValue = FALSE;
  10877.             break;
  10878.  
  10879.         case WM_DESTROY:
  10880.  
  10881.             WinStopTimer (Hhab, hwnd, ID_TIMER);
  10882.  
  10883.             for (index = 0; index < 8; index++)
  10884.             {
  10885.                 GpiDeleteBitmap (hbm [index]);
  10886.             }
  10887.  
  10888.             hwndPrevious = (HWND) WinQueryWindowULong (hwnd, COM_HWND);
  10889.  
  10890.             hwndLatest = WinSendMsg (hwnd,
  10891.                                      HM_QUERY,
  10892.                                      MPFROM2SHORT (NULL, HMQW_OBJCOM_WINDOW),
  10893.                                      NULL);
  10894.  
  10895.             WinSendMsg (hwndLatest,
  10896.                         HM_UPDATE_OBJCOM_WINDOW_CHAIN,
  10897.                         (MPARAM) hwndPrevious,
  10898.                         (MPARAM) WinQueryWindow (hwnd, QW_PARENT));
  10899.  
  10900.             DosFreeModule (hModule);
  10901.  
  10902.             rValue = FALSE;
  10903.             break;
  10904.  
  10905.         default:
  10906.  
  10907.             rValue = TRUE;
  10908.             break;
  10909.  
  10910.     }
  10911.  
  10912.     return (rValue ? WinDefWindowProc (hwnd, msg, mp1, mp2) : 0L);
  10913.  
  10914. }
  10915.  
  10916.  
  10917. ΓòÉΓòÉΓòÉ 13.1.1. Using Communication Windows ΓòÉΓòÉΓòÉ
  10918.  
  10919. To position windows or graphics within an application-controlled window, the 
  10920. IPF communication object requires a communication object window. For example, 
  10921. an application-controlled window can be used to represent the workplace, with 
  10922. an interactive, simulated application window positioned on the workplace. 
  10923. However, because IPF sizes and positions the application-controlled window 
  10924. after returning from the call to a communication object, the communication 
  10925. object cannot size and position the simulated application window until after it 
  10926. has created the window and returned control to IPF. 
  10927.  
  10928. The dilemma is resolved because the communication object can receive HM_INFORM 
  10929. messages after :acviewport. has been processed by IPF and the communication 
  10930. object has created an active communication object window. Upon receiving the 
  10931. HM_INFORM message from IPF, the window procedure can then create the simulated 
  10932. application window and position it within the application-controlled window. 
  10933.  
  10934. The following C-language source code contains the communication object 
  10935. ComWindow that creates a communication window and processes messages from IPF. 
  10936.  
  10937. #define INCL_WIN
  10938. #define INCL_DOS
  10939.  
  10940. #include <os2.h>
  10941.  
  10942. /* Define ID used with reftype = inform attribute in the link tag */
  10943. /* in tagged source for help information */
  10944.  
  10945. #define SIMULATE_APPWINDOW 1000
  10946.  
  10947. MRESULT EXPENTRY ComWindowProc (HWND hwnd, USHORT msg, MPARAM mp1, MPARAM mp2);
  10948. MRESULT EXPENTRY SimWindowProc (HWND hwnd, USHORT msg, MPARAM mp1, MPARAM mp2);
  10949.  
  10950. HWND hComWindow = NULL;
  10951. HWND hSimWindow = NULL;
  10952. HWND hComClientWindow;
  10953. HWND hSimClientWindow;
  10954. HWND PreviousComWindow;
  10955. HWND PreviousHwnd;
  10956.  
  10957. USHORT EXPENTRY ComWindow (pACVP, ObjectInfo)
  10958.  
  10959. PACVP pACVP;
  10960. PCH   ObjectInfo;
  10961. {
  10962.  
  10963. ULONG FrameFlags=0L;
  10964.  
  10965. /* Register class for communication window */
  10966.  
  10967.    WinRegisterClass (pACVP->hAB,
  10968.                      "CLASS_COMM",
  10969.                      (PFNWP)ComWindowProc,
  10970.                      CS_SYNCPAINT | CS_SIZEREDRAW | CS_MOVENOTIFY, 8);
  10971.  
  10972. /* Register class for simulated application window */
  10973.  
  10974.    WinRegisterClass (pACVP->hAB,
  10975.                      "CLASS_APPSIM",
  10976.                      (PFNWP)SimWindowProc,
  10977.                      CS_SYNCPAINT | CS_SIZEREDRAW | CS_MOVENOTIFY, 4);
  10978.  
  10979. /* Create the communication window */
  10980.  
  10981. hComWindow = WinCreateStdWindow (pACVP->hWndParent,
  10982.                                  0L,
  10983.                                  &FrameFlags,
  10984.                                  (PSZ)"CLASS_COMM",
  10985.                                  NULL,
  10986.                                  0L,
  10987.                                  (HMODULE)NULL,
  10988.                                  0L,
  10989.                                  (PHWND)&hComClientWindow);
  10990.  
  10991. /* Return handle of Communication frame window to IPF */
  10992.  
  10993. pACVP->hWndACVP=hComWindow;
  10994.  
  10995. /* Send a message to IPF indicating that it should talk to our */
  10996. /* communication window */
  10997.  
  10998. PreviousComWindow = WinSendMsg (pACVP->hWndParent,
  10999.                                 HM_SET_OBJCOM_WINDOW,
  11000.                                 (MPARAM)hComWindow,
  11001.                                 (MPARAM)hComWindow);
  11002.  
  11003. /* Save handle of IPF's communication window in window word of the */
  11004. /* communication window */
  11005.  
  11006. WinSetWindowULong (hComClientWindow, 0L, (ULONG)PreviousComWindow);
  11007.  
  11008. return FALSE;
  11009. }
  11010. MRESULT EXPENTRY ComWindowProc (HWND hwnd, USHORT msg, MPARAM mp1, MPARAM mp2)
  11011. {
  11012.     HPS      hps;
  11013.     RECTL    Rect;
  11014.  
  11015.     ULONG FrameFlags = FCF_TITLEBAR   | FCF_SYSMENU |
  11016.                        FCF_SIZEBORDER | FCF_MINMAX  ;
  11017.     switch (msg)
  11018.     {
  11019.  
  11020.         case HM_INFORM:
  11021.  
  11022.             switch ((USHORT)mp1)
  11023.             {
  11024.  
  11025.                 case SIMULATE_APPWINDOW:
  11026.  
  11027.                     /* create the application window */
  11028.  
  11029.                     hSimWindow = WinCreateStdWindow (hwnd,
  11030.                                                      WS_VISIBLE,
  11031.                                                      &FrameFlags,
  11032.                                                      (PSZ)"CLASS_APPSIM",
  11033.                                                      NULL,
  11034.                                                      0L,
  11035.                                                      (HMODULE)NULL,
  11036.                                                      0L,
  11037.                                                      (PHWND)&hSimClientWindow);
  11038.  
  11039.                     WinSetWindowText (hSimWindow, "Application X");
  11040.  
  11041.                     WinSendMsg (hSimWindow,
  11042.                                 WM_SETICON,
  11043.                                 WinQuerySysPointer (HWND_DESKTOP, SPTR_APPICON,
  11044.                                 FALSE),  NULL);
  11045.  
  11046.                     /* get the size of the communication client window */
  11047.  
  11048.                     WinQueryWindowRect (hwnd, &Rect);
  11049.  
  11050.                     /* adjust the size of the application window within the  */
  11051.                     /* communication client window                           */
  11052.  
  11053.                     Rect.xLeft = Rect.xRight / 12;
  11054.                     Rect.yBottom = Rect.yTop / 5;
  11055.                     Rect.xRight = Rect.xLeft * 10;
  11056.                     Rect.yTop = Rect.yBottom * 3;
  11057.  
  11058.                     /* position the application window within the */
  11059.                     /* communication client window                */
  11060.  
  11061.                     WinSetWindowPos (hSimWindow, HWND_TOP,
  11062.                                      (SHORT)Rect.xLeft,
  11063.                                      (SHORT)Rect.yBottom,
  11064.                                      (SHORT)Rect.xRight,
  11065.                                      (SHORT)Rect.yTop,
  11066.                                      (SWP_SHOW | SWP_SIZE |
  11067.                                       SWP_MOVE | SWP_ACTIVATE));
  11068.  
  11069.                     return (MRESULT)TRUE;
  11070.             }
  11071.  
  11072.         case WM_PAINT:
  11073.  
  11074.             hps = WinBeginPaint (hwnd, (HPS)NULL, (PRECTL)NULL);
  11075.             WinQueryWindowRect (hwnd, &Rect);
  11076.             WinFillRect (hps, &Rect, CLR_RED);
  11077.             WinEndPaint (hps);
  11078.             break;
  11079.  
  11080.         case WM_CLOSE:
  11081.  
  11082.             WinDestroyWindow (WinQueryWindow (hwnd, QW_PARENT));
  11083.             return (MRESULT)TRUE;
  11084.  
  11085.         case WM_DESTROY:
  11086.  
  11087.             PreviousHwnd = (HWND)WinQueryWindowULong (hwnd, 0L);
  11088.             WinSendMsg (WinQueryWindow (hwnd, QW_PARENT),
  11089.                         HM_SET_OBJCOM_WINDOW,
  11090.                         PreviousHwnd,
  11091.                         NULL);
  11092.             break;
  11093.     }
  11094.  
  11095.     return (WinDefWindowProc (hwnd, msg, mp1, mp2));
  11096. }
  11097.  
  11098. /* Create the simulated frame window */
  11099.  
  11100. MRESULT EXPENTRY SimWindowProc(HWND hwnd, USHORT msg, MPARAM mp1, MPARAM mp2)
  11101. {
  11102.     HPS      hps;
  11103.     RECTL    Rect;
  11104.  
  11105.     switch (msg)
  11106.     {
  11107.  
  11108.         case WM_PAINT:
  11109.  
  11110.             hps = WinBeginPaint (hwnd, (HPS)NULL, (PRECTL)NULL);
  11111.             WinQueryWindowRect (hwnd, &Rect);
  11112.             WinFillRect (hps, &Rect, CLR_WHITE);
  11113.             WinEndPaint (hps);
  11114.             break;
  11115.  
  11116.         case WM_CLOSE:
  11117.  
  11118.             WinDestroyWindow (WinQueryWindow (hwnd, QW_PARENT));
  11119.             return (MRESULT)TRUE;
  11120.  
  11121.         case WM_DESTROY:
  11122.  
  11123.             PreviousHwnd = (HWND)WinQueryWindowULong (hwnd, 0L);
  11124.             WinSendMsg (WinQueryWindow (hwnd, QW_PARENT),
  11125.                         HM_SET_OBJCOM_WINDOW,
  11126.                         PreviousHwnd,
  11127.                         NULL);
  11128.             break;
  11129.     }
  11130.  
  11131.     return (WinDefWindowProc (hwnd, msg, mp1, mp2));
  11132. }
  11133.  
  11134. The following shows the tagging that communicates with the communication object 
  11135. through the reftype=inform attribute of :link.. The contents of the right 
  11136. window are defined by IPF.  The contents of the left window are defined and 
  11137. controlled by the communication object ComWindow and resides in INFORM.DLL. 
  11138.  
  11139. :userdoc.
  11140. :docprof ctrlarea=none.
  11141. :h1 id=examp5 scroll=none
  11142.     x=left y=bottom width=100% height=100%.
  11143. Interacting with Application Windows on the Workplace
  11144. .*
  11145. :link reftype=hd refid=mytxt5
  11146.       vpx=left vpy=bottom vpcx=50% vpcy=100%
  11147.       titlebar=none scroll=none auto split.
  11148. .*
  11149. :acviewport dll='inform'
  11150.             objectname='ComWindow'
  11151.             objectid=1
  11152.             objectinfo='optional'
  11153.             vpx=right vpy=bottom
  11154.             vpcx=50% vpcy=100%.
  11155. .*
  11156. .*
  11157. :link reftype=inform res=1000 auto.
  11158. :h1 hide id=mytxt5.My text
  11159. :p.
  11160. This window could contain an explanation of how to interact with
  11161. the application-controlled window displayed on the right.
  11162. :euserdoc.
  11163.  
  11164. In the previous example, IPF processes :acviewport. as follows: 
  11165.  
  11166.    1. It loads INFORM.DLL and calls the procedure ComWindow. 
  11167.    2. ComWindow passes the value of objectid= and objectinfo=.  These 
  11168.       attributes are place holders for this example. 
  11169.    3. ComWindow creates a communication window that will receive the HM_INFORM 
  11170.       messages from IPF when it processes the reftype=inform attribute of 
  11171.       :link.. 
  11172.  
  11173.       When the HM_INFORM message is sent to IPF, IPF creates and displays the 
  11174.       simulated application window. 
  11175.  
  11176.  The following figure displays the windows from the previous tagging example. 
  11177.  
  11178.  An Application-Controlled Window.  The communication object window is a 
  11179.  functioning frame window. 
  11180.  
  11181.  Communication windows also are useful when the same communication object is 
  11182.  used to support multiple application-controlled windows in help information. 
  11183.  For example, you can use the same IPF communication object to represent 
  11184.  different simulated application windows from one window to another.  Using the 
  11185.  previous examples, this is accomplished in two steps. 
  11186.  
  11187.      Add another :h1. window definition to the tagged source for the help 
  11188.       information.  A different number is specified in the res= attribute for 
  11189.       the :link. tag that has the reftype=inform attribute 
  11190.  
  11191.      Add the corresponding res= number as another possible value of the 
  11192.       parameter to the HM_INFORM message. It is processed accordingly by the 
  11193.       communication object window procedure 
  11194.  
  11195.  
  11196. ΓòÉΓòÉΓòÉ 14. Changing Help Information at Run Time (DDF) ΓòÉΓòÉΓòÉ
  11197.  
  11198. Dynamic data formatting (DDF) allows you to incorporate text, bit maps, or 
  11199. metafiles in an IPF window at execution time. You can use the dynamic data 
  11200. formatting facility in conjunction with the dynamic data format tag (:ddf.). 
  11201. The :ddf. tag functions as a request by IPF to the application for the DDF 
  11202. data, and a set of DDF application programming interface calls that provide 
  11203. primitives for formatting text. The DDF calls also allow you to incorporate bit 
  11204. maps and metafiles dynamically, and to specify a hypertext or inform link from 
  11205. DDF data to non-DDF data. 
  11206.  
  11207. IPF has no knowledge of the DDF data it displays, other than that a block of 
  11208. data has been provided to it by the application program. Therefore, DDF data 
  11209. cannot be searched or printed. In effect, DDF is a specific extension of 
  11210. application-controlled windows. When the :ddf. tag is encountered at execution 
  11211. time, IPF sends the HM_QUERY_DDF_DATA message to the application window 
  11212. procedure with which the current instance of help is associated.  IPF sends the 
  11213. message either by a WinAssociateHelpInstance request or a HM_SET_OBJCOM_WINDOW 
  11214. message. 
  11215.  
  11216.  
  11217. ΓòÉΓòÉΓòÉ 14.1. DDF and Online Help ΓòÉΓòÉΓòÉ
  11218.  
  11219. DDF data is treated differently for a help and an online document. In the case 
  11220. of a help facility, the HM_QUERY_DDF_DATA message must be processed in the 
  11221. application's window procedure. Within the processing for this message, you can 
  11222. turn on the number specified in the res= attribute of the :ddf. tag to allow 
  11223. for different processing based on which IPF window with a :ddf. tag is 
  11224. currently being displayed. 
  11225.  
  11226. Therefore, in the case of dynamic data formatting within help, it is not 
  11227. necessary to specify an application-controlled window or a separate DLL. 
  11228. However, this would also work if the application-controlled window used the 
  11229. HM_SET_OBJCOM_WINDOW message to explicitly identify the entry point specified 
  11230. in the dll=' ' and objectname=' ' attributes of the :acviewport. tag as the 
  11231. proper window procedure where the HM_QUERY_DDF_DATA message is processed. 
  11232.  
  11233.  
  11234. ΓòÉΓòÉΓòÉ 14.2. DDF and Online Documents ΓòÉΓòÉΓòÉ
  11235.  
  11236. The situation is different with an online document (as in, filetype INF). To 
  11237. display DDF data in an online document, the :ddf. tag must be specified within 
  11238. an application-controlled window. The window that actually specifies the :ddf. 
  11239. tag must be defined as a LINK AUTO SPLIT of the application-controlled window's 
  11240. parent window that is specified with a heading tag. The reason is based on the 
  11241. serialization sequence when IPF reads an .INF source file. For example, suppose 
  11242. the file is tagged as follows: 
  11243.  
  11244. :h1 res=100 x=0 y=0 width=50% height=50%.DDF Parent
  11245. :acviewport dll='test.dll' objectname='someobject' objectid='1'.
  11246. :ddf res=100.
  11247.  
  11248. The HM_QUERY_DDF_DATA message will be sent to the window procedure of VIEW, 
  11249. which does not process it, and it will be lost. However, suppose the tagging 
  11250. sequence is as follows: 
  11251.  
  11252. :h1 res=100 x=left y=top width=100% height=100% titlebar=both clear.Look here first
  11253. :acviewport dll='flight' objectname='GetName' objectid='2'.
  11254. :link reftype=hd refid=ddf1 auto split.
  11255. :h1 id=ddf1 x=50% y=top width=50% height=100% hide.ddf1
  11256. :ddf res=100.
  11257.  
  11258. The HM_QUERY_DDF_DATA message will be sent to the "GetName" window procedure, 
  11259. which can initialize and process the DDF data. Therefore, to incorporate DDF 
  11260. data in an online document, you must write a DLL to handle the processing. This 
  11261. DLL must be a global communication object. (That is, docproof-loaded) 
  11262.  
  11263. The other DDF message is the HM_INVALIDATE_DDF_DATA.  This message is sent by 
  11264. the application and informs IPF that previous dynamic data formatting (DDF) 
  11265. information is no longer valid. 
  11266.  
  11267. For information about the DDF calls, see Dynamic Data Formatting Functions. 
  11268.  
  11269.  
  11270. ΓòÉΓòÉΓòÉ 14.3. Example using DDF ΓòÉΓòÉΓòÉ
  11271.  
  11272. /* DDF Sample */
  11273.  
  11274. #define INCL_GPIPRIMITIVES
  11275. #define INCL_WINHELP
  11276. #define INCL_WIN
  11277. #define INCL_DDF
  11278. #include <os2.h>
  11279. #include "ddf.h"
  11280.  
  11281. MRESULT EXPENTRY ClientWndProc( HWND, USHORT, MPARAM, MPARAM );
  11282. VOID HelpInit( HAB hab );
  11283.  
  11284. HWND hwndHelpInstance;
  11285.  
  11286. HELPSUBTABLE helpSubTableMAIN[ ] =
  11287. {
  11288.    2, 0, 0
  11289. };
  11290.  
  11291. HELPTABLE helpTableMAIN[ ] =
  11292. {
  11293.       ID_PRIMWIN, helpSubTableMAIN, EXT_HELP_PANEL,
  11294. };
  11295.  
  11296. VOID main()
  11297. {
  11298.    static ULONG flFrameFlags = FCF_TITLEBAR | FCF_SYSMENU | FCF_TASKLIST |
  11299.                                FCF_SIZEBORDER  | FCF_SHELLPOSITION |
  11300.                                FCF_MINBUTTON | FCF_MAXBUTTON;
  11301.  
  11302.  
  11303.    HAB hab;
  11304.    HMQ hmq;
  11305.    QMSG qmsg;
  11306.    HWND hwndFrame, hwndClient;
  11307.    BOOL bReturnCode;
  11308.  
  11309.    hab = WinInitialize( 0 );             /* Get anchor block */
  11310.    hmq = WinCreateMsgQueue( hab, 0 );    /* Create message queue */
  11311.  
  11312.    bReturnCode = WinRegisterClass( hab,                   /* Anchor Block */
  11313.                                    "ClientWindow",        /* Class name   */
  11314.                                    (PFNWP) ClientWndProc, /* Window Proc  */
  11315.                                    CS_SIZEREDRAW,         /* Classstyles  */
  11316.                                    0 );                   /* Extra data   */
  11317.    hwndFrame = WinCreateStdWindow( HWND_DESKTOP,           /* parent */
  11318.                                    WS_VISIBLE,             /* window styles */
  11319.                                    &flFrameFlags,         /* FCF values */
  11320.                                    "ClientWindow",        /* class */
  11321.                                    "Press F1 for a DDF Sample", /* titlebar text */
  11322.                                    0L,                    /* client styles */
  11323.                                    NULLHANDLE,            /* resource handle */
  11324.                                    ID_PRIMWIN,            /* ID */
  11325.                                    &hwndClient );         /* return client */
  11326.  
  11327.    /* Initialize Help */
  11328.    HelpInit( hab );
  11329.    /* Associate the help instance with the window */
  11330.    WinAssociateHelpInstance( hwndHelpInstance, hwndFrame );
  11331.  
  11332.    while ( WinGetMsg( hab, &qmsg, NULLHANDLE, 0, 0 ) )    /* message loop */
  11333.        WinDispatchMsg( hab, &qmsg );
  11334.  
  11335.    /* Destroy the help instance */
  11336.    WinDestroyHelpInstance( hwndHelpInstance );
  11337.  
  11338.    WinDestroyWindow( hwndFrame );      /* destroy window        */
  11339.    WinDestroyMsgQueue( hmq );          /* destroy message queue */
  11340.    WinTerminate( hab );                /* return anchor block   */
  11341. }
  11342.  
  11343. MRESULT EXPENTRY ClientWndProc( HWND hwnd, USHORT msg, MPARAM mp1, MPARAM mp2)
  11344. {
  11345.    HPS hps;
  11346.    ULONG ulResID;
  11347.    HDDF hDDF;
  11348.    HBITMAP hbm;
  11349.    APIRET returncode;
  11350.    ERRORID errcode;
  11351.  
  11352.    switch ( msg ) {
  11353.       case HM_INFORM:
  11354.          switch (SHORT1FROMMP(mp1)) {
  11355.          case 1:
  11356.             WinMessageBox( HWND_DESKTOP, HWND_DESKTOP, "You clicked on the link",
  11357.                           "DDF Sample", 0, MB_OK);
  11358.             break;
  11359.          default:
  11360.             WinMessageBox( HWND_DESKTOP, HWND_DESKTOP, "Unknown Inform link",
  11361.                           "DDF Sample", 0, MB_OK);
  11362.            break;
  11363.          } /* endswitch */
  11364.       break;
  11365.       case HM_QUERY_DDF_DATA:
  11366.          ulResID = LONGFROMMP( mp2 );
  11367.          /* Initialize DDF */
  11368.          hDDF = DdfInitialize( hwndHelpInstance, 0L, 0L);
  11369.          /* Check res id to see which DDF line */
  11370.          switch (ulResID) {
  11371.             case 1:
  11372.                DdfPara( hDDF);
  11373.                DdfText( hDDF, "This text was placed by DDF");
  11374.                DdfPara( hDDF);
  11375.                DdfText( hDDF, "You can use ");
  11376.                DdfSetFontStyle( hDDF, FM_SEL_ITALIC);
  11377.                DdfText( hDDF, "italic, ");
  11378.                DdfSetFontStyle( hDDF, FM_SEL_BOLD);
  11379.                DdfText( hDDF, "bold, ");
  11380.                DdfSetFontStyle( hDDF, FM_SEL_UNDERSCORE);
  11381.                DdfText( hDDF, "underscore, ");
  11382.                DdfSetFontStyle( hDDF, FM_SEL_UNDERSCORE | FM_SEL_ITALIC | FM_SEL_BOLD );
  11383.                DdfText( hDDF, "or all three!");
  11384.                DdfSetFontStyle( hDDF, 0);
  11385.                DdfPara( hDDF);
  11386.                DdfText( hDDF, "How about some color?");
  11387.                DdfPara( hDDF);
  11388.                DdfSetColor( hDDF, CLR_BLUE, CLR_RED);
  11389.                DdfText( hDDF, "Red on Blue\n");
  11390.                DdfSetColor( hDDF, CLR_BLACK, CLR_PALEGRAY);
  11391.                DdfText( hDDF, "Pale Gray on Black\n");
  11392.                DdfSetColor( hDDF, CLR_DEFAULT, CLR_DEFAULT);
  11393.                DdfPara( hDDF);
  11394.                DdfSetFont( hDDF, "Courier", 100, 100);
  11395.                DdfText( hDDF, "Or a font change?");
  11396.                DdfSetFont( hDDF, NULL, 1, 1);
  11397.                DdfPara( hDDF);
  11398.                DdfSetTextAlign( hDDF, TA_CENTER);
  11399.                DdfSetFormat( hDDF, FALSE);
  11400.                DdfText( hDDF, "We can\ncenter text");
  11401.                DdfSetFormat( hDDF, TRUE);
  11402.                DdfSetTextAlign( hDDF, TA_LEFT);
  11403.                hbm = WinGetSysBitmap( HWND_DESKTOP, SBMP_FOLDER);
  11404.                DdfPara( hDDF);
  11405.                DdfBitmap( hDDF, hbm, ART_RUNIN );
  11406.                DdfText( hDDF, "Perhaps a bitmap?" );
  11407.                DdfPara( hDDF);
  11408.                DdfText( hDDF, "Or a list?");
  11409.                DdfBeginList(hDDF, 15, HMBT_FIT, HMLS7us.SINGLELINE);
  11410.                DdfListItem( hDDF, "Item 1", "Item 1 Description");
  11411.                DdfListItem( hDDF, "Item 2", "Item 2 Description");
  11412.                DdfEndList( hDDF);
  11413.                DdfPara( hDDF);
  11414.                DdfText( hDDF, "You can even create a " );
  11415.                DdfHyperText( hDDF, "link to a panel ", "2", REFERENCE_BY_RES );
  11416.                DdfText( hDDF, "or an " );
  11417.                DdfInform( hDDF, "inform link", 1 );
  11418.                /* Return the DDF handle you just created */
  11419.                return (MRESULT) hDDF;
  11420.                break;
  11421.          } /* endswitch */
  11422.          break;
  11423.       case WM_PAINT:
  11424.          hps = WinBeginPaint( hwnd, NULLHANDLE, NULL );
  11425.          GpiErase( hps );
  11426.          WinEndPaint( hps );
  11427.          return 0;
  11428.          break;
  11429.    } /* endswitch */
  11430.    return WinDefWindowProc( hwnd, msg, mp1, mp2 );
  11431. }
  11432.  
  11433. VOID HelpInit( HAB hab )
  11434. {
  11435.    HELPINIT helpinit;
  11436.  
  11437.    helpinit.cb = sizeof( HELPINIT );
  11438.    helpinit.ulReturnCode = 0L;
  11439.    helpinit.pszTutorialName = NULL;
  11440.    helpinit.phtHelpTable = (PVOID) helpTableMAIN;
  11441.    helpinit.hmodHelpTableModule = 0;
  11442.    helpinit.hmodAccelActionBarModule = 0;
  11443.    helpinit.idAccelTable = 0;
  11444.    helpinit.idActionBar = 0;
  11445.    helpinit.pszHelpWindowTitle = "Help for DDF Sample\0";
  11446.    helpinit.fShowPanelId = CMIC_HIDE_PANEL_ID;
  11447.    helpinit.pszHelpLibraryName = "DDF.HLP";
  11448.  
  11449.    hwndHelpInstance = WinCreateHelpInstance( hab, &helpinit );
  11450.    if (!hwndHelpInstance)
  11451.       WinMessageBox( HWND_DESKTOP, HWND_DESKTOP, "Help could not be initialized",
  11452.                     "DDF Sample", 0, MB_OK | MB_ERROR);
  11453.    return;
  11454. }
  11455.  
  11456.  
  11457. ΓòÉΓòÉΓòÉ 15. Creating Master Indexes and Glossaries with Applications ΓòÉΓòÉΓòÉ
  11458.  
  11459. The Workplace Shell "Mindex" software object class exploits IPF's 
  11460. functionality, providing a user object interface from which users can link to 
  11461. online helps. Your applications can instantiate these software object classes 
  11462. at run-time. 
  11463.  
  11464.  
  11465. ΓòÉΓòÉΓòÉ 15.1. Master Help Index Objects and Glossary Objects ΓòÉΓòÉΓòÉ
  11466.  
  11467. The OS/2 operating system's online documentation includes two Workplace Shell 
  11468. user objects that correspond to a single Workplace Shell software class object. 
  11469. The "Master Help Index" user object and the "Glossary" user object are 
  11470. instances of the "Mindex" object class. With the Master Help Index and the 
  11471. Glossary, users can access online help panels which include the global 
  11472. attribute in their index tagging (for more information, see Customizing Master 
  11473. Help Index and Glossary Objects). Note that this object class only works with 
  11474. online help (.HLP files), not online information (.INF files). 
  11475.  
  11476. The Mindex class is a member of the WPAbstract class, which is, in turn, a 
  11477. member of the root WPObject class. All of the WPObject classes are easily 
  11478. accessed and instantiated through the "WP Class List", provided as one of the 
  11479. PM Development Tools in the IBM Developer's Toolkit for OS/2. For additional 
  11480. information about manipulating Mindex class user objects in the Workplace Shell 
  11481. (such as copying and shadowing) see Customizing Master Help Index and Glossary 
  11482. Objects. 
  11483.  
  11484. There are three task scenarios involving Mindex class objects of particular 
  11485. interest to a programmer: 
  11486.  
  11487.    1. Adding index entries to the Master Help Index user object at installation 
  11488.       time. 
  11489.  
  11490.    2. Adding index entries to the Glossary user object at installation time. 
  11491.  
  11492.    3. Instantiating a new Mindex class object with an application. For example, 
  11493.       creating a product-specific master index user object during the 
  11494.       installation of your application. 
  11495.  
  11496.  These tasks can be done with minimal programming effort. 
  11497.  
  11498.  
  11499. ΓòÉΓòÉΓòÉ 15.1.1. Adding Entries to the Master Help Index at Installation ΓòÉΓòÉΓòÉ
  11500.  
  11501. Mindex class objects such as the Master Help Index and Glossary user objects 
  11502. display index entries that have been tagged with the global attribute (see :i1. 
  11503. and :i2.  (Index)). These index entries can be placed in any .HLP file. The 
  11504. .HLP files available to a given Mindex class user object are identified in the 
  11505. object's Settings Notebook. 
  11506.  
  11507. For example, the Master Help Index user object that is installed with the OS/2 
  11508. operating system has a default "Files/Environment name(s)" setting of "HELP". 
  11509. This refers to the HELP environment variable identified in the CONFIG.SYS file. 
  11510. Therefore, if you wanted the global index entries in your .HLP files to appear 
  11511. in the Master Help Index user object, you could simply copy your .HLP files to 
  11512. directories or files specified by the HELP environment variable. 
  11513.  
  11514. The default value of HELP is: 
  11515.  
  11516. HELP=C:\OS2\HELP;C:\OS2\HELP\TUTORIAL;
  11517. Alternatively, you could modify the value of the "HELP" environment variable by 
  11518. updating CONFIG.SYS. 
  11519.  
  11520.  
  11521. ΓòÉΓòÉΓòÉ 15.1.2. Adding Entries to the Glossary at Installation ΓòÉΓòÉΓòÉ
  11522.  
  11523. Because both the Glossary and the Master Help Index user objects are simply 
  11524. Mindex class software objects, the manner in which you add entries to the 
  11525. Glossary is identical to the manner in which you add entries to the Master Help 
  11526. Index (see Adding Entries to the Master Help Index at Installation). However, 
  11527. if you check the default Settings Notebook for the Glossary user object, you 
  11528. will notice that the Glossary installed with the OS/2 operating has a default 
  11529. "Files/Environment name(s)" that is not set to the "HELP" environment variable. 
  11530. Rather, it is set to the "GLOSSARY" environment variable. Therefore, you can 
  11531. update the value of this variable in CONFIG.SYS to reflect the location of your 
  11532. .HLP files that contain global tagged index entries. Alternatively, you can 
  11533. simply copy your .HLP files to the path defined by the GLOBAL environment 
  11534. variable. The default value is: 
  11535.  
  11536. GLOSSARY=C:\OS2\HELP\GLOSS;
  11537.  
  11538.  
  11539. ΓòÉΓòÉΓòÉ 15.1.3. Creating New Mindex Class Objects ΓòÉΓòÉΓòÉ
  11540.  
  11541. To instantiate a Mindex class object (such as a product-specific index or 
  11542. glossary), you need to create the new instance of the object and pass it 
  11543. necessary setup strings. This can be done with the WinCreateObject PM function. 
  11544.  
  11545. If you need to create an instance of a Mindex class object for use by your 
  11546. application, you will probably want to do so during installation. 
  11547.  
  11548.  
  11549. ΓòÉΓòÉΓòÉ 15.1.3.1. Example- Instantiating a Mindex Class Object Using REXX ΓòÉΓòÉΓòÉ
  11550.  
  11551. Many applications are installed using the REXX procedural language. Rather than 
  11552. use the WinCreateObject function, you can use REXX's SysCreateObject function. 
  11553.  
  11554. A sample REXX implementation might resemble the following: 
  11555.  
  11556. /* Register and load the Rexx Utility Functions                  */
  11557.  
  11558. call RxFuncAdd 'SysLoadFuncs', 'RexxUtil', 'SysLoadFuncs'
  11559. call SysLoadFuncs
  11560.  
  11561. /* Create a new Mindex class object                              */
  11562. /*                                                               */
  11563. /* Call SysCreateObject Rexx Utility function, and pass it       */
  11564. /*          a class name (Mindex);                               */
  11565. /*                                                               */
  11566. /* then pass it the icon title ('My Product Index');             */
  11567. /*                                                               */
  11568. /* then pass it the folder I want the object in (<WP_DESKTOP>;   */
  11569. /*                                                               */
  11570. /* then pass it the setup string with INDEX= set to the names    */
  11571. /*          of the help files that I want to be in my index      */
  11572. /*          (in this case C:\myprod\myhelp\myprod.hlp); the */
  11573. /*          default value of INDEX is equal to the HELP          */
  11574. /*          environment variable;                                */
  11575. /*                                                               */
  11576. /* then pass it a unique object id (MYINDEX);                    */
  11577. /*                                                               */
  11578. /* then tell me if the installation was successful.              */
  11579. if SysCreateObject("Mindex", "My Product Index", "<WP_DESKTOP>",,
  11580.            "INDEX=C:\MYPROD\HELP\MYPROD.HLP; OBJECTID=<MYINDEX>")
  11581. then Say 'Installation of My Product Index was successful!'
  11582. else Say 'Installation of My Product Index failed!'
  11583.  
  11584.  
  11585. ΓòÉΓòÉΓòÉ 16. Window Functions ΓòÉΓòÉΓòÉ
  11586.  
  11587. Following is a summary of the window function calls that you would use to 
  11588. interface with IPF. 
  11589.  
  11590.  WinAssociateHelpInstance 
  11591.      Associates the help instance with the application window chain. 
  11592.  
  11593.  WinCreateHelpInstance 
  11594.      Calls the IPF help hook so that IPF can handle help requests. 
  11595.  
  11596.  WinCreateHelpTable 
  11597.      Identifies or changes the pointer to the help table in application memory. 
  11598.  
  11599.  WinDestroyHelpInstance 
  11600.      Ends the window chain's association with the help instance. 
  11601.  
  11602.  WinLoadHelpTable 
  11603.      Identifies or changes the handle of the module that contains the help 
  11604.      table resource. 
  11605.  
  11606.  WinQueryHelpInstance 
  11607.      Identifies the help instance associated with a particular application 
  11608.      window chain. 
  11609.  
  11610.  
  11611. ΓòÉΓòÉΓòÉ 16.1. WinAssociateHelpInstance ΓòÉΓòÉΓòÉ
  11612.  
  11613.  
  11614. ΓòÉΓòÉΓòÉ <hidden> WinAssociateHelpInstance - Syntax ΓòÉΓòÉΓòÉ
  11615.  
  11616. This function associates the specified instance of the Help Manager with the 
  11617. window chain of the specified application window. 
  11618.  
  11619.  
  11620. #define INCL_WINHELP /* Or use INCL_WIN, INCL_PM, */
  11621. #include <os2.h>
  11622.  
  11623. HWND    hwndHelpInstance;  /*  Handle of an instance of the Help Manager. */
  11624. HWND    hwndApp;           /*  Handle of an application window. */
  11625. BOOL    rc;                /*  Success indicator. */
  11626.  
  11627. rc = WinAssociateHelpInstance(hwndHelpInstance,
  11628.        hwndApp);
  11629.  
  11630.  
  11631. ΓòÉΓòÉΓòÉ <hidden> WinAssociateHelpInstance Parameter - hwndHelpInstance ΓòÉΓòÉΓòÉ
  11632.  
  11633.  hwndHelpInstance (HWND) - input 
  11634.     Handle of an instance of the Help Manager. 
  11635.  
  11636.     This is the handle returned by the WinCreateHelpInstance call. 
  11637.  
  11638.     NULLHANDLE 
  11639.             Disassociates an instance of the Help Manager from a window chain 
  11640.             when the instance has been destroyed. 
  11641.  
  11642.     Other 
  11643.             The handle of an instance of the Help Manager to be associated with 
  11644.             the application window chain. 
  11645.  
  11646.  
  11647. ΓòÉΓòÉΓòÉ <hidden> WinAssociateHelpInstance Parameter - hwndApp ΓòÉΓòÉΓòÉ
  11648.  
  11649.  hwndApp (HWND) - input 
  11650.     Handle of an application window. 
  11651.  
  11652.     The handle of the application window with which the instance of the Help 
  11653.     Manager will be associated. The instance of the Help Manager is associated 
  11654.     with the application window and any of its children or owned windows. 
  11655.  
  11656.  
  11657. ΓòÉΓòÉΓòÉ <hidden> WinAssociateHelpInstance Return Value - rc ΓòÉΓòÉΓòÉ
  11658.  
  11659.  rc (BOOL) - returns 
  11660.     Success indicator. 
  11661.  
  11662.     TRUE 
  11663.             Successful completion 
  11664.     FALSE 
  11665.             Error occurred. 
  11666.  
  11667.  
  11668. ΓòÉΓòÉΓòÉ <hidden> WinAssociateHelpInstance - Parameters ΓòÉΓòÉΓòÉ
  11669.  
  11670.  hwndHelpInstance (HWND) - input 
  11671.     Handle of an instance of the Help Manager. 
  11672.  
  11673.     This is the handle returned by the WinCreateHelpInstance call. 
  11674.  
  11675.     NULLHANDLE 
  11676.             Disassociates an instance of the Help Manager from a window chain 
  11677.             when the instance has been destroyed. 
  11678.  
  11679.     Other 
  11680.             The handle of an instance of the Help Manager to be associated with 
  11681.             the application window chain. 
  11682.  
  11683.  hwndApp (HWND) - input 
  11684.     Handle of an application window. 
  11685.  
  11686.     The handle of the application window with which the instance of the Help 
  11687.     Manager will be associated. The instance of the Help Manager is associated 
  11688.     with the application window and any of its children or owned windows. 
  11689.  
  11690.  rc (BOOL) - returns 
  11691.     Success indicator. 
  11692.  
  11693.     TRUE 
  11694.             Successful completion 
  11695.     FALSE 
  11696.             Error occurred. 
  11697.  
  11698.  
  11699. ΓòÉΓòÉΓòÉ <hidden> WinAssociateHelpInstance - Remarks ΓòÉΓòÉΓòÉ
  11700.  
  11701. In order to provide help, the application must associate an instance of the 
  11702. Help Manager with a chain of application windows. This association lets the 
  11703. Help Manager know which instance should provide the help function. 
  11704.  
  11705. The Help Manager traces the window chain, starting from the window where help 
  11706. is requested. The application window in the chain with the associated help 
  11707. instance will be the one with which the Help Manager communicates and next to 
  11708. which the help window is positioned, unless a HM_SET_ACTIVE_WINDOW message is 
  11709. sent to the Help Manager. If the HM_SET_ACTIVE_WINDOW message is sent to the 
  11710. Help Manager, the active window parameter is the window with which the Help 
  11711. Manager communicates. The Help Manager positions the help window next to the 
  11712. window specified as the relative window. 
  11713.  
  11714.  
  11715. ΓòÉΓòÉΓòÉ <hidden> WinAssociateHelpInstance - Related Functions ΓòÉΓòÉΓòÉ
  11716.  
  11717.      WinAssociateHelpInstance 
  11718.      WinCreateHelpInstance 
  11719.      WinCreateHelpTable 
  11720.      WinDestroyHelpInstance 
  11721.      WinLoadHelpTable 
  11722.      WinQueryHelpInstance 
  11723.  
  11724.  
  11725. ΓòÉΓòÉΓòÉ <hidden> WinAssociateHelpInstance - Related Messages ΓòÉΓòÉΓòÉ
  11726.  
  11727.      HM_SET_ACTIVE_WINDOW 
  11728.  
  11729.  
  11730. ΓòÉΓòÉΓòÉ <hidden> WinAssociateHelpInstance - Example Code ΓòÉΓòÉΓòÉ
  11731.  
  11732. This example shows a typical main function for an application which uses help. 
  11733. Following creation of the main application window the Help Manager is 
  11734. initialized and associated with the window.  The help table is defined in the 
  11735. application's resources. When the window is destroyed, terminating the 
  11736. application, the help instance is also destroyed. 
  11737.  
  11738. #define INCL=_WIN
  11739. #include <os2.h>
  11740.  
  11741. #define IDHT_APPLICATION        100     /* id of HELP TABLE in resource file */
  11742.  
  11743. main( int argc, char *argv[], char *envp[] )
  11744. {
  11745.    HAB  hab = WinInitialize( 0 );
  11746.    HMQ  hmq = WinCreateMsgQueue( hab, 0 );
  11747.    HWND hwnd;
  11748.    HWND hwndClient;
  11749.    HWND hwndHelp;
  11750.    QMSG qmsg;
  11751.    ULONG flStyle;
  11752.    HELPINIT helpinit;
  11753.  
  11754.    /* Setup the help initialization structure */
  11755.    helpinit.cb = sizeof( HELPINIT );
  11756.    helpinit.ulReturnCode =  0L;
  11757.    helpinit.pszTutorialName =  (PSZ)NULL;
  11758.    /* Help table in application resource */
  11759.    helpinit.phtHelpTable = (PHELPTABLE)MAKEULONG( IDHT_APPLICATION, 0xffff );
  11760.    helpinit.hmodHelpTableModule = NULLHANDLE;
  11761.    /* Default action bar and accelerators */
  11762.    helpinit.hmodAccelActionBarModule = NULLHANDLE;
  11763.    helpinit.idAccelTable = 0;
  11764.    helpinit.idActionBar = 0;
  11765.    helpinit.pszHelpWindowTitle = "APPNAME HELP";
  11766.    helpinit.fShowPanelId = CMIC_SHOW_PANEL_ID;
  11767.    helpinit.pszHelpLibraryName = "APPNAME.HLP";
  11768.  
  11769.    /* Register the class */
  11770.    if( WinRegisterClass( ... ) )
  11771.    {
  11772.       /* create the main window */
  11773.       flStyle = FCF_STANDARD;
  11774.       hwnd = WinCreateStdWindow( ... );
  11775.  
  11776.       if( hwnd )
  11777.       {
  11778.          /* Create and associate the help instance */
  11779.          hwndHelp = WinCreateHelpInstance( hab, &helpinit );
  11780.  
  11781.          if( hwndHelp && WinAssociateHelpInstance( hwndHelp, hwnd ) )
  11782.          {
  11783.             /* Process messages */
  11784.             while( WinGetMsg( hab, &qmsg, NULLHANDLE, 0, 0 ) )
  11785.             {
  11786.                WinDispatchMsg( hab, &qmsg );
  11787.             } /* endwhile */
  11788.          }
  11789.  
  11790.          /* Remove help instance - note: add                    */
  11791.          /*     WinAssociateHelpInstance( NULLHANDLE, hwnd );      */
  11792.          /* to WM_DESTROY processing to remove the association. */
  11793.          WinDestroyHelpInstance( hwndHelp );
  11794.       }
  11795.    }
  11796.  
  11797.    /* finish the cleanup and exit */
  11798.    WinDestroyMsgQueue( hmq );
  11799.    WinTerminate( hab );
  11800. }
  11801.  
  11802.  
  11803. ΓòÉΓòÉΓòÉ <hidden> WinAssociateHelpInstance - Topics ΓòÉΓòÉΓòÉ
  11804.  
  11805. Select an item: 
  11806.  
  11807. Syntax
  11808. Parameters
  11809. Returns
  11810. Remarks
  11811. Example Code
  11812. Related Functions
  11813. Related Messages
  11814. Glossary
  11815.  
  11816.  
  11817. ΓòÉΓòÉΓòÉ 16.2. WinCreateHelpInstance ΓòÉΓòÉΓòÉ
  11818.  
  11819.  
  11820. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpInstance - Syntax ΓòÉΓòÉΓòÉ
  11821.  
  11822. This function creates an instance of the Help Manager with which to request 
  11823. Help Manager functions. 
  11824.  
  11825.  
  11826. #define INCL_WINHELP /* Or use INCL_WIN, INCL_PM, */
  11827. #include <os2.h>
  11828.  
  11829. HAB          hab;                    /*  Anchor-block handle. */
  11830. PHELPINIT    phinitHMInitStructure;  /*  Help Manager initialization structure. */
  11831. HWND         hwndhelp;               /*  Help Manager handle. */
  11832.  
  11833. hwndhelp = WinCreateHelpInstance(hab, phinitHMInitStructure);
  11834.  
  11835.  
  11836. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpInstance Parameter - hab ΓòÉΓòÉΓòÉ
  11837.  
  11838.  hab (HAB) - input 
  11839.     Anchor-block handle. 
  11840.  
  11841.     The handle of the application anchor block returned from the WinInitialize 
  11842.     function. 
  11843.  
  11844.  
  11845. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpInstance Parameter - phinitHMInitStructure ΓòÉΓòÉΓòÉ
  11846.  
  11847.  phinitHMInitStructure (PHELPINIT) - in/out 
  11848.     Help Manager initialization structure. 
  11849.  
  11850.  
  11851. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpInstance Return Value - hwndhelp ΓòÉΓòÉΓòÉ
  11852.  
  11853.  hwndhelp (HWND) - returns 
  11854.     Help Manager handle. 
  11855.  
  11856.     NULLHANDLE 
  11857.             Error occurred 
  11858.     Other 
  11859.             Help Manager handle. 
  11860.  
  11861.  
  11862. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpInstance - Parameters ΓòÉΓòÉΓòÉ
  11863.  
  11864.  hab (HAB) - input 
  11865.     Anchor-block handle. 
  11866.  
  11867.     The handle of the application anchor block returned from the WinInitialize 
  11868.     function. 
  11869.  
  11870.  phinitHMInitStructure (PHELPINIT) - in/out 
  11871.     Help Manager initialization structure. 
  11872.  
  11873.  hwndhelp (HWND) - returns 
  11874.     Help Manager handle. 
  11875.  
  11876.     NULLHANDLE 
  11877.             Error occurred 
  11878.     Other 
  11879.             Help Manager handle. 
  11880.  
  11881.  
  11882. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpInstance - Remarks ΓòÉΓòÉΓòÉ
  11883.  
  11884. If an error occurs, it is in the ulReturnCode parameter of the HELPINIT 
  11885. structure. 
  11886.  
  11887.  
  11888. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpInstance - Related Functions ΓòÉΓòÉΓòÉ
  11889.  
  11890.      WinAssociateHelpInstance 
  11891.      WinCreateHelpInstance 
  11892.      WinCreateHelpTable 
  11893.      WinDestroyHelpInstance 
  11894.      WinLoadHelpTable 
  11895.      WinQueryHelpInstance 
  11896.  
  11897.  
  11898. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpInstance - Example Code ΓòÉΓòÉΓòÉ
  11899.  
  11900. This example shows a typical main function for an application which uses help. 
  11901. Following creation of the main application window the Help Manager is 
  11902. initialized and associated with the window.  The help table is defined in the 
  11903. application's resources. When the window is destroyed, terminating the 
  11904. application, the help instance is also destroyed. 
  11905.  
  11906. #define INCL=_WIN
  11907. #include <os2.h>
  11908.  
  11909. #define IDHT_APPLICATION        100     /* id of HELP TABLE in resource file
  11910. */
  11911.  
  11912. main( int argc, char *argv[], char *envp[] )
  11913. {
  11914.    HAB  hab = WinInitialize( 0 );
  11915.    HMQ  hmq = WinCreateMsgQueue( hab, 0 );
  11916.    HWND hwnd;
  11917.    HWND hwndClient;
  11918.    HWND hwndHelp;
  11919.    QMSG qmsg;
  11920.    ULONG flStyle;
  11921.    HELPINIT helpinit;
  11922.  
  11923.    /* Setup the help initialization structure */
  11924.    helpinit.cb = sizeof( HELPINIT );
  11925.    helpinit.ulReturnCode =  0L;
  11926.    helpinit.pszTutorialName =  (PSZ)NULL;
  11927.    /* Help table in application resource */
  11928.    helpinit.phtHelpTable = (PHELPTABLE)MAKEULONG( IDHT_APPLICATION, 0xffff );
  11929.    helpinit.hmodHelpTableModule = NULLHANDLE;
  11930.    /* Default action bar and accelerators */
  11931.    helpinit.hmodAccelActionBarModule = NULLHANDLE;
  11932.    helpinit.idAccelTable = 0;
  11933.    helpinit.idActionBar = 0;
  11934.    helpinit.pszHelpWindowTitle = "APPNAME HELP";
  11935.    helpinit.fShowPanelId = CMIC_SHOW_PANEL_ID;
  11936.    helpinit.pszHelpLibraryName = "APPNAME.HLP";
  11937.  
  11938.    /* Register the class */
  11939.    if( WinRegisterClass( ... ) )
  11940.    {
  11941.       /* create the main window */
  11942.       flStyle = FCF_STANDARD;
  11943.       hwnd = WinCreateStdWindow( ... );
  11944.  
  11945.       if( hwnd )
  11946.       {
  11947.          /* Create and associate the help instance */
  11948.          hwndHelp = WinCreateHelpInstance( hab, &helpinit );
  11949.  
  11950.          if( hwndHelp && WinAssociateHelpInstance( hwndHelp, hwnd ) )
  11951.          {
  11952.             /* Process messages */
  11953.             while( WinGetMsg( hab, &qmsg, NULLHANDLE, 0, 0 ) )
  11954.             {
  11955.                WinDispatchMsg( hab, &qmsg );
  11956.             } /* endwhile */
  11957.          }
  11958.  
  11959.          /* Remove help instance - note: add                    */
  11960.          /*     WinAssociateHelpInstance( NULLHANDLE, hwnd );      */
  11961.          /* to WM_DESTROY processing to remove the association. */
  11962.          WinDestroyHelpInstance( hwndHelp );
  11963.       }
  11964.    }
  11965.  
  11966.    /* finish the cleanup and exit */
  11967.    WinDestroyMsgQueue( hmq );
  11968.    WinTerminate( hab );
  11969. }
  11970.  
  11971.  
  11972. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpInstance - Topics ΓòÉΓòÉΓòÉ
  11973.  
  11974. Select an item: 
  11975.  
  11976. Syntax
  11977. Parameters
  11978. Returns
  11979. Remarks
  11980. Example Code
  11981. Related Functions
  11982. Glossary
  11983.  
  11984.  
  11985. ΓòÉΓòÉΓòÉ 16.3. WinCreateHelpTable ΓòÉΓòÉΓòÉ
  11986.  
  11987.  
  11988. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpTable - Syntax ΓòÉΓòÉΓòÉ
  11989.  
  11990. This function is used to identify or change the help table. 
  11991.  
  11992.  
  11993. #define INCL_WINHELP /* Or use INCL_WIN, INCL_PM, */
  11994. #include <os2.h>
  11995.  
  11996. HWND          hwndHelpInstance;  /*  Handle of an instance of the Help Manager. */
  11997. PHELPTABLE    phtHelpTable;      /*  Help table allocated by the application. */
  11998. BOOL          rc;                /*  Success indicator. */
  11999.  
  12000. rc = WinCreateHelpTable(hwndHelpInstance,
  12001.        phtHelpTable);
  12002.  
  12003.  
  12004. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpTable Parameter - hwndHelpInstance ΓòÉΓòÉΓòÉ
  12005.  
  12006.  hwndHelpInstance (HWND) - input 
  12007.     Handle of an instance of the Help Manager. 
  12008.  
  12009.     This is the handle returned by the WinCreateHelpInstance call. 
  12010.  
  12011.  
  12012. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpTable Parameter - phtHelpTable ΓòÉΓòÉΓòÉ
  12013.  
  12014.  phtHelpTable (PHELPTABLE) - input 
  12015.     Help table allocated by the application. 
  12016.  
  12017.  
  12018. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpTable Return Value - rc ΓòÉΓòÉΓòÉ
  12019.  
  12020.  rc (BOOL) - returns 
  12021.     Success indicator. 
  12022.  
  12023.     TRUE 
  12024.             Successful completion 
  12025.     FALSE 
  12026.             Error occurred. 
  12027.  
  12028.  
  12029. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpTable - Parameters ΓòÉΓòÉΓòÉ
  12030.  
  12031.  hwndHelpInstance (HWND) - input 
  12032.     Handle of an instance of the Help Manager. 
  12033.  
  12034.     This is the handle returned by the WinCreateHelpInstance call. 
  12035.  
  12036.  phtHelpTable (PHELPTABLE) - input 
  12037.     Help table allocated by the application. 
  12038.  
  12039.  rc (BOOL) - returns 
  12040.     Success indicator. 
  12041.  
  12042.     TRUE 
  12043.             Successful completion 
  12044.     FALSE 
  12045.             Error occurred. 
  12046.  
  12047.  
  12048. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpTable - Remarks ΓòÉΓòÉΓòÉ
  12049.  
  12050. This function corresponds to the HM_CREATE_HELP_TABLE message that identifies a 
  12051. help table that is in memory. 
  12052.  
  12053.  
  12054. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpTable - Related Functions ΓòÉΓòÉΓòÉ
  12055.  
  12056.      WinAssociateHelpInstance 
  12057.      WinCreateHelpInstance 
  12058.      WinCreateHelpTable 
  12059.      WinDestroyHelpInstance 
  12060.      WinLoadHelpTable 
  12061.      WinQueryHelpInstance 
  12062.  
  12063.  
  12064. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpTable - Related Messages ΓòÉΓòÉΓòÉ
  12065.  
  12066.      HM_CREATE_HELP_TABLE 
  12067.  
  12068.  
  12069. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpTable - Example Code ΓòÉΓòÉΓòÉ
  12070.  
  12071. This example creates a help table in memory and passes the table to the Help 
  12072. Manager via WinCreateHelpTable.  The help instance must have been created by 
  12073. WinCreateHelpInstance. 
  12074.  
  12075. #define INCL_WINHELP
  12076. #include <os2.h>
  12077.  
  12078. /* DEFINEs for window id's, menu items, controls, panels, etc. should */
  12079. /* be inserted here or in additional include files.                   */
  12080.  
  12081. /* Subtable for the main window's help */
  12082. HELPSUBTABLE phtMainTable[] = { 2,              /* Length of each entry */
  12083.                                  /* Fill in one line for each menu item   */
  12084.                                  IDM_FILE,       PANELID_FILEMENU,
  12085.                                  IDM_FILENEW,    PANELID_FILENEW,
  12086.                                  IDM_FILEOPEN,   PANELID_FILEOPEN,
  12087.                                  IDM_FILESAVE,   PANELID_FILESAVE,
  12088.                                  IDM_FILESAVEAS, PANELID_FILESAVEAS,
  12089.                                  IDM_FILEEXIT,   PANELID_FILEEXIT };
  12090.  
  12091. /* Subtable for the dialog window's help */
  12092. HELPSUBTABLE phtDlgTable[] = { 2,             /* Length of each entry */
  12093.                                 /* Fill in one line for each control */
  12094.                                 IDC_EDITFLD,    PANELID_DLGEDITFLD,
  12095.                                 IDC_OK,         PANELID_DLGOK,
  12096.                                 IDC_CANCEL,     PANELID_DLGCANCEL,
  12097.                                 IDC_HELP,       PANELID_HELP };
  12098.  
  12099. /* Help table for the applications context sensitive help */
  12100. HELPTABLE phtHelpTable[]= { WINDOWID_MAIN, phtMainTable,
  12101. PANELID_MAINEXT,
  12102.                               WINDOWID_DLG,  phtDlgTable,  PANELID_DLGEXT,
  12103.                               0,             NULL,           0 };
  12104.  
  12105. BOOL CreateHelpTable( HWND hWnd )
  12106. {
  12107.     BOOL bSuccess = FALSE;
  12108.     HWND hwndHelp;
  12109.  
  12110.     /* Get the associated help instance */
  12111.     hwndHelp = WinQueryHelpInstance( hWnd );
  12112.  
  12113.     if( hwndHelp )
  12114.     {
  12115.         /* Pass address of help table to the Help Manager */
  12116.         bSuccess = WinCreateHelpTable( hwndHelp, phtHelpTable );
  12117.     }
  12118.  
  12119.     /* return success indicator */
  12120.     return bSuccess;
  12121. }
  12122.  
  12123.  
  12124. ΓòÉΓòÉΓòÉ <hidden> WinCreateHelpTable - Topics ΓòÉΓòÉΓòÉ
  12125.  
  12126. Select an item: 
  12127.  
  12128. Syntax
  12129. Parameters
  12130. Returns
  12131. Remarks
  12132. Example Code
  12133. Related Functions
  12134. Related Messages
  12135. Glossary
  12136.  
  12137.  
  12138. ΓòÉΓòÉΓòÉ 16.4. WinDestroyHelpInstance ΓòÉΓòÉΓòÉ
  12139.  
  12140.  
  12141. ΓòÉΓòÉΓòÉ <hidden> WinDestroyHelpInstance - Syntax ΓòÉΓòÉΓòÉ
  12142.  
  12143. This function destroys the specified instance of the Help Manager. 
  12144.  
  12145.  
  12146. #define INCL_WINHELP /* Or use INCL_WIN, INCL_PM, */
  12147. #include <os2.h>
  12148.  
  12149. HWND    hwndHelpInstance;  /*  Handle of the instance of the Help Manager to be destroyed. */
  12150. BOOL    rc;                /*  Success indicator. */
  12151.  
  12152. rc = WinDestroyHelpInstance(hwndHelpInstance);
  12153.  
  12154.  
  12155. ΓòÉΓòÉΓòÉ <hidden> WinDestroyHelpInstance Parameter - hwndHelpInstance ΓòÉΓòÉΓòÉ
  12156.  
  12157.  hwndHelpInstance (HWND) - input 
  12158.     Handle of the instance of the Help Manager to be destroyed. 
  12159.  
  12160.     This is the handle returned by the WinCreateHelpInstance call. 
  12161.  
  12162.  
  12163. ΓòÉΓòÉΓòÉ <hidden> WinDestroyHelpInstance Return Value - rc ΓòÉΓòÉΓòÉ
  12164.  
  12165.  rc (BOOL) - returns 
  12166.     Success indicator. 
  12167.  
  12168.     TRUE 
  12169.             Successful completion 
  12170.     FALSE 
  12171.             Error occurred. 
  12172.  
  12173.  
  12174. ΓòÉΓòÉΓòÉ <hidden> WinDestroyHelpInstance - Parameters ΓòÉΓòÉΓòÉ
  12175.  
  12176.  hwndHelpInstance (HWND) - input 
  12177.     Handle of the instance of the Help Manager to be destroyed. 
  12178.  
  12179.     This is the handle returned by the WinCreateHelpInstance call. 
  12180.  
  12181.  rc (BOOL) - returns 
  12182.     Success indicator. 
  12183.  
  12184.     TRUE 
  12185.             Successful completion 
  12186.     FALSE 
  12187.             Error occurred. 
  12188.  
  12189.  
  12190. ΓòÉΓòÉΓòÉ <hidden> WinDestroyHelpInstance - Related Functions ΓòÉΓòÉΓòÉ
  12191.  
  12192.      WinAssociateHelpInstance 
  12193.      WinCreateHelpInstance 
  12194.      WinCreateHelpTable 
  12195.      WinDestroyHelpInstance 
  12196.      WinLoadHelpTable 
  12197.      WinQueryHelpInstance 
  12198.  
  12199.  
  12200. ΓòÉΓòÉΓòÉ <hidden> WinDestroyHelpInstance - Example Code ΓòÉΓòÉΓòÉ
  12201.  
  12202. This example shows a typical main function for an application which uses help. 
  12203. Following creation of the main application window the Help Manager is 
  12204. initialized and associated with the window.  The help table is defined in the 
  12205. application's resources. When the window is destroyed, terminating the 
  12206. application, the help instance is also destroyed. 
  12207.  
  12208. #define INCL=_WIN
  12209. #include <os2.h>
  12210.  
  12211. #define IDHT_APPLICATION        100     /* id of HELP TABLE in resource file
  12212. */
  12213.  
  12214. main( int argc, char *argv[], char *envp[] )
  12215. {
  12216.    HAB  hab = WinInitialize( 0 );
  12217.    HMQ  hmq = WinCreateMsgQueue( hab, 0 );
  12218.    HWND hwnd;
  12219.    HWND hwndClient;
  12220.    HWND hwndHelp;
  12221.    QMSG qmsg;
  12222.    ULONG flStyle;
  12223.    HELPINIT helpinit;
  12224.  
  12225.    /* Setup the help initialization structure */
  12226.    helpinit.cb = sizeof( HELPINIT );
  12227.    helpinit.ulReturnCode =  0L;
  12228.    helpinit.pszTutorialName =  (PSZ)NULL;
  12229.    /* Help table in application resource */
  12230.    helpinit.phtHelpTable = (PHELPTABLE)MAKEULONG( IDHT_APPLICATION, 0xffff );
  12231.    helpinit.hmodHelpTableModule = NULLHANDLE;
  12232.    /* Default action bar and accelerators */
  12233.    helpinit.hmodAccelActionBarModule = NULLHANDLE;
  12234.    helpinit.idAccelTable = 0;
  12235.    helpinit.idActionBar = 0;
  12236.    helpinit.pszHelpWindowTitle = "APPNAME HELP";
  12237.    helpinit.fShowPanelId = CMIC_SHOW_PANEL_ID;
  12238.    helpinit.pszHelpLibraryName = "APPNAME.HLP";
  12239.  
  12240.    /* Register the class */
  12241.    if( WinRegisterClass( ... ) )
  12242.    {
  12243.       /* create the main window */
  12244.       flStyle = FCF_STANDARD;
  12245.       hwnd = WinCreateStdWindow( ... );
  12246.  
  12247.       if( hwnd )
  12248.       {
  12249.          /* Create and associate the help instance */
  12250.          hwndHelp = WinCreateHelpInstance( hab, &helpinit );
  12251.  
  12252.          if( hwndHelp && WinAssociateHelpInstance( hwndHelp, hwnd ) )
  12253.          {
  12254.             /* Process messages */
  12255.             while( WinGetMsg( hab, &qmsg, NULLHANDLE, 0, 0 ) )
  12256.             {
  12257.                WinDispatchMsg( hab, &qmsg );
  12258.             } /* endwhile */
  12259.          }
  12260.  
  12261.          /* Remove help instance - note: add                    */
  12262.          /*     WinAssociateHelpInstance( NULLHANDLE, hwnd );      */
  12263.          /* to WM_DESTROY processing to remove the association. */
  12264.          WinDestroyHelpInstance( hwndHelp );
  12265.       }
  12266.    }
  12267.  
  12268.    /* finish the cleanup and exit */
  12269.    WinDestroyMsgQueue( hmq );
  12270.    WinTerminate( hab );
  12271. }
  12272.  
  12273.  
  12274. ΓòÉΓòÉΓòÉ <hidden> WinDestroyHelpInstance - Topics ΓòÉΓòÉΓòÉ
  12275.  
  12276. Select an item: 
  12277.  
  12278. Syntax
  12279. Parameters
  12280. Returns
  12281. Example Code
  12282. Related Functions
  12283. Glossary
  12284.  
  12285.  
  12286. ΓòÉΓòÉΓòÉ 16.5. WinLoadHelpTable ΓòÉΓòÉΓòÉ
  12287.  
  12288.  
  12289. ΓòÉΓòÉΓòÉ <hidden> WinLoadHelpTable - Syntax ΓòÉΓòÉΓòÉ
  12290.  
  12291. This function identifies the module handle and identity of the help table to 
  12292. the instance of the Help Manager. 
  12293.  
  12294.  
  12295. #define INCL_WINHELP /* Or use INCL_WIN, INCL_PM, */
  12296. #include <os2.h>
  12297.  
  12298. HWND       hwndHelpInstance;  /*  Handle of an instance of the Help Manager. */
  12299. ULONG      idHelpTable;       /*  Identity of the help table. */
  12300. HMODULE    Module;            /*  Handle of the module which contains the help table and help subtable resources. */
  12301. BOOL       rc;                /*  Success indicator. */
  12302.  
  12303. rc = WinLoadHelpTable(hwndHelpInstance, idHelpTable,
  12304.        Module);
  12305.  
  12306.  
  12307. ΓòÉΓòÉΓòÉ <hidden> WinLoadHelpTable Parameter - hwndHelpInstance ΓòÉΓòÉΓòÉ
  12308.  
  12309.  hwndHelpInstance (HWND) - input 
  12310.     Handle of an instance of the Help Manager. 
  12311.  
  12312.     This is the handle returned by the WinCreateHelpInstance call. 
  12313.  
  12314.  
  12315. ΓòÉΓòÉΓòÉ <hidden> WinLoadHelpTable Parameter - idHelpTable ΓòÉΓòÉΓòÉ
  12316.  
  12317.  idHelpTable (ULONG) - input 
  12318.     Identity of the help table. 
  12319.  
  12320.     It must be greater or equal to 0 and less or equal to 0xFFFF. 
  12321.  
  12322.  
  12323. ΓòÉΓòÉΓòÉ <hidden> WinLoadHelpTable Parameter - Module ΓòÉΓòÉΓòÉ
  12324.  
  12325.  Module (HMODULE) - input 
  12326.     Handle of the module which contains the help table and help subtable 
  12327.     resources. 
  12328.  
  12329.     NULLHANDLE 
  12330.             Use the resources file for the application. 
  12331.     Other 
  12332.             The module handle returned by the DosLoadModule or 
  12333.             DosQueryModuleHandle call referencing a dynamic-link library 
  12334.             containing the help resources. 
  12335.  
  12336.  
  12337. ΓòÉΓòÉΓòÉ <hidden> WinLoadHelpTable Return Value - rc ΓòÉΓòÉΓòÉ
  12338.  
  12339.  rc (BOOL) - returns 
  12340.     Success indicator. 
  12341.  
  12342.     TRUE 
  12343.             Successful completion 
  12344.     FALSE 
  12345.             Error occurred. 
  12346.  
  12347.  
  12348. ΓòÉΓòÉΓòÉ <hidden> WinLoadHelpTable - Parameters ΓòÉΓòÉΓòÉ
  12349.  
  12350.  hwndHelpInstance (HWND) - input 
  12351.     Handle of an instance of the Help Manager. 
  12352.  
  12353.     This is the handle returned by the WinCreateHelpInstance call. 
  12354.  
  12355.  idHelpTable (ULONG) - input 
  12356.     Identity of the help table. 
  12357.  
  12358.     It must be greater or equal to 0 and less or equal to 0xFFFF. 
  12359.  
  12360.  Module (HMODULE) - input 
  12361.     Handle of the module which contains the help table and help subtable 
  12362.     resources. 
  12363.  
  12364.     NULLHANDLE 
  12365.             Use the resources file for the application. 
  12366.     Other 
  12367.             The module handle returned by the DosLoadModule or 
  12368.             DosQueryModuleHandle call referencing a dynamic-link library 
  12369.             containing the help resources. 
  12370.  
  12371.  rc (BOOL) - returns 
  12372.     Success indicator. 
  12373.  
  12374.     TRUE 
  12375.             Successful completion 
  12376.     FALSE 
  12377.             Error occurred. 
  12378.  
  12379.  
  12380. ΓòÉΓòÉΓòÉ <hidden> WinLoadHelpTable - Remarks ΓòÉΓòÉΓòÉ
  12381.  
  12382. An application specifies or changes the handle of the module which contains the 
  12383. help table or the identity of the help table. 
  12384.  
  12385. This function corresponds to the HM_LOAD_HELP_TABLE message that identifies the 
  12386. identifier of a help table and the handle of the module which contains the help 
  12387. table and its associated help subtables. 
  12388.  
  12389.  
  12390. ΓòÉΓòÉΓòÉ <hidden> WinLoadHelpTable - Related Functions ΓòÉΓòÉΓòÉ
  12391.  
  12392.      WinAssociateHelpInstance 
  12393.      WinCreateHelpInstance 
  12394.      WinCreateHelpTable 
  12395.      WinDestroyHelpInstance 
  12396.      WinLoadHelpTable 
  12397.      WinQueryHelpInstance 
  12398.  
  12399.  
  12400. ΓòÉΓòÉΓòÉ <hidden> WinLoadHelpTable - Related Messages ΓòÉΓòÉΓòÉ
  12401.  
  12402.      HM_LOAD_HELP_TABLE 
  12403.  
  12404.  
  12405. ΓòÉΓòÉΓòÉ <hidden> WinLoadHelpTable - Example Code ΓòÉΓòÉΓòÉ
  12406.  
  12407. BOOL LoadHelpTable( HWND hWnd, USHORT usResource, PSZ pszModuleName )
  12408. {
  12409.     BOOL bSuccess = FALSE;
  12410.     HMODULE hmodule;
  12411.     HWND hwndHelp;
  12412.     PSZ  pszObjNameBuf[ 80 ];
  12413.  
  12414.     /* Get the DLL loaded */
  12415.     if( !DosLoadModule( pszObjNameBuf, sizeof( pszObjNameBuf ),
  12416.                    pszModuleName, &hmodule ) )
  12417.     {
  12418.         /* Get the associated help instance */
  12419.         hwndHelp = WinQueryHelpInstance( hWnd );
  12420.  
  12421.         if( hwndHelp )
  12422.         {
  12423.             /* Pass address of help table to the Help Manager */
  12424.             bSuccess = WinLoadHelpTable( hwndHelp, usResource, hmodule );
  12425.         }
  12426.     }
  12427.  
  12428.     /* Return success indicator */
  12429.     return bSuccess;
  12430. }
  12431.  
  12432.  
  12433. ΓòÉΓòÉΓòÉ <hidden> WinLoadHelpTable - Topics ΓòÉΓòÉΓòÉ
  12434.  
  12435. Select an item: 
  12436.  
  12437. Syntax
  12438. Parameters
  12439. Returns
  12440. Remarks
  12441. Example Code
  12442. Related Functions
  12443. Related Messages
  12444. Glossary
  12445.  
  12446.  
  12447. ΓòÉΓòÉΓòÉ 16.6. WinQueryHelpInstance ΓòÉΓòÉΓòÉ
  12448.  
  12449.  
  12450. ΓòÉΓòÉΓòÉ <hidden> WinQueryHelpInstance - Syntax ΓòÉΓòÉΓòÉ
  12451.  
  12452. This function enables the application to query the instance of the Help Manager 
  12453. associated with the application-supplied window handle. 
  12454.  
  12455.  
  12456. #define INCL_WINHELP /* Or use INCL_WIN, INCL_PM, */
  12457. #include <os2.h>
  12458.  
  12459. HWND    hwndApp;   /*  Handle of the application window. */
  12460. HWND    hwndHelp;  /*  Help Manager window handle. */
  12461.  
  12462. hwndHelp = WinQueryHelpInstance(hwndApp);
  12463.  
  12464.  
  12465. ΓòÉΓòÉΓòÉ <hidden> WinQueryHelpInstance Parameter - hwndApp ΓòÉΓòÉΓòÉ
  12466.  
  12467.  hwndApp (HWND) - input 
  12468.     Handle of the application window. 
  12469.  
  12470.  
  12471. ΓòÉΓòÉΓòÉ <hidden> WinQueryHelpInstance Return Value - hwndHelp ΓòÉΓòÉΓòÉ
  12472.  
  12473.  hwndHelp (HWND) - returns 
  12474.     Help Manager window handle. 
  12475.  
  12476.     NULLHANDLE 
  12477.             No Help Manager instance is associated with the application window. 
  12478.     Other 
  12479.             Help Manager window handle. 
  12480.  
  12481.  
  12482. ΓòÉΓòÉΓòÉ <hidden> WinQueryHelpInstance - Parameters ΓòÉΓòÉΓòÉ
  12483.  
  12484.  hwndApp (HWND) - input 
  12485.     Handle of the application window. 
  12486.  
  12487.  hwndHelp (HWND) - returns 
  12488.     Help Manager window handle. 
  12489.  
  12490.     NULLHANDLE 
  12491.             No Help Manager instance is associated with the application window. 
  12492.     Other 
  12493.             Help Manager window handle. 
  12494.  
  12495.  
  12496. ΓòÉΓòÉΓòÉ <hidden> WinQueryHelpInstance - Remarks ΓòÉΓòÉΓòÉ
  12497.  
  12498. The Help Manager first traces the parent window chain until it is NULLHANDLE or 
  12499. HWND_DESKTOP. Then Help Manager traces the owner chain. If a parent of the 
  12500. owner window exists, the trace begins again with the parent chain. 
  12501.  
  12502. The window chain will be traced until the Help Manager finds an instance of the 
  12503. Help Manager or until both the parent and owner windows are NULLHANDLE or 
  12504. HWND_DESKTOP. 
  12505.  
  12506.  
  12507. ΓòÉΓòÉΓòÉ <hidden> WinQueryHelpInstance - Related Functions ΓòÉΓòÉΓòÉ
  12508.  
  12509.      WinAssociateHelpInstance 
  12510.      WinCreateHelpInstance 
  12511.      WinCreateHelpTable 
  12512.      WinDestroyHelpInstance 
  12513.      WinLoadHelpTable 
  12514.      WinQueryHelpInstance 
  12515.  
  12516.  
  12517. ΓòÉΓòÉΓòÉ <hidden> WinQueryHelpInstance - Example Code ΓòÉΓòÉΓòÉ
  12518.  
  12519. This example shows the use of the WinQueryHelpInstance call during the 
  12520. processing of a WM_INITMENU message in order to obtain the handle for sending 
  12521. an HM_SET_ACTIVE_WINDOW message. 
  12522.  
  12523. #define INCL_WIN
  12524. #include <os2.h>
  12525.  
  12526. MRESULT wm_initmenu( HWND hWnd, ULONG ulMsg, MPARAM mp1, MPARAM mp2 )
  12527. {
  12528.    /* Send message to establish the current window's parent      */
  12529.    /* as the active help window.                                 */
  12530.    WinSendMsg( WinQueryHelpInstance( hWnd ),
  12531.                HM_SET_ACTIVE_WINDOW,
  12532.                (MPARAM)WinQueryWindow( hWnd, QW_PARENT ),
  12533.                (MPARAM)WinQueryWindow( hWnd, QW_PARENT ) );
  12534.  
  12535.    /* Pass message on for default processing                     */
  12536.    return WinDefWindowProc( hWnd, ulMsg, mp1, mp2 );
  12537. }
  12538.  
  12539.  
  12540. ΓòÉΓòÉΓòÉ <hidden> WinQueryHelpInstance - Topics ΓòÉΓòÉΓòÉ
  12541.  
  12542. Select an item: 
  12543.  
  12544. Syntax
  12545. Parameters
  12546. Returns
  12547. Remarks
  12548. Example Code
  12549. Related Functions
  12550. Glossary
  12551.  
  12552.  
  12553. ΓòÉΓòÉΓòÉ 17. Dynamic Data Formatting Functions ΓòÉΓòÉΓòÉ
  12554.  
  12555. The application can also use the window to establish a dialog with the user, 
  12556. and format text responses in the window by calling dynamic data formatting 
  12557. (DDF) routines. The DDF functions provide limited formatting of text at run 
  12558. time. 
  12559.  
  12560. Warning: Users can not print or search DDF data. 
  12561.  
  12562. Following is a summary of the DDF calls that you can use in your Presentation 
  12563. Manager application. 
  12564.  
  12565.  DdfBeginList 
  12566.      Begins a definition list in the DDF buffer. 
  12567.  
  12568.  DdfBitmap 
  12569.      Places a reference to a bit map in the DDF buffer. 
  12570.  
  12571.  DdfEndList 
  12572.      Terminates the definition list initialized by DdfBeginList. 
  12573.  
  12574.  DdfHyperText 
  12575.      Defines a hypertext link to another window. 
  12576.  
  12577.  DdfInform 
  12578.      Defines a hypertext inform link. 
  12579.  
  12580.  DdfInitialize 
  12581.      Initializes the IPF internal structures for a DDF facility and returns a 
  12582.      DDF handle. 
  12583.  
  12584.  DdfListItem 
  12585.      Inserts a definition list entry item in the DDF buffer. 
  12586.  
  12587.  DdfMetafile 
  12588.      Places a reference to a metafile into the DDF buffer. 
  12589.  
  12590.  DdfPara 
  12591.      Creates a paragraph within the DDF buffer. 
  12592.  
  12593.  DdfSetColor 
  12594.      Sets the background and foreground colors of the displayed text. 
  12595.  
  12596.  DdfSetFont 
  12597.      Specifies a text font (Courier) in the DDF buffer. 
  12598.  
  12599.  DdfSetFontStyle 
  12600.      Specifies a text font (bold face) in the DDF buffer. 
  12601.  
  12602.  DdfSetFormat 
  12603.      Turns formatting off or on. 
  12604.  
  12605.  DdfSetTextAlign 
  12606.      Defines whether left, center, or right text justification is to be used 
  12607.      when text formatting is off. 
  12608.  
  12609.  DdfText 
  12610.      Adds text to the DDF buffer. 
  12611.  
  12612.  
  12613. ΓòÉΓòÉΓòÉ 17.1. DdfBeginList ΓòÉΓòÉΓòÉ
  12614.  
  12615.  
  12616. ΓòÉΓòÉΓòÉ <hidden> DdfBeginList - Syntax ΓòÉΓòÉΓòÉ
  12617.  
  12618. This function begins a definition list in the DDF buffer; it corresponds to the 
  12619. :dl. (definition list) tag. 
  12620.  
  12621.  
  12622. #define INCL_DDF
  12623. #include <os2.h>
  12624.  
  12625. HDDF     hddf;        /*  Handle to DDF returned by DdfInitialize. */
  12626. ULONG    ulWidthDT;   /*  Width of the definition term. */
  12627. ULONG    fBreakType;  /*  Type of line break to use. */
  12628. ULONG    fSpacing;    /*  Spacing between definitions. */
  12629. BOOL     rc;          /*  Success indicator. */
  12630.  
  12631. rc = DdfBeginList(hddf, ulWidthDT, fBreakType,
  12632.        fSpacing);
  12633.  
  12634.  
  12635. ΓòÉΓòÉΓòÉ <hidden> DdfBeginList Parameter - hddf ΓòÉΓòÉΓòÉ
  12636.  
  12637.  hddf (HDDF) - input 
  12638.     Handle to DDF returned by DdfInitialize. 
  12639.  
  12640.  
  12641. ΓòÉΓòÉΓòÉ <hidden> DdfBeginList Parameter - ulWidthDT ΓòÉΓòÉΓòÉ
  12642.  
  12643.  ulWidthDT (ULONG) - input 
  12644.     Width of the definition term. 
  12645.  
  12646.  
  12647. ΓòÉΓòÉΓòÉ <hidden> DdfBeginList Parameter - fBreakType ΓòÉΓòÉΓòÉ
  12648.  
  12649.  fBreakType (ULONG) - input 
  12650.     Type of line break to use. 
  12651.  
  12652.     The following constants may be specified: 
  12653.  
  12654.     HMBT_ALL 
  12655.             Start all definition descriptions on the next line, regardless of 
  12656.             the actual lengths of definition terms. 
  12657.  
  12658.     HMBT_FIT 
  12659.             Start definition description on the next line only when the 
  12660.             definition term is longer than the width specified. 
  12661.  
  12662.     HMBT_NONE 
  12663.             Do not start the definition description on the next line, even when 
  12664.             the definition term is longer than the width specified. 
  12665.  
  12666.  
  12667. ΓòÉΓòÉΓòÉ <hidden> DdfBeginList Parameter - fSpacing ΓòÉΓòÉΓòÉ
  12668.  
  12669.  fSpacing (ULONG) - input 
  12670.     Spacing between definitions. 
  12671.  
  12672.     Only the following constants may be specified: 
  12673.  
  12674.     HMLS_SINGLELINE 
  12675.             Do not insert a blank line between each definition description and 
  12676.             the next definition term. 
  12677.  
  12678.     HMLS_DOUBLELINE 
  12679.             Insert a blank line between each definition description and the 
  12680.             next definition term. 
  12681.  
  12682.  
  12683. ΓòÉΓòÉΓòÉ <hidden> DdfBeginList Return Value - rc ΓòÉΓòÉΓòÉ
  12684.  
  12685.  rc (BOOL) - returns 
  12686.     Success indicator. 
  12687.  
  12688.     TRUE 
  12689.             Successful completion 
  12690.     FALSE 
  12691.             Error occurred. 
  12692.  
  12693.  
  12694. ΓòÉΓòÉΓòÉ <hidden> DdfBeginList - Parameters ΓòÉΓòÉΓòÉ
  12695.  
  12696.  hddf (HDDF) - input 
  12697.     Handle to DDF returned by DdfInitialize. 
  12698.  
  12699.  ulWidthDT (ULONG) - input 
  12700.     Width of the definition term. 
  12701.  
  12702.  fBreakType (ULONG) - input 
  12703.     Type of line break to use. 
  12704.  
  12705.     The following constants may be specified: 
  12706.  
  12707.     HMBT_ALL 
  12708.             Start all definition descriptions on the next line, regardless of 
  12709.             the actual lengths of definition terms. 
  12710.  
  12711.     HMBT_FIT 
  12712.             Start definition description on the next line only when the 
  12713.             definition term is longer than the width specified. 
  12714.  
  12715.     HMBT_NONE 
  12716.             Do not start the definition description on the next line, even when 
  12717.             the definition term is longer than the width specified. 
  12718.  
  12719.  fSpacing (ULONG) - input 
  12720.     Spacing between definitions. 
  12721.  
  12722.     Only the following constants may be specified: 
  12723.  
  12724.     HMLS_SINGLELINE 
  12725.             Do not insert a blank line between each definition description and 
  12726.             the next definition term. 
  12727.  
  12728.     HMLS_DOUBLELINE 
  12729.             Insert a blank line between each definition description and the 
  12730.             next definition term. 
  12731.  
  12732.  rc (BOOL) - returns 
  12733.     Success indicator. 
  12734.  
  12735.     TRUE 
  12736.             Successful completion 
  12737.     FALSE 
  12738.             Error occurred. 
  12739.  
  12740.  
  12741. ΓòÉΓòÉΓòÉ <hidden> DdfBeginList - Remarks ΓòÉΓòÉΓòÉ
  12742.  
  12743. Once this function has been called, use of any DDF function other than 
  12744. DdfListItem, DdfSetColor, and DdfEndList may produce unpredictable results. 
  12745.  
  12746.  
  12747. ΓòÉΓòÉΓòÉ <hidden> DdfBeginList - Errors ΓòÉΓòÉΓòÉ
  12748.  
  12749. Possible returns from WinGetLastError 
  12750.  
  12751.  HMERR_DDF_MEMORY (0x3001) 
  12752.     Not enough memory is available. 
  12753.  
  12754.  HMERR_DDF_LIST_UNCLOSED (0x3007) 
  12755.     An attempt was made to nest a list. 
  12756.  
  12757.  HMERR_DDF_LIST_BREAKTYPE (0x3009) 
  12758.     The value of BreakType is not valid. 
  12759.  
  12760.  HMERR_DDF_LIST_SPACING (0x300A) 
  12761.     The value for Spacing is not valid. 
  12762.  
  12763.  
  12764. ΓòÉΓòÉΓòÉ <hidden> DdfBeginList - Related Functions ΓòÉΓòÉΓòÉ
  12765.  
  12766.      DdfBeginList 
  12767.      DdfBitmap 
  12768.      DdfEndList 
  12769.      DdfHyperText 
  12770.      DdfInform 
  12771.      DdfInitialize 
  12772.      DdfListItem 
  12773.      DdfMetafile 
  12774.      DdfPara 
  12775.      DdfSetColor 
  12776.      DdfSetFont 
  12777.      DdfSetFontStyle 
  12778.      DdfSetFormat 
  12779.      DdfSetTextAlign 
  12780.      DdfText 
  12781.  
  12782.  
  12783. ΓòÉΓòÉΓòÉ <hidden> DdfBeginList - Example Code ΓòÉΓòÉΓòÉ
  12784.  
  12785. After initializing a DDF buffer with DdfInitialize, the example uses 
  12786. DdfBeginList to indicate the beginning of a definition list in the DDF buffer 
  12787. (this corresponds to the IPF dl tag). For a more detailed example and 
  12788. discussion of initializing DDF, see the DdfInitialize sample. 
  12789.  
  12790. #define INCL_WINWINDOWMGR       /* General window management    */
  12791. #define INCL_WINMESSAGEMGR      /* Message management           */
  12792. #define INCL_DDF                /* Dynamic Data Facility        */
  12793. #include <os2.h>
  12794. #include <pmhelp.h>
  12795.  
  12796. struct _LISTITEM        /* definition list                      */
  12797. {
  12798.     PSZ Term;
  12799.     PSZ Desc;
  12800. } Definition[2] = {{"MVS", "Multiple Virtual System"},
  12801.                    {"VM",  "Virtual Machine"}};
  12802.  
  12803. MRESULT WindowProc( HWND hwnd, ULONG ulMsg, MPARAM mp1, MPARAM mp2)
  12804. {
  12805.  
  12806.     HWND   hwndParent;
  12807.     HWND   hwndInstance;
  12808.     HDDF   hDdf;            /* DDF handle                           */
  12809.     SHORT  i;               /* loop index                           */
  12810.  
  12811.     switch( ulMsg )
  12812.     {
  12813.     case HM_QUERY_DDF_DATA:
  12814.         /* get the help instance */
  12815.         hwndParent = WinQueryWindow( hwnd, QW_PARENT );
  12816.         hwndParent = WinQueryWindow( hwndParent, QW_PARENT );
  12817.         hwndInstance = (HWND)WinSendMsg( hwndParent, HM_QUERY,
  12818.                                  MPFROMSHORT( HMQW_INSTANCE ), NULL );
  12819.  
  12820.         /* Allocate 1K Buffer (default)  */
  12821.         hDdf = DdfInitialize(
  12822.                    hwndInstance,  /* Handle of help instance */
  12823.                    0L,            /* Default buffer size     */
  12824.                    0L             /* Default increment       */
  12825.                    );
  12826.  
  12827.         if (hDdf == NULLHANDLE)       /* Check return code       */
  12828.         {
  12829.             return (MRESULT)FALSE;
  12830.         }
  12831.  
  12832.         /* begin definition list */
  12833.         if (!DdfBeginList(hDdf, 3L, HMBT_ALL, HMLS_SINGLELINE))
  12834.         {
  12835.             return (MRESULT)FALSE;
  12836.         }
  12837.  
  12838.         /* insert 2 entries into definition list */
  12839.         for (i=0; i < 2; i++)
  12840.         {
  12841.             if (!DdfListItem(hDdf, Definition[i].Term,
  12842.                                    Definition[i].Desc))
  12843.             {
  12844.                return (MRESULT)FALSE;
  12845.             }
  12846.         }
  12847.  
  12848.         /* terminate definition list */
  12849.         if (!DdfEndList(hDdf))
  12850.         {
  12851.             return (MRESULT)FALSE;
  12852.         }
  12853.  
  12854.         return (MRESULT)hDdf;
  12855.     }
  12856. }
  12857.  
  12858.  
  12859. ΓòÉΓòÉΓòÉ <hidden> DdfBeginList - Topics ΓòÉΓòÉΓòÉ
  12860.  
  12861. Select an item: 
  12862.  
  12863. Syntax
  12864. Parameters
  12865. Returns
  12866. Errors
  12867. Remarks
  12868. Example Code
  12869. Related Functions
  12870. Glossary
  12871.  
  12872.  
  12873. ΓòÉΓòÉΓòÉ 17.2. DdfBitmap ΓòÉΓòÉΓòÉ
  12874.  
  12875.  
  12876. ΓòÉΓòÉΓòÉ <hidden> DdfBitmap - Syntax ΓòÉΓòÉΓòÉ
  12877.  
  12878. This function places a reference to a bit map in the DDF buffer. 
  12879.  
  12880.  
  12881. #define INCL_DDF
  12882. #include <os2.h>
  12883.  
  12884. HDDF       hddf;    /*  Handle to DDF returned by DdfInitialize. */
  12885. HBITMAP    hbm;     /*  Standard Presentation Manager bit map handle. */
  12886. ULONG      fAlign;  /*  Text justification flag. */
  12887. BOOL       rc;      /*  Success indicator. */
  12888.  
  12889. rc = DdfBitmap(hddf, hbm, fAlign);
  12890.  
  12891.  
  12892. ΓòÉΓòÉΓòÉ <hidden> DdfBitmap Parameter - hddf ΓòÉΓòÉΓòÉ
  12893.  
  12894.  hddf (HDDF) - input 
  12895.     Handle to DDF returned by DdfInitialize. 
  12896.  
  12897.  
  12898. ΓòÉΓòÉΓòÉ <hidden> DdfBitmap Parameter - hbm ΓòÉΓòÉΓòÉ
  12899.  
  12900.  hbm (HBITMAP) - input 
  12901.     Standard Presentation Manager bit map handle. 
  12902.  
  12903.  
  12904. ΓòÉΓòÉΓòÉ <hidden> DdfBitmap Parameter - fAlign ΓòÉΓòÉΓòÉ
  12905.  
  12906.  fAlign (ULONG) - input 
  12907.     Text justification flag. 
  12908.  
  12909.     Any of the following values can be specified: 
  12910.  
  12911.     ART_LEFT 
  12912.             Left-justify the bit map. 
  12913.     ART_RIGHT 
  12914.             Right-justify the bit map. 
  12915.     ART_CENTER 
  12916.             Center the bit map. 
  12917.     ART_RUNIN 
  12918.             Allow the bit map to be reflowed with text. 
  12919.  
  12920.  
  12921. ΓòÉΓòÉΓòÉ <hidden> DdfBitmap Return Value - rc ΓòÉΓòÉΓòÉ
  12922.  
  12923.  rc (BOOL) - returns 
  12924.     Success indicator. 
  12925.  
  12926.     TRUE 
  12927.             Successful completion 
  12928.     FALSE 
  12929.             Error occurred. 
  12930.  
  12931.  
  12932. ΓòÉΓòÉΓòÉ <hidden> DdfBitmap - Parameters ΓòÉΓòÉΓòÉ
  12933.  
  12934.  hddf (HDDF) - input 
  12935.     Handle to DDF returned by DdfInitialize. 
  12936.  
  12937.  hbm (HBITMAP) - input 
  12938.     Standard Presentation Manager bit map handle. 
  12939.  
  12940.  fAlign (ULONG) - input 
  12941.     Text justification flag. 
  12942.  
  12943.     Any of the following values can be specified: 
  12944.  
  12945.     ART_LEFT 
  12946.             Left-justify the bit map. 
  12947.     ART_RIGHT 
  12948.             Right-justify the bit map. 
  12949.     ART_CENTER 
  12950.             Center the bit map. 
  12951.     ART_RUNIN 
  12952.             Allow the bit map to be reflowed with text. 
  12953.  
  12954.  rc (BOOL) - returns 
  12955.     Success indicator. 
  12956.  
  12957.     TRUE 
  12958.             Successful completion 
  12959.     FALSE 
  12960.             Error occurred. 
  12961.  
  12962.  
  12963. ΓòÉΓòÉΓòÉ <hidden> DdfBitmap - Remarks ΓòÉΓòÉΓòÉ
  12964.  
  12965. The handle to the presentation space in which the bit map was created cannot be 
  12966. freed by the application while the panel is displayed. 
  12967.  
  12968. Note:  There is a (3-byte + size of HBITMAP structure). ESC code overhead in 
  12969.        the DDF internal buffer for this function. There is a 1-byte ESC code 
  12970.        overhead required for the fAlign flag. 
  12971.  
  12972.  
  12973. ΓòÉΓòÉΓòÉ <hidden> DdfBitmap - Errors ΓòÉΓòÉΓòÉ
  12974.  
  12975. Possible returns from WinGetLastError 
  12976.  
  12977.  HMERR_DDF_MEMORY (0x3001) 
  12978.     Not enough memory is available. 
  12979.  
  12980.  HMERR_DDF_ALIGN_TYPE (0x3002) 
  12981.     The alignment type is not valid. 
  12982.  
  12983.  
  12984. ΓòÉΓòÉΓòÉ <hidden> DdfBitmap - Related Functions ΓòÉΓòÉΓòÉ
  12985.  
  12986.      DdfBeginList 
  12987.      DdfBitmap 
  12988.      DdfEndList 
  12989.      DdfHyperText 
  12990.      DdfInform 
  12991.      DdfInitialize 
  12992.      DdfListItem 
  12993.      DdfMetafile 
  12994.      DdfPara 
  12995.      DdfSetColor 
  12996.      DdfSetFont 
  12997.      DdfSetFontStyle 
  12998.      DdfSetFormat 
  12999.      DdfSetTextAlign 
  13000.      DdfText 
  13001.  
  13002.  
  13003. ΓòÉΓòÉΓòÉ <hidden> DdfBitmap - Example Code ΓòÉΓòÉΓòÉ
  13004.  
  13005. After initializing a DDF buffer with DdfInitialize, the example obtains a 
  13006. device context (DevOpenDC), creates a presentation space (GpiCreatePS), and 
  13007. loads a bit map (GpiLoadBitmap). It then uses DdfBitmap to place a reference to 
  13008. the bit map in the DDF buffer. For a more detailed example and discussion of 
  13009. initializing DDF, see the DdfInitialize sample. 
  13010.  
  13011. #define INCL_WINWINDOWMGR       /* General window management     */
  13012. #define INCL_WINMESSAGEMGR      /* Message management            */
  13013. #define INCL_GPICONTROL         /* Basic PS control              */
  13014. #define INCL_GPIBITMAPS         /* Bit maps and Pel Operations   */
  13015. #define INCL_GPIPRIMITIVES      /* Drawing Primitives/Attributes */
  13016. #define INCL_DDF                /* Dynamic Data Facility         */
  13017. #include <os2.h>
  13018. #include <pmhelp.h>
  13019.  
  13020. #define ACVP_HAB  12
  13021. #define BM_HPS    16
  13022. #define BM_HDC    20
  13023. #define BM_HWND   24
  13024. #define ID_LEFT   255
  13025.  
  13026. MRESULT WindowProc( HWND hwnd, ULONG ulMsg, MPARAM mp1, MPARAM mp2 )
  13027. {
  13028.     HWND    hwndParent;     /* parent window                        */
  13029.     HWND    hwndInstance;   /* help instance window                 */
  13030.     HDDF    hDdf;           /* DDF handle                           */
  13031.     HDC     hdc;            /* device context handle                */
  13032.     HPS     hps;            /* presentation space handle            */
  13033.     HAB     hab;            /* anchor block handle                  */
  13034.     SIZEL   sizel = {0L,0L};/* size of new PS                       */
  13035.     HBITMAP hBitmap;        /* bit map handle                       */
  13036.     HMODULE hModule;        /* module handle                        */
  13037.  
  13038.     switch( ulMsg )
  13039.     {
  13040.     case HM_QUERY_DDF_DATA:
  13041.         hwndParent = WinQueryWindow( hwnd, QW_PARENT );
  13042.         hwndParent = WinQueryWindow( hwndParent, QW_PARENT );
  13043.         hwndInstance = (HWND)WinSendMsg( hwndParent, HM_QUERY,
  13044.                                  MPFROMSHORT( HMQW_INSTANCE ), NULL );
  13045.  
  13046.         /* Allocate 1K Buffer (default)  */
  13047.         hDdf = DdfInitialize(
  13048.                        hwndInstance,  /* Handle of help instance */
  13049.                        0L,            /* Default buffer size     */
  13050.                        0L             /* Default increment       */
  13051.                        );
  13052.  
  13053.         if (hDdf == NULLHANDLE)       /* Check return code       */
  13054.         {
  13055.             return (MRESULT)FALSE;
  13056.         }
  13057.  
  13058.         /* get module handle for bit map */
  13059.         DosQueryModuleHandle("bitmap", &hModule);
  13060.         if (hModule == NULLHANDLE)
  13061.         {
  13062.             return (MRESULT)FALSE;
  13063.         }
  13064.  
  13065.         /* get hab for this window */
  13066.         if ((hab = (HAB)WinQueryWindowULong(hwnd, ACVP_HAB)) == NULLHANDLE)
  13067.         {
  13068.             return (MRESULT)FALSE;
  13069.         }
  13070.  
  13071.         /* create a device context */
  13072.         if ((hdc = DevOpenDC(hab, OD_MEMORY, "*", 0L,
  13073.                             (PDEVOPENDATA)NULL, (HDC)NULL)) == NULLHANDLE)
  13074.         {
  13075.            return (MRESULT)FALSE;
  13076.         }
  13077.  
  13078.         /* save hdc in reserved word */
  13079.         WinSetWindowULong(hwnd, BM_HDC, (ULONG)hdc);
  13080.  
  13081.         /* create a noncached micro presentation space */
  13082.         /* and associate it with the window */
  13083.         if ((hps = GpiCreatePS(hab, hdc, &sizel,
  13084.                    PU_PELS | GPIF_DEFAULT
  13085.                    | GPIT_MICRO | GPIA_ASSOC)) == NULLHANDLE)
  13086.         {
  13087.            return (MRESULT)FALSE;
  13088.         }
  13089.  
  13090.         /* save hps in reserved word */
  13091.         WinSetWindowULong(hwnd, BM_HPS, (ULONG)hps);
  13092.  
  13093.         /* Load the Bit map to display */
  13094.         if ((hBitmap = GpiLoadBitmap(hps, hModule, ID_LEFT, 300L,
  13095.                                      300L)) == NULLHANDLE)
  13096.         {
  13097.             return (MRESULT)FALSE;
  13098.         }
  13099.  
  13100.         /* save bit map hwnd in reserved word */
  13101.         WinSetWindowULong(hwnd, BM_HWND, (ULONG)hBitmap);
  13102.  
  13103.         /* Display the bit map align left */
  13104.         if (!DdfBitmap(hDdf, hBitmap, ART_LEFT))
  13105.         {
  13106.             return (MRESULT)FALSE;
  13107.         }
  13108.  
  13109.         return (MRESULT)hDdf;
  13110.  
  13111.     case WM_CLOSE:
  13112.         /* release PS, DC, and bit map */
  13113.         GpiDestroyPS((HPS)WinQueryWindowULong(hwnd, BM_HPS));
  13114.         DevCloseDC((HDC)WinQueryWindowULong(hwnd, BM_HDC));
  13115.         GpiDeleteBitmap((HBITMAP)WinQueryWindowULong(hwnd, BM_HWND));
  13116.         WinDestroyWindow(WinQueryWindow(hwnd, QW_PARENT));
  13117.         return (MRESULT)TRUE;
  13118.     }
  13119. }
  13120.  
  13121.  
  13122. ΓòÉΓòÉΓòÉ <hidden> DdfBitmap - Topics ΓòÉΓòÉΓòÉ
  13123.  
  13124. Select an item: 
  13125.  
  13126. Syntax
  13127. Parameters
  13128. Returns
  13129. Errors
  13130. Remarks
  13131. Example Code
  13132. Related Functions
  13133. Glossary
  13134.  
  13135.  
  13136. ΓòÉΓòÉΓòÉ 17.3. DdfEndList ΓòÉΓòÉΓòÉ
  13137.  
  13138.  
  13139. ΓòÉΓòÉΓòÉ <hidden> DdfEndList - Syntax ΓòÉΓòÉΓòÉ
  13140.  
  13141. This function terminates the definition list initialized by DdfBeginList. 
  13142.  
  13143.  
  13144. #define INCL_DDF
  13145. #include <os2.h>
  13146.  
  13147. HDDF    hddf;  /*  Handle to DDF returned by DdfInitialize. */
  13148. BOOL    rc;    /*  Success indicator. */
  13149.  
  13150. rc = DdfEndList(hddf);
  13151.  
  13152.  
  13153. ΓòÉΓòÉΓòÉ <hidden> DdfEndList Parameter - hddf ΓòÉΓòÉΓòÉ
  13154.  
  13155.  hddf (HDDF) - input 
  13156.     Handle to DDF returned by DdfInitialize. 
  13157.  
  13158.  
  13159. ΓòÉΓòÉΓòÉ <hidden> DdfEndList Return Value - rc ΓòÉΓòÉΓòÉ
  13160.  
  13161.  rc (BOOL) - returns 
  13162.     Success indicator. 
  13163.  
  13164.     TRUE 
  13165.             Successful completion 
  13166.     FALSE 
  13167.             Error occurred. 
  13168.  
  13169.  
  13170. ΓòÉΓòÉΓòÉ <hidden> DdfEndList - Parameters ΓòÉΓòÉΓòÉ
  13171.  
  13172.  hddf (HDDF) - input 
  13173.     Handle to DDF returned by DdfInitialize. 
  13174.  
  13175.  rc (BOOL) - returns 
  13176.     Success indicator. 
  13177.  
  13178.     TRUE 
  13179.             Successful completion 
  13180.     FALSE 
  13181.             Error occurred. 
  13182.  
  13183.  
  13184. ΓòÉΓòÉΓòÉ <hidden> DdfEndList - Errors ΓòÉΓòÉΓòÉ
  13185.  
  13186. Possible returns from WinGetLastError 
  13187.  
  13188.  HMERR_DDF_LIST_UNINITIALIZED (0x3008) 
  13189.     No definition list has been initialized by DdfBeginList. 
  13190.  
  13191.  
  13192. ΓòÉΓòÉΓòÉ <hidden> DdfEndList - Related Functions ΓòÉΓòÉΓòÉ
  13193.  
  13194.      DdfBeginList 
  13195.      DdfBitmap 
  13196.      DdfEndList 
  13197.      DdfHyperText 
  13198.      DdfInform 
  13199.      DdfInitialize 
  13200.      DdfListItem 
  13201.      DdfMetafile 
  13202.      DdfPara 
  13203.      DdfSetColor 
  13204.      DdfSetFont 
  13205.      DdfSetFontStyle 
  13206.      DdfSetFormat 
  13207.      DdfSetTextAlign 
  13208.      DdfText 
  13209.  
  13210.  
  13211. ΓòÉΓòÉΓòÉ <hidden> DdfEndList - Example Code ΓòÉΓòÉΓòÉ
  13212.  
  13213. After initializing a DDF buffer with DdfInitialize, the example uses 
  13214. DdfBeginList to indicate the beginning of a definition list in the DDF buffer 
  13215. (this corresponds to the IPF dl tag). For a more detailed example and 
  13216. discussion of initializing DDF, see the DdfInitialize sample. 
  13217.  
  13218. #define INCL_WINWINDOWMGR       /* General window management    */
  13219. #define INCL_WINMESSAGEMGR      /* Message management           */
  13220. #define INCL_DDF                /* Dynamic Data Facility        */
  13221. #include <os2.h>
  13222. #include <pmhelp.h>
  13223.  
  13224. struct _LISTITEM        /* definition list                      */
  13225. {
  13226.     PSZ Term;
  13227.     PSZ Desc;
  13228. } Definition[2] = {{"MVS", "Multiple Virtual System"},
  13229.                    {"VM",  "Virtual Machine"}};
  13230.  
  13231. MRESULT WindowProc( HWND hwnd, ULONG ulMsg, MPARAM mp1, MPARAM mp2)
  13232. {
  13233.  
  13234.     HWND   hwndParent;
  13235.     HWND   hwndInstance;
  13236.     HDDF   hDdf;            /* DDF handle                           */
  13237.     SHORT  i;               /* loop index                           */
  13238.  
  13239.     switch( ulMsg )
  13240.     {
  13241.     case HM_QUERY_DDF_DATA:
  13242.         /* get the help instance */
  13243.         hwndParent = WinQueryWindow( hwnd, QW_PARENT );
  13244.         hwndParent = WinQueryWindow( hwndParent, QW_PARENT );
  13245.         hwndInstance = (HWND)WinSendMsg( hwndParent, HM_QUERY,
  13246.                                  MPFROMSHORT( HMQW_INSTANCE ), NULL );
  13247.  
  13248.         /* Allocate 1K Buffer (default)  */
  13249.         hDdf = DdfInitialize(
  13250.                    hwndInstance,  /* Handle of help instance */
  13251.                    0L,            /* Default buffer size     */
  13252.                    0L             /* Default increment       */
  13253.                    );
  13254.  
  13255.         if (hDdf == NULLHANDLE)       /* Check return code       */
  13256.         {
  13257.             return (MRESULT)FALSE;
  13258.         }
  13259.  
  13260.         /* begin definition list */
  13261.         if (!DdfBeginList(hDdf, 3L, HMBT_ALL, HMLS_SINGLELINE))
  13262.         {
  13263.             return (MRESULT)FALSE;
  13264.         }
  13265.  
  13266.         /* insert 2 entries into definition list */
  13267.         for (i=0; i < 2; i++)
  13268.         {
  13269.             if (!DdfListItem(hDdf, Definition[i].Term,
  13270.                                    Definition[i].Desc))
  13271.             {
  13272.                return (MRESULT)FALSE;
  13273.             }
  13274.         }
  13275.  
  13276.         /* terminate definition list */
  13277.         if (!DdfEndList(hDdf))
  13278.         {
  13279.             return (MRESULT)FALSE;
  13280.         }
  13281.  
  13282.         return (MRESULT)hDdf;
  13283.     }
  13284. }
  13285.  
  13286.  
  13287. ΓòÉΓòÉΓòÉ <hidden> DdfEndList - Topics ΓòÉΓòÉΓòÉ
  13288.  
  13289. Select an item: 
  13290.  
  13291. Syntax
  13292. Parameters
  13293. Returns
  13294. Errors
  13295. Example Code
  13296. Related Functions
  13297. Glossary
  13298.  
  13299.  
  13300. ΓòÉΓòÉΓòÉ 17.4. DdfHyperText ΓòÉΓòÉΓòÉ
  13301.  
  13302.  
  13303. ΓòÉΓòÉΓòÉ <hidden> DdfHyperText - Syntax ΓòÉΓòÉΓòÉ
  13304.  
  13305. This function defines a hypertext link to another panel, which is equal to a 
  13306. link of reftype=hd.  Links to footnotes, launch links and links to external 
  13307. databases are not supported. 
  13308.  
  13309.  
  13310. #define INCL_DDF
  13311. #include <os2.h>
  13312.  
  13313. HDDF     hddf;            /*  Handle to DDF returned by DdfInitialize. */
  13314. PCSZ     pszText;         /*  Hypertext phrase. */
  13315. PCSZ     pszReference;    /*  Pointer to a string containing the link reference. */
  13316. ULONG    fReferenceType;  /*  Reference Type. */
  13317. BOOL     rc;              /*  Success indicator. */
  13318.  
  13319. rc = DdfHyperText(hddf, pszText, pszReference,
  13320.        fReferenceType);
  13321.  
  13322.  
  13323. ΓòÉΓòÉΓòÉ <hidden> DdfHyperText Parameter - hddf ΓòÉΓòÉΓòÉ
  13324.  
  13325.  hddf (HDDF) - input 
  13326.     Handle to DDF returned by DdfInitialize. 
  13327.  
  13328.  
  13329. ΓòÉΓòÉΓòÉ <hidden> DdfHyperText Parameter - pszText ΓòÉΓòÉΓòÉ
  13330.  
  13331.  pszText (PCSZ) - input 
  13332.     Hypertext phrase. 
  13333.  
  13334.  
  13335. ΓòÉΓòÉΓòÉ <hidden> DdfHyperText Parameter - pszReference ΓòÉΓòÉΓòÉ
  13336.  
  13337.  pszReference (PCSZ) - input 
  13338.     Pointer to a string containing the link reference. 
  13339.  
  13340.     The value of this parameter depends on the value of fReferenceType. 
  13341.  
  13342.     If fReferenceType is REFERENCE_BY_RES 
  13343.             pszReference must contain a pointer to a numeric string containing 
  13344.             the res number; otherwise it will default to a res number of zero. 
  13345.             Valid values are 1 - 64000; all other values are reserved. 
  13346.  
  13347.     If fReferenceType is REFERENCE_BY_ID 
  13348.             pszReference must contain a pointer to a string containing the 
  13349.             alphanumeric identifier of the destination panel. 
  13350.  
  13351.  
  13352. ΓòÉΓòÉΓòÉ <hidden> DdfHyperText Parameter - fReferenceType ΓòÉΓòÉΓòÉ
  13353.  
  13354.  fReferenceType (ULONG) - input 
  13355.     Reference Type. 
  13356.  
  13357.     This parameter specifies whether you are linking via a resource identifier 
  13358.     (res number) or via an alphanumeric identifier. 
  13359.  
  13360.     REFERENCE_BY_RES 
  13361.             To link via a resource identifier. 
  13362.     REFERENCE_BY_ID 
  13363.             To link via an alphanumeric identifier. 
  13364.  
  13365.  
  13366. ΓòÉΓòÉΓòÉ <hidden> DdfHyperText Return Value - rc ΓòÉΓòÉΓòÉ
  13367.  
  13368.  rc (BOOL) - returns 
  13369.     Success indicator. 
  13370.  
  13371.     TRUE 
  13372.             Successful completion 
  13373.     FALSE 
  13374.             Error occurred. 
  13375.  
  13376.  
  13377. ΓòÉΓòÉΓòÉ <hidden> DdfHyperText - Parameters ΓòÉΓòÉΓòÉ
  13378.  
  13379.  hddf (HDDF) - input 
  13380.     Handle to DDF returned by DdfInitialize. 
  13381.  
  13382.  pszText (PCSZ) - input 
  13383.     Hypertext phrase. 
  13384.  
  13385.  pszReference (PCSZ) - input 
  13386.     Pointer to a string containing the link reference. 
  13387.  
  13388.     The value of this parameter depends on the value of fReferenceType. 
  13389.  
  13390.     If fReferenceType is REFERENCE_BY_RES 
  13391.             pszReference must contain a pointer to a numeric string containing 
  13392.             the res number; otherwise it will default to a res number of zero. 
  13393.             Valid values are 1 - 64000; all other values are reserved. 
  13394.  
  13395.     If fReferenceType is REFERENCE_BY_ID 
  13396.             pszReference must contain a pointer to a string containing the 
  13397.             alphanumeric identifier of the destination panel. 
  13398.  
  13399.  fReferenceType (ULONG) - input 
  13400.     Reference Type. 
  13401.  
  13402.     This parameter specifies whether you are linking via a resource identifier 
  13403.     (res number) or via an alphanumeric identifier. 
  13404.  
  13405.     REFERENCE_BY_RES 
  13406.             To link via a resource identifier. 
  13407.     REFERENCE_BY_ID 
  13408.             To link via an alphanumeric identifier. 
  13409.  
  13410.  rc (BOOL) - returns 
  13411.     Success indicator. 
  13412.  
  13413.     TRUE 
  13414.             Successful completion 
  13415.     FALSE 
  13416.             Error occurred. 
  13417.  
  13418.  
  13419. ΓòÉΓòÉΓòÉ <hidden> DdfHyperText - Remarks ΓòÉΓòÉΓòÉ
  13420.  
  13421. There is a 3-byte ESC code overhead in the DDF internal buffer for each word in 
  13422. the text buffer.  There is a 1-byte ESC code overhead for each blank and for 
  13423. each newline character.  If fReferenceType is REFERENCE_BY_ID, then there is a 
  13424. (3-byte + Reference length) ESC code overhead. For a fReferenceType of 
  13425. REFERENCE_BY_RES, the overhead is 5 bytes. Finally, there is a 3-byte ESC code 
  13426. overhead that is required for ending the hypertext link. 
  13427.  
  13428.  
  13429. ΓòÉΓòÉΓòÉ <hidden> DdfHyperText - Errors ΓòÉΓòÉΓòÉ
  13430.  
  13431. Possible returns from WinGetLastError 
  13432.  
  13433.  HMERR_DDF_MEMORY (0x3001) 
  13434.     Not enough memory is available. 
  13435.  
  13436.  HMERR_DDF_REFTYPE (0x3006) 
  13437.     The reference type is not valid. 
  13438.  
  13439.  
  13440. ΓòÉΓòÉΓòÉ <hidden> DdfHyperText - Related Functions ΓòÉΓòÉΓòÉ
  13441.  
  13442.      DdfBeginList 
  13443.      DdfBitmap 
  13444.      DdfEndList 
  13445.      DdfHyperText 
  13446.      DdfInform 
  13447.      DdfInitialize 
  13448.      DdfListItem 
  13449.      DdfMetafile 
  13450.      DdfPara 
  13451.      DdfSetColor 
  13452.      DdfSetFont 
  13453.      DdfSetFontStyle 
  13454.      DdfSetFormat 
  13455.      DdfSetTextAlign 
  13456.      DdfText 
  13457.  
  13458.  
  13459. ΓòÉΓòÉΓòÉ <hidden> DdfHyperText - Example Code ΓòÉΓòÉΓòÉ
  13460.  
  13461. After initializing a DDF buffer with DdfInitialize, the example uses 
  13462. DdfHyperText to create a hypertext link with another resource. For a more 
  13463. detailed example and discussion of initializing DDF, see the DdfInitialize 
  13464. sample. 
  13465.  
  13466. #define INCL_WINWINDOWMGR       /* General window management    */
  13467. #define INCL_WINMESSAGEMGR      /* Message management           */
  13468. #define INCL_DDF                /* Dynamic Data Facility        */
  13469. #include <os2.h>
  13470. #include <pmhelp.h>
  13471.  
  13472. PSZ    Text = "This text is a HYPERTEXT message.\n"; /* hypertext string  */
  13473. PSZ    ResID = "1";     /* Resource identifier                  */
  13474.  
  13475. MRESULT WindowProc( HWND hwnd, ULONG ulMsg, MPARAM mp1, MPARAM mp2 )
  13476. {
  13477.     HWND   hwndParent;
  13478.     HWND   hwndInstance;
  13479.     HDDF   hDdf;            /* DDF handle                           */
  13480.  
  13481.     switch( ulMsg )
  13482.     {
  13483.     case HM_QUERY_DDF_DATA:
  13484.         /* get the help instance */
  13485.         hwndParent = WinQueryWindow( hwnd, QW_PARENT );
  13486.         hwndParent = WinQueryWindow( hwndParent, QW_PARENT );
  13487.         hwndInstance = (HWND)WinSendMsg( hwndParent, HM_QUERY,
  13488.                                  MPFROMSHORT( HMQW_INSTANCE ), NULL );
  13489.  
  13490.         /* Allocate 1K Buffer (default)  */
  13491.         hDdf = DdfInitialize(
  13492.                     hwndInstance,  /* Handle of help instance */
  13493.                     0L,            /* Default buffer size     */
  13494.                     0L             /* Default increment       */
  13495.                     );
  13496.  
  13497.         if (hDdf == NULLHANDLE)       /* Check return code       */
  13498.         {
  13499.             return (MRESULT)FALSE;
  13500.         }
  13501.  
  13502.         /* create hypertext link with resource 1 */
  13503.         if (!DdfHyperText(hDdf, (PSZ)Text, ResID, REFERENCE_BY_RES))
  13504.         {
  13505.             return (MRESULT)FALSE;
  13506.         }
  13507.  
  13508.         return (MRESULT)hDdf;
  13509.     }
  13510. }
  13511.  
  13512.  
  13513. ΓòÉΓòÉΓòÉ <hidden> DdfHyperText - Topics ΓòÉΓòÉΓòÉ
  13514.  
  13515. Select an item: 
  13516.  
  13517. Syntax
  13518. Parameters
  13519. Returns
  13520. Errors
  13521. Remarks
  13522. Example Code
  13523. Related Functions
  13524. Glossary
  13525.  
  13526.  
  13527. ΓòÉΓòÉΓòÉ 17.5. DdfInform ΓòÉΓòÉΓòÉ
  13528.  
  13529.  
  13530. ΓòÉΓòÉΓòÉ <hidden> DdfInform - Syntax ΓòÉΓòÉΓòÉ
  13531.  
  13532. This function defines a hypertext inform link, which sends an HM_INFORM message 
  13533. to the application with a res= attribute. It also corresponds to the link tag 
  13534. with reftype=inform. 
  13535.  
  13536.  
  13537. #define INCL_DDF
  13538. #include <os2.h>
  13539.  
  13540. HDDF     hddf;             /*  Handle to DDF returned by DdfInitialize. */
  13541. PCSZ     pszText;          /*  Hypertext phrase. */
  13542. ULONG    resInformNumber;  /*  Res number associated with this hypertext field. */
  13543. BOOL     rc;               /*  Success indicator. */
  13544.  
  13545. rc = DdfInform(hddf, pszText, resInformNumber);
  13546.  
  13547.  
  13548. ΓòÉΓòÉΓòÉ <hidden> DdfInform Parameter - hddf ΓòÉΓòÉΓòÉ
  13549.  
  13550.  hddf (HDDF) - input 
  13551.     Handle to DDF returned by DdfInitialize. 
  13552.  
  13553.  
  13554. ΓòÉΓòÉΓòÉ <hidden> DdfInform Parameter - pszText ΓòÉΓòÉΓòÉ
  13555.  
  13556.  pszText (PCSZ) - input 
  13557.     Hypertext phrase. 
  13558.  
  13559.  
  13560. ΓòÉΓòÉΓòÉ <hidden> DdfInform Parameter - resInformNumber ΓòÉΓòÉΓòÉ
  13561.  
  13562.  resInformNumber (ULONG) - input 
  13563.     Res number associated with this hypertext field. 
  13564.  
  13565.     Possible values are 1 to 64000; all other values are reserved. 
  13566.  
  13567.  
  13568. ΓòÉΓòÉΓòÉ <hidden> DdfInform Return Value - rc ΓòÉΓòÉΓòÉ
  13569.  
  13570.  rc (BOOL) - returns 
  13571.     Success indicator. 
  13572.  
  13573.     TRUE 
  13574.             Successful completion 
  13575.     FALSE 
  13576.             Error occurred. 
  13577.  
  13578.  
  13579. ΓòÉΓòÉΓòÉ <hidden> DdfInform - Parameters ΓòÉΓòÉΓòÉ
  13580.  
  13581.  hddf (HDDF) - input 
  13582.     Handle to DDF returned by DdfInitialize. 
  13583.  
  13584.  pszText (PCSZ) - input 
  13585.     Hypertext phrase. 
  13586.  
  13587.  resInformNumber (ULONG) - input 
  13588.     Res number associated with this hypertext field. 
  13589.  
  13590.     Possible values are 1 to 64000; all other values are reserved. 
  13591.  
  13592.  rc (BOOL) - returns 
  13593.     Success indicator. 
  13594.  
  13595.     TRUE 
  13596.             Successful completion 
  13597.     FALSE 
  13598.             Error occurred. 
  13599.  
  13600.  
  13601. ΓòÉΓòÉΓòÉ <hidden> DdfInform - Errors ΓòÉΓòÉΓòÉ
  13602.  
  13603. Possible returns from WinGetLastError 
  13604.  
  13605.  HMERR_DDF_MEMORY (0x3001) 
  13606.     Not enough memory is available. 
  13607.  
  13608.  
  13609. ΓòÉΓòÉΓòÉ <hidden> DdfInform - Related Functions ΓòÉΓòÉΓòÉ
  13610.  
  13611.      DdfBeginList 
  13612.      DdfBitmap 
  13613.      DdfEndList 
  13614.      DdfHyperText 
  13615.      DdfInform 
  13616.      DdfInitialize 
  13617.      DdfListItem 
  13618.      DdfMetafile 
  13619.      DdfPara 
  13620.      DdfSetColor 
  13621.      DdfSetFont 
  13622.      DdfSetFontStyle 
  13623.      DdfSetFormat 
  13624.      DdfSetTextAlign 
  13625.      DdfText 
  13626.  
  13627.  
  13628. ΓòÉΓòÉΓòÉ <hidden> DdfInform - Example Code ΓòÉΓòÉΓòÉ
  13629.  
  13630. After initializing a DDF buffer with DdfInitialize, the example uses DdfInform 
  13631. to create a hypertext inform link with another resource (corresponds to the IPF 
  13632. :link. tag with reftype=inform). For a more detailed example and discussion of 
  13633. initializing DDF, see the DdfInitialize sample. 
  13634.  
  13635. #define INCL_WINWINDOWMGR       /* General window management    */
  13636. #define INCL_WINMESSAGEMGR      /* Message management           */
  13637. #define INCL_DDF                /* Dynamic Data Facility        */
  13638. #include <os2.h>
  13639. #include <pmhelp.h>
  13640.  
  13641. PSZ    Text = "This text is a HYPERTEXT message.\n"; /* hypertext string  */
  13642. MRESULT WindowProc( HWND hwnd, ULONG ulMsg, MPARAM mp1, MPARAM mp2 )
  13643. {
  13644.     HWND   hwndParent;
  13645.     HWND   hwndInstance;
  13646.     HDDF   hDdf;            /* DDF handle                           */
  13647.  
  13648.     switch( ulMsg )
  13649.     {
  13650.         case HM_QUERY_DDF_DATA:
  13651.             /* get the help instance */
  13652.             hwndParent = WinQueryWindow( hwnd, QW_PARENT );
  13653.             hwndParent = WinQueryWindow( hwndParent, QW_PARENT );
  13654.             hwndInstance = (HWND)WinSendMsg( hwndParent, HM_QUERY,
  13655.                                      MPFROMSHORT( HMQW_INSTANCE ), NULL );
  13656.  
  13657.         /* Allocate 1K Buffer (default)  */
  13658.         hDdf = DdfInitialize(
  13659.                         hwndInstance,  /* Handle of help instance */
  13660.                         0L,            /* Default buffer size     */
  13661.                         0L             /* Default increment       */
  13662.                         );
  13663.  
  13664.         if (hDdf == NULLHANDLE)       /* Check return code       */
  13665.         {
  13666.             return (MRESULT)FALSE;
  13667.         }
  13668.  
  13669.         /* create hypertext inform link with resource 1 */
  13670.         if (!DdfInform(hDdf, (PSZ)Text, 1L))
  13671.         {
  13672.             return (MRESULT)FALSE;
  13673.         }
  13674.  
  13675.         return (MRESULT)hDdf;
  13676.     }
  13677. }
  13678.  
  13679.  
  13680. ΓòÉΓòÉΓòÉ <hidden> DdfInform - Topics ΓòÉΓòÉΓòÉ
  13681.  
  13682. Select an item: 
  13683.  
  13684. Syntax
  13685. Parameters
  13686. Returns
  13687. Errors
  13688. Example Code
  13689. Related Functions
  13690. Glossary
  13691.  
  13692.  
  13693. ΓòÉΓòÉΓòÉ 17.6. DdfInitialize ΓòÉΓòÉΓòÉ
  13694.  
  13695.  
  13696. ΓòÉΓòÉΓòÉ <hidden> DdfInitialize - Syntax ΓòÉΓòÉΓòÉ
  13697.  
  13698. This function initializes the IPF internal structures for dynamic data 
  13699. formatting and returns a DDF handle. The application uses this handle to refer 
  13700. to a particular DDF panel. 
  13701.  
  13702.  
  13703. #define INCL_DDF
  13704. #include <os2.h>
  13705.  
  13706. HWND     hwndHelpInstance;  /*  Handle of a help instance. */
  13707. ULONG    cbBuffer;          /*  Initial length of internal buffer. */
  13708. ULONG    ulIncrement;       /*  Amount by which to increment the buffer size, if necessary. */
  13709. HDDF     hddf;              /*  Handle to DDF. */
  13710.  
  13711. hddf = DdfInitialize(hwndHelpInstance, cbBuffer,
  13712.          ulIncrement);
  13713.  
  13714.  
  13715. ΓòÉΓòÉΓòÉ <hidden> DdfInitialize Parameter - hwndHelpInstance ΓòÉΓòÉΓòÉ
  13716.  
  13717.  hwndHelpInstance (HWND) - input 
  13718.     Handle of a help instance. 
  13719.  
  13720.  
  13721. ΓòÉΓòÉΓòÉ <hidden> DdfInitialize Parameter - cbBuffer ΓòÉΓòÉΓòÉ
  13722.  
  13723.  cbBuffer (ULONG) - input 
  13724.     Initial length of internal buffer. 
  13725.  
  13726.     Initial length of internal buffer where DDF information is to be stored. If 
  13727.     this field is 0L, a default value of 1K is defined. The maximum value is 61 
  13728.     440 bytes (60KB). 
  13729.  
  13730.  
  13731. ΓòÉΓòÉΓòÉ <hidden> DdfInitialize Parameter - ulIncrement ΓòÉΓòÉΓòÉ
  13732.  
  13733.  ulIncrement (ULONG) - input 
  13734.     Amount by which to increment the buffer size, if necessary. 
  13735.  
  13736.     If this field is NULL, a default value of 256 bytes is defined.  The 
  13737.     maximum value is 60KB. 
  13738.  
  13739.  
  13740. ΓòÉΓòÉΓòÉ <hidden> DdfInitialize Return Value - hddf ΓòÉΓòÉΓòÉ
  13741.  
  13742.  hddf (HDDF) - returns 
  13743.     Handle to DDF. 
  13744.  
  13745.     A handle to DDF is returned if initialization was successful. Otherwise, 
  13746.     the value returned is NULL, indicating that an error has occurred because 
  13747.     of insufficient memory or incorrect instance. 
  13748.  
  13749.  
  13750. ΓòÉΓòÉΓòÉ <hidden> DdfInitialize - Parameters ΓòÉΓòÉΓòÉ
  13751.  
  13752.  hwndHelpInstance (HWND) - input 
  13753.     Handle of a help instance. 
  13754.  
  13755.  cbBuffer (ULONG) - input 
  13756.     Initial length of internal buffer. 
  13757.  
  13758.     Initial length of internal buffer where DDF information is to be stored. If 
  13759.     this field is 0L, a default value of 1K is defined. The maximum value is 61 
  13760.     440 bytes (60KB). 
  13761.  
  13762.  ulIncrement (ULONG) - input 
  13763.     Amount by which to increment the buffer size, if necessary. 
  13764.  
  13765.     If this field is NULL, a default value of 256 bytes is defined.  The 
  13766.     maximum value is 60KB. 
  13767.  
  13768.  hddf (HDDF) - returns 
  13769.     Handle to DDF. 
  13770.  
  13771.     A handle to DDF is returned if initialization was successful. Otherwise, 
  13772.     the value returned is NULL, indicating that an error has occurred because 
  13773.     of insufficient memory or incorrect instance. 
  13774.  
  13775.  
  13776. ΓòÉΓòÉΓòÉ <hidden> DdfInitialize - Remarks ΓòÉΓòÉΓòÉ
  13777.  
  13778. At initialization, the default for dynamic data display is that text aligned on 
  13779. the left, and formatting is turned on. 
  13780.  
  13781.  
  13782. ΓòÉΓòÉΓòÉ <hidden> DdfInitialize - Related Functions ΓòÉΓòÉΓòÉ
  13783.  
  13784.      DdfBeginList 
  13785.      DdfBitmap 
  13786.      DdfEndList 
  13787.      DdfHyperText 
  13788.      DdfInform 
  13789.      DdfInitialize 
  13790.      DdfListItem 
  13791.      DdfMetafile 
  13792.      DdfPara 
  13793.      DdfSetColor 
  13794.      DdfSetFont 
  13795.      DdfSetFontStyle 
  13796.      DdfSetFormat 
  13797.      DdfSetTextAlign 
  13798.      DdfText 
  13799.  
  13800.  
  13801. ΓòÉΓòÉΓòÉ <hidden> DdfInitialize - Example Code ΓòÉΓòÉΓòÉ
  13802.  
  13803. This example shows how to initialize and use the Dynamic Data Facility for 
  13804. displaying an online document. Two functions are defined: the first, SampleObj, 
  13805. creates a window that will display the online information and specifies the 
  13806. second function, SampleWindowProc, as the corresponding window procedure. These 
  13807. two functions are compiled into a DLL and exported, so that IPF can invoke them 
  13808. when it encounters the :ddf and :acviewport tags during execution. The 
  13809. :acviewport tag will specify the DLL name and the SampleObj function; when IPF 
  13810. calls SampleObj, it initializes an application-controlled window with 
  13811. SampleWindowProc as the window procedure and returns the window handle. Later, 
  13812. when IPF encounters the :ddf tag, it will send SampleWindowProc an 
  13813. HM_QUERY_DDF_DATA message. At this point, before calling any of the DDF API, 
  13814. DdfInitialize must first be called to initiate a DDF buffer, after which the 
  13815. other DDF API can be called to display the online information. 
  13816.  
  13817. #define INCL_WINWINDOWMGR       /* General window management    */
  13818. #define INCL_WINMESSAGEMGR      /* Message management           */
  13819. #define INCL_WINDIALOGS         /* Dialog boxes                 */
  13820. #define INCL_DDF                /* Dynamic Data Facility        */
  13821. #define INCL_32
  13822. #include <os2.h>
  13823. #include <pmhelp.h>
  13824.  
  13825. #define COM_HWND 4                /* window word offsets        */
  13826. #define PAGE_HWND 8
  13827. #define ACVP_HAB  12
  13828.  
  13829. USHORT DdfClass = FALSE;
  13830.  
  13831. MRESULT EXPENTRY SampleWindowProc(HWND hWnd, ULONG Message,
  13832.                                  MPARAM lParam1, MPARAM lParam2);
  13833.  
  13834. USHORT APIENTRY SampleObj(PACVP pACVP, PCH Parameter)
  13835. {
  13836. HWND DdfHwnd;           /* Client window handle                  */
  13837. HWND DdfCHwnd;          /* Child window handle                   */
  13838. HWND PreviousHwnd;      /* Handle for setting comm window active */
  13839.  
  13840.     /* register DDF Base class if not registered already */
  13841.     if (!DdfClass)
  13842.     {
  13843.          if (!WinRegisterClass(
  13844.                    pACVP->hAB,        /* Anchor block handle           */
  13845.                    "CLASS_Ddf",       /* Application window class name */
  13846.                    SampleWindowProc,  /* Address of window procedure   */
  13847.                    CS_SYNCPAINT |     /* Window class style            */
  13848.                    CS_SIZEREDRAW |
  13849.                    CS_MOVENOTIFY,
  13850.                    20))               /* Extra storage                 */
  13851.         {
  13852.             return TRUE;
  13853.         }
  13854.         DdfClass = TRUE;
  13855.     }
  13856.  
  13857.     /*  create standard window  */
  13858.     if (!(DdfHwnd = WinCreateStdWindow(
  13859.                       pACVP->hWndParent, /* ACVP is parent       */
  13860.                       0L,                /* No class style       */
  13861.                       NULL,              /* Frame control flag   */
  13862.                       "CLASS_Ddf",       /* Window class name    */
  13863.                       NULL,              /* No title bar         */
  13864.                       0L,                /* No special style     */
  13865.                       0L,                /* Resource in .EXE     */
  13866.                       0,                 /* No window identifier */
  13867.                       &DdfCHwnd )))      /* Client window handle */
  13868.     {
  13869.         return FALSE;
  13870.     }
  13871.  
  13872.     /* store the frame window handle in ACVP data structure */
  13873.     pACVP->hWndACVP = DdfHwnd;
  13874.  
  13875.     /* set this window as active communication window */
  13876.     PreviousHwnd = (HWND)WinSendMsg(pACVP->hWndParent,
  13877.                            HM_SET_OBJCOM_WINDOW,
  13878.                            MPFROMHWND(DdfHwnd), NULL);
  13879.  
  13880.     /* save returned communication hwnd in reserved word */
  13881.     WinSetWindowULong(DdfCHwnd, COM_HWND, (ULONG)PreviousHwnd);
  13882.  
  13883.     /* save anchor block handle in reserved word */
  13884.     WinSetWindowULong (DdfCHwnd, ACVP_HAB, (ULONG)pACVP->hAB);
  13885.  
  13886.     return FALSE;
  13887. } /* SampleObj */
  13888.  
  13889. MRESULT EXPENTRY SampleWindowProc(HWND hWnd, ULONG Message,
  13890.                                  MPARAM lParam1, MPARAM lParam2)
  13891. {
  13892.     HWND   hwndParent;       /* parent window                        */
  13893.     HWND   hwndHelpInstance; /* help instance window                 */
  13894.     HDDF   hDdf;             /* DDF handle                           */
  13895.     ULONG  DdfID;            /* DDF resource id                      */
  13896.  
  13897.     switch (Message)
  13898.     {
  13899.     case HM_QUERY_DDF_DATA:
  13900.         WinSetWindowULong(hWnd, PAGE_HWND, LONGFROMMP(lParam1));
  13901.         DdfID = LONGFROMMP(lParam2);
  13902.         hwndParent = WinQueryWindow(hWnd, QW_PARENT);
  13903.         hwndParent = WinQueryWindow(hwndParent, QW_PARENT);
  13904.         hwndHelpInstance = (HWND)WinSendMsg(hwndParent, HM_QUERY,
  13905.                                   MPFROMSHORT(HMQW_INSTANCE), NULL);
  13906.  
  13907.         /* Allocate 1K Buffer (default)  */
  13908.         hDdf = DdfInitialize(
  13909.                         hwndHelpInstance, /* Handle of help instance */
  13910.                         0L,               /* Default buffer size     */
  13911.                         0L                /* Default increment       */
  13912.                         );
  13913.  
  13914.         if (hDdf == NULLHANDLE)       /* Check return code       */
  13915.         {
  13916.             return (MRESULT)FALSE;
  13917.         }
  13918.  
  13919.         return (MRESULT)hDdf;
  13920.  
  13921.     default:
  13922.         return (WinDefWindowProc(hWnd, Message, lParam1, lParam2));
  13923.     }
  13924. } /* SampleWindowProc */
  13925.  
  13926.  
  13927. ΓòÉΓòÉΓòÉ <hidden> DdfInitialize - Topics ΓòÉΓòÉΓòÉ
  13928.  
  13929. Select an item: 
  13930.  
  13931. Syntax
  13932. Parameters
  13933. Returns
  13934. Remarks
  13935. Example Code
  13936. Related Functions
  13937. Glossary
  13938.  
  13939.  
  13940. ΓòÉΓòÉΓòÉ 17.7. DdfListItem ΓòÉΓòÉΓòÉ
  13941.  
  13942.  
  13943. ΓòÉΓòÉΓòÉ <hidden> DdfListItem - Syntax ΓòÉΓòÉΓòÉ
  13944.  
  13945. This function inserts a definition list entry in the DDF buffer; it corresponds 
  13946. to a combination of the :dt. (definition term) and :dd. (definition define) 
  13947. tags. 
  13948.  
  13949.  
  13950. #define INCL_DDF
  13951. #include <os2.h>
  13952.  
  13953. HDDF    hddf;            /*  Handle to DDF returned by DdfInitialize. */
  13954. PCSZ    pszTerm;         /*  Term portion of the definition list entry. */
  13955. PCSZ    pszDescription;  /*  Description portion of the definition list entry. */
  13956. BOOL    rc;              /*  Success indicator. */
  13957.  
  13958. rc = DdfListItem(hddf, pszTerm, pszDescription);
  13959.  
  13960.  
  13961. ΓòÉΓòÉΓòÉ <hidden> DdfListItem Parameter - hddf ΓòÉΓòÉΓòÉ
  13962.  
  13963.  hddf (HDDF) - input 
  13964.     Handle to DDF returned by DdfInitialize. 
  13965.  
  13966.  
  13967. ΓòÉΓòÉΓòÉ <hidden> DdfListItem Parameter - pszTerm ΓòÉΓòÉΓòÉ
  13968.  
  13969.  pszTerm (PCSZ) - input 
  13970.     Term portion of the definition list entry. 
  13971.  
  13972.  
  13973. ΓòÉΓòÉΓòÉ <hidden> DdfListItem Parameter - pszDescription ΓòÉΓòÉΓòÉ
  13974.  
  13975.  pszDescription (PCSZ) - input 
  13976.     Description portion of the definition list entry. 
  13977.  
  13978.     Note:  There is a 3-byte ESC code overhead in the DDF internal buffer for 
  13979.     each word in both the term and the description.  There is a 1-byte ESC code 
  13980.     overhead for each blank and for each newline character.  For each list 
  13981.     item, there is a 5-byte ESC code overhead for the margin alignment. 
  13982.  
  13983.  
  13984. ΓòÉΓòÉΓòÉ <hidden> DdfListItem Return Value - rc ΓòÉΓòÉΓòÉ
  13985.  
  13986.  rc (BOOL) - returns 
  13987.     Success indicator. 
  13988.  
  13989.     TRUE 
  13990.             Successful completion 
  13991.     FALSE 
  13992.             Error occurred. 
  13993.  
  13994.  
  13995. ΓòÉΓòÉΓòÉ <hidden> DdfListItem - Parameters ΓòÉΓòÉΓòÉ
  13996.  
  13997.  hddf (HDDF) - input 
  13998.     Handle to DDF returned by DdfInitialize. 
  13999.  
  14000.  pszTerm (PCSZ) - input 
  14001.     Term portion of the definition list entry. 
  14002.  
  14003.  pszDescription (PCSZ) - input 
  14004.     Description portion of the definition list entry. 
  14005.  
  14006.     Note:  There is a 3-byte ESC code overhead in the DDF internal buffer for 
  14007.     each word in both the term and the description.  There is a 1-byte ESC code 
  14008.     overhead for each blank and for each newline character.  For each list 
  14009.     item, there is a 5-byte ESC code overhead for the margin alignment. 
  14010.  
  14011.  rc (BOOL) - returns 
  14012.     Success indicator. 
  14013.  
  14014.     TRUE 
  14015.             Successful completion 
  14016.     FALSE 
  14017.             Error occurred. 
  14018.  
  14019.  
  14020. ΓòÉΓòÉΓòÉ <hidden> DdfListItem - Remarks ΓòÉΓòÉΓòÉ
  14021.  
  14022. The handle to the presentation space in which the bit map was created cannot be 
  14023. freed by the application while the panel is displayed. 
  14024.  
  14025. Note:  There is a (3-byte + size of HBITMAP structure) ESC code overhead in the 
  14026. DDF internal buffer for this function. There is a 1-byte ESC code overhead 
  14027. required for the Align flag. 
  14028.  
  14029.  
  14030. ΓòÉΓòÉΓòÉ <hidden> DdfListItem - Errors ΓòÉΓòÉΓòÉ
  14031.  
  14032. Possible returns from WinGetLastError 
  14033.  
  14034.  HMERR_DDF_MEMORY (0x3001) 
  14035.     Not enough memory is available. 
  14036.  
  14037.  HMERR_DDF_LIST_UNINITIALIZED (0x3008) 
  14038.     No definition list has been initialized by DdfBeginList. 
  14039.  
  14040.  
  14041. ΓòÉΓòÉΓòÉ <hidden> DdfListItem - Related Functions ΓòÉΓòÉΓòÉ
  14042.  
  14043.      DdfBeginList 
  14044.      DdfBitmap 
  14045.      DdfEndList 
  14046.      DdfHyperText 
  14047.      DdfInform 
  14048.      DdfInitialize 
  14049.      DdfListItem 
  14050.      DdfMetafile 
  14051.      DdfPara 
  14052.      DdfSetColor 
  14053.      DdfSetFont 
  14054.      DdfSetFontStyle 
  14055.      DdfSetFormat 
  14056.      DdfSetTextAlign 
  14057.      DdfText 
  14058.  
  14059.  
  14060. ΓòÉΓòÉΓòÉ <hidden> DdfListItem - Example Code ΓòÉΓòÉΓòÉ
  14061.  
  14062. After initializing a DDF buffer with DdfInitialize, the example uses 
  14063. DdfBeginList to indicate the beginning of a definition list in the DDF buffer 
  14064. (this corresponds to the IPF dl tag). For a more detailed example and 
  14065. discussion of initializing DDF, see the DdfInitialize sample. 
  14066.  
  14067. #define INCL_WINWINDOWMGR       /* General window management    */
  14068. #define INCL_WINMESSAGEMGR      /* Message management           */
  14069. #define INCL_DDF                /* Dynamic Data Facility        */
  14070. #include <os2.h>
  14071. #include <pmhelp.h>
  14072.  
  14073. struct _LISTITEM        /* definition list                      */
  14074. {
  14075.     PSZ Term;
  14076.     PSZ Desc;
  14077. } Definition[2] = {{"MVS", "Multiple Virtual System"},
  14078.                    {"VM",  "Virtual Machine"}};
  14079.  
  14080. MRESULT WindowProc( HWND hwnd, ULONG ulMsg, MPARAM mp1, MPARAM mp2)
  14081. {
  14082.  
  14083.     HWND   hwndParent;
  14084.     HWND   hwndInstance;
  14085.     HDDF   hDdf;            /* DDF handle                           */
  14086.     SHORT i;               /* loop index                           */
  14087.  
  14088.     switch( ulMsg )
  14089.     {
  14090.     case HM_QUERY_DDF_DATA:
  14091.         /* get the help instance */
  14092.         hwndParent = WinQueryWindow( hwnd, QW_PARENT );
  14093.         hwndParent = WinQueryWindow( hwndParent, QW_PARENT );
  14094.         hwndInstance = (HWND)WinSendMsg( hwndParent, HM_QUERY,
  14095.                                  MPFROMSHORT( HMQW_INSTANCE ), NULL );
  14096.  
  14097.         /* Allocate 1K Buffer (default)  */
  14098.         hDdf = DdfInitialize(
  14099.                    hwndInstance,  /* Handle of help instance */
  14100.                    0L,            /* Default buffer size     */
  14101.                    0L             /* Default increment       */
  14102.                    );
  14103.  
  14104.         if (hDdf == NULLHANDLE)       /* Check return code       */
  14105.         {
  14106.             return (MRESULT)FALSE;
  14107.         }
  14108.  
  14109.         /* begin definition list */
  14110.         if (!DdfBeginList(hDdf, 3L, HMBT_ALL, HMLS_SINGLELINE))
  14111.         {
  14112.             return (MRESULT)FALSE;
  14113.         }
  14114.  
  14115.         /* insert 2 entries into definition list */
  14116.         for (i=0; i < 2; i++)
  14117.         {
  14118.             if (!DdfListItem(hDdf, Definition[i].Term,
  14119.                                    Definition[i].Desc))
  14120.             {
  14121.                return (MRESULT)FALSE;
  14122.             }
  14123.         }
  14124.  
  14125.         /* terminate definition list */
  14126.         if (!DdfEndList(hDdf))
  14127.         {
  14128.             return (MRESULT)FALSE;
  14129.         }
  14130.  
  14131.         return (MRESULT)hDdf;
  14132.     }
  14133. }
  14134.  
  14135.  
  14136. ΓòÉΓòÉΓòÉ <hidden> DdfListItem - Topics ΓòÉΓòÉΓòÉ
  14137.  
  14138. Select an item: 
  14139.  
  14140. Syntax
  14141. Parameters
  14142. Returns
  14143. Errors
  14144. Remarks
  14145. Example Code
  14146. Related Functions
  14147. Glossary
  14148.  
  14149.  
  14150. ΓòÉΓòÉΓòÉ 17.8. DdfMetafile ΓòÉΓòÉΓòÉ
  14151.  
  14152.  
  14153. ΓòÉΓòÉΓòÉ <hidden> DdfMetafile - Syntax ΓòÉΓòÉΓòÉ
  14154.  
  14155. This function places a reference to a metafile into the DDF buffer. 
  14156.  
  14157.  
  14158. #define INCL_DDF
  14159. #include <os2.h>
  14160.  
  14161. HDDF      hddf;      /*  Handle to DDF returned by DdfInitialize. */
  14162. HMF       hmf;       /*  The handle of the metafile to display. */
  14163. PRECTL    prclRect;  /*  Size of the rectangle. */
  14164. BOOL      rc;        /*  Success indicator. */
  14165.  
  14166. rc = DdfMetafile(hddf, hmf, prclRect);
  14167.  
  14168.  
  14169. ΓòÉΓòÉΓòÉ <hidden> DdfMetafile Parameter - hddf ΓòÉΓòÉΓòÉ
  14170.  
  14171.  hddf (HDDF) - input 
  14172.     Handle to DDF returned by DdfInitialize. 
  14173.  
  14174.  
  14175. ΓòÉΓòÉΓòÉ <hidden> DdfMetafile Parameter - hmf ΓòÉΓòÉΓòÉ
  14176.  
  14177.  hmf (HMF) - input 
  14178.     The handle of the metafile to display. 
  14179.  
  14180.  
  14181. ΓòÉΓòÉΓòÉ <hidden> DdfMetafile Parameter - prclRect ΓòÉΓòÉΓòÉ
  14182.  
  14183.  prclRect (PRECTL) - input 
  14184.     Size of the rectangle. 
  14185.  
  14186.     If not NULL, contains the size of the rectangle in which the metafile will 
  14187.     be displayed.  The aspect ratio of the metafile is adjusted to fit this 
  14188.     rectangle. 
  14189.  
  14190.  
  14191. ΓòÉΓòÉΓòÉ <hidden> DdfMetafile Return Value - rc ΓòÉΓòÉΓòÉ
  14192.  
  14193.  rc (BOOL) - returns 
  14194.     Success indicator. 
  14195.  
  14196.     TRUE 
  14197.             Successful completion 
  14198.     FALSE 
  14199.             Error occurred. 
  14200.  
  14201.  
  14202. ΓòÉΓòÉΓòÉ <hidden> DdfMetafile - Parameters ΓòÉΓòÉΓòÉ
  14203.  
  14204.  hddf (HDDF) - input 
  14205.     Handle to DDF returned by DdfInitialize. 
  14206.  
  14207.  hmf (HMF) - input 
  14208.     The handle of the metafile to display. 
  14209.  
  14210.  prclRect (PRECTL) - input 
  14211.     Size of the rectangle. 
  14212.  
  14213.     If not NULL, contains the size of the rectangle in which the metafile will 
  14214.     be displayed.  The aspect ratio of the metafile is adjusted to fit this 
  14215.     rectangle. 
  14216.  
  14217.  rc (BOOL) - returns 
  14218.     Success indicator. 
  14219.  
  14220.     TRUE 
  14221.             Successful completion 
  14222.     FALSE 
  14223.             Error occurred. 
  14224.  
  14225.  
  14226. ΓòÉΓòÉΓòÉ <hidden> DdfMetafile - Remarks ΓòÉΓòÉΓòÉ
  14227.  
  14228. There is a 3-byte ESC code overhead in the DDF internal buffer for this 
  14229. function.  There is also a (MetaFilename length) overhead. Finally, the 
  14230. prclRect variable requires an additional 16 bytes of overhead in the DDF 
  14231. internal buffer. 
  14232.  
  14233.  
  14234. ΓòÉΓòÉΓòÉ <hidden> DdfMetafile - Errors ΓòÉΓòÉΓòÉ
  14235.  
  14236. Possible returns from WinGetLastError 
  14237.  
  14238.  HMERR_DDF_MEMORY (0x3001) 
  14239.     Not enough memory is available. 
  14240.  
  14241.  
  14242. ΓòÉΓòÉΓòÉ <hidden> DdfMetafile - Related Functions ΓòÉΓòÉΓòÉ
  14243.  
  14244.      DdfBeginList 
  14245.      DdfBitmap 
  14246.      DdfEndList 
  14247.      DdfHyperText 
  14248.      DdfInform 
  14249.      DdfInitialize 
  14250.      DdfListItem 
  14251.      DdfMetafile 
  14252.      DdfPara 
  14253.      DdfSetColor 
  14254.      DdfSetFont 
  14255.      DdfSetFontStyle 
  14256.      DdfSetFormat 
  14257.      DdfSetTextAlign 
  14258.      DdfText 
  14259.  
  14260.  
  14261. ΓòÉΓòÉΓòÉ <hidden> DdfMetafile - Example Code ΓòÉΓòÉΓòÉ
  14262.  
  14263. After initializing a DDF buffer with DdfInitialize, and loading a metafile with 
  14264. GpiLoadMetaFile, the example uses DdfMetafile to place a reference to the 
  14265. metafile in the DDF buffer.  For a more detailed example and discussion of 
  14266. initializing DDF, see the DdfInitialize sample. 
  14267.  
  14268. #define INCL_WINWINDOWMGR       /* General window management    */
  14269. #define INCL_WINMESSAGEMGR      /* Message management           */
  14270. #define INCL_DDF                /* Dynamic Data Facility        */
  14271. #define INCL_GPIMETAFILES       /* MetaFiles                    */
  14272. #include <os2.h>
  14273. #include <pmhelp.h>
  14274.  
  14275. #define MF_HWND   0
  14276. #define ACVP_HAB  4
  14277.  
  14278. MRESULT WindowProc( HWND hwnd, ULONG ulMsg, MPARAM mp1, MPARAM mp2 )
  14279. {
  14280.     HWND   hwndParent;
  14281.     HAB    hab;
  14282.     HWND   hwndInstance;    /* help instance window                 */
  14283.     HDDF   hDdf;            /* DDF handle                           */
  14284.     HMF    hwndMetaFile;    /* metafile handle                      */
  14285.  
  14286.     switch( ulMsg )
  14287.     {
  14288.     case HM_QUERY_DDF_DATA:
  14289.         /* get the help instance */
  14290.         hwndParent = WinQueryWindow( hwnd, QW_PARENT );
  14291.         hwndParent = WinQueryWindow( hwndParent, QW_PARENT );
  14292.         hwndInstance = (HWND)WinSendMsg( hwndParent, HM_QUERY,
  14293.                                  MPFROMSHORT( HMQW_INSTANCE ), NULL );
  14294.  
  14295.         /* Allocate 1K Buffer (default)  */
  14296.         hDdf = DdfInitialize(
  14297.                     hwndInstance,  /* Handle of help instance */
  14298.                     0L,            /* Default buffer size     */
  14299.                     0L             /* Default increment       */
  14300.                     );
  14301.  
  14302.         if (hDdf == NULLHANDLE)       /* Check return code       */
  14303.         {
  14304.             return (MRESULT)FALSE;
  14305.         }
  14306.  
  14307.         /* get hab for this window */
  14308.         if ((hab = (HAB)WinQueryWindowULong(hwnd, ACVP_HAB)) == NULLHANDLE)
  14309.         {
  14310.            return (MRESULT)FALSE;
  14311.         }
  14312.  
  14313.         /* Load the Metafile to display */
  14314.         if ((hwndMetaFile = GpiLoadMetaFile(hab, "SAMP.MET")) == NULLHANDLE)
  14315.         {
  14316.             return (MRESULT)FALSE;
  14317.         }
  14318.  
  14319.         /* Save MetaFile hwnd in reserved word */
  14320.         WinSetWindowULong(hwnd, MF_HWND, hwndMetaFile);
  14321.  
  14322.         if (!DdfMetafile(hDdf, hwndMetaFile, NULL))
  14323.         {
  14324.             return (MRESULT)FALSE;
  14325.         }
  14326.  
  14327.         return (hDdf);
  14328.  
  14329.     case WM_CLOSE:
  14330.         GpiDeleteMetaFile((HMF)WinQueryWindowULong(hwnd, MF_HWND));
  14331.         WinDestroyWindow(WinQueryWindow(hwnd, QW_PARENT));
  14332.  
  14333.         return (MRESULT)TRUE;
  14334.     }
  14335.     return WinDefWindowProc( hwnd, ulMsg, mp1, mp2 );
  14336. }
  14337.  
  14338.  
  14339. ΓòÉΓòÉΓòÉ <hidden> DdfMetafile - Topics ΓòÉΓòÉΓòÉ
  14340.  
  14341. Select an item: 
  14342.  
  14343. Syntax
  14344. Parameters
  14345. Returns
  14346. Errors
  14347. Remarks
  14348. Example Code
  14349. Related Functions
  14350. Glossary
  14351.  
  14352.  
  14353. ΓòÉΓòÉΓòÉ 17.9. DdfPara ΓòÉΓòÉΓòÉ
  14354.  
  14355.  
  14356. ΓòÉΓòÉΓòÉ <hidden> DdfPara - Syntax ΓòÉΓòÉΓòÉ
  14357.  
  14358. This function creates a paragraph within the DDF buffer. It corresponds to the 
  14359. :p. tag. This function places a reference to a bit map in the DDF buffer. 
  14360.  
  14361.  
  14362. #define INCL_DDF
  14363. #include <os2.h>
  14364.  
  14365. HDDF    hddf;  /*  Handle to DDF returned by DdfInitialize. */
  14366. BOOL    rc;    /*  Success indicator. */
  14367.  
  14368. rc = DdfPara(hddf);
  14369.  
  14370.  
  14371. ΓòÉΓòÉΓòÉ <hidden> DdfPara Parameter - hddf ΓòÉΓòÉΓòÉ
  14372.  
  14373.  hddf (HDDF) - input 
  14374.     Handle to DDF returned by DdfInitialize. 
  14375.  
  14376.  
  14377. ΓòÉΓòÉΓòÉ <hidden> DdfPara Return Value - rc ΓòÉΓòÉΓòÉ
  14378.  
  14379.  rc (BOOL) - returns 
  14380.     Success indicator. 
  14381.  
  14382.     TRUE 
  14383.             Successful completion 
  14384.     FALSE 
  14385.             Error occurred. 
  14386.  
  14387.  
  14388. ΓòÉΓòÉΓòÉ <hidden> DdfPara - Parameters ΓòÉΓòÉΓòÉ
  14389.  
  14390.  hddf (HDDF) - input 
  14391.     Handle to DDF returned by DdfInitialize. 
  14392.  
  14393.  rc (BOOL) - returns 
  14394.     Success indicator. 
  14395.  
  14396.     TRUE 
  14397.             Successful completion 
  14398.     FALSE 
  14399.             Error occurred. 
  14400.  
  14401.  
  14402. ΓòÉΓòÉΓòÉ <hidden> DdfPara - Remarks ΓòÉΓòÉΓòÉ
  14403.  
  14404. There is a 1-byte ESC code overhead in the DDF internal buffer for this 
  14405. function. 
  14406.  
  14407.  
  14408. ΓòÉΓòÉΓòÉ <hidden> DdfPara - Errors ΓòÉΓòÉΓòÉ
  14409.  
  14410. Possible returns from WinGetLastError 
  14411.  
  14412.  HMERR_DDF_MEMORY (0x3001) 
  14413.     Not enough memory is available. 
  14414.  
  14415.  
  14416. ΓòÉΓòÉΓòÉ <hidden> DdfPara - Related Functions ΓòÉΓòÉΓòÉ
  14417.  
  14418.      DdfBeginList 
  14419.      DdfBitmap 
  14420.      DdfEndList 
  14421.      DdfHyperText 
  14422.      DdfInform 
  14423.      DdfInitialize 
  14424.      DdfListItem 
  14425.      DdfMetafile 
  14426.      DdfPara 
  14427.      DdfSetColor 
  14428.      DdfSetFont 
  14429.      DdfSetFontStyle 
  14430.      DdfSetFormat 
  14431.      DdfSetTextAlign 
  14432.      DdfText 
  14433.  
  14434.  
  14435. ΓòÉΓòÉΓòÉ <hidden> DdfPara - Example Code ΓòÉΓòÉΓòÉ
  14436.  
  14437. After initializing a DDF buffer with DdfInitialize, the example uses DdfPara to 
  14438. start a new paragraph, DdfSetFont and DdfSetFontStyle to have the text 
  14439. displayed in a large, bold Courier font, DdfSetColor to change the text color, 
  14440. and DdfText to place text in the buffer.  For a more detailed example and 
  14441. discussion of initializing DDF, see the DdfInitialize DdfInitialize sample. 
  14442.  
  14443. #define INCL_WINWINDOWMGR       /* General window management    */
  14444. #define INCL_WINMESSAGEMGR      /* Message management           */
  14445. #define INCL_DDF                /* Dynamic Data Facility        */
  14446. #include <os2.h>
  14447. #include <pmhelp.h>
  14448.  
  14449. MRESULT WindowProc( HWND hwnd, ULONG ulMsg, MPARAM mp1, MPARAM mp2 )
  14450. {
  14451.    HWND   hwndParent;
  14452.    HWND   hwndInstance;    /* help instance window                 */
  14453.    HDDF   hDdf;            /* DDF handle                           */
  14454.  
  14455.     switch( ulMsg )
  14456.     {
  14457.     case HM_QUERY_DDF_DATA:
  14458.         /* get the help instance */
  14459.         hwndParent = WinQueryWindow( hwnd, QW_PARENT );
  14460.         hwndParent = WinQueryWindow( hwndParent, QW_PARENT );
  14461.         hwndInstance = (HWND)WinSendMsg( hwndParent, HM_QUERY,
  14462.                                  MPFROMSHORT( HMQW_INSTANCE ), NULL );
  14463.  
  14464.         /* Allocate 1K Buffer (default)  */
  14465.         hDdf = DdfInitialize(
  14466.                     hwndInstance,  /* Handle of help instance */
  14467.                     0L,            /* Default buffer size     */
  14468.                     0L             /* Default increment       */
  14469.                     );
  14470.  
  14471.         if (hDdf == NULLHANDLE)       /* Check return code       */
  14472.         {
  14473.             return (MRESULT)FALSE;
  14474.         }
  14475.  
  14476.         /* create paragraph in DDF buffer */
  14477.         if( !DdfPara( hDdf ) )
  14478.         {
  14479.            return (MRESULT)FALSE;
  14480.         }
  14481.  
  14482.         /* Change to large (100 x 100 dimensions) Courier font */
  14483.         if( !DdfSetFont( hDdf, "Courier", 100L, 100L ) )
  14484.         {
  14485.            return (MRESULT)FALSE;
  14486.         }
  14487.  
  14488.         /* make the font BOLDFACE */
  14489.         if( !DdfSetFontStyle( hDdf, FM_SEL_BOLD ) )
  14490.         {
  14491.            return (MRESULT)FALSE;
  14492.         }
  14493.  
  14494.         /* make the text display as BLUE on a PALE GRAY background */
  14495.         if( !DdfSetColor( hDdf, CLR_PALEGRAY, CLR_BLUE ) )
  14496.         {
  14497.            return (MRESULT)FALSE;
  14498.         }
  14499.  
  14500.         /* Write data into the buffer */
  14501.         if (!DdfText(hDdf, "Sample Text"))
  14502.         {
  14503.            return (MRESULT)FALSE;
  14504.         }
  14505.  
  14506.         return (MRESULT)hDdf;
  14507.     }
  14508.     return WinDefWindowProc( hwnd, ulMsg, mp1, mp2 );
  14509. }
  14510.  
  14511.  
  14512. ΓòÉΓòÉΓòÉ <hidden> DdfPara - Topics ΓòÉΓòÉΓòÉ
  14513.  
  14514. Select an item: 
  14515.  
  14516. Syntax
  14517. Parameters
  14518. Returns
  14519. Errors
  14520. Remarks
  14521. Example Code
  14522. Related Functions
  14523. Glossary
  14524.  
  14525.  
  14526. ΓòÉΓòÉΓòÉ 17.10. DdfSetColor ΓòÉΓòÉΓòÉ
  14527.  
  14528.  
  14529. ΓòÉΓòÉΓòÉ <hidden> DdfSetColor - Syntax ΓòÉΓòÉΓòÉ
  14530.  
  14531. This function sets the background and foreground colors of the displayed text. 
  14532.  
  14533.  
  14534. #define INCL_DDF
  14535. #include <os2.h>
  14536.  
  14537. HDDF     hddf;        /*  Handle to DDF returned by DdfInitialize. */
  14538. COLOR    fBackColor;  /*  Specifies the desired background color. */
  14539. COLOR    fForColor;   /*  Specifies the desired foreground color. */
  14540. BOOL     rc;          /*  Success indicator. */
  14541.  
  14542. rc = DdfSetColor(hddf, fBackColor, fForColor);
  14543.  
  14544.  
  14545. ΓòÉΓòÉΓòÉ <hidden> DdfSetColor Parameter - hddf ΓòÉΓòÉΓòÉ
  14546.  
  14547.  hddf (HDDF) - input 
  14548.     Handle to DDF returned by DdfInitialize. 
  14549.  
  14550.  
  14551. ΓòÉΓòÉΓòÉ <hidden> DdfSetColor Parameter - fBackColor ΓòÉΓòÉΓòÉ
  14552.  
  14553.  fBackColor (COLOR) - input 
  14554.     Specifies the desired background color. 
  14555.  
  14556.  
  14557. ΓòÉΓòÉΓòÉ <hidden> DdfSetColor Parameter - fForColor ΓòÉΓòÉΓòÉ
  14558.  
  14559.  fForColor (COLOR) - input 
  14560.     Specifies the desired foreground color. 
  14561.  
  14562.     The following color value constants may be used for the foreground and 
  14563.     background colors: 
  14564.  
  14565.          CLR_DEFAULT -  used to set IPF default text color 
  14566.          CLR_BLACK 
  14567.          CLR_BLUE 
  14568.          CLR_RED 
  14569.          CLR_PINK 
  14570.          CLR_GREEN 
  14571.          CLR_CYAN 
  14572.          CLR_YELLOW 
  14573.          CLR_BROWN 
  14574.          CLR_DARKGRAY 
  14575.          CLR_DARKBLUE 
  14576.          CLR_DARKRED 
  14577.          CLR_DARKPINK 
  14578.          CLR_DARKGREEN 
  14579.          CLR_DARKCYAN 
  14580.          CLR_PALEGRAY 
  14581.  
  14582.  
  14583. ΓòÉΓòÉΓòÉ <hidden> DdfSetColor Return Value - rc ΓòÉΓòÉΓòÉ
  14584.  
  14585.  rc (BOOL) - returns 
  14586.     Success indicator. 
  14587.  
  14588.     TRUE 
  14589.             Successful completion 
  14590.     FALSE 
  14591.             Error occurred. 
  14592.  
  14593.  
  14594. ΓòÉΓòÉΓòÉ <hidden> DdfSetColor - Parameters ΓòÉΓòÉΓòÉ
  14595.  
  14596.  hddf (HDDF) - input 
  14597.     Handle to DDF returned by DdfInitialize. 
  14598.  
  14599.  fBackColor (COLOR) - input 
  14600.     Specifies the desired background color. 
  14601.  
  14602.  fForColor (COLOR) - input 
  14603.     Specifies the desired foreground color. 
  14604.  
  14605.     The following color value constants may be used for the foreground and 
  14606.     background colors: 
  14607.  
  14608.          CLR_DEFAULT -  used to set IPF default text color 
  14609.          CLR_BLACK 
  14610.          CLR_BLUE 
  14611.          CLR_RED 
  14612.          CLR_PINK 
  14613.          CLR_GREEN 
  14614.          CLR_CYAN 
  14615.          CLR_YELLOW 
  14616.          CLR_BROWN 
  14617.          CLR_DARKGRAY 
  14618.          CLR_DARKBLUE 
  14619.          CLR_DARKRED 
  14620.          CLR_DARKPINK 
  14621.          CLR_DARKGREEN 
  14622.          CLR_DARKCYAN 
  14623.          CLR_PALEGRAY 
  14624.  
  14625.  rc (BOOL) - returns 
  14626.     Success indicator. 
  14627.  
  14628.     TRUE 
  14629.             Successful completion 
  14630.     FALSE 
  14631.             Error occurred. 
  14632.  
  14633.  
  14634. ΓòÉΓòÉΓòÉ <hidden> DdfSetColor - Remarks ΓòÉΓòÉΓòÉ
  14635.  
  14636. There is a 4-byte ESC code overhead in the DDF internal buffer for the 
  14637. foreground color, and a 4-byte overhead for the background color, with this 
  14638. function. 
  14639.  
  14640.  
  14641. ΓòÉΓòÉΓòÉ <hidden> DdfSetColor - Errors ΓòÉΓòÉΓòÉ
  14642.  
  14643. Possible returns from WinGetLastError 
  14644.  
  14645.  HMERR_DDF_MEMORY (0x3001) 
  14646.     Not enough memory is available. 
  14647.  
  14648.  HMERR_DDF_BACKCOLOR (0x3003) 
  14649.     The background color is not valid. 
  14650.  
  14651.  HMERR_DDF_FORECOLOR (0x3004) 
  14652.     The foreground color is not valid. 
  14653.  
  14654.  
  14655. ΓòÉΓòÉΓòÉ <hidden> DdfSetColor - Related Functions ΓòÉΓòÉΓòÉ
  14656.  
  14657.      DdfBeginList 
  14658.      DdfBitmap 
  14659.      DdfEndList 
  14660.      DdfHyperText 
  14661.      DdfInform 
  14662.      DdfInitialize 
  14663.      DdfListItem 
  14664.      DdfMetafile 
  14665.      DdfPara 
  14666.      DdfSetColor 
  14667.      DdfSetFont 
  14668.      DdfSetFontStyle 
  14669.      DdfSetFormat 
  14670.      DdfSetTextAlign 
  14671.      DdfText 
  14672.  
  14673.  
  14674. ΓòÉΓòÉΓòÉ <hidden> DdfSetColor - Example Code ΓòÉΓòÉΓòÉ
  14675.  
  14676. After initializing a DDF buffer with DdfInitialize, the example uses DdfPara to 
  14677. start a new paragraph, DdfSetFont and DdfSetFontStyle to have the text 
  14678. displayed in a large, bold Courier font, DdfSetColor to change the text color, 
  14679. and DdfText to place text in the buffer.  For a more detailed example and 
  14680. discussion of initializing DDF, see the DdfInitialize sample. 
  14681.  
  14682. #define INCL_WINWINDOWMGR       /* General window management    */
  14683. #define INCL_WINMESSAGEMGR      /* Message management           */
  14684. #define INCL_DDF                /* Dynamic Data Facility        */
  14685. #include <os2.h>
  14686. #include <pmhelp.h>
  14687.  
  14688. MRESULT WindowProc( HWND hwnd, ULONG ulMsg, MPARAM mp1, MPARAM mp2 )
  14689. {
  14690.    HWND   hwndParent;
  14691.    HWND   hwndInstance;    /* help instance window                 */
  14692.    HDDF   hDdf;            /* DDF handle                           */
  14693.  
  14694.     switch( ulMsg )
  14695.     {
  14696.     case HM_QUERY_DDF_DATA:
  14697.         /* get the help instance */
  14698.         hwndParent = WinQueryWindow( hwnd, QW_PARENT );
  14699.         hwndParent = WinQueryWindow( hwndParent, QW_PARENT );
  14700.         hwndInstance = (HWND)WinSendMsg( hwndParent, HM_QUERY,
  14701.                                  MPFROMSHORT( HMQW_INSTANCE ), NULL );
  14702.  
  14703.         /* Allocate 1K Buffer (default)  */
  14704.         hDdf = DdfInitialize(
  14705.                     hwndInstance,  /* Handle of help instance */
  14706.                     0L,            /* Default buffer size     */
  14707.                     0L             /* Default increment       */
  14708.                     );
  14709.  
  14710.         if (hDdf == NULLHANDLE)       /* Check return code       */
  14711.         {
  14712.             return (MRESULT)FALSE;
  14713.         }
  14714.  
  14715.         /* create paragraph in DDF buffer */
  14716.         if( !DdfPara( hDdf ) )
  14717.         {
  14718.            return (MRESULT)FALSE;
  14719.         }
  14720.  
  14721.         /* Change to large (100 x 100 dimensions) Courier font */
  14722.         if( !DdfSetFont( hDdf, "Courier", 100L, 100L ) )
  14723.         {
  14724.            return (MRESULT)FALSE;
  14725.         }
  14726.  
  14727.         /* make the font BOLDFACE */
  14728.         if( !DdfSetFontStyle( hDdf, FM_SEL_BOLD ) )
  14729.         {
  14730.            return (MRESULT)FALSE;
  14731.         }
  14732.  
  14733.         /* make the text display as BLUE on a PALE GRAY background */
  14734.         if( !DdfSetColor( hDdf, CLR_PALEGRAY, CLR_BLUE ) )
  14735.         {
  14736.            return (MRESULT)FALSE;
  14737.         }
  14738.  
  14739.         /* Write data into the buffer */
  14740.         if (!DdfText(hDdf, "Sample Text"))
  14741.         {
  14742.            return (MRESULT)FALSE;
  14743.         }
  14744.  
  14745.         return (MRESULT)hDdf;
  14746.     }
  14747.     return WinDefWindowProc( hwnd, ulMsg, mp1, mp2 );
  14748. }
  14749.  
  14750.  
  14751. ΓòÉΓòÉΓòÉ <hidden> DdfSetColor - Topics ΓòÉΓòÉΓòÉ
  14752.  
  14753. Select an item: 
  14754.  
  14755. Syntax
  14756. Parameters
  14757. Returns
  14758. Errors
  14759. Remarks
  14760. Example Code
  14761. Related Functions
  14762. Glossary
  14763.  
  14764.  
  14765. ΓòÉΓòÉΓòÉ 17.11. DdfSetFont ΓòÉΓòÉΓòÉ
  14766.  
  14767.  
  14768. ΓòÉΓòÉΓòÉ <hidden> DdfSetFont - Syntax ΓòÉΓòÉΓòÉ
  14769.  
  14770. This function specifies a text font in the DDF buffer. 
  14771.  
  14772.  
  14773. #define INCL_DDF
  14774. #include <os2.h>
  14775.  
  14776. HDDF     hddf;         /*  Handle to DDF returned by DdfInitialize. */
  14777. PCSZ     pszFaceName;  /*  Pointer to font name. */
  14778. ULONG    ulWidth;      /*  Font width in points. */
  14779. ULONG    ulHeight;     /*  Font height in points. */
  14780. BOOL     rc;           /*  Success indicator. */
  14781.  
  14782. rc = DdfSetFont(hddf, pszFaceName, ulWidth,
  14783.        ulHeight);
  14784.  
  14785.  
  14786. ΓòÉΓòÉΓòÉ <hidden> DdfSetFont Parameter - hddf ΓòÉΓòÉΓòÉ
  14787.  
  14788.  hddf (HDDF) - input 
  14789.     Handle to DDF returned by DdfInitialize. 
  14790.  
  14791.  
  14792. ΓòÉΓòÉΓòÉ <hidden> DdfSetFont Parameter - pszFaceName ΓòÉΓòÉΓòÉ
  14793.  
  14794.  pszFaceName (PCSZ) - input 
  14795.     Pointer to font name. 
  14796.  
  14797.     This parameter can be specified in two ways: 
  14798.  
  14799.         An ASCIIZ string specifying the font name. 
  14800.         NULL or "default" to specify the default font. 
  14801.  
  14802.  
  14803. ΓòÉΓòÉΓòÉ <hidden> DdfSetFont Parameter - ulWidth ΓòÉΓòÉΓòÉ
  14804.  
  14805.  ulWidth (ULONG) - input 
  14806.     Font width in points. 
  14807.  
  14808.     A point is approximately 1/72 of an inch. 
  14809.  
  14810.  
  14811. ΓòÉΓòÉΓòÉ <hidden> DdfSetFont Parameter - ulHeight ΓòÉΓòÉΓòÉ
  14812.  
  14813.  ulHeight (ULONG) - input 
  14814.     Font height in points. 
  14815.  
  14816.  
  14817. ΓòÉΓòÉΓòÉ <hidden> DdfSetFont Return Value - rc ΓòÉΓòÉΓòÉ
  14818.  
  14819.  rc (BOOL) - returns 
  14820.     Success indicator. 
  14821.  
  14822.     TRUE 
  14823.             Successful completion 
  14824.     FALSE 
  14825.             Error occurred. 
  14826.  
  14827.  
  14828. ΓòÉΓòÉΓòÉ <hidden> DdfSetFont - Parameters ΓòÉΓòÉΓòÉ
  14829.  
  14830.  hddf (HDDF) - input 
  14831.     Handle to DDF returned by DdfInitialize. 
  14832.  
  14833.  pszFaceName (PCSZ) - input 
  14834.     Pointer to font name. 
  14835.  
  14836.     This parameter can be specified in two ways: 
  14837.  
  14838.         An ASCIIZ string specifying the font name. 
  14839.         NULL or "default" to specify the default font. 
  14840.  
  14841.  ulWidth (ULONG) - input 
  14842.     Font width in points. 
  14843.  
  14844.     A point is approximately 1/72 of an inch. 
  14845.  
  14846.  ulHeight (ULONG) - input 
  14847.     Font height in points. 
  14848.  
  14849.  rc (BOOL) - returns 
  14850.     Success indicator. 
  14851.  
  14852.     TRUE 
  14853.             Successful completion 
  14854.     FALSE 
  14855.             Error occurred. 
  14856.  
  14857.  
  14858. ΓòÉΓòÉΓòÉ <hidden> DdfSetFont - Errors ΓòÉΓòÉΓòÉ
  14859.  
  14860. Possible returns from WinGetLastError 
  14861.  
  14862.  HMERR_DDF_MEMORY (0x3001) 
  14863.     Not enough memory is available. 
  14864.  
  14865.  
  14866. ΓòÉΓòÉΓòÉ <hidden> DdfSetFont - Related Functions ΓòÉΓòÉΓòÉ
  14867.  
  14868.      DdfBeginList 
  14869.      DdfBitmap 
  14870.      DdfEndList 
  14871.      DdfHyperText 
  14872.      DdfInform 
  14873.      DdfInitialize 
  14874.      DdfListItem 
  14875.      DdfMetafile 
  14876.      DdfPara 
  14877.      DdfSetColor 
  14878.      DdfSetFont 
  14879.      DdfSetFontStyle 
  14880.      DdfSetFormat 
  14881.      DdfSetTextAlign 
  14882.      DdfText 
  14883.  
  14884.  
  14885. ΓòÉΓòÉΓòÉ <hidden> DdfSetFont - Example Code ΓòÉΓòÉΓòÉ
  14886.  
  14887. After initializing a DDF buffer with DdfInitialize, the example uses DdfPara to 
  14888. start a new paragraph, DdfSetFont and DdfSetFontStyle to have the text 
  14889. displayed in a large, bold Courier font, DdfSetColor to change the text color, 
  14890. and DdfText to place text in the buffer.  For a more detailed example and 
  14891. discussion of initializing DDF, see the DdfInitialize sample. 
  14892.  
  14893. #define INCL_WINWINDOWMGR       /* General window management    */
  14894. #define INCL_WINMESSAGEMGR      /* Message management           */
  14895. #define INCL_DDF                /* Dynamic Data Facility        */
  14896. #include <os2.h>
  14897. #include <pmhelp.h>
  14898.  
  14899. MRESULT WindowProc( HWND hwnd, ULONG ulMsg, MPARAM mp1, MPARAM mp2 )
  14900. {
  14901.    HWND   hwndParent;
  14902.    HWND   hwndInstance;    /* help instance window                 */
  14903.    HDDF   hDdf;            /* DDF handle                           */
  14904.  
  14905.     switch( ulMsg )
  14906.     {
  14907.     case HM_QUERY_DDF_DATA:
  14908.         /* get the help instance */
  14909.         hwndParent = WinQueryWindow( hwnd, QW_PARENT );
  14910.         hwndParent = WinQueryWindow( hwndParent, QW_PARENT );
  14911.         hwndInstance = (HWND)WinSendMsg( hwndParent, HM_QUERY,
  14912.                                  MPFROMSHORT( HMQW_INSTANCE ), NULL );
  14913.  
  14914.         /* Allocate 1K Buffer (default)  */
  14915.         hDdf = DdfInitialize(
  14916.                     hwndInstance,  /* Handle of help instance */
  14917.                     0L,            /* Default buffer size     */
  14918.                     0L             /* Default increment       */
  14919.                     );
  14920.  
  14921.         if (hDdf == NULLHANDLE)       /* Check return code       */
  14922.         {
  14923.             return (MRESULT)FALSE;
  14924.         }
  14925.  
  14926.         /* create paragraph in DDF buffer */
  14927.         if( !DdfPara( hDdf ) )
  14928.         {
  14929.            return (MRESULT)FALSE;
  14930.         }
  14931.  
  14932.         /* Change to large (100 x 100 dimensions) Courier font */
  14933.         if( !DdfSetFont( hDdf, "Courier", 100L, 100L ) )
  14934.         {
  14935.            return (MRESULT)FALSE;
  14936.         }
  14937.  
  14938.         /* make the font BOLDFACE */
  14939.         if( !DdfSetFontStyle( hDdf, FM_SEL_BOLD ) )
  14940.         {
  14941.            return (MRESULT)FALSE;
  14942.         }
  14943.  
  14944.         /* make the text display as BLUE on a PALE GRAY background */
  14945.         if( !DdfSetColor( hDdf, CLR_PALEGRAY, CLR_BLUE ) )
  14946.         {
  14947.            return (MRESULT)FALSE;
  14948.         }
  14949.  
  14950.         /* Write data into the buffer */
  14951.         if (!DdfText(hDdf, "Sample Text"))
  14952.         {
  14953.            return (MRESULT)FALSE;
  14954.         }
  14955.  
  14956.         return (MRESULT)hDdf;
  14957.     }
  14958.     return WinDefWindowProc( hwnd, ulMsg, mp1, mp2 );
  14959. }
  14960.  
  14961.  
  14962. ΓòÉΓòÉΓòÉ <hidden> DdfSetFont - Topics ΓòÉΓòÉΓòÉ
  14963.  
  14964. Select an item: 
  14965.  
  14966. Syntax
  14967. Parameters
  14968. Returns
  14969. Errors
  14970. Example Code
  14971. Related Functions
  14972. Glossary
  14973.  
  14974.  
  14975. ΓòÉΓòÉΓòÉ 17.12. DdfSetFontStyle ΓòÉΓòÉΓòÉ
  14976.  
  14977.  
  14978. ΓòÉΓòÉΓòÉ <hidden> DdfSetFontStyle - Syntax ΓòÉΓòÉΓòÉ
  14979.  
  14980. This function specifies a text font style in the DDF buffer. 
  14981.  
  14982.  
  14983. #define INCL_DDF
  14984. #include <os2.h>
  14985.  
  14986. HDDF     hddf;        /*  Handle to DDF returned by DdfInitialize. */
  14987. ULONG    fFontStyle;  /*  Font style flag. */
  14988. BOOL     rc;          /*  Success indicator. */
  14989.  
  14990. rc = DdfSetFontStyle(hddf, fFontStyle);
  14991.  
  14992.  
  14993. ΓòÉΓòÉΓòÉ <hidden> DdfSetFontStyle Parameter - hddf ΓòÉΓòÉΓòÉ
  14994.  
  14995.  hddf (HDDF) - input 
  14996.     Handle to DDF returned by DdfInitialize. 
  14997.  
  14998.  
  14999. ΓòÉΓòÉΓòÉ <hidden> DdfSetFontStyle Parameter - fFontStyle ΓòÉΓòÉΓòÉ
  15000.  
  15001.  fFontStyle (ULONG) - input 
  15002.     Font style flag. 
  15003.  
  15004.     A NULL value for this parameter will set the font-style back to the 
  15005.     default. Any of the following values can be specified: 
  15006.  
  15007.          FM_SEL_ITALIC 
  15008.          FM_SEL_BOLD 
  15009.          FM_SEL_UNDERSCORE 
  15010.  
  15011.     These values can be "ORed" together to combine different font styles. 
  15012.  
  15013.     Note:  There is a 4-byte ESC code overhead in the DDF internal buffer for 
  15014.     fFontStyle. 
  15015.  
  15016.  
  15017. ΓòÉΓòÉΓòÉ <hidden> DdfSetFontStyle Return Value - rc ΓòÉΓòÉΓòÉ
  15018.  
  15019.  rc (BOOL) - returns 
  15020.     Success indicator. 
  15021.  
  15022.     TRUE 
  15023.             Successful completion. 
  15024.     FALSE 
  15025.             Error occurred. 
  15026.  
  15027.  
  15028. ΓòÉΓòÉΓòÉ <hidden> DdfSetFontStyle - Parameters ΓòÉΓòÉΓòÉ
  15029.  
  15030.  hddf (HDDF) - input 
  15031.     Handle to DDF returned by DdfInitialize. 
  15032.  
  15033.  fFontStyle (ULONG) - input 
  15034.     Font style flag. 
  15035.  
  15036.     A NULL value for this parameter will set the font-style back to the 
  15037.     default. Any of the following values can be specified: 
  15038.  
  15039.          FM_SEL_ITALIC 
  15040.          FM_SEL_BOLD 
  15041.          FM_SEL_UNDERSCORE 
  15042.  
  15043.     These values can be "ORed" together to combine different font styles. 
  15044.  
  15045.     Note:  There is a 4-byte ESC code overhead in the DDF internal buffer for 
  15046.     fFontStyle. 
  15047.  
  15048.  rc (BOOL) - returns 
  15049.     Success indicator. 
  15050.  
  15051.     TRUE 
  15052.             Successful completion. 
  15053.     FALSE 
  15054.             Error occurred. 
  15055.  
  15056.  
  15057. ΓòÉΓòÉΓòÉ <hidden> DdfSetFontStyle - Errors ΓòÉΓòÉΓòÉ
  15058.  
  15059. Possible returns from WinGetLastError 
  15060.  
  15061.  HMERR_DDF_MEMORY (0x3001) 
  15062.     Not enough memory is available. 
  15063.  
  15064.  HMERR_DDF_FONTSTYLE (0x3005) 
  15065.     The font style is not valid. 
  15066.  
  15067.  
  15068. ΓòÉΓòÉΓòÉ <hidden> DdfSetFontStyle - Related Functions ΓòÉΓòÉΓòÉ
  15069.  
  15070.      DdfBeginList 
  15071.      DdfBitmap 
  15072.      DdfEndList 
  15073.      DdfHyperText 
  15074.      DdfInform 
  15075.      DdfInitialize 
  15076.      DdfListItem 
  15077.      DdfMetafile 
  15078.      DdfPara 
  15079.      DdfSetColor 
  15080.      DdfSetFont 
  15081.      DdfSetFontStyle 
  15082.      DdfSetFormat 
  15083.      DdfSetTextAlign 
  15084.      DdfText 
  15085.  
  15086.  
  15087. ΓòÉΓòÉΓòÉ <hidden> DdfSetFontStyle - Example Code ΓòÉΓòÉΓòÉ
  15088.  
  15089. After initializing a DDF buffer with DdfInitialize, the example uses DdfPara to 
  15090. start a new paragraph, DdfSetFont and DdfSetFontStyle to have the text 
  15091. displayed in a large, bold Courier font, DdfSetColor to change the text color, 
  15092. and DdfText to place text in the buffer.  For a more detailed example and 
  15093. discussion of initializing DDF, see the DdfInitialize sample. 
  15094.  
  15095. #define INCL_WINWINDOWMGR       /* General window management    */
  15096. #define INCL_WINMESSAGEMGR      /* Message management           */
  15097. #define INCL_DDF                /* Dynamic Data Facility        */
  15098. #include <os2.h>
  15099. #include <pmhelp.h>
  15100.  
  15101. MRESULT WindowProc( HWND hwnd, ULONG ulMsg, MPARAM mp1, MPARAM mp2 )
  15102. {
  15103.    HWND   hwndParent;
  15104.    HWND   hwndInstance;    /* help instance window                 */
  15105.    HDDF   hDdf;            /* DDF handle                           */
  15106.  
  15107.     switch( ulMsg )
  15108.     {
  15109.     case HM_QUERY_DDF_DATA:
  15110.         /* get the help instance */
  15111.         hwndParent = WinQueryWindow( hwnd, QW_PARENT );
  15112.         hwndParent = WinQueryWindow( hwndParent, QW_PARENT );
  15113.         hwndInstance = (HWND)WinSendMsg( hwndParent, HM_QUERY,
  15114.                                  MPFROMSHORT( HMQW_INSTANCE ), NULL );
  15115.  
  15116.         /* Allocate 1K Buffer (default)  */
  15117.         hDdf = DdfInitialize(
  15118.                     hwndInstance,  /* Handle of help instance */
  15119.                     0L,            /* Default buffer size     */
  15120.                     0L             /* Default increment       */
  15121.                     );
  15122.  
  15123.         if (hDdf == NULLHANDLE)       /* Check return code       */
  15124.         {
  15125.             return (MRESULT)FALSE;
  15126.         }
  15127.  
  15128.         /* create paragraph in DDF buffer */
  15129.         if( !DdfPara( hDdf ) )
  15130.         {
  15131.            return (MRESULT)FALSE;
  15132.         }
  15133.  
  15134.         /* Change to large (100 x 100 dimensions) Courier font */
  15135.         if( !DdfSetFont( hDdf, "Courier", 100L, 100L ) )
  15136.         {
  15137.            return (MRESULT)FALSE;
  15138.         }
  15139.  
  15140.         /* make the font BOLDFACE */
  15141.         if( !DdfSetFontStyle( hDdf, FM_SEL_BOLD ) )
  15142.         {
  15143.            return (MRESULT)FALSE;
  15144.         }
  15145.  
  15146.         /* make the text display as BLUE on a PALE GRAY background */
  15147.         if( !DdfSetColor( hDdf, CLR_PALEGRAY, CLR_BLUE ) )
  15148.         {
  15149.            return (MRESULT)FALSE;
  15150.         }
  15151.  
  15152.         /* Write data into the buffer */
  15153.         if (!DdfText(hDdf, "Sample Text"))
  15154.         {
  15155.            return (MRESULT)FALSE;
  15156.         }
  15157.  
  15158.         return (MRESULT)hDdf;
  15159.     }
  15160.     return WinDefWindowProc( hwnd, ulMsg, mp1, mp2 );
  15161. }
  15162.  
  15163.  
  15164. ΓòÉΓòÉΓòÉ <hidden> DdfSetFontStyle - Topics ΓòÉΓòÉΓòÉ
  15165.  
  15166. Select an item: 
  15167.  
  15168. Syntax
  15169. Parameters
  15170. Returns
  15171. Errors
  15172. Example Code
  15173. Related Functions
  15174. Glossary
  15175.  
  15176.  
  15177. ΓòÉΓòÉΓòÉ 17.13. DdfSetFormat ΓòÉΓòÉΓòÉ
  15178.  
  15179.  
  15180. ΓòÉΓòÉΓòÉ <hidden> DdfSetFormat - Syntax ΓòÉΓòÉΓòÉ
  15181.  
  15182. This function is used to turn formatting off or on. It corresponds to the 
  15183. :lines. tag. 
  15184.  
  15185.  
  15186. #define INCL_DDF
  15187. #include <os2.h>
  15188.  
  15189. HDDF     hddf;         /*  Handle to DDF returned by DdfInitialize. */
  15190. ULONG    fFormatType;  /*  Formatting-activation flag. */
  15191. BOOL     rc;           /*  Success indicator. */
  15192.  
  15193. rc = DdfSetFormat(hddf, fFormatType);
  15194.  
  15195.  
  15196. ΓòÉΓòÉΓòÉ <hidden> DdfSetFormat Parameter - hddf ΓòÉΓòÉΓòÉ
  15197.  
  15198.  hddf (HDDF) - input 
  15199.     Handle to DDF returned by DdfInitialize. 
  15200.  
  15201.  
  15202. ΓòÉΓòÉΓòÉ <hidden> DdfSetFormat Parameter - fFormatType ΓòÉΓòÉΓòÉ
  15203.  
  15204.  fFormatType (ULONG) - input 
  15205.     Formatting-activation flag. 
  15206.  
  15207.     Only the following constants may be used in this parameter: 
  15208.  
  15209.     TRUE 
  15210.             Turn formatting on. 
  15211.     FALSE 
  15212.             Turn formatting off. 
  15213.  
  15214.  
  15215. ΓòÉΓòÉΓòÉ <hidden> DdfSetFormat Return Value - rc ΓòÉΓòÉΓòÉ
  15216.  
  15217.  rc (BOOL) - returns 
  15218.     Success indicator. 
  15219.  
  15220.     TRUE 
  15221.             Successful completion 
  15222.     FALSE 
  15223.             Error occurred. 
  15224.  
  15225.  
  15226. ΓòÉΓòÉΓòÉ <hidden> DdfSetFormat - Parameters ΓòÉΓòÉΓòÉ
  15227.  
  15228.  hddf (HDDF) - input 
  15229.     Handle to DDF returned by DdfInitialize. 
  15230.  
  15231.  fFormatType (ULONG) - input 
  15232.     Formatting-activation flag. 
  15233.  
  15234.     Only the following constants may be used in this parameter: 
  15235.  
  15236.     TRUE 
  15237.             Turn formatting on. 
  15238.     FALSE 
  15239.             Turn formatting off. 
  15240.  
  15241.  rc (BOOL) - returns 
  15242.     Success indicator. 
  15243.  
  15244.     TRUE 
  15245.             Successful completion 
  15246.     FALSE 
  15247.             Error occurred. 
  15248.  
  15249.  
  15250. ΓòÉΓòÉΓòÉ <hidden> DdfSetFormat - Remarks ΓòÉΓòÉΓòÉ
  15251.  
  15252. If formatting is ON, there is a 3-byte ESC code overhead in the DDF internal 
  15253. buffer for this function. Otherwise, there is a 4-byte ESC code overhead. 
  15254.  
  15255.  
  15256. ΓòÉΓòÉΓòÉ <hidden> DdfSetFormat - Errors ΓòÉΓòÉΓòÉ
  15257.  
  15258. Possible returns from WinGetLastError 
  15259.  
  15260.  HMERR_DDF_MEMORY (0x3001) 
  15261.     Not enough memory is available. 
  15262.  
  15263.  
  15264. ΓòÉΓòÉΓòÉ <hidden> DdfSetFormat - Related Functions ΓòÉΓòÉΓòÉ
  15265.  
  15266.      DdfBeginList 
  15267.      DdfBitmap 
  15268.      DdfEndList 
  15269.      DdfHyperText 
  15270.      DdfInform 
  15271.      DdfInitialize 
  15272.      DdfListItem 
  15273.      DdfMetafile 
  15274.      DdfPara 
  15275.      DdfSetColor 
  15276.      DdfSetFont 
  15277.      DdfSetFontStyle 
  15278.      DdfSetFormat 
  15279.      DdfSetTextAlign 
  15280.      DdfText 
  15281.  
  15282.  
  15283. ΓòÉΓòÉΓòÉ <hidden> DdfSetFormat - Example Code ΓòÉΓòÉΓòÉ
  15284.  
  15285. After initializing a DDF buffer with DdfInitialize, the example uses 
  15286. DdfSetTextAlign to specify left justified test in the DDF buffer when 
  15287. formatting is OFF. The example then uses DdfSetFormat to turn off formatting 
  15288. for text in the DDF buffer (corresponds to the IPF lines tag). For a more 
  15289. detailed example and discussion of initializing DDF, see the DdfInitialize 
  15290. sample. 
  15291.  
  15292. #define INCL_WINWINDOWMGR       /* General window management    */
  15293. #define INCL_WINMESSAGEMGR      /* Message management           */
  15294. #define INCL_GPIPRIMITIVES      /* Drawing Primitives/Attributes*/
  15295. #define INCL_DDF                /* Dynamic Data Facility        */
  15296. #include <os2.h>
  15297. #include <pmhelp.h>
  15298.  
  15299. MRESULT WindowProc( HWND hwnd, ULONG ulMsg, MPARAM mp1, MPARAM mp2 )
  15300. {
  15301.    HWND   hwndParent;
  15302.    HWND   hwndInstance;    /* help instance window                 */
  15303.    HDDF   hDdf;            /* DDF handle                           */
  15304.  
  15305.     switch( ulMsg )
  15306.     {
  15307.     case HM_QUERY_DDF_DATA:
  15308.         /* get the help instance */
  15309.         hwndParent = WinQueryWindow( hwnd, QW_PARENT );
  15310.         hwndParent = WinQueryWindow( hwndParent, QW_PARENT );
  15311.         hwndInstance = (HWND)WinSendMsg( hwndParent, HM_QUERY,
  15312.                                  MPFROMSHORT( HMQW_INSTANCE ), NULL );
  15313.  
  15314.         /* Allocate 1K Buffer (default)  */
  15315.         hDdf = DdfInitialize(
  15316.                     hwndInstance,  /* Handle of help instance */
  15317.                     0L,            /* Default buffer size     */
  15318.                     0L             /* Default increment       */
  15319.                     );
  15320.  
  15321.         if (hDdf == NULLHANDLE)       /* Check return code       */
  15322.         {
  15323.            return (MRESULT)FALSE;
  15324.         }
  15325.  
  15326.         /* left justify text when formatting is OFF */
  15327.         if (!DdfSetTextAlign(hDdf, TA_LEFT))
  15328.         {
  15329.            return (MRESULT)FALSE;
  15330.         }
  15331.  
  15332.         /* turn formatting OFF */
  15333.         if (!DdfSetFormat(hDdf, FALSE))
  15334.         {
  15335.            return (MRESULT)FALSE;
  15336.         }
  15337.  
  15338.         if (!DdfText(hDdf,
  15339.                 "Format OFF: This text should be Left Aligned!\n"))
  15340.         {
  15341.            return (MRESULT)FALSE;
  15342.         }
  15343.  
  15344.         return (MRESULT)hDdf;
  15345.      }
  15346.      return WinDefWindowProc( hwnd, ulMsg, mp1, mp2 );
  15347. }
  15348.  
  15349.  
  15350. ΓòÉΓòÉΓòÉ <hidden> DdfSetFormat - Topics ΓòÉΓòÉΓòÉ
  15351.  
  15352. Select an item: 
  15353.  
  15354. Syntax
  15355. Parameters
  15356. Returns
  15357. Errors
  15358. Remarks
  15359. Example Code
  15360. Related Functions
  15361. Glossary
  15362.  
  15363.  
  15364. ΓòÉΓòÉΓòÉ 17.14. DdfSetTextAlign ΓòÉΓòÉΓòÉ
  15365.  
  15366.  
  15367. ΓòÉΓòÉΓòÉ <hidden> DdfSetTextAlign - Syntax ΓòÉΓòÉΓòÉ
  15368.  
  15369. This function defines whether left, center, or right text justification is to 
  15370. be used when text formatting is off. 
  15371.  
  15372.  
  15373. #define INCL_DDF
  15374. #include <os2.h>
  15375.  
  15376. HDDF     hddf;    /*  Handle to DDF returned by DdfInitialize. */
  15377. ULONG    fAlign;  /*  Justification flag. */
  15378. BOOL     rc;      /*  Success indicator. */
  15379.  
  15380. rc = DdfSetTextAlign(hddf, fAlign);
  15381.  
  15382.  
  15383. ΓòÉΓòÉΓòÉ <hidden> DdfSetTextAlign Parameter - hddf ΓòÉΓòÉΓòÉ
  15384.  
  15385.  hddf (HDDF) - input 
  15386.     Handle to DDF returned by DdfInitialize. 
  15387.  
  15388.  
  15389. ΓòÉΓòÉΓòÉ <hidden> DdfSetTextAlign Parameter - fAlign ΓòÉΓòÉΓòÉ
  15390.  
  15391.  fAlign (ULONG) - input 
  15392.     Justification flag. 
  15393.  
  15394.     Only the following constants may be used: 
  15395.  
  15396.     TA_LEFT 
  15397.             Left-justify text. 
  15398.     TA_RIGHT 
  15399.             Right-justify text. 
  15400.     TA_CENTER 
  15401.             Center text. 
  15402.  
  15403.  
  15404. ΓòÉΓòÉΓòÉ <hidden> DdfSetTextAlign Return Value - rc ΓòÉΓòÉΓòÉ
  15405.  
  15406.  rc (BOOL) - returns 
  15407.     Success indicator. 
  15408.  
  15409.     TRUE 
  15410.             Successful completion. 
  15411.     FALSE 
  15412.             Error occurred. 
  15413.  
  15414.  
  15415. ΓòÉΓòÉΓòÉ <hidden> DdfSetTextAlign - Parameters ΓòÉΓòÉΓòÉ
  15416.  
  15417.  hddf (HDDF) - input 
  15418.     Handle to DDF returned by DdfInitialize. 
  15419.  
  15420.  fAlign (ULONG) - input 
  15421.     Justification flag. 
  15422.  
  15423.     Only the following constants may be used: 
  15424.  
  15425.     TA_LEFT 
  15426.             Left-justify text. 
  15427.     TA_RIGHT 
  15428.             Right-justify text. 
  15429.     TA_CENTER 
  15430.             Center text. 
  15431.  
  15432.  rc (BOOL) - returns 
  15433.     Success indicator. 
  15434.  
  15435.     TRUE 
  15436.             Successful completion. 
  15437.     FALSE 
  15438.             Error occurred. 
  15439.  
  15440.  
  15441. ΓòÉΓòÉΓòÉ <hidden> DdfSetTextAlign - Remarks ΓòÉΓòÉΓòÉ
  15442.  
  15443. It should be called before DdfSetFormat is called to turn off text formatting, 
  15444. and should not be called again until formatting is turned back on. Note that 
  15445. leading and trailing spaces are not stripped from the text as a result of this 
  15446. alignment. 
  15447.  
  15448.  
  15449. ΓòÉΓòÉΓòÉ <hidden> DdfSetTextAlign - Errors ΓòÉΓòÉΓòÉ
  15450.  
  15451. Possible returns from WinGetLastError 
  15452.  
  15453.  HMERR_DDF_ALIGN_TYPE (0x3002) 
  15454.     The alignment type is not valid. 
  15455.  
  15456.  
  15457. ΓòÉΓòÉΓòÉ <hidden> DdfSetTextAlign - Related Functions ΓòÉΓòÉΓòÉ
  15458.  
  15459.      DdfBeginList 
  15460.      DdfBitmap 
  15461.      DdfEndList 
  15462.      DdfHyperText 
  15463.      DdfInform 
  15464.      DdfInitialize 
  15465.      DdfListItem 
  15466.      DdfMetafile 
  15467.      DdfPara 
  15468.      DdfSetColor 
  15469.      DdfSetFont 
  15470.      DdfSetFontStyle 
  15471.      DdfSetFormat 
  15472.      DdfSetTextAlign 
  15473.      DdfText 
  15474.  
  15475.  
  15476. ΓòÉΓòÉΓòÉ <hidden> DdfSetTextAlign - Example Code ΓòÉΓòÉΓòÉ
  15477.  
  15478. After initializing a DDF buffer with DdfInitialize, the example uses 
  15479. DdfSetTextAlign to specify left justified test in the DDF buffer when 
  15480. formatting is OFF. The example then uses DdfSetFormat to turn off formatting 
  15481. for text in the DDF buffer (corresponds to the IPF lines tag). For a more 
  15482. detailed example and discussion of initializing DDF, see the DdfInitialize 
  15483. sample. 
  15484.  
  15485. #define INCL_WINWINDOWMGR       /* General window management    */
  15486. #define INCL_WINMESSAGEMGR      /* Message management           */
  15487. #define INCL_GPIPRIMITIVES      /* Drawing Primitives/Attributes*/
  15488. #define INCL_DDF                /* Dynamic Data Facility        */
  15489. #include <os2.h>
  15490. #include <pmhelp.h>
  15491.  
  15492. MRESULT WindowProc( HWND hwnd, ULONG ulMsg, MPARAM mp1, MPARAM mp2 )
  15493. {
  15494.    HWND   hwndParent;
  15495.    HWND   hwndInstance;    /* help instance window                 */
  15496.    HDDF   hDdf;            /* DDF handle                           */
  15497.  
  15498.     switch( ulMsg )
  15499.     {
  15500.     case HM_QUERY_DDF_DATA:
  15501.         /* get the help instance */
  15502.         hwndParent = WinQueryWindow( hwnd, QW_PARENT );
  15503.         hwndParent = WinQueryWindow( hwndParent, QW_PARENT );
  15504.         hwndInstance = (HWND)WinSendMsg( hwndParent, HM_QUERY,
  15505.                                  MPFROMSHORT( HMQW_INSTANCE ), NULL );
  15506.  
  15507.         /* Allocate 1K Buffer (default)  */
  15508.         hDdf = DdfInitialize(
  15509.                     hwndInstance,  /* Handle of help instance */
  15510.                     0L,            /* Default buffer size     */
  15511.                     0L             /* Default increment       */
  15512.                     );
  15513.  
  15514.         if (hDdf == NULLHANDLE)       /* Check return code       */
  15515.         {
  15516.            return (MRESULT)FALSE;
  15517.         }
  15518.  
  15519.         /* left justify text when formatting is OFF */
  15520.         if (!DdfSetTextAlign(hDdf, TA_LEFT))
  15521.         {
  15522.            return (MRESULT)FALSE;
  15523.         }
  15524.  
  15525.         /* turn formatting OFF */
  15526.         if (!DdfSetFormat(hDdf, FALSE))
  15527.         {
  15528.            return (MRESULT)FALSE;
  15529.         }
  15530.  
  15531.         if (!DdfText(hDdf,
  15532.                 "Format OFF: This text should be Left Aligned!\n"))
  15533.         {
  15534.            return (MRESULT)FALSE;
  15535.         }
  15536.  
  15537.         return (MRESULT)hDdf;
  15538.      }
  15539.      return WinDefWindowProc( hwnd, ulMsg, mp1, mp2 );
  15540. }
  15541.  
  15542.  
  15543. ΓòÉΓòÉΓòÉ <hidden> DdfSetTextAlign - Topics ΓòÉΓòÉΓòÉ
  15544.  
  15545. Select an item: 
  15546.  
  15547. Syntax
  15548. Parameters
  15549. Returns
  15550. Errors
  15551. Remarks
  15552. Example Code
  15553. Related Functions
  15554. Glossary
  15555.  
  15556.  
  15557. ΓòÉΓòÉΓòÉ 17.15. DdfText ΓòÉΓòÉΓòÉ
  15558.  
  15559.  
  15560. ΓòÉΓòÉΓòÉ <hidden> DdfText - Syntax ΓòÉΓòÉΓòÉ
  15561.  
  15562. This function adds text to the DDF buffer. 
  15563.  
  15564.  
  15565. #define INCL_DDF
  15566. #include <os2.h>
  15567.  
  15568. HDDF    hddf;     /*  Handle to DDF returned by DdfInitialize. */
  15569. PCSZ    pszText;  /*  Pointer to the text buffer to be formatted. */
  15570. BOOL    rc;       /*  Success indicator. */
  15571.  
  15572. rc = DdfText(hddf, pszText);
  15573.  
  15574.  
  15575. ΓòÉΓòÉΓòÉ <hidden> DdfText Parameter - hddf ΓòÉΓòÉΓòÉ
  15576.  
  15577.  hddf (HDDF) - input 
  15578.     Handle to DDF returned by DdfInitialize. 
  15579.  
  15580.  
  15581. ΓòÉΓòÉΓòÉ <hidden> DdfText Parameter - pszText ΓòÉΓòÉΓòÉ
  15582.  
  15583.  pszText (PCSZ) - input 
  15584.     Pointer to the text buffer to be formatted. 
  15585.  
  15586.     Note:  There is a 3-byte ESC code overhead in the DDF internal buffer for 
  15587.            each word in the text buffer. There is a 1-byte ESC code overhead 
  15588.            for each blank and for each newline character. 
  15589.  
  15590.  
  15591. ΓòÉΓòÉΓòÉ <hidden> DdfText Return Value - rc ΓòÉΓòÉΓòÉ
  15592.  
  15593.  rc (BOOL) - returns 
  15594.     Success indicator. 
  15595.  
  15596.     TRUE 
  15597.             Successful completion. 
  15598.     FALSE 
  15599.             Error occurred. 
  15600.  
  15601.  
  15602. ΓòÉΓòÉΓòÉ <hidden> DdfText - Parameters ΓòÉΓòÉΓòÉ
  15603.  
  15604.  hddf (HDDF) - input 
  15605.     Handle to DDF returned by DdfInitialize. 
  15606.  
  15607.  pszText (PCSZ) - input 
  15608.     Pointer to the text buffer to be formatted. 
  15609.  
  15610.     Note:  There is a 3-byte ESC code overhead in the DDF internal buffer for 
  15611.            each word in the text buffer. There is a 1-byte ESC code overhead 
  15612.            for each blank and for each newline character. 
  15613.  
  15614.  rc (BOOL) - returns 
  15615.     Success indicator. 
  15616.  
  15617.     TRUE 
  15618.             Successful completion. 
  15619.     FALSE 
  15620.             Error occurred. 
  15621.  
  15622.  
  15623. ΓòÉΓòÉΓòÉ <hidden> DdfText - Related Functions ΓòÉΓòÉΓòÉ
  15624.  
  15625.      DdfBeginList 
  15626.      DdfBitmap 
  15627.      DdfEndList 
  15628.      DdfHyperText 
  15629.      DdfInform 
  15630.      DdfInitialize 
  15631.      DdfListItem 
  15632.      DdfMetafile 
  15633.      DdfPara 
  15634.      DdfSetColor 
  15635.      DdfSetFont 
  15636.      DdfSetFontStyle 
  15637.      DdfSetFormat 
  15638.      DdfSetTextAlign 
  15639.      DdfText 
  15640.  
  15641.  
  15642. ΓòÉΓòÉΓòÉ <hidden> DdfText - Example Code ΓòÉΓòÉΓòÉ
  15643.  
  15644. After initializing a DDF buffer with DdfInitialize, the example uses DdfPara to 
  15645. start a new paragraph, DdfSetFont and DdfSetFontStyle to have the text 
  15646. displayed in a large, bold Courier font, DdfSetColor to change the text color, 
  15647. and DdfText to place text in the buffer.  For a more detailed example and 
  15648. discussion of initializing DDF, see the DdfInitialize sample. 
  15649.  
  15650. #define INCL_WINWINDOWMGR       /* General window management    */
  15651. #define INCL_WINMESSAGEMGR      /* Message management           */
  15652. #define INCL_DDF                /* Dynamic Data Facility        */
  15653. #include <os2.h>
  15654. #include <pmhelp.h>
  15655.  
  15656. MRESULT WindowProc( HWND hwnd, ULONG ulMsg, MPARAM mp1, MPARAM mp2 )
  15657. {
  15658.    HWND   hwndParent;
  15659.    HWND   hwndInstance;    /* help instance window                 */
  15660.    HDDF   hDdf;            /* DDF handle                           */
  15661.  
  15662.     switch( ulMsg )
  15663.     {
  15664.     case HM_QUERY_DDF_DATA:
  15665.         /* get the help instance */
  15666.         hwndParent = WinQueryWindow( hwnd, QW_PARENT );
  15667.         hwndParent = WinQueryWindow( hwndParent, QW_PARENT );
  15668.         hwndInstance = (HWND)WinSendMsg( hwndParent, HM_QUERY,
  15669.                                  MPFROMSHORT( HMQW_INSTANCE ), NULL );
  15670.  
  15671.         /* Allocate 1K Buffer (default)  */
  15672.         hDdf = DdfInitialize(
  15673.                     hwndInstance,  /* Handle of help instance */
  15674.                     0L,            /* Default buffer size     */
  15675.                     0L             /* Default increment       */
  15676.                     );
  15677.  
  15678.         if (hDdf == NULLHANDLE)       /* Check return code       */
  15679.         {
  15680.             return (MRESULT)FALSE;
  15681.         }
  15682.  
  15683.         /* create paragraph in DDF buffer */
  15684.         if( !DdfPara( hDdf ) )
  15685.         {
  15686.            return (MRESULT)FALSE;
  15687.         }
  15688.  
  15689.         /* Change to large (100 x 100 dimensions) Courier font */
  15690.         if( !DdfSetFont( hDdf, "Courier", 100L, 100L ) )
  15691.         {
  15692.            return (MRESULT)FALSE;
  15693.         }
  15694.  
  15695.         /* make the font BOLDFACE */
  15696.         if( !DdfSetFontStyle( hDdf, FM_SEL_BOLD ) )
  15697.         {
  15698.            return (MRESULT)FALSE;
  15699.         }
  15700.  
  15701.         /* make the text display as BLUE on a PALE GRAY background */
  15702.         if( !DdfSetColor( hDdf, CLR_PALEGRAY, CLR_BLUE ) )
  15703.         {
  15704.            return (MRESULT)FALSE;
  15705.         }
  15706.  
  15707.         /* Write data into the buffer */
  15708.         if (!DdfText(hDdf, "Sample Text"))
  15709.         {
  15710.            return (MRESULT)FALSE;
  15711.         }
  15712.  
  15713.         return (MRESULT)hDdf;
  15714.     }
  15715.     return WinDefWindowProc( hwnd, ulMsg, mp1, mp2 );
  15716. }
  15717.  
  15718.  
  15719. ΓòÉΓòÉΓòÉ <hidden> DdfText - Topics ΓòÉΓòÉΓòÉ
  15720.  
  15721. Select an item: 
  15722.  
  15723. Syntax
  15724. Parameters
  15725. Returns
  15726. Example Code
  15727. Related Functions
  15728. Glossary
  15729.  
  15730.  
  15731. ΓòÉΓòÉΓòÉ 18. Help Manager Messages ΓòÉΓòÉΓòÉ
  15732.  
  15733. The following is a summary of the messages sent by IPF and the application in 
  15734. response to user help requests. 
  15735.  
  15736.  HM_ACTIONBAR_COMMAND 
  15737.      This message is sent by IPF and notifies the application that a user has 
  15738.      selected a tailored menu bar item. 
  15739.  
  15740.  HM_CONTROL 
  15741.      This message is sent to the application or the communication object by IPF 
  15742.      prior to the addition of a push button in the control area of a window. 
  15743.  
  15744.  HM_CREATE_HELP_TABLE 
  15745.      This message is sent by the application and informs IPF to use the new 
  15746.      help table indicated by this address in memory. 
  15747.  
  15748.  HM_DISMISS_WINDOW 
  15749.      This message is sent by the application and informs IPF to remove the 
  15750.      active help window. 
  15751.  
  15752.  HM_DISPLAY_HELP 
  15753.      This message is sent by the application and informs IPF to display a 
  15754.      specific help window. 
  15755.  
  15756.  HM_ERROR 
  15757.      This message notifies the application of an error caused by user 
  15758.      interaction. 
  15759.  
  15760.  HM_EXT_HELP 
  15761.      This message is sent by the application and informs IPF to display the 
  15762.      extended help window for the active application window. 
  15763.  
  15764.  HM_EXT_HELP_UNDEFINED 
  15765.      This message is sent by IPF and notifies the application that an extended 
  15766.      help window has not been defined. 
  15767.  
  15768.  HM_GENERAL_HELP 
  15769.      This message is sent by the application and informs IPF to display the 
  15770.      general help window for the active application window. 
  15771.  
  15772.  HM_GENERAL_HELP_UNDEFINED 
  15773.      This message is sent by IPF and notifies the application that a general 
  15774.      help window has not been defined. 
  15775.  
  15776.  HM_HELP_CONTENTS 
  15777.      This message is sent by the application and informs IPF to display the 
  15778.      Contents window. 
  15779.  
  15780.  HM_HELP_INDEX 
  15781.      This message is sent by the application and informs IPF to display the 
  15782.      help index window. 
  15783.  
  15784.  HM_HELPSUBITEM_NOT_FOUND 
  15785.      This message is sent by IPF and notifies the application that a user has 
  15786.      requested help on a field but that IPF cannot find a related entry in the 
  15787.      help subtable. 
  15788.  
  15789.  HM_INFORM 
  15790.      This message is sent by IPF and notifies the application that a user has 
  15791.      selected a hypertext field that was specified with the reftype=inform 
  15792.      attribute of the :link. tag. 
  15793.  
  15794.  HM_INVALIDATE_DDF_DATA 
  15795.      This message is sent by the application and informs IPF that previous 
  15796.      dynamic data formatting (DDF) information is no longer valid. 
  15797.  
  15798.  HM_KEYS_HELP 
  15799.      This message is sent by the application and informs IPF to display the 
  15800.      keys help window. 
  15801.  
  15802.  HM_LOAD_HELP_TABLE 
  15803.      This message is sent by the application and provides IPF with the module 
  15804.      handle that contains the help table, the help subtable, and the identity 
  15805.      of the help table. 
  15806.  
  15807.  HM_NOTIFY 
  15808.      This message is sent by IPF and notifies the application or communication 
  15809.      object that an event has occurred that the application may be interested 
  15810.      in controlling. 
  15811.  
  15812.  HM_QUERY 
  15813.      This message is sent by the application and notifies IPF that the 
  15814.      application requires IPF-specific information. 
  15815.  
  15816.  HM_QUERY_DDF_DATA 
  15817.      This message is sent by IPF and notifies the communication object that IPF 
  15818.      has encountered the dynamic data formatting tag (:ddf.). 
  15819.  
  15820.  HM_QUERY_KEYS_HELP 
  15821.      This message is sent by IPF and notifies the application that a user has 
  15822.      requested keys help for a function. 
  15823.  
  15824.  HM_REPLACE_HELP_FOR_HELP 
  15825.      This message is sent by the application and informs IPF to display the 
  15826.      application-defined Help for Help window instead of the IPF Help for Help 
  15827.      window. 
  15828.  
  15829.  HM_REPLACE_USING_HELP 
  15830.      This message is sent by the application and informs IPF to display the 
  15831.      application-defined Using help window instead of the IPF Using help 
  15832.      window. 
  15833.  
  15834.  HM_SET_ACTIVE_WINDOW 
  15835.      This message is sent by the application and enables the application to 
  15836.      change the active application window with which the IPF help window is 
  15837.      associated. 
  15838.  
  15839.  HM_SET_COVERPAGE_SIZE 
  15840.      This message is sent by the application and informs IPF to set the size of 
  15841.      the coverpage window (the window within which all other IPF windows are 
  15842.      displayed). 
  15843.  
  15844.  HM_SET_HELP_LIBRARY_NAME 
  15845.      This message is sent by the application and informs IPF to replace the 
  15846.      list of help libraries specified in the initialization structure with a 
  15847.      new list. 
  15848.  
  15849.  HM_SET_HELP_WINDOW_TITLE 
  15850.      This message is sent by the application and informs IPF to change the text 
  15851.      of a help window title. 
  15852.  
  15853.  HM_SET_OBJCOM_WINDOW 
  15854.      This message is sent by the application and informs IPF to identify the 
  15855.      communication object to which the HM_INFORM and HM_QUERY_DDF_DATA messages 
  15856.      are sent. 
  15857.  
  15858.  HM_SET_SHOW_PANEL_ID 
  15859.      This message is sent by the application and informs IPF to display or hide 
  15860.      window IDs for each help window. 
  15861.  
  15862.  HM_SET_USERDATA 
  15863.      This message is sent by the application and informs IPF to store data in 
  15864.      the IPF data area. 
  15865.  
  15866.  HM_TUTORIAL 
  15867.      This message is sent by IPF and notifies the application when the user 
  15868.      selects Tutorial choice from the Help menu bar. 
  15869.  
  15870.  HM_UPDATE_OBJCOM_WINDOW_CHAIN 
  15871.      This message is sent to the currently active communication object by the 
  15872.      communication object who wants to withdraw from the communication chain. 
  15873.  
  15874.  A detailed description of the parameters and returns for these messages 
  15875.  follows. 
  15876.  
  15877.  
  15878. ΓòÉΓòÉΓòÉ 18.1. HM_ACTIONBAR_COMMAND ΓòÉΓòÉΓòÉ
  15879.  
  15880.  
  15881. ΓòÉΓòÉΓòÉ <hidden> HM_ACTIONBAR_COMMAND - Syntax ΓòÉΓòÉΓòÉ
  15882.  
  15883. This message is sent to the current active application window by the Help 
  15884. Manager to notify the application when the user selects a tailored action bar 
  15885. item. 
  15886.  
  15887.  
  15888. param1
  15889.     USHORT  idCommand   /*  Identity of the action bar item that was selected. */
  15890.  
  15891. param2
  15892.     ULONG   ulReserved  /*  Reserved value, should be 0. */
  15893.  
  15894. returns
  15895.     ULONG   ulReserved  /*  Reserved value, should be 0. */
  15896.  
  15897.  
  15898. ΓòÉΓòÉΓòÉ <hidden> HM_ACTIONBAR_COMMAND Field - idCommand ΓòÉΓòÉΓòÉ
  15899.  
  15900.  idCommand (USHORT) 
  15901.     Identity of the action bar item that was selected. 
  15902.  
  15903.  
  15904. ΓòÉΓòÉΓòÉ <hidden> HM_ACTIONBAR_COMMAND Field - ulReserved ΓòÉΓòÉΓòÉ
  15905.  
  15906.  ulReserved (ULONG) 
  15907.     Reserved value, should be 0. 
  15908.  
  15909.  
  15910. ΓòÉΓòÉΓòÉ <hidden> HM_ACTIONBAR_COMMAND Return Value - ulReserved ΓòÉΓòÉΓòÉ
  15911.  
  15912.  ulReserved (ULONG) 
  15913.     Reserved value, should be 0. 
  15914.  
  15915.  
  15916. ΓòÉΓòÉΓòÉ <hidden> HM_ACTIONBAR_COMMAND - Parameters ΓòÉΓòÉΓòÉ
  15917.  
  15918.  idCommand (USHORT) 
  15919.     Identity of the action bar item that was selected. 
  15920.  
  15921.  ulReserved (ULONG) 
  15922.     Reserved value, should be 0. 
  15923.  
  15924.  ulReserved (ULONG) 
  15925.     Reserved value, should be 0. 
  15926.  
  15927.  
  15928. ΓòÉΓòÉΓòÉ <hidden> HM_ACTIONBAR_COMMAND - Default Processing ΓòÉΓòÉΓòÉ
  15929.  
  15930. None. 
  15931.  
  15932.  
  15933. ΓòÉΓòÉΓòÉ <hidden> HM_ACTIONBAR_COMMAND - Topics ΓòÉΓòÉΓòÉ
  15934.  
  15935. Select an item: 
  15936.  
  15937. Syntax
  15938. Parameters
  15939. Returns
  15940. Default Processing
  15941. Glossary
  15942.  
  15943.  
  15944. ΓòÉΓòÉΓòÉ 18.2. HM_CONTROL ΓòÉΓòÉΓòÉ
  15945.  
  15946.  
  15947. ΓòÉΓòÉΓòÉ <hidden> HM_CONTROL - Syntax ΓòÉΓòÉΓòÉ
  15948.  
  15949. This message is sent by the Help Manager to the child of the coverpage window 
  15950. to add a control in the control area of a window. 
  15951.  
  15952.  
  15953. param1
  15954.     USHORT  usReserve   /*  Reserved value. */
  15955.     USHORT  controlres  /*  Res number of the control that was selected. */
  15956.  
  15957. param2
  15958.     ULONG   ulReserved  /*  Reserved value. */
  15959.  
  15960. returns
  15961.     ULONG   ulReserved  /*  Reserved value, should be 0. */
  15962.  
  15963.  
  15964. ΓòÉΓòÉΓòÉ <hidden> HM_CONTROL Field - usReserve ΓòÉΓòÉΓòÉ
  15965.  
  15966.  usReserve (USHORT) 
  15967.     Reserved value. 
  15968.  
  15969.  
  15970. ΓòÉΓòÉΓòÉ <hidden> HM_CONTROL Field - controlres ΓòÉΓòÉΓòÉ
  15971.  
  15972.  controlres (USHORT) 
  15973.     Res number of the control that was selected. 
  15974.  
  15975.     For author-defined push buttons, this is the res identification number that 
  15976.     was specified with the push button tag (:pbutton.).  For default push 
  15977.     buttons, this is the res identification number defined in the PMHELP.H 
  15978.     file. 
  15979.  
  15980.  
  15981. ΓòÉΓòÉΓòÉ <hidden> HM_CONTROL Field - ulReserved ΓòÉΓòÉΓòÉ
  15982.  
  15983.  ulReserved (ULONG) 
  15984.     Reserved value. 
  15985.  
  15986.  
  15987. ΓòÉΓòÉΓòÉ <hidden> HM_CONTROL Return Value - ulReserved ΓòÉΓòÉΓòÉ
  15988.  
  15989.  ulReserved (ULONG) 
  15990.     Reserved value, should be 0. 
  15991.  
  15992.  
  15993. ΓòÉΓòÉΓòÉ <hidden> HM_CONTROL - Parameters ΓòÉΓòÉΓòÉ
  15994.  
  15995.  usReserve (USHORT) 
  15996.     Reserved value. 
  15997.  
  15998.  controlres (USHORT) 
  15999.     Res number of the control that was selected. 
  16000.  
  16001.     For author-defined push buttons, this is the res identification number that 
  16002.     was specified with the push button tag (:pbutton.).  For default push 
  16003.     buttons, this is the res identification number defined in the PMHELP.H 
  16004.     file. 
  16005.  
  16006.  ulReserved (ULONG) 
  16007.     Reserved value. 
  16008.  
  16009.  ulReserved (ULONG) 
  16010.     Reserved value, should be 0. 
  16011.  
  16012.  
  16013. ΓòÉΓòÉΓòÉ <hidden> HM_CONTROL - Remarks ΓòÉΓòÉΓòÉ
  16014.  
  16015. If an application wants to filter any of the controls, it can subclass the 
  16016. child of the coverpage window and intercept this message.  If the application 
  16017. does not intercept this message, the Help Manager adds the control to the 
  16018. control area. 
  16019.  
  16020.  
  16021. ΓòÉΓòÉΓòÉ <hidden> HM_CONTROL - Default Processing ΓòÉΓòÉΓòÉ
  16022.  
  16023. None. 
  16024.  
  16025.  
  16026. ΓòÉΓòÉΓòÉ <hidden> HM_CONTROL - Topics ΓòÉΓòÉΓòÉ
  16027.  
  16028. Select an item: 
  16029.  
  16030. Syntax
  16031. Parameters
  16032. Returns
  16033. Remarks
  16034. Default Processing
  16035. Glossary
  16036.  
  16037.  
  16038. ΓòÉΓòÉΓòÉ 18.3. HM_CREATE_HELP_TABLE ΓòÉΓòÉΓòÉ
  16039.  
  16040.  
  16041. ΓòÉΓòÉΓòÉ <hidden> HM_CREATE_HELP_TABLE - Syntax ΓòÉΓòÉΓòÉ
  16042.  
  16043. This message is sent by the application to give the Help Manager a new help 
  16044. table. 
  16045.  
  16046.  
  16047. param1
  16048.     PHELPTABLE  pHELPTABLE  /*  Help table. */
  16049.  
  16050. param2
  16051.     ULONG       ulReserved  /*  Reserved value, should be 0. */
  16052.  
  16053. returns
  16054.     ULONG       rc          /*  Return code. */
  16055.  
  16056.  
  16057. ΓòÉΓòÉΓòÉ <hidden> HM_CREATE_HELP_TABLE Field - pHELPTABLE ΓòÉΓòÉΓòÉ
  16058.  
  16059.  pHELPTABLE (PHELPTABLE) 
  16060.     Help table. 
  16061.  
  16062.     This points to a help table structure; see HELPTABLE. 
  16063.  
  16064.  
  16065. ΓòÉΓòÉΓòÉ <hidden> HM_CREATE_HELP_TABLE Field - ulReserved ΓòÉΓòÉΓòÉ
  16066.  
  16067.  ulReserved (ULONG) 
  16068.     Reserved value, should be 0. 
  16069.  
  16070.  
  16071. ΓòÉΓòÉΓòÉ <hidden> HM_CREATE_HELP_TABLE Return Value - rc ΓòÉΓòÉΓòÉ
  16072.  
  16073.  rc (ULONG) 
  16074.     Return code. 
  16075.  
  16076.     0 
  16077.             The procedure was successfully completed 
  16078.     Other 
  16079.             See the values of the ulErrorCode parameter of the HM_ERROR 
  16080.             message. 
  16081.  
  16082.  
  16083. ΓòÉΓòÉΓòÉ <hidden> HM_CREATE_HELP_TABLE - Parameters ΓòÉΓòÉΓòÉ
  16084.  
  16085.  pHELPTABLE (PHELPTABLE) 
  16086.     Help table. 
  16087.  
  16088.     This points to a help table structure; see HELPTABLE. 
  16089.  
  16090.  ulReserved (ULONG) 
  16091.     Reserved value, should be 0. 
  16092.  
  16093.  rc (ULONG) 
  16094.     Return code. 
  16095.  
  16096.     0 
  16097.             The procedure was successfully completed 
  16098.     Other 
  16099.             See the values of the ulErrorCode parameter of the HM_ERROR 
  16100.             message. 
  16101.  
  16102.  
  16103. ΓòÉΓòÉΓòÉ <hidden> HM_CREATE_HELP_TABLE - Default Processing ΓòÉΓòÉΓòÉ
  16104.  
  16105. None. 
  16106.  
  16107.  
  16108. ΓòÉΓòÉΓòÉ <hidden> HM_CREATE_HELP_TABLE - Topics ΓòÉΓòÉΓòÉ
  16109.  
  16110. Select an item: 
  16111.  
  16112. Syntax
  16113. Parameters
  16114. Returns
  16115. Default Processing
  16116. Glossary
  16117.  
  16118.  
  16119. ΓòÉΓòÉΓòÉ 18.4. HM_DISMISS_WINDOW ΓòÉΓòÉΓòÉ
  16120.  
  16121.  
  16122. ΓòÉΓòÉΓòÉ <hidden> HM_DISMISS_WINDOW - Syntax ΓòÉΓòÉΓòÉ
  16123.  
  16124. This message tells the Help Manager to remove the active help window. 
  16125.  
  16126.  
  16127. param1
  16128.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  16129.  
  16130. param2
  16131.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  16132.  
  16133. returns
  16134.     ULONG  rc          /*  Return code. */
  16135.  
  16136.  
  16137. ΓòÉΓòÉΓòÉ <hidden> HM_DISMISS_WINDOW Field - ulReserved ΓòÉΓòÉΓòÉ
  16138.  
  16139.  ulReserved (ULONG) 
  16140.     Reserved value, should be 0. 
  16141.  
  16142.  
  16143. ΓòÉΓòÉΓòÉ <hidden> HM_DISMISS_WINDOW Field - ulReserved ΓòÉΓòÉΓòÉ
  16144.  
  16145.  ulReserved (ULONG) 
  16146.     Reserved value, should be 0. 
  16147.  
  16148.  
  16149. ΓòÉΓòÉΓòÉ <hidden> HM_DISMISS_WINDOW Return Value - rc ΓòÉΓòÉΓòÉ
  16150.  
  16151.  rc (ULONG) 
  16152.     Return code. 
  16153.  
  16154.     0 
  16155.             The help window was successfully removed 
  16156.     Other 
  16157.             There was no associated help window. 
  16158.  
  16159.             See also the values of the ulErrorCode parameter of the HM_ERROR 
  16160.             message. 
  16161.  
  16162.  
  16163. ΓòÉΓòÉΓòÉ <hidden> HM_DISMISS_WINDOW - Parameters ΓòÉΓòÉΓòÉ
  16164.  
  16165.  ulReserved (ULONG) 
  16166.     Reserved value, should be 0. 
  16167.  
  16168.  ulReserved (ULONG) 
  16169.     Reserved value, should be 0. 
  16170.  
  16171.  rc (ULONG) 
  16172.     Return code. 
  16173.  
  16174.     0 
  16175.             The help window was successfully removed 
  16176.     Other 
  16177.             There was no associated help window. 
  16178.  
  16179.             See also the values of the ulErrorCode parameter of the HM_ERROR 
  16180.             message. 
  16181.  
  16182.  
  16183. ΓòÉΓòÉΓòÉ <hidden> HM_DISMISS_WINDOW - Remarks ΓòÉΓòÉΓòÉ
  16184.  
  16185. If the user requests help from a primary or secondary window, and then 
  16186. interacts with the primary or secondary window without leaving help, the 
  16187. currently displayed help window might not be appropriate for the application 
  16188. window. This message gives the application the ability to remove that help 
  16189. window. 
  16190.  
  16191.  
  16192. ΓòÉΓòÉΓòÉ <hidden> HM_DISMISS_WINDOW - Default Processing ΓòÉΓòÉΓòÉ
  16193.  
  16194. None. 
  16195.  
  16196.  
  16197. ΓòÉΓòÉΓòÉ <hidden> HM_DISMISS_WINDOW - Topics ΓòÉΓòÉΓòÉ
  16198.  
  16199. Select an item: 
  16200.  
  16201. Syntax
  16202. Parameters
  16203. Returns
  16204. Remarks
  16205. Default Processing
  16206. Glossary
  16207.  
  16208.  
  16209. ΓòÉΓòÉΓòÉ 18.5. HM_DISPLAY_HELP ΓòÉΓòÉΓòÉ
  16210.  
  16211.  
  16212. ΓòÉΓòÉΓòÉ <hidden> HM_DISPLAY_HELP - Syntax ΓòÉΓòÉΓòÉ
  16213.  
  16214. This message tells the Help Manager to display a specific help window. 
  16215.  
  16216.  
  16217. param1
  16218.     USHORT  idHelpPanelId     /*  Identity of the help window. */
  16219.     PSZ     pszHelpPanelName  /*  Name of the help window. */
  16220.  
  16221. param2
  16222.     USHORT  usTypeFlag        /*  Flag indicating how to interpret the first parameter. */
  16223.  
  16224. returns
  16225.     ULONG   rc                /*  Return code. */
  16226.  
  16227.  
  16228. ΓòÉΓòÉΓòÉ <hidden> HM_DISPLAY_HELP Field - idHelpPanelId ΓòÉΓòÉΓòÉ
  16229.  
  16230.  idHelpPanelId (USHORT) 
  16231.     Identity of the help window. 
  16232.  
  16233.     This points to a USHORT data type. 
  16234.  
  16235.  For a value of the usTypeFlag parameter of HM_PANELNAME. 
  16236.  
  16237.  
  16238. ΓòÉΓòÉΓòÉ <hidden> HM_DISPLAY_HELP Field - pszHelpPanelName ΓòÉΓòÉΓòÉ
  16239.  
  16240.  pszHelpPanelName (PSZ) 
  16241.     Name of the help window. 
  16242.  
  16243.     This points to a string containing the name of the help window. 
  16244.  
  16245.  
  16246. ΓòÉΓòÉΓòÉ <hidden> HM_DISPLAY_HELP Field - usTypeFlag ΓòÉΓòÉΓòÉ
  16247.  
  16248.  usTypeFlag (USHORT) 
  16249.     Flag indicating how to interpret the first parameter. 
  16250.  
  16251.     HM_RESOURCEID 
  16252.             Indicates the param1 points to the identity of the help window. 
  16253.  
  16254.     HM_PANELNAME 
  16255.             Indicates the param1 points to the name of the help window. 
  16256.  
  16257.  
  16258. ΓòÉΓòÉΓòÉ <hidden> HM_DISPLAY_HELP Return Value - rc ΓòÉΓòÉΓòÉ
  16259.  
  16260.  rc (ULONG) 
  16261.     Return code. 
  16262.  
  16263.     0 
  16264.             The window was successfully displayed 
  16265.     Other 
  16266.             See the values of the ulErrorCode parameter of the HM_ERROR 
  16267.             message. 
  16268.  
  16269.  
  16270. ΓòÉΓòÉΓòÉ <hidden> HM_DISPLAY_HELP - Parameters ΓòÉΓòÉΓòÉ
  16271.  
  16272.  idHelpPanelId (USHORT) 
  16273.     Identity of the help window. 
  16274.  
  16275.     This points to a USHORT data type. 
  16276.  
  16277.  For a value of the usTypeFlag parameter of HM_PANELNAME. 
  16278.  
  16279.  pszHelpPanelName (PSZ) 
  16280.     Name of the help window. 
  16281.  
  16282.     This points to a string containing the name of the help window. 
  16283.  
  16284.  usTypeFlag (USHORT) 
  16285.     Flag indicating how to interpret the first parameter. 
  16286.  
  16287.     HM_RESOURCEID 
  16288.             Indicates the param1 points to the identity of the help window. 
  16289.  
  16290.     HM_PANELNAME 
  16291.             Indicates the param1 points to the name of the help window. 
  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 - Remarks ΓòÉΓòÉΓòÉ
  16304.  
  16305. param1 depends on the value of the usTypeFlag parameter. 
  16306.  
  16307.  
  16308. ΓòÉΓòÉΓòÉ <hidden> HM_DISPLAY_HELP - Default Processing ΓòÉΓòÉΓòÉ
  16309.  
  16310. None. 
  16311.  
  16312.  
  16313. ΓòÉΓòÉΓòÉ <hidden> HM_DISPLAY_HELP - Topics ΓòÉΓòÉΓòÉ
  16314.  
  16315. Select an item: 
  16316.  
  16317. Syntax
  16318. Parameters
  16319. Returns
  16320. Remarks
  16321. Default Processing
  16322. Glossary
  16323.  
  16324.  
  16325. ΓòÉΓòÉΓòÉ 18.6. HM_ERROR ΓòÉΓòÉΓòÉ
  16326.  
  16327.  
  16328. ΓòÉΓòÉΓòÉ <hidden> HM_ERROR - Syntax ΓòÉΓòÉΓòÉ
  16329.  
  16330. This message notifies the application of an error caused by a user interaction. 
  16331.  
  16332.  
  16333. param1
  16334.     ULONG  ulErrorCode  /*  Error code. */
  16335.  
  16336. param2
  16337.     ULONG  ulReserved   /*  Reserved value, should be 0. */
  16338.  
  16339. returns
  16340.     ULONG  ulReserved   /*  Reserved value, should be 0. */
  16341.  
  16342.  
  16343. ΓòÉΓòÉΓòÉ <hidden> HM_ERROR Field - ulErrorCode ΓòÉΓòÉΓòÉ
  16344.  
  16345.  ulErrorCode (ULONG) 
  16346.     Error code. 
  16347.  
  16348.     A constant describing the type of error that occurred. The application can 
  16349.     also receive some of these error constants in the ulReserved parameter of 
  16350.     messages it has sent to the Help Manager. 
  16351.  
  16352.     The error constants are: 
  16353.  
  16354.     HMERR_LOAD_DLL 
  16355.              The resource DLL was unable to be loaded. 
  16356.  
  16357.     HMERR_NO_FRAME_WND_IN_CHAIN 
  16358.              There is no frame window in the window chain from which to find or 
  16359.              set the associated help instance. 
  16360.  
  16361.     HMERR_INVALID_ASSOC_APP_WND 
  16362.              The application window handle specified on the 
  16363.              WinAssociateHelpInstance function is not a valid window handle. 
  16364.  
  16365.     HMERR_INVALID_ASSOC_HELP_INST 
  16366.              The help instance handle specified on the WinAssociateHelpInstance 
  16367.              function is not a valid window handle. 
  16368.  
  16369.     HMERR_INVALID_DESTROY_HELP_INST 
  16370.              The window handle specified as the help instance to destroy is not 
  16371.              of the help instance class. 
  16372.  
  16373.     HMERR_NO_HELP_INST_IN_CHAIN 
  16374.              The parent or owner chain of the application window specified does 
  16375.              not have an associated help instance. 
  16376.  
  16377.     HMERR_INVALID_HELP_INSTANCE_HDL 
  16378.              The handle specified to be a help instance does not have the class 
  16379.              name of a Help Manager instance. 
  16380.  
  16381.     HMERR_INVALID_QUERY_APP_WND 
  16382.              The application window specified on a WinQueryHelpInstance 
  16383.              function is not a valid window handle. 
  16384.  
  16385.     HMERR_HELP_INST_CALLED_INVALID 
  16386.              The handle of the instance specified on a call to the Help Manager 
  16387.              does not have the class name of a Help Manager instance. 
  16388.  
  16389.     HMERR_HELPTABLE_UNDEFINE 
  16390.              The application did not provide a help table for context-sensitive 
  16391.              help. 
  16392.  
  16393.     HMERR_HELP_INSTANCE_UNDEFINE 
  16394.              The help instance handle specified is invalid. 
  16395.  
  16396.     HMERR_HELPITEM_NOT_FOUND 
  16397.              Context-sensitive help was requested but the ID of the main help 
  16398.              item specified was not found in the help table. 
  16399.  
  16400.     HMERR_INVALID_HELPSUBITEM_SIZE 
  16401.              The help subtable item size is less than 2. 
  16402.  
  16403.     HMERR_HELPSUBITEM_NOT_FOUND 
  16404.              Context-sensitive help was requested but the ID of the help item 
  16405.              specified was not found in the help subtable. 
  16406.  
  16407.     HMERR_INDEX_NOT_FOUND 
  16408.              The index is not in the library file. 
  16409.  
  16410.     HMERR_CONTENT_NOT_FOUND 
  16411.              The library file does not have any content. 
  16412.  
  16413.     HMERR_OPEN_LIB_FILE 
  16414.              The library file cannot be opened. 
  16415.  
  16416.     HMERR_READ_LIB_FILE 
  16417.              The library file cannot be read. 
  16418.  
  16419.     HMERR_CLOSE_LIB_FILE 
  16420.              The library file cannot be closed. 
  16421.  
  16422.     HMERR_INVALID_LIB_FILE 
  16423.              Improper library file provided. 
  16424.  
  16425.     HMERR_NO_MEMORY 
  16426.              Unable to allocate the requested amount of memory. 
  16427.  
  16428.     HMERR_ALLOCATE_SEGMENT 
  16429.              Unable to allocate a segment of memory for memory allocation 
  16430.              requests from the Help Manager. 
  16431.  
  16432.     HMERR_FREE_MEMORY 
  16433.              Unable to free allocated memory. 
  16434.  
  16435.     HMERR_PANEL_NOT_FOUND 
  16436.              Unable to find the requested help window. 
  16437.  
  16438.     HMERR_DATABASE_NOT_OPEN 
  16439.              Unable to read the unopened database. 
  16440.  
  16441.  
  16442. ΓòÉΓòÉΓòÉ <hidden> HM_ERROR Field - ulReserved ΓòÉΓòÉΓòÉ
  16443.  
  16444.  ulReserved (ULONG) 
  16445.     Reserved value, should be 0. 
  16446.  
  16447.  
  16448. ΓòÉΓòÉΓòÉ <hidden> HM_ERROR Return Value - ulReserved ΓòÉΓòÉΓòÉ
  16449.  
  16450.  ulReserved (ULONG) 
  16451.     Reserved value, should be 0. 
  16452.  
  16453.  
  16454. ΓòÉΓòÉΓòÉ <hidden> HM_ERROR - Parameters ΓòÉΓòÉΓòÉ
  16455.  
  16456.  ulErrorCode (ULONG) 
  16457.     Error code. 
  16458.  
  16459.     A constant describing the type of error that occurred. The application can 
  16460.     also receive some of these error constants in the ulReserved parameter of 
  16461.     messages it has sent to the Help Manager. 
  16462.  
  16463.     The error constants are: 
  16464.  
  16465.     HMERR_LOAD_DLL 
  16466.              The resource DLL was unable to be loaded. 
  16467.  
  16468.     HMERR_NO_FRAME_WND_IN_CHAIN 
  16469.              There is no frame window in the window chain from which to find or 
  16470.              set the associated help instance. 
  16471.  
  16472.     HMERR_INVALID_ASSOC_APP_WND 
  16473.              The application window handle specified on the 
  16474.              WinAssociateHelpInstance function is not a valid window handle. 
  16475.  
  16476.     HMERR_INVALID_ASSOC_HELP_INST 
  16477.              The help instance handle specified on the WinAssociateHelpInstance 
  16478.              function is not a valid window handle. 
  16479.  
  16480.     HMERR_INVALID_DESTROY_HELP_INST 
  16481.              The window handle specified as the help instance to destroy is not 
  16482.              of the help instance class. 
  16483.  
  16484.     HMERR_NO_HELP_INST_IN_CHAIN 
  16485.              The parent or owner chain of the application window specified does 
  16486.              not have an associated help instance. 
  16487.  
  16488.     HMERR_INVALID_HELP_INSTANCE_HDL 
  16489.              The handle specified to be a help instance does not have the class 
  16490.              name of a Help Manager instance. 
  16491.  
  16492.     HMERR_INVALID_QUERY_APP_WND 
  16493.              The application window specified on a WinQueryHelpInstance 
  16494.              function is not a valid window handle. 
  16495.  
  16496.     HMERR_HELP_INST_CALLED_INVALID 
  16497.              The handle of the instance specified on a call to the Help Manager 
  16498.              does not have the class name of a Help Manager instance. 
  16499.  
  16500.     HMERR_HELPTABLE_UNDEFINE 
  16501.              The application did not provide a help table for context-sensitive 
  16502.              help. 
  16503.  
  16504.     HMERR_HELP_INSTANCE_UNDEFINE 
  16505.              The help instance handle specified is invalid. 
  16506.  
  16507.     HMERR_HELPITEM_NOT_FOUND 
  16508.              Context-sensitive help was requested but the ID of the main help 
  16509.              item specified was not found in the help table. 
  16510.  
  16511.     HMERR_INVALID_HELPSUBITEM_SIZE 
  16512.              The help subtable item size is less than 2. 
  16513.  
  16514.     HMERR_HELPSUBITEM_NOT_FOUND 
  16515.              Context-sensitive help was requested but the ID of the help item 
  16516.              specified was not found in the help subtable. 
  16517.  
  16518.     HMERR_INDEX_NOT_FOUND 
  16519.              The index is not in the library file. 
  16520.  
  16521.     HMERR_CONTENT_NOT_FOUND 
  16522.              The library file does not have any content. 
  16523.  
  16524.     HMERR_OPEN_LIB_FILE 
  16525.              The library file cannot be opened. 
  16526.  
  16527.     HMERR_READ_LIB_FILE 
  16528.              The library file cannot be read. 
  16529.  
  16530.     HMERR_CLOSE_LIB_FILE 
  16531.              The library file cannot be closed. 
  16532.  
  16533.     HMERR_INVALID_LIB_FILE 
  16534.              Improper library file provided. 
  16535.  
  16536.     HMERR_NO_MEMORY 
  16537.              Unable to allocate the requested amount of memory. 
  16538.  
  16539.     HMERR_ALLOCATE_SEGMENT 
  16540.              Unable to allocate a segment of memory for memory allocation 
  16541.              requests from the Help Manager. 
  16542.  
  16543.     HMERR_FREE_MEMORY 
  16544.              Unable to free allocated memory. 
  16545.  
  16546.     HMERR_PANEL_NOT_FOUND 
  16547.              Unable to find the requested help window. 
  16548.  
  16549.     HMERR_DATABASE_NOT_OPEN 
  16550.              Unable to read the unopened database. 
  16551.  
  16552.  ulReserved (ULONG) 
  16553.     Reserved value, should be 0. 
  16554.  
  16555.  ulReserved (ULONG) 
  16556.     Reserved value, should be 0. 
  16557.  
  16558.  
  16559. ΓòÉΓòÉΓòÉ <hidden> HM_ERROR - Remarks ΓòÉΓòÉΓòÉ
  16560.  
  16561. There is no other way to communicate the error to the application since the 
  16562. user initiated communication, not the application. Other errors which occur 
  16563. when the application sends a message to the Help Manager are returned as the 
  16564. ulReserved parameter of the message. 
  16565.  
  16566. The Help Manager does not display any error messages to the user. Instead, the 
  16567. Help Manager sends or returns all error notifications to the application so 
  16568. that it can display its own messages. This procedure ensures a consistent 
  16569. message interface for all user messages. 
  16570.  
  16571.  
  16572. ΓòÉΓòÉΓòÉ <hidden> HM_ERROR - Default Processing ΓòÉΓòÉΓòÉ
  16573.  
  16574. None. 
  16575.  
  16576.  
  16577. ΓòÉΓòÉΓòÉ <hidden> HM_ERROR - Topics ΓòÉΓòÉΓòÉ
  16578.  
  16579. Select an item: 
  16580.  
  16581. Syntax
  16582. Parameters
  16583. Returns
  16584. Remarks
  16585. Default Processing
  16586. Glossary
  16587.  
  16588.  
  16589. ΓòÉΓòÉΓòÉ 18.7. HM_EXT_HELP ΓòÉΓòÉΓòÉ
  16590.  
  16591.  
  16592. ΓòÉΓòÉΓòÉ <hidden> HM_EXT_HELP - Syntax ΓòÉΓòÉΓòÉ
  16593.  
  16594. When the Help Manager receives this message, it displays the extended help 
  16595. window for the active application panel. 
  16596.  
  16597.  
  16598. param1
  16599.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  16600.  
  16601. param2
  16602.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  16603.  
  16604. returns
  16605.     ULONG  rc          /*  Return code. */
  16606.  
  16607.  
  16608. ΓòÉΓòÉΓòÉ <hidden> HM_EXT_HELP Field - ulReserved ΓòÉΓòÉΓòÉ
  16609.  
  16610.  ulReserved (ULONG) 
  16611.     Reserved value, should be 0. 
  16612.  
  16613.  
  16614. ΓòÉΓòÉΓòÉ <hidden> HM_EXT_HELP Field - ulReserved ΓòÉΓòÉΓòÉ
  16615.  
  16616.  ulReserved (ULONG) 
  16617.     Reserved value, should be 0. 
  16618.  
  16619.  
  16620. ΓòÉΓòÉΓòÉ <hidden> HM_EXT_HELP Return Value - rc ΓòÉΓòÉΓòÉ
  16621.  
  16622.  rc (ULONG) 
  16623.     Return code. 
  16624.  
  16625.     0 
  16626.             The extended help window was successfully displayed 
  16627.     Other 
  16628.             See the values of the ulErrorCode parameter of the HM_ERROR 
  16629.             message. 
  16630.  
  16631.  
  16632. ΓòÉΓòÉΓòÉ <hidden> HM_EXT_HELP - Parameters ΓòÉΓòÉΓòÉ
  16633.  
  16634.  ulReserved (ULONG) 
  16635.     Reserved value, should be 0. 
  16636.  
  16637.  ulReserved (ULONG) 
  16638.     Reserved value, should be 0. 
  16639.  
  16640.  rc (ULONG) 
  16641.     Return code. 
  16642.  
  16643.     0 
  16644.             The extended help window was successfully displayed 
  16645.     Other 
  16646.             See the values of the ulErrorCode parameter of the HM_ERROR 
  16647.             message. 
  16648.  
  16649.  
  16650. ΓòÉΓòÉΓòÉ <hidden> HM_EXT_HELP - Default Processing ΓòÉΓòÉΓòÉ
  16651.  
  16652. None. 
  16653.  
  16654.  
  16655. ΓòÉΓòÉΓòÉ <hidden> HM_EXT_HELP - Topics ΓòÉΓòÉΓòÉ
  16656.  
  16657. Select an item: 
  16658.  
  16659. Syntax
  16660. Parameters
  16661. Returns
  16662. Default Processing
  16663. Glossary
  16664.  
  16665.  
  16666. ΓòÉΓòÉΓòÉ 18.8. HM_EXT_HELP_UNDEFINED ΓòÉΓòÉΓòÉ
  16667.  
  16668.  
  16669. ΓòÉΓòÉΓòÉ <hidden> HM_EXT_HELP_UNDEFINED - Syntax ΓòÉΓòÉΓòÉ
  16670.  
  16671. This message is sent to the application by the Help Manager to notify it that 
  16672. an extended help window has not been defined. 
  16673.  
  16674.  
  16675. param1
  16676.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  16677.  
  16678. param2
  16679.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  16680.  
  16681. returns
  16682.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  16683.  
  16684.  
  16685. ΓòÉΓòÉΓòÉ <hidden> HM_EXT_HELP_UNDEFINED Field - ulReserved ΓòÉΓòÉΓòÉ
  16686.  
  16687.  ulReserved (ULONG) 
  16688.     Reserved value, should be 0. 
  16689.  
  16690.  
  16691. ΓòÉΓòÉΓòÉ <hidden> HM_EXT_HELP_UNDEFINED Field - ulReserved ΓòÉΓòÉΓòÉ
  16692.  
  16693.  ulReserved (ULONG) 
  16694.     Reserved value, should be 0. 
  16695.  
  16696.  
  16697. ΓòÉΓòÉΓòÉ <hidden> HM_EXT_HELP_UNDEFINED Return Value - ulReserved ΓòÉΓòÉΓòÉ
  16698.  
  16699.  ulReserved (ULONG) 
  16700.     Reserved value, should be 0. 
  16701.  
  16702.  
  16703. ΓòÉΓòÉΓòÉ <hidden> HM_EXT_HELP_UNDEFINED - Parameters ΓòÉΓòÉΓòÉ
  16704.  
  16705.  ulReserved (ULONG) 
  16706.     Reserved value, should be 0. 
  16707.  
  16708.  ulReserved (ULONG) 
  16709.     Reserved value, should be 0. 
  16710.  
  16711.  ulReserved (ULONG) 
  16712.     Reserved value, should be 0. 
  16713.  
  16714.  
  16715. ΓòÉΓòÉΓòÉ <hidden> HM_EXT_HELP_UNDEFINED - Remarks ΓòÉΓòÉΓòÉ
  16716.  
  16717. When the extended help window is requested, the Help Manager searches the help 
  16718. table for its identity. If the extended help window identity associated with 
  16719. the current active window is zero, the Help Manager sends this message to the 
  16720. application to notify it that an extended help window has not been defined. The 
  16721. application then can: 
  16722.  
  16723.      Ignore the request for help and not display a help window. 
  16724.  
  16725.      Display its own window. 
  16726.  
  16727.      Use the HM_DISPLAY_HELP message to tell the Help Manager to display a 
  16728.       particular window. 
  16729.  
  16730.  
  16731. ΓòÉΓòÉΓòÉ <hidden> HM_EXT_HELP_UNDEFINED - Default Processing ΓòÉΓòÉΓòÉ
  16732.  
  16733. None. 
  16734.  
  16735.  
  16736. ΓòÉΓòÉΓòÉ <hidden> HM_EXT_HELP_UNDEFINED - Topics ΓòÉΓòÉΓòÉ
  16737.  
  16738. Select an item: 
  16739.  
  16740. Syntax
  16741. Parameters
  16742. Returns
  16743. Remarks
  16744. Default Processing
  16745. Glossary
  16746.  
  16747.  
  16748. ΓòÉΓòÉΓòÉ 18.9. HM_GENERAL_HELP ΓòÉΓòÉΓòÉ
  16749.  
  16750.  
  16751. ΓòÉΓòÉΓòÉ <hidden> HM_GENERAL_HELP - Syntax ΓòÉΓòÉΓòÉ
  16752.  
  16753. When the Help Manager receives this message, it displays the general help 
  16754. window for the active application window. 
  16755.  
  16756.  
  16757. param1
  16758.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  16759.  
  16760. param2
  16761.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  16762.  
  16763. returns
  16764.     ULONG  rc          /*  Return code. */
  16765.  
  16766.  
  16767. ΓòÉΓòÉΓòÉ <hidden> HM_GENERAL_HELP Field - ulReserved ΓòÉΓòÉΓòÉ
  16768.  
  16769.  ulReserved (ULONG) 
  16770.     Reserved value, should be 0. 
  16771.  
  16772.  
  16773. ΓòÉΓòÉΓòÉ <hidden> HM_GENERAL_HELP Field - ulReserved ΓòÉΓòÉΓòÉ
  16774.  
  16775.  ulReserved (ULONG) 
  16776.     Reserved value, should be 0. 
  16777.  
  16778.  
  16779. ΓòÉΓòÉΓòÉ <hidden> HM_GENERAL_HELP Return Value - rc ΓòÉΓòÉΓòÉ
  16780.  
  16781.  rc (ULONG) 
  16782.     Return code. 
  16783.  
  16784.     0 
  16785.             The general help window was successfully displayed. 
  16786.     Other 
  16787.             See the values of the ulErrorCode parameter of the HM_ERROR 
  16788.             message. 
  16789.  
  16790.  
  16791. ΓòÉΓòÉΓòÉ <hidden> HM_GENERAL_HELP - Parameters ΓòÉΓòÉΓòÉ
  16792.  
  16793.  ulReserved (ULONG) 
  16794.     Reserved value, should be 0. 
  16795.  
  16796.  ulReserved (ULONG) 
  16797.     Reserved value, should be 0. 
  16798.  
  16799.  rc (ULONG) 
  16800.     Return code. 
  16801.  
  16802.     0 
  16803.             The general help window was successfully displayed. 
  16804.     Other 
  16805.             See the values of the ulErrorCode parameter of the HM_ERROR 
  16806.             message. 
  16807.  
  16808.  
  16809. ΓòÉΓòÉΓòÉ <hidden> HM_GENERAL_HELP - Default Processing ΓòÉΓòÉΓòÉ
  16810.  
  16811. None. 
  16812.  
  16813.  
  16814. ΓòÉΓòÉΓòÉ <hidden> HM_GENERAL_HELP - Topics ΓòÉΓòÉΓòÉ
  16815.  
  16816. Select an item: 
  16817.  
  16818. Syntax
  16819. Parameters
  16820. Returns
  16821. Default Processing
  16822. Glossary
  16823.  
  16824.  
  16825. ΓòÉΓòÉΓòÉ 18.10. HM_GENERAL_HELP_UNDEFINED ΓòÉΓòÉΓòÉ
  16826.  
  16827.  
  16828. ΓòÉΓòÉΓòÉ <hidden> HM_GENERAL_HELP_UNDEFINED - Syntax ΓòÉΓòÉΓòÉ
  16829.  
  16830. This message is sent to the application by the Help Manager to notify it that a 
  16831. general help window has not been defined. 
  16832.  
  16833.  
  16834. param1
  16835.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  16836.  
  16837. param2
  16838.     ULONG  ulReserved  /*  Reserved. */
  16839.  
  16840. returns
  16841.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  16842.  
  16843.  
  16844. ΓòÉΓòÉΓòÉ <hidden> HM_GENERAL_HELP_UNDEFINED Field - ulReserved ΓòÉΓòÉΓòÉ
  16845.  
  16846.  ulReserved (ULONG) 
  16847.     Reserved value, should be 0. 
  16848.  
  16849.  
  16850. ΓòÉΓòÉΓòÉ <hidden> HM_GENERAL_HELP_UNDEFINED Field - ulReserved ΓòÉΓòÉΓòÉ
  16851.  
  16852.  ulReserved (ULONG) 
  16853.     Reserved. 
  16854.  
  16855.     0 
  16856.             Reserved value, 0. 
  16857.  
  16858.  
  16859. ΓòÉΓòÉΓòÉ <hidden> HM_GENERAL_HELP_UNDEFINED Return Value - ulReserved ΓòÉΓòÉΓòÉ
  16860.  
  16861.  ulReserved (ULONG) 
  16862.     Reserved value, should be 0. 
  16863.  
  16864.  
  16865. ΓòÉΓòÉΓòÉ <hidden> HM_GENERAL_HELP_UNDEFINED - Parameters ΓòÉΓòÉΓòÉ
  16866.  
  16867.  ulReserved (ULONG) 
  16868.     Reserved value, should be 0. 
  16869.  
  16870.  ulReserved (ULONG) 
  16871.     Reserved. 
  16872.  
  16873.     0 
  16874.             Reserved value, 0. 
  16875.  
  16876.  ulReserved (ULONG) 
  16877.     Reserved value, should be 0. 
  16878.  
  16879.  
  16880. ΓòÉΓòÉΓòÉ <hidden> HM_GENERAL_HELP_UNDEFINED - Remarks ΓòÉΓòÉΓòÉ
  16881.  
  16882. When the general help window is requested, the Help Manager searches the help 
  16883. table for its identity. If the general help window identity associated with the 
  16884. current active window is zero, the Help Manager sends this message to the 
  16885. application to notify it that a general help window has not been defined. The 
  16886. application can then: 
  16887.  
  16888.      Ignore the request for help and not display a help window. 
  16889.  
  16890.      Display its own window. 
  16891.  
  16892.      Use the HM_DISPLAY_HELP message to tell the Help Manager to display a 
  16893.       particular window. 
  16894.  
  16895.  
  16896. ΓòÉΓòÉΓòÉ <hidden> HM_GENERAL_HELP_UNDEFINED - Default Processing ΓòÉΓòÉΓòÉ
  16897.  
  16898. None. 
  16899.  
  16900.  
  16901. ΓòÉΓòÉΓòÉ <hidden> HM_GENERAL_HELP_UNDEFINED - Topics ΓòÉΓòÉΓòÉ
  16902.  
  16903. Select an item: 
  16904.  
  16905. Syntax
  16906. Parameters
  16907. Returns
  16908. Remarks
  16909. Default Processing
  16910. Glossary
  16911.  
  16912.  
  16913. ΓòÉΓòÉΓòÉ 18.11. HM_HELP_CONTENTS ΓòÉΓòÉΓòÉ
  16914.  
  16915.  
  16916. ΓòÉΓòÉΓòÉ <hidden> HM_HELP_CONTENTS - Syntax ΓòÉΓòÉΓòÉ
  16917.  
  16918. When the Help Manager receives this message, it displays the help contents 
  16919. window. 
  16920.  
  16921.  
  16922. param1
  16923.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  16924.  
  16925. param2
  16926.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  16927.  
  16928. returns
  16929.     ULONG  rc          /*  Return code. */
  16930.  
  16931.  
  16932. ΓòÉΓòÉΓòÉ <hidden> HM_HELP_CONTENTS Field - ulReserved ΓòÉΓòÉΓòÉ
  16933.  
  16934.  ulReserved (ULONG) 
  16935.     Reserved value, should be 0. 
  16936.  
  16937.  
  16938. ΓòÉΓòÉΓòÉ <hidden> HM_HELP_CONTENTS Field - ulReserved ΓòÉΓòÉΓòÉ
  16939.  
  16940.  ulReserved (ULONG) 
  16941.     Reserved value, should be 0. 
  16942.  
  16943.  
  16944. ΓòÉΓòÉΓòÉ <hidden> HM_HELP_CONTENTS Return Value - rc ΓòÉΓòÉΓòÉ
  16945.  
  16946.  rc (ULONG) 
  16947.     Return code. 
  16948.  
  16949.     0 
  16950.             The help contents window was successfully displayed. 
  16951.     Other 
  16952.             See the values of the ulErrorCode parameter of the HM_ERROR 
  16953.             message. 
  16954.  
  16955.  
  16956. ΓòÉΓòÉΓòÉ <hidden> HM_HELP_CONTENTS - Parameters ΓòÉΓòÉΓòÉ
  16957.  
  16958.  ulReserved (ULONG) 
  16959.     Reserved value, should be 0. 
  16960.  
  16961.  ulReserved (ULONG) 
  16962.     Reserved value, should be 0. 
  16963.  
  16964.  rc (ULONG) 
  16965.     Return code. 
  16966.  
  16967.     0 
  16968.             The help contents window was successfully displayed. 
  16969.     Other 
  16970.             See the values of the ulErrorCode parameter of the HM_ERROR 
  16971.             message. 
  16972.  
  16973.  
  16974. ΓòÉΓòÉΓòÉ <hidden> HM_HELP_CONTENTS - Default Processing ΓòÉΓòÉΓòÉ
  16975.  
  16976. None. 
  16977.  
  16978.  
  16979. ΓòÉΓòÉΓòÉ <hidden> HM_HELP_CONTENTS - Topics ΓòÉΓòÉΓòÉ
  16980.  
  16981. Select an item: 
  16982.  
  16983. Syntax
  16984. Parameters
  16985. Returns
  16986. Default Processing
  16987. Glossary
  16988.  
  16989.  
  16990. ΓòÉΓòÉΓòÉ 18.12. HM_HELP_INDEX ΓòÉΓòÉΓòÉ
  16991.  
  16992.  
  16993. ΓòÉΓòÉΓòÉ <hidden> HM_HELP_INDEX - Syntax ΓòÉΓòÉΓòÉ
  16994.  
  16995. When the Help Manager receives this message, it displays the help index window. 
  16996.  
  16997.  
  16998. param1
  16999.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  17000.  
  17001. param2
  17002.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  17003.  
  17004. returns
  17005.     ULONG  rc          /*  Return code. */
  17006.  
  17007.  
  17008. ΓòÉΓòÉΓòÉ <hidden> HM_HELP_INDEX Field - ulReserved ΓòÉΓòÉΓòÉ
  17009.  
  17010.  ulReserved (ULONG) 
  17011.     Reserved value, should be 0. 
  17012.  
  17013.  
  17014. ΓòÉΓòÉΓòÉ <hidden> HM_HELP_INDEX Field - ulReserved ΓòÉΓòÉΓòÉ
  17015.  
  17016.  ulReserved (ULONG) 
  17017.     Reserved value, should be 0. 
  17018.  
  17019.  
  17020. ΓòÉΓòÉΓòÉ <hidden> HM_HELP_INDEX Return Value - rc ΓòÉΓòÉΓòÉ
  17021.  
  17022.  rc (ULONG) 
  17023.     Return code. 
  17024.  
  17025.     0 
  17026.             The help index window was successfully displayed. 
  17027.     Other 
  17028.             See the values of the ulErrorCode parameter of the HM_ERROR 
  17029.             message. 
  17030.  
  17031.  
  17032. ΓòÉΓòÉΓòÉ <hidden> HM_HELP_INDEX - Parameters ΓòÉΓòÉΓòÉ
  17033.  
  17034.  ulReserved (ULONG) 
  17035.     Reserved value, should be 0. 
  17036.  
  17037.  ulReserved (ULONG) 
  17038.     Reserved value, should be 0. 
  17039.  
  17040.  rc (ULONG) 
  17041.     Return code. 
  17042.  
  17043.     0 
  17044.             The help index window was successfully displayed. 
  17045.     Other 
  17046.             See the values of the ulErrorCode parameter of the HM_ERROR 
  17047.             message. 
  17048.  
  17049.  
  17050. ΓòÉΓòÉΓòÉ <hidden> HM_HELP_INDEX - Default Processing ΓòÉΓòÉΓòÉ
  17051.  
  17052. None. 
  17053.  
  17054.  
  17055. ΓòÉΓòÉΓòÉ <hidden> HM_HELP_INDEX - Topics ΓòÉΓòÉΓòÉ
  17056.  
  17057. Select an item: 
  17058.  
  17059. Syntax
  17060. Parameters
  17061. Returns
  17062. Default Processing
  17063. Glossary
  17064.  
  17065.  
  17066. ΓòÉΓòÉΓòÉ 18.13. HM_HELPSUBITEM_NOT_FOUND ΓòÉΓòÉΓòÉ
  17067.  
  17068.  
  17069. ΓòÉΓòÉΓòÉ <hidden> HM_HELPSUBITEM_NOT_FOUND - Syntax ΓòÉΓòÉΓòÉ
  17070.  
  17071. The Help Manager sends this message to the application when the user requests 
  17072. help on a field and it cannot find a related entry in the help subtable. 
  17073.  
  17074.  
  17075. param1
  17076.     USHORT  usContext  /*  Type of window on which help was requested. */
  17077.  
  17078. param2
  17079.     SHORT   sTopic     /*  Topic identifier. */
  17080.     SHORT   sSubTopic  /*  Subtopic identifier. */
  17081.  
  17082. returns
  17083.     BOOL    rc         /*  Action indicator. */
  17084.  
  17085.  
  17086. ΓòÉΓòÉΓòÉ <hidden> HM_HELPSUBITEM_NOT_FOUND Field - usContext ΓòÉΓòÉΓòÉ
  17087.  
  17088.  usContext (USHORT) 
  17089.     Type of window on which help was requested. 
  17090.  
  17091.     HLPM_WINDOW            An application window 
  17092.     HLPM_FRAME             A frame window 
  17093.     HLPM_MENU              A menu window. 
  17094.  
  17095.  
  17096. ΓòÉΓòÉΓòÉ <hidden> HM_HELPSUBITEM_NOT_FOUND Field - sTopic ΓòÉΓòÉΓòÉ
  17097.  
  17098.  sTopic (SHORT) 
  17099.     Topic identifier. 
  17100.  
  17101.     For a value of the usContext parameter of HLPM_WINDOW or HLPM_FRAME: 
  17102.  
  17103.     window 
  17104.             Identity of the window containing the field on which help was 
  17105.             requested. 
  17106.     menu 
  17107.             Identity of the submenu containing the field on which help was 
  17108.             requested. 
  17109.  
  17110.  
  17111. ΓòÉΓòÉΓòÉ <hidden> HM_HELPSUBITEM_NOT_FOUND Field - sSubTopic ΓòÉΓòÉΓòÉ
  17112.  
  17113.  sSubTopic (SHORT) 
  17114.     Subtopic identifier. 
  17115.  
  17116.     For a value of the usContext parameter of HLPM_WINDOW or HLPM_FRAME: 
  17117.  
  17118.     control        Control identity of the cursored field and on which help was 
  17119.                    requested. 
  17120.  
  17121.     For a value of the usContext parameter of HLPM_MENU: 
  17122.  
  17123.     -1             No menu item was selected 
  17124.  
  17125.     other          Menu item identity of the currently selected submenu item on 
  17126.                    which help was requested. 
  17127.  
  17128.  
  17129. ΓòÉΓòÉΓòÉ <hidden> HM_HELPSUBITEM_NOT_FOUND Return Value - rc ΓòÉΓòÉΓòÉ
  17130.  
  17131.  rc (BOOL) 
  17132.     Action indicator. 
  17133.  
  17134.  
  17135. ΓòÉΓòÉΓòÉ <hidden> HM_HELPSUBITEM_NOT_FOUND - Parameters ΓòÉΓòÉΓòÉ
  17136.  
  17137.  usContext (USHORT) 
  17138.     Type of window on which help was requested. 
  17139.  
  17140.     HLPM_WINDOW            An application window 
  17141.     HLPM_FRAME             A frame window 
  17142.     HLPM_MENU              A menu window. 
  17143.  
  17144.  sTopic (SHORT) 
  17145.     Topic identifier. 
  17146.  
  17147.     For a value of the usContext parameter of HLPM_WINDOW or HLPM_FRAME: 
  17148.  
  17149.     window 
  17150.             Identity of the window containing the field on which help was 
  17151.             requested. 
  17152.     menu 
  17153.             Identity of the submenu containing the field on which help was 
  17154.             requested. 
  17155.  
  17156.  sSubTopic (SHORT) 
  17157.     Subtopic identifier. 
  17158.  
  17159.     For a value of the usContext parameter of HLPM_WINDOW or HLPM_FRAME: 
  17160.  
  17161.     control        Control identity of the cursored field and on which help was 
  17162.                    requested. 
  17163.  
  17164.     For a value of the usContext parameter of HLPM_MENU: 
  17165.  
  17166.     -1             No menu item was selected 
  17167.  
  17168.     other          Menu item identity of the currently selected submenu item on 
  17169.                    which help was requested. 
  17170.  
  17171.  rc (BOOL) 
  17172.     Action indicator. 
  17173.  
  17174.  
  17175. ΓòÉΓòÉΓòÉ <hidden> HM_HELPSUBITEM_NOT_FOUND - Remarks ΓòÉΓòÉΓòÉ
  17176.  
  17177. If FALSE is returned from this message, the Help Manager displays the extended 
  17178. help window. 
  17179.  
  17180. The application has the following options: 
  17181.  
  17182.      Ignore the notification and not display help for that field or window. 
  17183.  
  17184.      Display its own window. 
  17185.  
  17186.      Use the HM_DISPLAY_HELP message to tell the Help Manager to display a 
  17187.       particular window. 
  17188.  
  17189.  
  17190. ΓòÉΓòÉΓòÉ <hidden> HM_HELPSUBITEM_NOT_FOUND - Default Processing ΓòÉΓòÉΓòÉ
  17191.  
  17192. None. 
  17193.  
  17194.  
  17195. ΓòÉΓòÉΓòÉ <hidden> HM_HELPSUBITEM_NOT_FOUND - Topics ΓòÉΓòÉΓòÉ
  17196.  
  17197. Select an item: 
  17198.  
  17199. Syntax
  17200. Parameters
  17201. Returns
  17202. Remarks
  17203. Default Processing
  17204. Glossary
  17205.  
  17206.  
  17207. ΓòÉΓòÉΓòÉ 18.14. HM_INFORM ΓòÉΓòÉΓòÉ
  17208.  
  17209.  
  17210. ΓòÉΓòÉΓòÉ <hidden> HM_INFORM - Syntax ΓòÉΓòÉΓòÉ
  17211.  
  17212. This message is used by the Help Manager to notify the application when the 
  17213. user selects a hypertext field that was specified with the reftype=inform 
  17214. attribute of the :link. tag. 
  17215.  
  17216.  
  17217. param1
  17218.     USHORT  idnum       /*  Window identity. */
  17219.  
  17220. param2
  17221.     ULONG   ulReserved  /*  Reserved value, should be 0. */
  17222.  
  17223. returns
  17224.     ULONG   ulReserved  /*  Reserved value, should be 0. */
  17225.  
  17226.  
  17227. ΓòÉΓòÉΓòÉ <hidden> HM_INFORM Field - idnum ΓòÉΓòÉΓòÉ
  17228.  
  17229.  idnum (USHORT) 
  17230.     Window identity. 
  17231.  
  17232.     The identity that is associated with the hypertext field. 
  17233.  
  17234.  
  17235. ΓòÉΓòÉΓòÉ <hidden> HM_INFORM Field - ulReserved ΓòÉΓòÉΓòÉ
  17236.  
  17237.  ulReserved (ULONG) 
  17238.     Reserved value, should be 0. 
  17239.  
  17240.  
  17241. ΓòÉΓòÉΓòÉ <hidden> HM_INFORM Return Value - ulReserved ΓòÉΓòÉΓòÉ
  17242.  
  17243.  ulReserved (ULONG) 
  17244.     Reserved value, should be 0. 
  17245.  
  17246.     0 
  17247.             Reserved value, zero. 
  17248.  
  17249.  
  17250. ΓòÉΓòÉΓòÉ <hidden> HM_INFORM - Parameters ΓòÉΓòÉΓòÉ
  17251.  
  17252.  idnum (USHORT) 
  17253.     Window identity. 
  17254.  
  17255.     The identity that is associated with the hypertext field. 
  17256.  
  17257.  ulReserved (ULONG) 
  17258.     Reserved value, should be 0. 
  17259.  
  17260.  ulReserved (ULONG) 
  17261.     Reserved value, should be 0. 
  17262.  
  17263.     0 
  17264.             Reserved value, zero. 
  17265.  
  17266.  
  17267. ΓòÉΓòÉΓòÉ <hidden> HM_INFORM - Default Processing ΓòÉΓòÉΓòÉ
  17268.  
  17269. None. 
  17270.  
  17271.  
  17272. ΓòÉΓòÉΓòÉ <hidden> HM_INFORM - Topics ΓòÉΓòÉΓòÉ
  17273.  
  17274. Select an item: 
  17275.  
  17276. Syntax
  17277. Parameters
  17278. Returns
  17279. Default Processing
  17280. Glossary
  17281.  
  17282.  
  17283. ΓòÉΓòÉΓòÉ 18.15. HM_INVALIDATE_DDF_DATA ΓòÉΓòÉΓòÉ
  17284.  
  17285.  
  17286. ΓòÉΓòÉΓòÉ <hidden> HM_INVALIDATE_DDF_DATA - Syntax ΓòÉΓòÉΓòÉ
  17287.  
  17288. The application sends this message to IPF to indicate that the previous DDF 
  17289. data is no longer valid. 
  17290.  
  17291.  
  17292. param1
  17293.     ULONG    rescount  /*  The count of DDFs to be invalidated. */
  17294.  
  17295. param2
  17296.     PUSHORT  resarray  /*  Pointer to an array. */
  17297.  
  17298. returns
  17299.     ULONG    rc        /*  Return code. */
  17300.  
  17301.  
  17302. ΓòÉΓòÉΓòÉ <hidden> HM_INVALIDATE_DDF_DATA Field - rescount ΓòÉΓòÉΓòÉ
  17303.  
  17304.  rescount (ULONG) 
  17305.     The count of DDFs to be invalidated. 
  17306.  
  17307.  
  17308. ΓòÉΓòÉΓòÉ <hidden> HM_INVALIDATE_DDF_DATA Field - resarray ΓòÉΓòÉΓòÉ
  17309.  
  17310.  resarray (PUSHORT) 
  17311.     Pointer to an array. 
  17312.  
  17313.     The pointer to an array of unsigned 16-bit (USHORT) integers that are the 
  17314.     res numbers of DDFs to be invalidated. 
  17315.  
  17316.     Note:  If both param1 and param2 are NULL, then all the DDFs in that page 
  17317.            will be invalidated. 
  17318.  
  17319.  
  17320. ΓòÉΓòÉΓòÉ <hidden> HM_INVALIDATE_DDF_DATA Return Value - rc ΓòÉΓòÉΓòÉ
  17321.  
  17322.  rc (ULONG) 
  17323.     Return code. 
  17324.  
  17325.     0 
  17326.             The procedure was successfully completed. 
  17327.     Other 
  17328.             See the values of the errorcode parameter of the HM_ERROR message. 
  17329.  
  17330.  
  17331. ΓòÉΓòÉΓòÉ <hidden> HM_INVALIDATE_DDF_DATA - Parameters ΓòÉΓòÉΓòÉ
  17332.  
  17333.  rescount (ULONG) 
  17334.     The count of DDFs to be invalidated. 
  17335.  
  17336.  resarray (PUSHORT) 
  17337.     Pointer to an array. 
  17338.  
  17339.     The pointer to an array of unsigned 16-bit (USHORT) integers that are the 
  17340.     res numbers of DDFs to be invalidated. 
  17341.  
  17342.     Note:  If both param1 and param2 are NULL, then all the DDFs in that page 
  17343.            will be invalidated. 
  17344.  
  17345.  rc (ULONG) 
  17346.     Return code. 
  17347.  
  17348.     0 
  17349.             The procedure was successfully completed. 
  17350.     Other 
  17351.             See the values of the errorcode parameter of the HM_ERROR message. 
  17352.  
  17353.  
  17354. ΓòÉΓòÉΓòÉ <hidden> HM_INVALIDATE_DDF_DATA - Remarks ΓòÉΓòÉΓòÉ
  17355.  
  17356. When IPF receives this message, it discards the current DDF data and sends a 
  17357. new HM_QUERY_DDF_DATA message to the object communication window. 
  17358.  
  17359. This message should be sent to the child of the coverpage window handle. 
  17360.  
  17361.  
  17362. ΓòÉΓòÉΓòÉ <hidden> HM_INVALIDATE_DDF_DATA - Default Processing ΓòÉΓòÉΓòÉ
  17363.  
  17364. None. 
  17365.  
  17366.  
  17367. ΓòÉΓòÉΓòÉ <hidden> HM_INVALIDATE_DDF_DATA - Topics ΓòÉΓòÉΓòÉ
  17368.  
  17369. Select an item: 
  17370.  
  17371. Syntax
  17372. Parameters
  17373. Returns
  17374. Remarks
  17375. Default Processing
  17376. Glossary
  17377.  
  17378.  
  17379. ΓòÉΓòÉΓòÉ 18.16. HM_KEYS_HELP ΓòÉΓòÉΓòÉ
  17380.  
  17381.  
  17382. ΓòÉΓòÉΓòÉ <hidden> HM_KEYS_HELP - Syntax ΓòÉΓòÉΓòÉ
  17383.  
  17384. This message is sent by the application and informs the help manager to display 
  17385. the keys help window. 
  17386.  
  17387.  
  17388. param1
  17389.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  17390.  
  17391. param2
  17392.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  17393.  
  17394. returns
  17395.     ULONG  rc          /*  Return code. */
  17396.  
  17397.  
  17398. ΓòÉΓòÉΓòÉ <hidden> HM_KEYS_HELP Field - ulReserved ΓòÉΓòÉΓòÉ
  17399.  
  17400.  ulReserved (ULONG) 
  17401.     Reserved value, should be 0. 
  17402.  
  17403.  
  17404. ΓòÉΓòÉΓòÉ <hidden> HM_KEYS_HELP Field - ulReserved ΓòÉΓòÉΓòÉ
  17405.  
  17406.  ulReserved (ULONG) 
  17407.     Reserved value, should be 0. 
  17408.  
  17409.  
  17410. ΓòÉΓòÉΓòÉ <hidden> HM_KEYS_HELP Return Value - rc ΓòÉΓòÉΓòÉ
  17411.  
  17412.  rc (ULONG) 
  17413.     Return code. 
  17414.  
  17415.     0 
  17416.             The keys help window was successfully displayed 
  17417.     Other 
  17418.             See the values of the ulErrorCode parameter of the HM_ERROR 
  17419.             message. 
  17420.  
  17421.  
  17422. ΓòÉΓòÉΓòÉ <hidden> HM_KEYS_HELP - Parameters ΓòÉΓòÉΓòÉ
  17423.  
  17424.  ulReserved (ULONG) 
  17425.     Reserved value, should be 0. 
  17426.  
  17427.  ulReserved (ULONG) 
  17428.     Reserved value, should be 0. 
  17429.  
  17430.  rc (ULONG) 
  17431.     Return code. 
  17432.  
  17433.     0 
  17434.             The keys help window was successfully displayed 
  17435.     Other 
  17436.             See the values of the ulErrorCode parameter of the HM_ERROR 
  17437.             message. 
  17438.  
  17439.  
  17440. ΓòÉΓòÉΓòÉ <hidden> HM_KEYS_HELP - Remarks ΓòÉΓòÉΓòÉ
  17441.  
  17442. When the Help Manager receives this message, it sends a HM_QUERY_KEYS_HELP 
  17443. message to the active application window. The active application window is the 
  17444. window that was specified when the last HM_SET_ACTIVE_WINDOW message was sent. 
  17445. If no HM_SET_ACTIVE_WINDOW message was issued, then the active application 
  17446. window is the window specified in the WinAssociateHelpInstance call. 
  17447.  
  17448. The application must return one of the following: 
  17449.  
  17450.      The identity of a keys help window in the usHelpPanel parameter of the 
  17451.       HM_QUERY_KEYS_HELP message. 
  17452.  
  17453.      Zero, if no action is to be taken by the Help Manager for keys help. 
  17454.  
  17455.  
  17456. ΓòÉΓòÉΓòÉ <hidden> HM_KEYS_HELP - Default Processing ΓòÉΓòÉΓòÉ
  17457.  
  17458. None. 
  17459.  
  17460.  
  17461. ΓòÉΓòÉΓòÉ <hidden> HM_KEYS_HELP - Topics ΓòÉΓòÉΓòÉ
  17462.  
  17463. Select an item: 
  17464.  
  17465. Syntax
  17466. Parameters
  17467. Returns
  17468. Remarks
  17469. Default Processing
  17470. Glossary
  17471.  
  17472.  
  17473. ΓòÉΓòÉΓòÉ 18.17. HM_LOAD_HELP_TABLE ΓòÉΓòÉΓòÉ
  17474.  
  17475.  
  17476. ΓòÉΓòÉΓòÉ <hidden> HM_LOAD_HELP_TABLE - Syntax ΓòÉΓòÉΓòÉ
  17477.  
  17478. The application sends this message to give the Help Manager the module handle 
  17479. that contains the help table, the help subtable, and the identity of the help 
  17480. table. 
  17481.  
  17482.  
  17483. param1
  17484.     USHORT   idHelpTable     /*  Identity of the help table. */
  17485.     USHORT   fsidentityflag  /*  Help table identity indicator. */
  17486.  
  17487. param2
  17488.     HMODULE  MODULE          /*  Resource identity. */
  17489.  
  17490. returns
  17491.     ULONG    rc              /*  Return code. */
  17492.  
  17493.  
  17494. ΓòÉΓòÉΓòÉ <hidden> HM_LOAD_HELP_TABLE Field - idHelpTable ΓòÉΓòÉΓòÉ
  17495.  
  17496.  idHelpTable (USHORT) 
  17497.     Identity of the help table. 
  17498.  
  17499.  
  17500. ΓòÉΓòÉΓòÉ <hidden> HM_LOAD_HELP_TABLE Field - fsidentityflag ΓòÉΓòÉΓòÉ
  17501.  
  17502.  fsidentityflag (USHORT) 
  17503.     Help table identity indicator. 
  17504.  
  17505.     0xFFFF 
  17506.             Reserved value. 
  17507.  
  17508.  
  17509. ΓòÉΓòÉΓòÉ <hidden> HM_LOAD_HELP_TABLE Field - MODULE ΓòÉΓòÉΓòÉ
  17510.  
  17511.  MODULE (HMODULE) 
  17512.     Resource identity. 
  17513.  
  17514.     Handle of the module that contains the help table and help subtable. 
  17515.  
  17516.  
  17517. ΓòÉΓòÉΓòÉ <hidden> HM_LOAD_HELP_TABLE Return Value - rc ΓòÉΓòÉΓòÉ
  17518.  
  17519.  rc (ULONG) 
  17520.     Return code. 
  17521.  
  17522.     0 
  17523.             The procedure was successfully completed. 
  17524.     Other 
  17525.             See the values of the ulErrorCode parameter of the HM_ERROR 
  17526.             message. 
  17527.  
  17528.  
  17529. ΓòÉΓòÉΓòÉ <hidden> HM_LOAD_HELP_TABLE - Parameters ΓòÉΓòÉΓòÉ
  17530.  
  17531.  idHelpTable (USHORT) 
  17532.     Identity of the help table. 
  17533.  
  17534.  fsidentityflag (USHORT) 
  17535.     Help table identity indicator. 
  17536.  
  17537.     0xFFFF 
  17538.             Reserved value. 
  17539.  
  17540.  MODULE (HMODULE) 
  17541.     Resource identity. 
  17542.  
  17543.     Handle of the module that contains the help table and help subtable. 
  17544.  
  17545.  rc (ULONG) 
  17546.     Return code. 
  17547.  
  17548.     0 
  17549.             The procedure was successfully completed. 
  17550.     Other 
  17551.             See the values of the ulErrorCode parameter of the HM_ERROR 
  17552.             message. 
  17553.  
  17554.  
  17555. ΓòÉΓòÉΓòÉ <hidden> HM_LOAD_HELP_TABLE - Default Processing ΓòÉΓòÉΓòÉ
  17556.  
  17557. None. 
  17558.  
  17559.  
  17560. ΓòÉΓòÉΓòÉ <hidden> HM_LOAD_HELP_TABLE - Topics ΓòÉΓòÉΓòÉ
  17561.  
  17562. Select an item: 
  17563.  
  17564. Syntax
  17565. Parameters
  17566. Returns
  17567. Default Processing
  17568. Glossary
  17569.  
  17570.  
  17571. ΓòÉΓòÉΓòÉ 18.18. HM_NOTIFY ΓòÉΓòÉΓòÉ
  17572.  
  17573.  
  17574. ΓòÉΓòÉΓòÉ <hidden> HM_NOTIFY - Syntax ΓòÉΓòÉΓòÉ
  17575.  
  17576. This message is used by the application to sub-class and change the behavior or 
  17577. appearance of the help window. 
  17578.  
  17579.  
  17580. param1
  17581.     USHORT  controlres  /*  Res number of the control that was selected. */
  17582.     USHORT  usReserve   /*  Reserved value, should be 0. */
  17583.     USHORT  usevent     /*  The type of event which has occurred. */
  17584.  
  17585. param2
  17586.     ULONG   ulhwnd      /*  Window handle of relevant window. */
  17587.  
  17588. returns
  17589.     BOOL    rc          /*  Return code. */
  17590.  
  17591.  
  17592. ΓòÉΓòÉΓòÉ <hidden> HM_NOTIFY Field - controlres ΓòÉΓòÉΓòÉ
  17593.  
  17594.  controlres (USHORT) 
  17595.     Res number of the control that was selected. 
  17596.  
  17597.     For author-defined push buttons, this is the res number that was specified 
  17598.     with the push button tag (:pbutton.).  For default push buttons, this is 
  17599.     the res number defined in the PMHELP.H file. 
  17600.  
  17601.  
  17602. ΓòÉΓòÉΓòÉ <hidden> HM_NOTIFY Field - usReserve ΓòÉΓòÉΓòÉ
  17603.  
  17604.  usReserve (USHORT) 
  17605.     Reserved value, should be 0. 
  17606.  
  17607.     Reserved for events other than CONTROL_SELECTED and HELP_REQUESTED. 
  17608.  
  17609.  
  17610. ΓòÉΓòÉΓòÉ <hidden> HM_NOTIFY Field - usevent ΓòÉΓòÉΓòÉ
  17611.  
  17612.  usevent (USHORT) 
  17613.     The type of event which has occurred. 
  17614.  
  17615.     CONTROL_SELECTED                A control was selected. 
  17616.  
  17617.     HELP_REQUESTED                  Help was requested. 
  17618.  
  17619.     OPEN_COVERPAGE                  The coverpage is displayed. 
  17620.  
  17621.     OPEN_PAGE                       The child window of the coverpage is 
  17622.                                     opened. 
  17623.  
  17624.     SWAP_PAGE                       The child window of the coverpage is 
  17625.                                     swapped. 
  17626.  
  17627.     OPEN_INDEX                      The index window is displayed. 
  17628.  
  17629.     OPEN_TOC                        The table of contents window is displayed. 
  17630.  
  17631.     OPEN_HISTORY                    The history window is displayed. 
  17632.  
  17633.     OPEN_LIBRARY                    The new library is opened. 
  17634.  
  17635.     OPEN_SEARCH_HIT_LIST            The search list displayed. 
  17636.  
  17637.  
  17638. ΓòÉΓòÉΓòÉ <hidden> HM_NOTIFY Field - ulhwnd ΓòÉΓòÉΓòÉ
  17639.  
  17640.  ulhwnd (ULONG) 
  17641.     Window handle of relevant window. 
  17642.  
  17643.  
  17644. ΓòÉΓòÉΓòÉ <hidden> HM_NOTIFY Return Value - rc ΓòÉΓòÉΓòÉ
  17645.  
  17646.  rc (BOOL) 
  17647.     Return code. 
  17648.  
  17649.     TRUE 
  17650.             IPF will not format the controls and re-size the window. 
  17651.     FALSE 
  17652.             IPF will process as normal. 
  17653.  
  17654.  
  17655. ΓòÉΓòÉΓòÉ <hidden> HM_NOTIFY - Parameters ΓòÉΓòÉΓòÉ
  17656.  
  17657.  controlres (USHORT) 
  17658.     Res number of the control that was selected. 
  17659.  
  17660.     For author-defined push buttons, this is the res number that was specified 
  17661.     with the push button tag (:pbutton.).  For default push buttons, this is 
  17662.     the res number defined in the PMHELP.H file. 
  17663.  
  17664.  usReserve (USHORT) 
  17665.     Reserved value, should be 0. 
  17666.  
  17667.     Reserved for events other than CONTROL_SELECTED and HELP_REQUESTED. 
  17668.  
  17669.  usevent (USHORT) 
  17670.     The type of event which has occurred. 
  17671.  
  17672.     CONTROL_SELECTED                A control was selected. 
  17673.  
  17674.     HELP_REQUESTED                  Help was requested. 
  17675.  
  17676.     OPEN_COVERPAGE                  The coverpage is displayed. 
  17677.  
  17678.     OPEN_PAGE                       The child window of the coverpage is 
  17679.                                     opened. 
  17680.  
  17681.     SWAP_PAGE                       The child window of the coverpage is 
  17682.                                     swapped. 
  17683.  
  17684.     OPEN_INDEX                      The index window is displayed. 
  17685.  
  17686.     OPEN_TOC                        The table of contents window is displayed. 
  17687.  
  17688.     OPEN_HISTORY                    The history window is displayed. 
  17689.  
  17690.     OPEN_LIBRARY                    The new library is opened. 
  17691.  
  17692.     OPEN_SEARCH_HIT_LIST            The search list displayed. 
  17693.  
  17694.  ulhwnd (ULONG) 
  17695.     Window handle of relevant window. 
  17696.  
  17697.  rc (BOOL) 
  17698.     Return code. 
  17699.  
  17700.     TRUE 
  17701.             IPF will not format the controls and re-size the window. 
  17702.     FALSE 
  17703.             IPF will process as normal. 
  17704.  
  17705.  
  17706. ΓòÉΓòÉΓòÉ <hidden> HM_NOTIFY - Remarks ΓòÉΓòÉΓòÉ
  17707.  
  17708. This message is sent to the application to notify it of events that the 
  17709. application would be interested in controlling. 
  17710.  
  17711.  
  17712. ΓòÉΓòÉΓòÉ <hidden> HM_NOTIFY - Default Processing ΓòÉΓòÉΓòÉ
  17713.  
  17714. None. 
  17715.  
  17716.  
  17717. ΓòÉΓòÉΓòÉ <hidden> HM_NOTIFY - Topics ΓòÉΓòÉΓòÉ
  17718.  
  17719. Select an item: 
  17720.  
  17721. Syntax
  17722. Parameters
  17723. Returns
  17724. Remarks
  17725. Default Processing
  17726. Glossary
  17727.  
  17728.  
  17729. ΓòÉΓòÉΓòÉ 18.19. HM_QUERY ΓòÉΓòÉΓòÉ
  17730.  
  17731.  
  17732. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY - Syntax ΓòÉΓòÉΓòÉ
  17733.  
  17734. This message is sent to IPF by the application to request IPF-specific 
  17735. information, such as the current Instance handle, the active communication 
  17736. object window, the active window, or the group number of the current window. 
  17737.  
  17738.  
  17739. param1
  17740.     USHORT  usselectionid  /*  What is being requested. */
  17741.     USHORT  usmessageid    /*  Type of window queried. */
  17742.  
  17743. param2
  17744.     PVOID   pvoid          /*  Varies, depending on value selected above. */
  17745.  
  17746. returns
  17747.     ULONG   rc             /*  Return code. */
  17748.  
  17749.  
  17750. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY Field - usselectionid ΓòÉΓòÉΓòÉ
  17751.  
  17752.  usselectionid (USHORT) 
  17753.     What is being requested. 
  17754.  
  17755.     This parameter should be specified only if the query is for HMQW_VIEWPORT 
  17756.     and should otherwise be coded as NULL. 
  17757.  
  17758.     Specifies whether a res ID, ID number, or group number is being requested. 
  17759.     The value can be any of the following constants: 
  17760.  
  17761.     HMQVP_NUMBER 
  17762.                                   A pointer to a USHORT that holds the res ID 
  17763.                                   of the window. 
  17764.  
  17765.     HMQVP_NAME 
  17766.                                   A pointer to a null-terminated string that 
  17767.                                   holds the ID of the window. 
  17768.  
  17769.     HMQVP_GROUP 
  17770.                                   The group number of the window. 
  17771.  
  17772.  
  17773. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY Field - usmessageid ΓòÉΓòÉΓòÉ
  17774.  
  17775.  usmessageid (USHORT) 
  17776.     Type of window queried. 
  17777.  
  17778.     Specifies the type of window to query.  The value can be any of the 
  17779.     following constants: 
  17780.  
  17781.     HMQW_INDEX 
  17782.                                        The handle of the index window. 
  17783.     HMQW_TOC 
  17784.                                        The handle of the Table of Contents 
  17785.                                        window. 
  17786.     HMQW_SEARCH 
  17787.                                        The handle of the Search Hitlist window. 
  17788.     HMQW_VIEWEDPAGES 
  17789.                                        The handle of the Viewed Pages window. 
  17790.     HMQW_LIBRARY 
  17791.                                        The handle of the Library List window. 
  17792.     HMQW_OBJCOM_WINDOW 
  17793.                                        The handle of the active communication 
  17794.                                        window. 
  17795.     HMQW_INSTANCE 
  17796.                                        The handle of the help instance. 
  17797.     HMQW_COVERPAGE 
  17798.                                        The handle of the help manager multiple 
  17799.                                        document interface (MDI) parent window. 
  17800.                                        It is where the secondary windows are 
  17801.                                        contained within the parent window. 
  17802.     HMQW_VIEWPORT 
  17803.                                        The handle of the viewport window 
  17804.                                        specified in the low-order word of 
  17805.                                        param1 and in param2. 
  17806.  
  17807.                                        When HMQW_VIEWPORT is specified in 
  17808.                                        usmessageid, a value must be specified 
  17809.                                        in usselectionid to indicate whether a 
  17810.                                        res ID, ID number, or group number is 
  17811.                                        being requested. 
  17812.     HMQW_GROUP_VIEWPORT 
  17813.                                        The group number of the window whose 
  17814.                                        handle is specified in param2. 
  17815.     HMQW_RES_VIEWPORT 
  17816.                                        The res number of the window whose 
  17817.                                        handle is specified in param2. 
  17818.     HMQW_ACTIVEVIEWPORT 
  17819.                                        The handle of the currently active 
  17820.                                        window. 
  17821.     USERDATA 
  17822.                                        The previously stored user-data. 
  17823.  
  17824.  
  17825. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY Field - pvoid ΓòÉΓòÉΓòÉ
  17826.  
  17827.  pvoid (PVOID) 
  17828.     Varies, depending on value selected above. 
  17829.  
  17830.     param2 depends on the value of param1 usmessageid. 
  17831.  
  17832.     If param1 usmessageid is HMQW_VIEWPORT, then param2 is a pointer to the res 
  17833.     number, ID, or group ID. 
  17834.  
  17835.     If param1 usmessageid is HMQW_GROUP_VIEWPORT, then param2 is the handle of 
  17836.     the viewport for which the group number is assigned. 
  17837.  
  17838.     If param1 usmessageid is HMQW_RES_VIEWPORT, then param2 is the handle of 
  17839.     the viewport for which the res number is requested. 
  17840.  
  17841.  
  17842. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY Return Value - rc ΓòÉΓòÉΓòÉ
  17843.  
  17844.  rc (ULONG) 
  17845.     Return code. 
  17846.  
  17847.     0 
  17848.             The procedure was not successfully completed. 
  17849.  
  17850.     Other 
  17851.             The handle (HWND), group number (USHORT), or res number (USHORT) of 
  17852.             the window, or the user data (USHORT), depending on the value of 
  17853.             param1 usselectionid. 
  17854.  
  17855.  
  17856. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY - Parameters ΓòÉΓòÉΓòÉ
  17857.  
  17858.  usselectionid (USHORT) 
  17859.     What is being requested. 
  17860.  
  17861.     This parameter should be specified only if the query is for HMQW_VIEWPORT 
  17862.     and should otherwise be coded as NULL. 
  17863.  
  17864.     Specifies whether a res ID, ID number, or group number is being requested. 
  17865.     The value can be any of the following constants: 
  17866.  
  17867.     HMQVP_NUMBER 
  17868.                                   A pointer to a USHORT that holds the res ID 
  17869.                                   of the window. 
  17870.  
  17871.     HMQVP_NAME 
  17872.                                   A pointer to a null-terminated string that 
  17873.                                   holds the ID of the window. 
  17874.  
  17875.     HMQVP_GROUP 
  17876.                                   The group number of the window. 
  17877.  
  17878.  usmessageid (USHORT) 
  17879.     Type of window queried. 
  17880.  
  17881.     Specifies the type of window to query.  The value can be any of the 
  17882.     following constants: 
  17883.  
  17884.     HMQW_INDEX 
  17885.                                        The handle of the index window. 
  17886.     HMQW_TOC 
  17887.                                        The handle of the Table of Contents 
  17888.                                        window. 
  17889.     HMQW_SEARCH 
  17890.                                        The handle of the Search Hitlist window. 
  17891.     HMQW_VIEWEDPAGES 
  17892.                                        The handle of the Viewed Pages window. 
  17893.     HMQW_LIBRARY 
  17894.                                        The handle of the Library List window. 
  17895.     HMQW_OBJCOM_WINDOW 
  17896.                                        The handle of the active communication 
  17897.                                        window. 
  17898.     HMQW_INSTANCE 
  17899.                                        The handle of the help instance. 
  17900.     HMQW_COVERPAGE 
  17901.                                        The handle of the help manager multiple 
  17902.                                        document interface (MDI) parent window. 
  17903.                                        It is where the secondary windows are 
  17904.                                        contained within the parent window. 
  17905.     HMQW_VIEWPORT 
  17906.                                        The handle of the viewport window 
  17907.                                        specified in the low-order word of 
  17908.                                        param1 and in param2. 
  17909.  
  17910.                                        When HMQW_VIEWPORT is specified in 
  17911.                                        usmessageid, a value must be specified 
  17912.                                        in usselectionid to indicate whether a 
  17913.                                        res ID, ID number, or group number is 
  17914.                                        being requested. 
  17915.     HMQW_GROUP_VIEWPORT 
  17916.                                        The group number of the window whose 
  17917.                                        handle is specified in param2. 
  17918.     HMQW_RES_VIEWPORT 
  17919.                                        The res number of the window whose 
  17920.                                        handle is specified in param2. 
  17921.     HMQW_ACTIVEVIEWPORT 
  17922.                                        The handle of the currently active 
  17923.                                        window. 
  17924.     USERDATA 
  17925.                                        The previously stored user-data. 
  17926.  
  17927.  pvoid (PVOID) 
  17928.     Varies, depending on value selected above. 
  17929.  
  17930.     param2 depends on the value of param1 usmessageid. 
  17931.  
  17932.     If param1 usmessageid is HMQW_VIEWPORT, then param2 is a pointer to the res 
  17933.     number, ID, or group ID. 
  17934.  
  17935.     If param1 usmessageid is HMQW_GROUP_VIEWPORT, then param2 is the handle of 
  17936.     the viewport for which the group number is assigned. 
  17937.  
  17938.     If param1 usmessageid is HMQW_RES_VIEWPORT, then param2 is the handle of 
  17939.     the viewport for which the res number is requested. 
  17940.  
  17941.  rc (ULONG) 
  17942.     Return code. 
  17943.  
  17944.     0 
  17945.             The procedure was not successfully completed. 
  17946.  
  17947.     Other 
  17948.             The handle (HWND), group number (USHORT), or res number (USHORT) of 
  17949.             the window, or the user data (USHORT), depending on the value of 
  17950.             param1 usselectionid. 
  17951.  
  17952.  
  17953. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY - Default Processing ΓòÉΓòÉΓòÉ
  17954.  
  17955. None. 
  17956.  
  17957.  
  17958. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY - Topics ΓòÉΓòÉΓòÉ
  17959.  
  17960. Select an item: 
  17961.  
  17962. Syntax
  17963. Parameters
  17964. Returns
  17965. Default Processing
  17966. Glossary
  17967.  
  17968.  
  17969. ΓòÉΓòÉΓòÉ 18.20. HM_QUERY_DDF_DATA ΓòÉΓòÉΓòÉ
  17970.  
  17971.  
  17972. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY_DDF_DATA - Syntax ΓòÉΓòÉΓòÉ
  17973.  
  17974. This message is sent to the communication object window by IPF when it 
  17975. encounters the dynamic data formatting (:ddf.) tag. 
  17976.  
  17977.  
  17978. param1
  17979.     HWND   pageclienthwnd  /*  Client handle. */
  17980.  
  17981. param2
  17982.     ULONG  resid           /*  The res ID associated with the DDF tag. */
  17983.  
  17984. returns
  17985.     HDDF   rc              /*  Return code. */
  17986.  
  17987.  
  17988. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY_DDF_DATA Field - pageclienthwnd ΓòÉΓòÉΓòÉ
  17989.  
  17990.  pageclienthwnd (HWND) 
  17991.     Client handle. 
  17992.  
  17993.     The client handle of the page that contains the object communication 
  17994.     window. 
  17995.  
  17996.  
  17997. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY_DDF_DATA Field - resid ΓòÉΓòÉΓòÉ
  17998.  
  17999.  resid (ULONG) 
  18000.     The res ID associated with the DDF tag. 
  18001.  
  18002.  
  18003. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY_DDF_DATA Return Value - rc ΓòÉΓòÉΓòÉ
  18004.  
  18005.  rc (HDDF) 
  18006.     Return code. 
  18007.  
  18008.     0 
  18009.             An error has occurred in the application's DDF processing. 
  18010.  
  18011.     Other 
  18012.             The DDF handle to be displayed. 
  18013.  
  18014.             Note:  Once this handle has been returned, the HDDF handle can no 
  18015.                    longer be used by the application. 
  18016.  
  18017.  
  18018. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY_DDF_DATA - Parameters ΓòÉΓòÉΓòÉ
  18019.  
  18020.  pageclienthwnd (HWND) 
  18021.     Client handle. 
  18022.  
  18023.     The client handle of the page that contains the object communication 
  18024.     window. 
  18025.  
  18026.  resid (ULONG) 
  18027.     The res ID associated with the DDF tag. 
  18028.  
  18029.  rc (HDDF) 
  18030.     Return code. 
  18031.  
  18032.     0 
  18033.             An error has occurred in the application's DDF processing. 
  18034.  
  18035.     Other 
  18036.             The DDF handle to be displayed. 
  18037.  
  18038.             Note:  Once this handle has been returned, the HDDF handle can no 
  18039.                    longer be used by the application. 
  18040.  
  18041.  
  18042. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY_DDF_DATA - Remarks ΓòÉΓòÉΓòÉ
  18043.  
  18044. Upon receiving this message, the communication object calls DdfInitialize to 
  18045. indicate the start of dynamic data formatting (DDF).  Any combination of other 
  18046. DDF calls are then made to describe this data.  When this is complete, the 
  18047. communication object finishes processing this message, indicating that the DDF 
  18048. data is complete.  After that time, the DDF handle received from DdfInitialize 
  18049. is considered invalid. 
  18050.  
  18051.  
  18052. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY_DDF_DATA - Default Processing ΓòÉΓòÉΓòÉ
  18053.  
  18054. None. 
  18055.  
  18056.  
  18057. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY_DDF_DATA - Topics ΓòÉΓòÉΓòÉ
  18058.  
  18059. Select an item: 
  18060.  
  18061. Syntax
  18062. Parameters
  18063. Returns
  18064. Remarks
  18065. Default Processing
  18066. Glossary
  18067.  
  18068.  
  18069. ΓòÉΓòÉΓòÉ 18.21. HM_QUERY_KEYS_HELP ΓòÉΓòÉΓòÉ
  18070.  
  18071.  
  18072. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY_KEYS_HELP - Syntax ΓòÉΓòÉΓòÉ
  18073.  
  18074. When the user requests the keys help function, the Help Manager sends this 
  18075. message to the application. 
  18076.  
  18077.  
  18078. param1
  18079.     ULONG   ulReserved   /*  Reserved value, should be 0. */
  18080.  
  18081. param2
  18082.     ULONG   ulReserved   /*  Reserved value, should be 0. */
  18083.  
  18084. returns
  18085.     USHORT  usHelpPanel  /*  Help panel ID. */
  18086.  
  18087.  
  18088. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY_KEYS_HELP Field - ulReserved ΓòÉΓòÉΓòÉ
  18089.  
  18090.  ulReserved (ULONG) 
  18091.     Reserved value, should be 0. 
  18092.  
  18093.  
  18094. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY_KEYS_HELP Field - ulReserved ΓòÉΓòÉΓòÉ
  18095.  
  18096.  ulReserved (ULONG) 
  18097.     Reserved value, should be 0. 
  18098.  
  18099.  
  18100. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY_KEYS_HELP Return Value - usHelpPanel ΓòÉΓòÉΓòÉ
  18101.  
  18102.  usHelpPanel (USHORT) 
  18103.     Help panel ID. 
  18104.  
  18105.     The identity of the application-defined keys help window to be displayed. 
  18106.  
  18107.     0 
  18108.             Do nothing 
  18109.     Other 
  18110.             Identity of the keys help window to be displayed. 
  18111.  
  18112.  
  18113. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY_KEYS_HELP - Parameters ΓòÉΓòÉΓòÉ
  18114.  
  18115.  ulReserved (ULONG) 
  18116.     Reserved value, should be 0. 
  18117.  
  18118.  ulReserved (ULONG) 
  18119.     Reserved value, should be 0. 
  18120.  
  18121.  usHelpPanel (USHORT) 
  18122.     Help panel ID. 
  18123.  
  18124.     The identity of the application-defined keys help window to be displayed. 
  18125.  
  18126.     0 
  18127.             Do nothing 
  18128.     Other 
  18129.             Identity of the keys help window to be displayed. 
  18130.  
  18131.  
  18132. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY_KEYS_HELP - Remarks ΓòÉΓòÉΓòÉ
  18133.  
  18134. The application responds by returning the identity of the requested keys help 
  18135. window. The Help Manager then displays that help window. Returning 0 in the 
  18136. usHelpPanel parameter indicates that the Help Manager should do nothing for the 
  18137. keys help function. 
  18138.  
  18139.  
  18140. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY_KEYS_HELP - Default Processing ΓòÉΓòÉΓòÉ
  18141.  
  18142. None. 
  18143.  
  18144.  
  18145. ΓòÉΓòÉΓòÉ <hidden> HM_QUERY_KEYS_HELP - Topics ΓòÉΓòÉΓòÉ
  18146.  
  18147. Select an item: 
  18148.  
  18149. Syntax
  18150. Parameters
  18151. Returns
  18152. Remarks
  18153. Default Processing
  18154. Glossary
  18155.  
  18156.  
  18157. ΓòÉΓòÉΓòÉ 18.22. HM_REPLACE_HELP_FOR_HELP ΓòÉΓòÉΓòÉ
  18158.  
  18159.  
  18160. ΓòÉΓòÉΓòÉ <hidden> HM_REPLACE_HELP_FOR_HELP - Syntax ΓòÉΓòÉΓòÉ
  18161.  
  18162. This message tells the Help Manager to display the application-defined Help for 
  18163. Help window instead of the Help Manager Help for Help window. 
  18164.  
  18165.  
  18166. param1
  18167.     USHORT  idHelpForHelpPanel  /*  Identity of the application-defined Help for Help window. */
  18168.  
  18169. param2
  18170.     ULONG   ulReserved          /*  Reserved value, should be 0. */
  18171.  
  18172. returns
  18173.     ULONG   ulReserved          /*  Reserved value, should be 0. */
  18174.  
  18175.  
  18176. ΓòÉΓòÉΓòÉ <hidden> HM_REPLACE_HELP_FOR_HELP Field - idHelpForHelpPanel ΓòÉΓòÉΓòÉ
  18177.  
  18178.  idHelpForHelpPanel (USHORT) 
  18179.     Identity of the application-defined Help for Help window. 
  18180.  
  18181.     0 
  18182.             Use the Help Manager Help for Help window. 
  18183.     Other 
  18184.             Identity of the application-defined Help for Help window. 
  18185.  
  18186.  
  18187. ΓòÉΓòÉΓòÉ <hidden> HM_REPLACE_HELP_FOR_HELP Field - ulReserved ΓòÉΓòÉΓòÉ
  18188.  
  18189.  ulReserved (ULONG) 
  18190.     Reserved value, should be 0. 
  18191.  
  18192.  
  18193. ΓòÉΓòÉΓòÉ <hidden> HM_REPLACE_HELP_FOR_HELP Return Value - ulReserved ΓòÉΓòÉΓòÉ
  18194.  
  18195.  ulReserved (ULONG) 
  18196.     Reserved value, should be 0. 
  18197.  
  18198.  
  18199. ΓòÉΓòÉΓòÉ <hidden> HM_REPLACE_HELP_FOR_HELP - Parameters ΓòÉΓòÉΓòÉ
  18200.  
  18201.  idHelpForHelpPanel (USHORT) 
  18202.     Identity of the application-defined Help for Help window. 
  18203.  
  18204.     0 
  18205.             Use the Help Manager Help for Help window. 
  18206.     Other 
  18207.             Identity of the application-defined Help for Help window. 
  18208.  
  18209.  ulReserved (ULONG) 
  18210.     Reserved value, should be 0. 
  18211.  
  18212.  ulReserved (ULONG) 
  18213.     Reserved value, should be 0. 
  18214.  
  18215.  
  18216. ΓòÉΓòÉΓòÉ <hidden> HM_REPLACE_HELP_FOR_HELP - Remarks ΓòÉΓòÉΓòÉ
  18217.  
  18218. An application may prefer to provide information that is more specific to 
  18219. itself, rather than the more general help information provided in the Help 
  18220. Manager Help for Help window. 
  18221.  
  18222.  
  18223. ΓòÉΓòÉΓòÉ <hidden> HM_REPLACE_HELP_FOR_HELP - Default Processing ΓòÉΓòÉΓòÉ
  18224.  
  18225. None. 
  18226.  
  18227.  
  18228. ΓòÉΓòÉΓòÉ <hidden> HM_REPLACE_HELP_FOR_HELP - Topics ΓòÉΓòÉΓòÉ
  18229.  
  18230. Select an item: 
  18231.  
  18232. Syntax
  18233. Parameters
  18234. Returns
  18235. Remarks
  18236. Default Processing
  18237. Glossary
  18238.  
  18239.  
  18240. ΓòÉΓòÉΓòÉ 18.23. HM_REPLACE_USING_HELP ΓòÉΓòÉΓòÉ
  18241.  
  18242.  
  18243. ΓòÉΓòÉΓòÉ <hidden> HM_REPLACE_USING_HELP - Syntax ΓòÉΓòÉΓòÉ
  18244.  
  18245. This message tells the Help Manager to display the application-defined Using 
  18246. help window instead of the Help Manager Using help window. 
  18247.  
  18248.  
  18249. param1
  18250.     USHORT  idUsingHelpPanel
  18251.  
  18252. param2
  18253.     ULONG   ulReserved        /*  Reserved value, should be 0. */
  18254.  
  18255. returns
  18256.     ULONG   ulReserved        /*  Reserved value, should be 0. */
  18257.  
  18258.  
  18259. ΓòÉΓòÉΓòÉ <hidden> HM_REPLACE_USING_HELP Field - idUsingHelpPanel ΓòÉΓòÉΓòÉ
  18260.  
  18261.  idUsingHelpPanel (USHORT) 
  18262.     The identity of the application-defined Using Help window. 
  18263.  
  18264.     0 
  18265.             Use the Help Manager Using Help window. 
  18266.     Other 
  18267.             The identity of the application-defined Using Help window. 
  18268.  
  18269.  
  18270. ΓòÉΓòÉΓòÉ <hidden> HM_REPLACE_USING_HELP Field - ulReserved ΓòÉΓòÉΓòÉ
  18271.  
  18272.  ulReserved (ULONG) 
  18273.     Reserved value, should be 0. 
  18274.  
  18275.  
  18276. ΓòÉΓòÉΓòÉ <hidden> HM_REPLACE_USING_HELP Return Value - ulReserved ΓòÉΓòÉΓòÉ
  18277.  
  18278.  ulReserved (ULONG) 
  18279.     Reserved value, should be 0. 
  18280.  
  18281.  
  18282. ΓòÉΓòÉΓòÉ <hidden> HM_REPLACE_USING_HELP - Parameters ΓòÉΓòÉΓòÉ
  18283.  
  18284.  idUsingHelpPanel (USHORT) 
  18285.     The identity of the application-defined Using Help window. 
  18286.  
  18287.     0 
  18288.             Use the Help Manager Using Help window. 
  18289.     Other 
  18290.             The identity of the application-defined Using Help window. 
  18291.  
  18292.  ulReserved (ULONG) 
  18293.     Reserved value, should be 0. 
  18294.  
  18295.  ulReserved (ULONG) 
  18296.     Reserved value, should be 0. 
  18297.  
  18298.  
  18299. ΓòÉΓòÉΓòÉ <hidden> HM_REPLACE_USING_HELP - Remarks ΓòÉΓòÉΓòÉ
  18300.  
  18301. An application may prefer to provide information that is more specific to 
  18302. itself, rather than the more general help information that is provided in the 
  18303. Help Manager Using help window.  The guidelines that define the current CUA 
  18304. interface recommend the Using help choice be provided in a pull-down menu from 
  18305. the Help choice. 
  18306.  
  18307.  
  18308. ΓòÉΓòÉΓòÉ <hidden> HM_REPLACE_USING_HELP - Default Processing ΓòÉΓòÉΓòÉ
  18309.  
  18310. None. 
  18311.  
  18312.  
  18313. ΓòÉΓòÉΓòÉ <hidden> HM_REPLACE_USING_HELP - Topics ΓòÉΓòÉΓòÉ
  18314.  
  18315. Select an item: 
  18316.  
  18317. Syntax
  18318. Parameters
  18319. Returns
  18320. Remarks
  18321. Default Processing
  18322. Glossary
  18323.  
  18324.  
  18325. ΓòÉΓòÉΓòÉ 18.24. HM_SET_ACTIVE_WINDOW ΓòÉΓòÉΓòÉ
  18326.  
  18327.  
  18328. ΓòÉΓòÉΓòÉ <hidden> HM_SET_ACTIVE_WINDOW - Syntax ΓòÉΓòÉΓòÉ
  18329.  
  18330. This message allows the application to change the window with which the Help 
  18331. Manager communicates and the window to which the help window is to be 
  18332. positioned. 
  18333.  
  18334.  
  18335. param1
  18336.     HWND   hwndActiveWindow    /*  The handle of the window to be made active. */
  18337.  
  18338. param2
  18339.     HWND   hwndRelativeWindow  /*  The handle of the window next to which the help window is to be positioned. */
  18340.  
  18341. returns
  18342.     ULONG  rc                  /*  Return code. */
  18343.  
  18344.  
  18345. ΓòÉΓòÉΓòÉ <hidden> HM_SET_ACTIVE_WINDOW Field - hwndActiveWindow ΓòÉΓòÉΓòÉ
  18346.  
  18347.  hwndActiveWindow (HWND) 
  18348.     The handle of the window to be made active. 
  18349.  
  18350.     Its window procedure receives all messages from the Help Manager until the 
  18351.     application changes the active window with another HM_SET_ACTIVE_WINDOW 
  18352.     message. 
  18353.  
  18354.  
  18355. ΓòÉΓòÉΓòÉ <hidden> HM_SET_ACTIVE_WINDOW Field - hwndRelativeWindow ΓòÉΓòÉΓòÉ
  18356.  
  18357.  hwndRelativeWindow (HWND) 
  18358.     The handle of the window next to which the help window is to be positioned. 
  18359.  
  18360.     The handle of the application window next to which the Help Manager will 
  18361.     position a new help window. 
  18362.  
  18363.     HWND_PARENT 
  18364.             This Help Manager defined constant tells the Help Manager to trace 
  18365.             the parent chain of the window that had the focus when the user 
  18366.             requested help. 
  18367.  
  18368.     Other 
  18369.             Handle of the window next to which the help window is to be 
  18370.             positioned. 
  18371.  
  18372.  
  18373. ΓòÉΓòÉΓòÉ <hidden> HM_SET_ACTIVE_WINDOW Return Value - rc ΓòÉΓòÉΓòÉ
  18374.  
  18375.  rc (ULONG) 
  18376.     Return code. 
  18377.  
  18378.     0 
  18379.             The procedure has been successfully completed. 
  18380.     Other 
  18381.             See the values of the ulErrorCode parameter of the HM_ERROR 
  18382.             message. 
  18383.  
  18384.  
  18385. ΓòÉΓòÉΓòÉ <hidden> HM_SET_ACTIVE_WINDOW - Parameters ΓòÉΓòÉΓòÉ
  18386.  
  18387.  hwndActiveWindow (HWND) 
  18388.     The handle of the window to be made active. 
  18389.  
  18390.     Its window procedure receives all messages from the Help Manager until the 
  18391.     application changes the active window with another HM_SET_ACTIVE_WINDOW 
  18392.     message. 
  18393.  
  18394.  hwndRelativeWindow (HWND) 
  18395.     The handle of the window next to which the help window is to be positioned. 
  18396.  
  18397.     The handle of the application window next to which the Help Manager will 
  18398.     position a new help window. 
  18399.  
  18400.     HWND_PARENT 
  18401.             This Help Manager defined constant tells the Help Manager to trace 
  18402.             the parent chain of the window that had the focus when the user 
  18403.             requested help. 
  18404.  
  18405.     Other 
  18406.             Handle of the window next to which the help window is to be 
  18407.             positioned. 
  18408.  
  18409.  rc (ULONG) 
  18410.     Return code. 
  18411.  
  18412.     0 
  18413.             The procedure has been successfully completed. 
  18414.     Other 
  18415.             See the values of the ulErrorCode parameter of the HM_ERROR 
  18416.             message. 
  18417.  
  18418.  
  18419. ΓòÉΓòÉΓòÉ <hidden> HM_SET_ACTIVE_WINDOW - Remarks ΓòÉΓòÉΓòÉ
  18420.  
  18421. Normally the Help Manager communicates with the application window with which 
  18422. the Help Manager instance has been associated. The help window is positioned 
  18423. next to this same application window. 
  18424.  
  18425. If the hwndActiveWindow parameter is 0, the hwndRelativeWindow parameter is set 
  18426. to 0. That is, if the active window is NULL HANDLE, the relative window is not 
  18427. used. 
  18428.  
  18429.  
  18430. ΓòÉΓòÉΓòÉ <hidden> HM_SET_ACTIVE_WINDOW - Default Processing ΓòÉΓòÉΓòÉ
  18431.  
  18432. None. 
  18433.  
  18434.  
  18435. ΓòÉΓòÉΓòÉ <hidden> HM_SET_ACTIVE_WINDOW - Topics ΓòÉΓòÉΓòÉ
  18436.  
  18437. Select an item: 
  18438.  
  18439. Syntax
  18440. Parameters
  18441. Returns
  18442. Remarks
  18443. Default Processing
  18444. Glossary
  18445.  
  18446.  
  18447. ΓòÉΓòÉΓòÉ 18.25. HM_SET_COVERPAGE_SIZE ΓòÉΓòÉΓòÉ
  18448.  
  18449.  
  18450. ΓòÉΓòÉΓòÉ <hidden> HM_SET_COVERPAGE_SIZE - Syntax ΓòÉΓòÉΓòÉ
  18451.  
  18452. This message is sent to IPF by the application to set the size of the 
  18453. coverpage, the window within which all other IPF windows are displayed. 
  18454.  
  18455.  
  18456. param1
  18457.     PRECTL  coverpagerectl  /*  Pointer to RECTL containing the size of the coverpage. */
  18458.  
  18459. param2
  18460.     ULONG   ulReserved      /*  Reserved value, should be 0. */
  18461.  
  18462. returns
  18463.     ULONG   rc              /*  Return code. */
  18464.  
  18465.  
  18466. ΓòÉΓòÉΓòÉ <hidden> HM_SET_COVERPAGE_SIZE Field - coverpagerectl ΓòÉΓòÉΓòÉ
  18467.  
  18468.  coverpagerectl (PRECTL) 
  18469.     Pointer to RECTL containing the size of the coverpage. 
  18470.  
  18471.  
  18472. ΓòÉΓòÉΓòÉ <hidden> HM_SET_COVERPAGE_SIZE Field - ulReserved ΓòÉΓòÉΓòÉ
  18473.  
  18474.  ulReserved (ULONG) 
  18475.     Reserved value, should be 0. 
  18476.  
  18477.  
  18478. ΓòÉΓòÉΓòÉ <hidden> HM_SET_COVERPAGE_SIZE Return Value - rc ΓòÉΓòÉΓòÉ
  18479.  
  18480.  rc (ULONG) 
  18481.     Return code. 
  18482.  
  18483.     0 
  18484.             The procedure was successfully completed. 
  18485.     Other 
  18486.             See the values of the errorcode parameter of the HM_ERROR message. 
  18487.  
  18488.  
  18489. ΓòÉΓòÉΓòÉ <hidden> HM_SET_COVERPAGE_SIZE - Parameters ΓòÉΓòÉΓòÉ
  18490.  
  18491.  coverpagerectl (PRECTL) 
  18492.     Pointer to RECTL containing the size of the coverpage. 
  18493.  
  18494.  ulReserved (ULONG) 
  18495.     Reserved value, should be 0. 
  18496.  
  18497.  rc (ULONG) 
  18498.     Return code. 
  18499.  
  18500.     0 
  18501.             The procedure was successfully completed. 
  18502.     Other 
  18503.             See the values of the errorcode parameter of the HM_ERROR message. 
  18504.  
  18505.  
  18506. ΓòÉΓòÉΓòÉ <hidden> HM_SET_COVERPAGE_SIZE - Remarks ΓòÉΓòÉΓòÉ
  18507.  
  18508. The default size for the coverpage of a book is the full width of the screen, 
  18509. while the default size for a help file is one-half the width of the screen. 
  18510.  
  18511. This message takes effect immediately, changing the size of the coverpage.  If 
  18512. the coverpage is not currently open, the requested size is saved for the next 
  18513. open. 
  18514.  
  18515.  
  18516. ΓòÉΓòÉΓòÉ <hidden> HM_SET_COVERPAGE_SIZE - Default Processing ΓòÉΓòÉΓòÉ
  18517.  
  18518. None. 
  18519.  
  18520.  
  18521. ΓòÉΓòÉΓòÉ <hidden> HM_SET_COVERPAGE_SIZE - Topics ΓòÉΓòÉΓòÉ
  18522.  
  18523. Select an item: 
  18524.  
  18525. Syntax
  18526. Parameters
  18527. Returns
  18528. Remarks
  18529. Default Processing
  18530. Glossary
  18531.  
  18532.  
  18533. ΓòÉΓòÉΓòÉ 18.26. HM_SET_HELP_LIBRARY_NAME ΓòÉΓòÉΓòÉ
  18534.  
  18535.  
  18536. ΓòÉΓòÉΓòÉ <hidden> HM_SET_HELP_LIBRARY_NAME - Syntax ΓòÉΓòÉΓòÉ
  18537.  
  18538. This message identifies a list of help window library names to the Help Manager 
  18539. instance. 
  18540.  
  18541.  
  18542. param1
  18543.     PSZ    pszHelpLibraryName  /*  Library name. */
  18544.  
  18545. param2
  18546.     ULONG  ulReserved          /*  Reserved value, should be 0. */
  18547.  
  18548. returns
  18549.     ULONG  rc                  /*  Return code. */
  18550.  
  18551.  
  18552. ΓòÉΓòÉΓòÉ <hidden> HM_SET_HELP_LIBRARY_NAME Field - pszHelpLibraryName ΓòÉΓòÉΓòÉ
  18553.  
  18554.  pszHelpLibraryName (PSZ) 
  18555.     Library name. 
  18556.  
  18557.     This points to a string that contains a list of help window library names 
  18558.     that will be searched by the Help Manager for the requested help window. 
  18559.     The names must be separated by a blank. 
  18560.  
  18561.  
  18562. ΓòÉΓòÉΓòÉ <hidden> HM_SET_HELP_LIBRARY_NAME Field - ulReserved ΓòÉΓòÉΓòÉ
  18563.  
  18564.  ulReserved (ULONG) 
  18565.     Reserved value, should be 0. 
  18566.  
  18567.  
  18568. ΓòÉΓòÉΓòÉ <hidden> HM_SET_HELP_LIBRARY_NAME Return Value - rc ΓòÉΓòÉΓòÉ
  18569.  
  18570.  rc (ULONG) 
  18571.     Return code. 
  18572.  
  18573.     0 
  18574.             The newly specified library successfully replaced the current help 
  18575.             window library name. 
  18576.     Other 
  18577.             See the values of the ulErrorCode parameter of the HM_ERROR 
  18578.             message. 
  18579.  
  18580.  
  18581. ΓòÉΓòÉΓòÉ <hidden> HM_SET_HELP_LIBRARY_NAME - Parameters ΓòÉΓòÉΓòÉ
  18582.  
  18583.  pszHelpLibraryName (PSZ) 
  18584.     Library name. 
  18585.  
  18586.     This points to a string that contains a list of help window library names 
  18587.     that will be searched by the Help Manager for the requested help window. 
  18588.     The names must be separated by a blank. 
  18589.  
  18590.  ulReserved (ULONG) 
  18591.     Reserved value, should be 0. 
  18592.  
  18593.  rc (ULONG) 
  18594.     Return code. 
  18595.  
  18596.     0 
  18597.             The newly specified library successfully replaced the current help 
  18598.             window library name. 
  18599.     Other 
  18600.             See the values of the ulErrorCode parameter of the HM_ERROR 
  18601.             message. 
  18602.  
  18603.  
  18604. ΓòÉΓòÉΓòÉ <hidden> HM_SET_HELP_LIBRARY_NAME - Remarks ΓòÉΓòÉΓòÉ
  18605.  
  18606. Any subsequent communication to the Help Manager with this message replaces the 
  18607. current list of names with the newly specified list. 
  18608.  
  18609. When help is requested, the Help Manager will search each library in the list 
  18610. for the requested help window. 
  18611.  
  18612.  
  18613. ΓòÉΓòÉΓòÉ <hidden> HM_SET_HELP_LIBRARY_NAME - Default Processing ΓòÉΓòÉΓòÉ
  18614.  
  18615. None. 
  18616.  
  18617.  
  18618. ΓòÉΓòÉΓòÉ <hidden> HM_SET_HELP_LIBRARY_NAME - Topics ΓòÉΓòÉΓòÉ
  18619.  
  18620. Select an item: 
  18621.  
  18622. Syntax
  18623. Parameters
  18624. Returns
  18625. Remarks
  18626. Default Processing
  18627. Glossary
  18628.  
  18629.  
  18630. ΓòÉΓòÉΓòÉ 18.27. HM_SET_HELP_WINDOW_TITLE ΓòÉΓòÉΓòÉ
  18631.  
  18632.  
  18633. ΓòÉΓòÉΓòÉ <hidden> HM_SET_HELP_WINDOW_TITLE - Syntax ΓòÉΓòÉΓòÉ
  18634.  
  18635. This message allows the application to change the window text of a help window 
  18636. title. 
  18637.  
  18638.  
  18639. param1
  18640.     PSZ    pszHelpWindowTitle  /*  Help window title. */
  18641.  
  18642. param2
  18643.     ULONG  ulReserved          /*  Reserved value, should be 0. */
  18644.  
  18645. returns
  18646.     ULONG  rc                  /*  Return code. */
  18647.  
  18648.  
  18649. ΓòÉΓòÉΓòÉ <hidden> HM_SET_HELP_WINDOW_TITLE Field - pszHelpWindowTitle ΓòÉΓòÉΓòÉ
  18650.  
  18651.  pszHelpWindowTitle (PSZ) 
  18652.     Help window title. 
  18653.  
  18654.     This points to a string containing the new Help Window title. 
  18655.  
  18656.  
  18657. ΓòÉΓòÉΓòÉ <hidden> HM_SET_HELP_WINDOW_TITLE Field - ulReserved ΓòÉΓòÉΓòÉ
  18658.  
  18659.  ulReserved (ULONG) 
  18660.     Reserved value, should be 0. 
  18661.  
  18662.  
  18663. ΓòÉΓòÉΓòÉ <hidden> HM_SET_HELP_WINDOW_TITLE Return Value - rc ΓòÉΓòÉΓòÉ
  18664.  
  18665.  rc (ULONG) 
  18666.     Return code. 
  18667.  
  18668.     0 
  18669.             The window title was successfully set. 
  18670.     Other 
  18671.             See the values of the ulErrorCode parameter of the HM_ERROR 
  18672.             message. 
  18673.  
  18674.  
  18675. ΓòÉΓòÉΓòÉ <hidden> HM_SET_HELP_WINDOW_TITLE - Parameters ΓòÉΓòÉΓòÉ
  18676.  
  18677.  pszHelpWindowTitle (PSZ) 
  18678.     Help window title. 
  18679.  
  18680.     This points to a string containing the new Help Window title. 
  18681.  
  18682.  ulReserved (ULONG) 
  18683.     Reserved value, should be 0. 
  18684.  
  18685.  rc (ULONG) 
  18686.     Return code. 
  18687.  
  18688.     0 
  18689.             The window title was successfully set. 
  18690.     Other 
  18691.             See the values of the ulErrorCode parameter of the HM_ERROR 
  18692.             message. 
  18693.  
  18694.  
  18695. ΓòÉΓòÉΓòÉ <hidden> HM_SET_HELP_WINDOW_TITLE - Default Processing ΓòÉΓòÉΓòÉ
  18696.  
  18697. None. 
  18698.  
  18699.  
  18700. ΓòÉΓòÉΓòÉ <hidden> HM_SET_HELP_WINDOW_TITLE - Topics ΓòÉΓòÉΓòÉ
  18701.  
  18702. Select an item: 
  18703.  
  18704. Syntax
  18705. Parameters
  18706. Returns
  18707. Default Processing
  18708. Glossary
  18709.  
  18710.  
  18711. ΓòÉΓòÉΓòÉ 18.28. HM_SET_OBJCOM_WINDOW ΓòÉΓòÉΓòÉ
  18712.  
  18713.  
  18714. ΓòÉΓòÉΓòÉ <hidden> HM_SET_OBJCOM_WINDOW - Syntax ΓòÉΓòÉΓòÉ
  18715.  
  18716. This message is sent to IPF by the application to identify the communication 
  18717. object window to which the HM_INFORM and HM_QUERY_DDF_DATA messages will be 
  18718. sent.  This message is not necessary if the communication object does not 
  18719. expect to receive either of these messages. 
  18720.  
  18721.  
  18722. hwndparam1
  18723.     HWND   objcomhwnd        /*  Handle of the communication object window to be set. */
  18724.  
  18725. param2
  18726.     ULONG  ulReserved        /*  Reserved value, should be 0. */
  18727.  
  18728. returns
  18729.     HWND   hwndprevioushwnd  /*  The handle of the previous communication object window. */
  18730.  
  18731.  
  18732. ΓòÉΓòÉΓòÉ <hidden> HM_SET_OBJCOM_WINDOW Field - objcomhwnd ΓòÉΓòÉΓòÉ
  18733.  
  18734.  objcomhwnd (HWND) 
  18735.     Handle of the communication object window to be set. 
  18736.  
  18737.  
  18738. ΓòÉΓòÉΓòÉ <hidden> HM_SET_OBJCOM_WINDOW Field - ulReserved ΓòÉΓòÉΓòÉ
  18739.  
  18740.  ulReserved (ULONG) 
  18741.     Reserved value, should be 0. 
  18742.  
  18743.  
  18744. ΓòÉΓòÉΓòÉ <hidden> HM_SET_OBJCOM_WINDOW Return Value - hwndprevioushwnd ΓòÉΓòÉΓòÉ
  18745.  
  18746.  hwndprevioushwnd (HWND) 
  18747.     The handle of the previous communication object window. 
  18748.  
  18749.  
  18750. ΓòÉΓòÉΓòÉ <hidden> HM_SET_OBJCOM_WINDOW - Parameters ΓòÉΓòÉΓòÉ
  18751.  
  18752.  objcomhwnd (HWND) 
  18753.     Handle of the communication object window to be set. 
  18754.  
  18755.  ulReserved (ULONG) 
  18756.     Reserved value, should be 0. 
  18757.  
  18758.  hwndprevioushwnd (HWND) 
  18759.     The handle of the previous communication object window. 
  18760.  
  18761.  
  18762. ΓòÉΓòÉΓòÉ <hidden> HM_SET_OBJCOM_WINDOW - Remarks ΓòÉΓòÉΓòÉ
  18763.  
  18764. HM_INFORM and HM_QUERY_DDF_DATA messages which are not processed must be passed 
  18765. to the previous communication object window which was returned when 
  18766. HM_SET_OBJECT_WINDOW was sent. 
  18767.  
  18768.  
  18769. ΓòÉΓòÉΓòÉ <hidden> HM_SET_OBJCOM_WINDOW - Default Processing ΓòÉΓòÉΓòÉ
  18770.  
  18771. None. 
  18772.  
  18773.  
  18774. ΓòÉΓòÉΓòÉ <hidden> HM_SET_OBJCOM_WINDOW - Topics ΓòÉΓòÉΓòÉ
  18775.  
  18776. Select an item: 
  18777.  
  18778. Syntax
  18779. Parameters
  18780. Returns
  18781. Remarks
  18782. Default Processing
  18783. Glossary
  18784.  
  18785.  
  18786. ΓòÉΓòÉΓòÉ 18.29. HM_SET_SHOW_PANEL_ID ΓòÉΓòÉΓòÉ
  18787.  
  18788.  
  18789. ΓòÉΓòÉΓòÉ <hidden> HM_SET_SHOW_PANEL_ID - Syntax ΓòÉΓòÉΓòÉ
  18790.  
  18791. This message tells the Help Manager to display, hide, or toggle the window 
  18792. identity for each help window displayed. 
  18793.  
  18794.  
  18795. param1
  18796.     USHORT  fsShowPanelId  /*  The show window identity indicator. */
  18797.  
  18798. param2
  18799.     ULONG   ulReserved     /*  Reserved value, should be 0. */
  18800.  
  18801. rc
  18802.     ULONG   rc             /*  Return code. */
  18803.  
  18804.  
  18805. ΓòÉΓòÉΓòÉ <hidden> HM_SET_SHOW_PANEL_ID Field - fsShowPanelId ΓòÉΓòÉΓòÉ
  18806.  
  18807.  fsShowPanelId (USHORT) 
  18808.     The show window identity indicator. 
  18809.  
  18810.     CMIC_HIDE_PANEL_ID 
  18811.             Sets the show option off and the window identity is not displayed. 
  18812.  
  18813.     CMIC_SHOW_PANEL_ID 
  18814.             Sets the show option on and the window identity is displayed. 
  18815.  
  18816.     CMIC_TOGGLE_PANEL_ID 
  18817.             Toggles the display of the window identity. 
  18818.  
  18819.  
  18820. ΓòÉΓòÉΓòÉ <hidden> HM_SET_SHOW_PANEL_ID Field - ulReserved ΓòÉΓòÉΓòÉ
  18821.  
  18822.  ulReserved (ULONG) 
  18823.     Reserved value, should be 0. 
  18824.  
  18825.  
  18826. ΓòÉΓòÉΓòÉ <hidden> HM_SET_SHOW_PANEL_ID Parameter - rc ΓòÉΓòÉΓòÉ
  18827.  
  18828.  rc (ULONG) 
  18829.     Return code. 
  18830.  
  18831.     0 
  18832.             The show window identity indicator was successfully changed. 
  18833.     Other 
  18834.             See the values of the ulErrorCode parameter of the HM_ERROR 
  18835.             message. 
  18836.  
  18837.  
  18838. ΓòÉΓòÉΓòÉ <hidden> HM_SET_SHOW_PANEL_ID - Parameters ΓòÉΓòÉΓòÉ
  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.  ulReserved (ULONG) 
  18853.     Reserved value, should be 0. 
  18854.  
  18855.  rc (ULONG) 
  18856.     Return code. 
  18857.  
  18858.     0 
  18859.             The show window identity indicator was successfully changed. 
  18860.     Other 
  18861.             See the values of the ulErrorCode parameter of the HM_ERROR 
  18862.             message. 
  18863.  
  18864.  
  18865. ΓòÉΓòÉΓòÉ <hidden> HM_SET_SHOW_PANEL_ID - Default Processing ΓòÉΓòÉΓòÉ
  18866.  
  18867. None. 
  18868.  
  18869.  
  18870. ΓòÉΓòÉΓòÉ <hidden> HM_SET_SHOW_PANEL_ID - Topics ΓòÉΓòÉΓòÉ
  18871.  
  18872. Select an item: 
  18873.  
  18874. Syntax
  18875. Parameters
  18876. Default Processing
  18877. Glossary
  18878.  
  18879.  
  18880. ΓòÉΓòÉΓòÉ 18.30. HM_SET_USERDATA ΓòÉΓòÉΓòÉ
  18881.  
  18882.  
  18883. ΓòÉΓòÉΓòÉ <hidden> HM_SET_USERDATA - Syntax ΓòÉΓòÉΓòÉ
  18884.  
  18885. The application sends this message to IPF to store data in the IPF data area. 
  18886.  
  18887.  
  18888. param1
  18889.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  18890.  
  18891. param2
  18892.     VOID   usrdata     /*  4-byte user data area. */
  18893.  
  18894. rc
  18895.     ULONG  rc          /*  Return code. */
  18896.  
  18897.  
  18898. ΓòÉΓòÉΓòÉ <hidden> HM_SET_USERDATA Field - ulReserved ΓòÉΓòÉΓòÉ
  18899.  
  18900.  ulReserved (ULONG) 
  18901.     Reserved value, should be 0. 
  18902.  
  18903.  
  18904. ΓòÉΓòÉΓòÉ <hidden> HM_SET_USERDATA Field - usrdata ΓòÉΓòÉΓòÉ
  18905.  
  18906.  usrdata (VOID) 
  18907.     4-byte user data area. 
  18908.  
  18909.  
  18910. ΓòÉΓòÉΓòÉ <hidden> HM_SET_USERDATA Parameter - rc ΓòÉΓòÉΓòÉ
  18911.  
  18912.  rc (ULONG) 
  18913.     Return code. 
  18914.  
  18915.     TRUE 
  18916.             The user data was successfully stored. 
  18917.     FALSE 
  18918.             The call failed. 
  18919.  
  18920.  
  18921. ΓòÉΓòÉΓòÉ <hidden> HM_SET_USERDATA - Parameters ΓòÉΓòÉΓòÉ
  18922.  
  18923.  ulReserved (ULONG) 
  18924.     Reserved value, should be 0. 
  18925.  
  18926.  usrdata (VOID) 
  18927.     4-byte user data area. 
  18928.  
  18929.  rc (ULONG) 
  18930.     Return code. 
  18931.  
  18932.     TRUE 
  18933.             The user data was successfully stored. 
  18934.     FALSE 
  18935.             The call failed. 
  18936.  
  18937.  
  18938. ΓòÉΓòÉΓòÉ <hidden> HM_SET_USERDATA - Default Processing ΓòÉΓòÉΓòÉ
  18939.  
  18940. None. 
  18941.  
  18942.  
  18943. ΓòÉΓòÉΓòÉ <hidden> HM_SET_USERDATA - Topics ΓòÉΓòÉΓòÉ
  18944.  
  18945. Select an item: 
  18946.  
  18947. Syntax
  18948. Parameters
  18949. Default Processing
  18950. Glossary
  18951.  
  18952.  
  18953. ΓòÉΓòÉΓòÉ 18.31. HM_TUTORIAL ΓòÉΓòÉΓòÉ
  18954.  
  18955.  
  18956. ΓòÉΓòÉΓòÉ <hidden> HM_TUTORIAL - Syntax ΓòÉΓòÉΓòÉ
  18957.  
  18958. The Help Manager sends this message to the application window when the user 
  18959. selects the Tutorial choice from a help window. 
  18960.  
  18961.  
  18962. param1
  18963.     PSZ    pszTutorialName  /*  Default tutorial name. */
  18964.  
  18965. param2
  18966.     ULONG  ulReserved       /*  Reserved value, should be 0. */
  18967.  
  18968. returns
  18969.     ULONG  ulReserved       /*  Reserved value, should be 0. */
  18970.  
  18971.  
  18972. ΓòÉΓòÉΓòÉ <hidden> HM_TUTORIAL Field - pszTutorialName ΓòÉΓòÉΓòÉ
  18973.  
  18974.  pszTutorialName (PSZ) 
  18975.     Default tutorial name. 
  18976.  
  18977.     This points to a string that contains the name of the default tutorial 
  18978.     program specified in the Help Manager initialization structure. A tutorial 
  18979.     name specified in the help window definition overrides this default 
  18980.     tutorial program. 
  18981.  
  18982.  
  18983. ΓòÉΓòÉΓòÉ <hidden> HM_TUTORIAL Field - ulReserved ΓòÉΓòÉΓòÉ
  18984.  
  18985.  ulReserved (ULONG) 
  18986.     Reserved value, should be 0. 
  18987.  
  18988.  
  18989. ΓòÉΓòÉΓòÉ <hidden> HM_TUTORIAL Return Value - ulReserved ΓòÉΓòÉΓòÉ
  18990.  
  18991.  ulReserved (ULONG) 
  18992.     Reserved value, should be 0. 
  18993.  
  18994.  
  18995. ΓòÉΓòÉΓòÉ <hidden> HM_TUTORIAL - Parameters ΓòÉΓòÉΓòÉ
  18996.  
  18997.  pszTutorialName (PSZ) 
  18998.     Default tutorial name. 
  18999.  
  19000.     This points to a string that contains the name of the default tutorial 
  19001.     program specified in the Help Manager initialization structure. A tutorial 
  19002.     name specified in the help window definition overrides this default 
  19003.     tutorial program. 
  19004.  
  19005.  ulReserved (ULONG) 
  19006.     Reserved value, should be 0. 
  19007.  
  19008.  ulReserved (ULONG) 
  19009.     Reserved value, should be 0. 
  19010.  
  19011.  
  19012. ΓòÉΓòÉΓòÉ <hidden> HM_TUTORIAL - Remarks ΓòÉΓòÉΓòÉ
  19013.  
  19014. The application then calls its own tutorial program. 
  19015.  
  19016.  
  19017. ΓòÉΓòÉΓòÉ <hidden> HM_TUTORIAL - Default Processing ΓòÉΓòÉΓòÉ
  19018.  
  19019. None. 
  19020.  
  19021.  
  19022. ΓòÉΓòÉΓòÉ <hidden> HM_TUTORIAL - Topics ΓòÉΓòÉΓòÉ
  19023.  
  19024. Select an item: 
  19025.  
  19026. Syntax
  19027. Parameters
  19028. Returns
  19029. Remarks
  19030. Default Processing
  19031. Glossary
  19032.  
  19033.  
  19034. ΓòÉΓòÉΓòÉ 18.32. HM_UPDATE_OBJCOM_WINDOW_CHAIN ΓòÉΓòÉΓòÉ
  19035.  
  19036.  
  19037. ΓòÉΓòÉΓòÉ <hidden> HM_UPDATE_OBJCOM_WINDOW_CHAIN - Syntax ΓòÉΓòÉΓòÉ
  19038.  
  19039. This message is sent to the currently active communication object by the 
  19040. communication object who wants to withdraw from the communication chain. 
  19041.  
  19042.  
  19043. param1
  19044.     HWND   hwnd        /*  The handle of the object to be withdrawn from the communication chain. */
  19045.  
  19046. param2
  19047.     HWND   hwnd        /*  Window containing the handle of the object to be replaced. */
  19048.  
  19049. returns
  19050.     ULONG  ulReserved  /*  Reserved value, should be 0. */
  19051.  
  19052.  
  19053. ΓòÉΓòÉΓòÉ <hidden> HM_UPDATE_OBJCOM_WINDOW_CHAIN Field - hwnd ΓòÉΓòÉΓòÉ
  19054.  
  19055.  hwnd (HWND) 
  19056.     The handle of the object to be withdrawn from the communication chain. 
  19057.  
  19058.  
  19059. ΓòÉΓòÉΓòÉ <hidden> HM_UPDATE_OBJCOM_WINDOW_CHAIN Field - hwnd ΓòÉΓòÉΓòÉ
  19060.  
  19061.  hwnd (HWND) 
  19062.     Window containing the handle of the object to be replaced. 
  19063.  
  19064.  
  19065. ΓòÉΓòÉΓòÉ <hidden> HM_UPDATE_OBJCOM_WINDOW_CHAIN Return Value - ulReserved ΓòÉΓòÉΓòÉ
  19066.  
  19067.  ulReserved (ULONG) 
  19068.     Reserved value, should be 0. 
  19069.  
  19070.  
  19071. ΓòÉΓòÉΓòÉ <hidden> HM_UPDATE_OBJCOM_WINDOW_CHAIN - Parameters ΓòÉΓòÉΓòÉ
  19072.  
  19073.  hwnd (HWND) 
  19074.     The handle of the object to be withdrawn from the communication chain. 
  19075.  
  19076.  hwnd (HWND) 
  19077.     Window containing the handle of the object to be replaced. 
  19078.  
  19079.  ulReserved (ULONG) 
  19080.     Reserved value, should be 0. 
  19081.  
  19082.  
  19083. ΓòÉΓòÉΓòÉ <hidden> HM_UPDATE_OBJCOM_WINDOW_CHAIN - Remarks ΓòÉΓòÉΓòÉ
  19084.  
  19085. The object that receives this message should check to see if the object handle 
  19086. returned from HM_SET_OBJCOM_WINDOW is equal to the handle in param1. If the 
  19087. handle is equal, then the handle in param1 should be replaced by the handle in 
  19088. param2. If the handle is not equal and the handle previously received is not 
  19089. NULL HANDLE, then send HM_UPDATE_OBJCOM_WINDOW_CHAIN to that object. 
  19090.  
  19091.  
  19092. ΓòÉΓòÉΓòÉ <hidden> HM_UPDATE_OBJCOM_WINDOW_CHAIN - Default Processing ΓòÉΓòÉΓòÉ
  19093.  
  19094. None. 
  19095.  
  19096.  
  19097. ΓòÉΓòÉΓòÉ <hidden> HM_UPDATE_OBJCOM_WINDOW_CHAIN - Topics ΓòÉΓòÉΓòÉ
  19098.  
  19099. Select an item: 
  19100.  
  19101. Syntax
  19102. Parameters
  19103. Returns
  19104. Remarks
  19105. Default Processing
  19106. Glossary
  19107.  
  19108.  
  19109. ΓòÉΓòÉΓòÉ 19. Notices ΓòÉΓòÉΓòÉ
  19110.  
  19111. First Edition (October 1994) 
  19112.  
  19113. The following paragraph does not apply to the United Kingdom or any country 
  19114. where such provisions are inconsistent with local law:  INTERNATIONAL BUSINESS 
  19115. MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY 
  19116. KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 
  19117. WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states 
  19118. do not allow disclaimer of express or implied warranties in certain 
  19119. transactions, therefore, this statement may not apply to you. 
  19120.  
  19121. This publication could include technical inaccuracies or typographical errors. 
  19122. Changes are periodically made to the information herein; these changes will be 
  19123. incorporated in new editions of the publication. IBM may make improvements 
  19124. and/or changes in the product(s) and/or the program(s) described in this 
  19125. publication at any time. 
  19126.  
  19127. It is possible that this publication may contain reference to, or information 
  19128. about, IBM products (machines and programs), programming, or services that are 
  19129. not announced in your country.  Such references or information must not be 
  19130. construed to mean that IBM intends to announce such IBM products, programming, 
  19131. or services in your country. 
  19132.  
  19133. Requests for technical information about IBM products should be made to your 
  19134. IBM reseller or IBM marketing representative. 
  19135.  
  19136.  
  19137. ΓòÉΓòÉΓòÉ 19.1. Copyright Notices ΓòÉΓòÉΓòÉ
  19138.  
  19139. COPYRIGHT LICENSE: This publication contains printed sample application 
  19140. programs in source language, which illustrate OS/2 programming techniques. You 
  19141. may copy, modify, and distribute these sample programs in any form without 
  19142. payment to IBM, for the purposes of developing, using, marketing or 
  19143. distributing application programs conforming to the OS/2 application 
  19144. programming interface. 
  19145.  
  19146. Each copy of any portion of these sample programs or any derivative work, which 
  19147. is distributed to others, must include a copyright notice as follows: "(C) 
  19148. (your company name) (year).  All rights reserved." 
  19149.  
  19150. (C) Copyright International Business Machines Corporation 1994. All rights 
  19151. reserved. 
  19152. Note to U.S. Government Users - Documentation related to restricted rights - 
  19153. Use, duplication or disclosure is subject to restrictions set forth in GSA ADP 
  19154. Schedule Contract with IBM Corp. 
  19155.  
  19156.  
  19157. ΓòÉΓòÉΓòÉ 19.2. Disclaimers ΓòÉΓòÉΓòÉ
  19158.  
  19159. References in this publication to IBM products, programs, or services do not 
  19160. imply that IBM intends to make these available in all countries in which IBM 
  19161. operates. Any reference to an IBM product, program, or service is not intended 
  19162. to state or imply that only IBM's product, program, or service may be used. 
  19163. Subject to IBM's valid intellectual property or other legally protectable 
  19164. rights, any functionally equivalent product, program, or service may be used 
  19165. instead of the IBM product, program, or service. Evaluation and verification of 
  19166. operation in conjunction with other products, programs, or services, except 
  19167. those expressly designated by IBM, are the user's responsibility. 
  19168.  
  19169. IBM may have patents or pending patent applications covering subject matter in 
  19170. this document. The furnishing of this document does not give you any license to 
  19171. these patents. You can send license inquiries, in writing, to the IBM Director 
  19172. of Licensing, IBM Corporation, 500 Columbus Avenue, Thornwood, NY 10594, U.S.A. 
  19173.  
  19174. Licensees of this program who wish to have information about it for the purpose 
  19175. of enabling:  (i) the exchange of information between independently created 
  19176. programs and other programs (including this one) and (ii) the mutual use of the 
  19177. information which has been exchanged, should contact IBM Corporation, 
  19178. Department RM1A, 1000 N.W. 51st Street, Boca Raton, FL 33431, U.S.A.  Such 
  19179. information may be available, subject to appropriate terms and conditions, 
  19180. including in some cases, payment of a fee. 
  19181.  
  19182.  
  19183. ΓòÉΓòÉΓòÉ 19.3. Trademarks ΓòÉΓòÉΓòÉ
  19184.  
  19185. The following terms are trademarks of the IBM Corporation in the United States 
  19186. or other countries or both: 
  19187.  
  19188. Common User Access
  19189. CUA
  19190. IBM
  19191. Operating System/2
  19192. OS/2
  19193. Personal System/2
  19194. Presentation Manager
  19195. Systems Application Architecture
  19196.  
  19197. The following terms are trademarks of other companies: 
  19198.  
  19199.  Adobe               Adobe Systems Incorporated 
  19200.  Helvetica           Linotype AG 
  19201.  Intel486            Intel Corporation 
  19202.  PostScript          Adobe Systems Incorporated 
  19203.  Times New Roman     Monotype Corporation 
  19204.  
  19205.  Windows is a trademark of Microsoft Corporation. 
  19206.  
  19207.  PC Direct is a trademark of Ziff Communications Company and is used by IBM 
  19208.  Corporation under license. 
  19209.  
  19210.  UNIX is a registered trademark in the United States and other countries 
  19211.  licensed exclusively through X/Open Company Limited. 
  19212.  
  19213.  Other company, product, and service names, which may be denoted by a double 
  19214.  asterisk (**), may be trademarks or service marks of others. 
  19215.  
  19216.  
  19217. ΓòÉΓòÉΓòÉ 20. Glossary ΓòÉΓòÉΓòÉ
  19218.  
  19219. This glossary defines many of the terms used in this book. It includes terms 
  19220. and definitions from the IBM Dictionary of Computing, as well as terms specific 
  19221. to the OS/2 operating system and the Presentation Manager. It is not a complete 
  19222. glossary for the entire OS/2 operating system; nor is it a complete dictionary 
  19223. of computer terms. 
  19224.  
  19225. Other primary sources for these definitions are: 
  19226.  
  19227.      The American National Standard Dictionary for Information Systems, ANSI 
  19228.       X3.172-1990, copyrighted 1990 by the American National Standards 
  19229.       Institute, 11 West 42nd Street, New York, New York 10036. These 
  19230.       definitions are identified by the symbol (A) after the definition. 
  19231.  
  19232.      The Information Technology Vocabulary, developed by Subcommittee 1, Joint 
  19233.       Technical Committee 1, of the International Organization for 
  19234.       Standardization and the International Electrotechnical Commission 
  19235.       (ISO/IEC JTC1/SC1). Definitions of published parts of this vocabulary are 
  19236.       identified by the symbol (I) after the definition; definitions taken from 
  19237.       draft international standards, committee drafts, and working papers being 
  19238.       developed by ISO/IEC JTC1/SC1 are identified by the symbol (T) after the 
  19239.       definition, indicating that final agreement has not yet been reached 
  19240.       among the participating National Bodies of SC1. 
  19241.  
  19242.  
  19243. ΓòÉΓòÉΓòÉ 20.1. Glossary Listing ΓòÉΓòÉΓòÉ
  19244.  
  19245. Select a starting letter of glossary terms: 
  19246.  
  19247.  A    N 
  19248.  B    O 
  19249.  C    P 
  19250.  D    Q 
  19251.  E    R 
  19252.  F    S 
  19253.  G    T 
  19254.  H    U 
  19255.  I    V 
  19256.  J    W 
  19257.  K    X 
  19258.  L    Y 
  19259.  M    Z 
  19260.  
  19261.  
  19262. ΓòÉΓòÉΓòÉ <hidden> Glossary - A ΓòÉΓòÉΓòÉ
  19263.  
  19264.  accelerator  - In SAA Common User Access architecture, a key or combination of 
  19265.    keys that invokes an application-defined function. 
  19266.  
  19267.  accelerator table  - A table used to define which key strokes are treated as 
  19268.    accelerators and the commands they are translated into. 
  19269.  
  19270.  access mode  - The manner in which an application gains access to a file it 
  19271.    has opened. Examples of access modes are read-only, write-only, and 
  19272.    read/write. 
  19273.  
  19274.  access permission  - All access rights that a user has regarding an object. (I)
  19275.  
  19276.  action  - One of a set of defined tasks that a computer performs. Users 
  19277.    request the application to perform an action in several ways, such as typing 
  19278.    a command, pressing a function key, or selecting the action name from an 
  19279.    action bar or menu. 
  19280.  
  19281.  action bar  - In SAA Common User Access architecture, the area at the top of a 
  19282.    window that contains choices that give a user access to actions available in 
  19283.    that window. 
  19284.  
  19285.  action point  - The current position on the screen at which the pointer is 
  19286.    pointing. Contrast with hot spot and input focus. 
  19287.  
  19288.  active program  - A program currently running on the computer.  An active 
  19289.    program can be interactive (running and receiving input from the user) or 
  19290.    noninteractive (running but not receiving input from the user). See also 
  19291.    interactive program and noninteractive program. 
  19292.  
  19293.  active window  - The window with which the user is currently interacting. 
  19294.  
  19295.  address space  - (1) The range of addresses available to a program. (A)  (2) 
  19296.    The area of virtual storage available for a particular job. 
  19297.  
  19298.  alphanumeric video output  - Output to the logical video buffer when the video 
  19299.    adapter is in text mode and the logical video buffer is addressed by an 
  19300.    application as a rectangular array of character cells. 
  19301.  
  19302.  American National Standard Code for Information Interchange  - The standard 
  19303.    code, using a coded character set consisting of 7-bit coded characters (8 
  19304.    bits including parity check), that is used for information interchange among 
  19305.    data processing systems, data communication systems, and associated 
  19306.    equipment. The ASCII set consists of control characters and graphic 
  19307.    characters. (A) 
  19308.  
  19309.    Note:  IBM has defined an extension to ASCII code (characters 128-255). 
  19310.  
  19311.  anchor  - A window procedure that handles Presentation Manager message 
  19312.    conversions between an icon procedure and an application. 
  19313.  
  19314.  anchor block  - An area of Presentation-Manager-internal resources to 
  19315.    allocated process or thread that calls WinInitialize. 
  19316.  
  19317.  anchor point  - A point in a window used by a program designer or by a window 
  19318.    manager to position a subsequently appearing window. 
  19319.  
  19320.  ANSI  - American National Standards Institute. 
  19321.  
  19322.  APA  - All points addressable. 
  19323.  
  19324.  API  - Application programming interface. 
  19325.  
  19326.  application  - A collection of software components used to perform specific 
  19327.    types of work on a computer; for example, a payroll application, an airline 
  19328.    reservation application, a network application. 
  19329.  
  19330.  application object  - In SAA Advanced Common User Access architecture, a form 
  19331.    that an application provides for a user; for example, a spreadsheet form. 
  19332.    Contrast with user object. 
  19333.  
  19334.  application programming interface (API)  - A functional interface supplied by 
  19335.    the operating system or by a separately orderable licensed program that 
  19336.    allows an application program written in a high-level language to use 
  19337.    specific data or functions of the operating system or the licensed program. 
  19338.  
  19339.  application-modal  - Pertaining to a message box or dialog box for which 
  19340.    processing must be completed before further interaction with any other 
  19341.    window owned by the same application may take place. 
  19342.  
  19343.  area  - In computer graphics, a filled shape such as a solid rectangle. 
  19344.  
  19345.  ASCII  - American National Standard Code for Information Interchange. 
  19346.  
  19347.  ASCIIZ  - A string of ASCII characters that is terminated with a byte 
  19348.    containing the value 0. 
  19349.  
  19350.  aspect ratio  - In computer graphics, the width-to-height ratio of an area, 
  19351.    symbol, or shape. 
  19352.  
  19353.  asynchronous (ASYNC)  - (1) Pertaining to two or more processes that do not 
  19354.    depend upon the occurrence of specific events such as common timing 
  19355.    signals. (T)  (2) Without regular time relationship;  unexpected or 
  19356.    unpredictable with respect to the execution of program instructions. See 
  19357.    also synchronous. 
  19358.  
  19359.  atom  - A constant that represents a string. As soon as a string has been 
  19360.    defined as an atom, the atom can be used in place of the string to save 
  19361.    space. Strings are associated with their respective atoms in an atom table. 
  19362.    See also integer atom. 
  19363.  
  19364.  atom table  - A table used to relate atoms with the strings that they 
  19365.    represent. Also in the table is the mechanism by which the presence of a 
  19366.    string can be checked. 
  19367.  
  19368.  atomic operation  - An operation that completes its work on an object before 
  19369.    another operation can be performed on the same object. 
  19370.  
  19371.  attribute  - A characteristic or property that can be controlled, usually to 
  19372.    obtain a required appearance;  for example, the color of a line. See also 
  19373.    graphics attributes and segment attributes. 
  19374.  
  19375.  automatic link  - In Information Presentation Facility (IPF), a link that 
  19376.    begins a chain reaction at the primary window. When the user selects the 
  19377.    primary window, an automatic link is activated to display secondary windows. 
  19378.  
  19379.  AVIO  - Advanced Video Input/Output. 
  19380.  
  19381.  
  19382. ΓòÉΓòÉΓòÉ <hidden> Glossary - B ΓòÉΓòÉΓòÉ
  19383.  
  19384.  B╨Æzier curve  - (1) A mathematical technique of specifying smooth continous 
  19385.    lines and surfaces, which require a starting point and a finishing point 
  19386.    with several intermediate points that influence or control the path of the 
  19387.    linking curve. Named after Dr. P. B╨Æzier. (2) (D of C) In the AIX Graphics 
  19388.    Library, a cubic spline approximation to a set of four control points that 
  19389.    passes through the first and fourth control points and that has a continuous 
  19390.    slope where two spline segments meet. Named after Dr. P. B╨Æzier. 
  19391.  
  19392.  background  - (1) In multiprogramming, the conditions under which low-priority 
  19393.    programs are executed. Contrast with foreground. (2) An active session that 
  19394.    is not currently displayed on the screen. 
  19395.  
  19396.  background color  - The color in which the background of a graphic primitive 
  19397.    is drawn. 
  19398.  
  19399.  background mix  - An attribute that determines how the background of a graphic 
  19400.    primitive is combined with the existing color of the graphics presentation 
  19401.    space. Contrast with mix. 
  19402.  
  19403.  background program  - In multiprogramming, a program that executes with a low 
  19404.    priority. Contrast with foreground program. 
  19405.  
  19406.  bit map  - A representation in memory of the data displayed on an APA device, 
  19407.    usually the screen. 
  19408.  
  19409.  block  - (1) A string of data elements recorded or transmitted as a unit. The 
  19410.    elements may be characters, words, or logical records. (T)  (2) To record 
  19411.    data in a block. (3) A collection of contiguous records recorded as a unit. 
  19412.    Blocks are separated by interblock gaps and each block may contain one or 
  19413.    more records. (A)
  19414.  
  19415.  block device  - A storage device that performs I/O operations on blocks of 
  19416.    data called sectors. Data on block devices can be randomly accessed. Block 
  19417.    devices are designated by a drive letter (for example, C:). 
  19418.  
  19419.  blocking mode  - A condition set by an application that determines when its 
  19420.    threads might block. For example, an application might set the Pipemode 
  19421.    parameter for the DosCreateNPipe function so that its threads perform I/O 
  19422.    operations to the named pipe block when no data is available. 
  19423.  
  19424.  border  - A visual indication (for example, a separator line or a background 
  19425.    color) of the boundaries of a window. 
  19426.  
  19427.  boundary determination  - An operation used to compute the size of the 
  19428.    smallest rectangle that encloses a graphics object on the screen. 
  19429.  
  19430.  breakpoint  - (1) A point in a computer program where execution may be halted. 
  19431.    A breakpoint is usually at the beginning of an instruction where halts, 
  19432.    caused by external intervention, are convenient for resuming 
  19433.    execution. (T)  (2) A place in a program, specified by a command or a 
  19434.    condition, where the system halts execution and gives control to the 
  19435.    workstation user or to a specified program. 
  19436.  
  19437.  broken pipe  - When all of the handles that access one end of a pipe have been 
  19438.    closed. 
  19439.  
  19440.  bucket  - One or more fields in which the result of an operation is kept. 
  19441.  
  19442.  buffer  - (1) A portion of storage used to hold input or output data 
  19443.    temporarily. (2) To allocate and schedule the use of buffers. (A)
  19444.  
  19445.  button  - A mechanism used to request or initiate an action. See also barrel 
  19446.    buttons, bezel buttons, mouse button, push button, and radio button. 
  19447.  
  19448.  byte pipe  - Pipes that handle data as byte streams. All unnamed pipes are 
  19449.    byte pipes. Named pipes can be byte pipes or message pipes. See byte stream. 
  19450.  
  19451.  byte stream  - Data that consists of an unbroken stream of bytes. 
  19452.  
  19453.  
  19454. ΓòÉΓòÉΓòÉ <hidden> Glossary - C ΓòÉΓòÉΓòÉ
  19455.  
  19456.  cache  - A high-speed buffer storage that contains frequently accessed 
  19457.    instructions and data; it is used to reduce access time. 
  19458.  
  19459.  cached micro presentation space  - A presentation space from a 
  19460.    Presentation-Manager-owned store of micro presentation spaces. It can be 
  19461.    used for drawing to a window only, and must be returned to the store when 
  19462.    the task is complete. 
  19463.  
  19464.  CAD  - Computer-Aided Design. 
  19465.  
  19466.  call  - (1) The action of bringing a computer program, a routine, or a 
  19467.    subroutine into effect, usually by specifying the entry conditions and 
  19468.    jumping to an entry point. (I)  (A)  (2) To transfer control to a procedure, 
  19469.    program, routine, or subroutine. 
  19470.  
  19471.  calling sequence  - A sequence of instructions together with any associated 
  19472.    data necessary to execute a call. (T)
  19473.  
  19474.  Cancel  - An action that removes the current window or menu without processing 
  19475.    it, and returns the previous window. 
  19476.  
  19477.  cascaded menu  - In the OS/2 operating system, a menu that appears when the 
  19478.    arrow to the right of a cascading choice is selected. It contains a set of 
  19479.    choices that are related to the cascading choice. Cascaded menus are used to 
  19480.    reduce the length of a menu. See also cascading choice. 
  19481.  
  19482.  cascading choice  - In SAA Common User Access architecture, a choice in a menu 
  19483.    that, when selected, produces a cascaded menu containing other choices.  An 
  19484.    arrow () appears to the right of the cascading choice. 
  19485.  
  19486.  CASE statement  - In PM programming, provides the body of a window procedure. 
  19487.    There is usually one CASE statement for each message type supported by an 
  19488.    application. 
  19489.  
  19490.  CGA  - Color graphics adapter. 
  19491.  
  19492.  chained list  - A list in which the data elements may be dispersed but in 
  19493.    which each data element contains information for locating the 
  19494.    next. (T)Synonymous with linked list. 
  19495.  
  19496.  character  - A letter, digit, or other symbol. 
  19497.  
  19498.  character box  - In computer graphics, the boundary that defines, in world 
  19499.    coordinates, the horizontal and vertical space occupied by a single 
  19500.    character from a character set. See also character mode. Contrast with 
  19501.    character cell. 
  19502.  
  19503.  character cell  - The physical, rectangular space in which any single 
  19504.    character is displayed on a screen or printer device. Position is addressed 
  19505.    by row and column coordinates. Contrast with character box. 
  19506.  
  19507.  character code  - The means of addressing a character in a character set, 
  19508.    sometimes called code point. 
  19509.  
  19510.  character device  - A device that performs I/O operations on one character at 
  19511.    a time. Because character devices view data as a stream of bytes, 
  19512.    character-device data cannot be randomly accessed. Character devices include 
  19513.    the keyboard, mouse, and printer, and are referred to by name. 
  19514.  
  19515.  character mode  - A mode that, in conjunction with the font type, determines 
  19516.    the extent to which graphics characters are affected by the character box, 
  19517.    shear, and angle attributes. 
  19518.  
  19519.  character set  - (1) An ordered set of unique representations called 
  19520.    characters; for example, the 26 letters of English alphabet, Boolean 0 and 
  19521.    1, the set of symbols in the Morse code, and the 128 ASCII 
  19522.    characters. (A)  (2) All the valid characters for a programming language or 
  19523.    for a computer system. (3) A group of characters used for a specific reason; 
  19524.    for example, the set of characters a printer can print. 
  19525.  
  19526.  check box  - In SAA Advanced Common User Access architecture, a square box 
  19527.    with associated text that represents a choice. When a user selects a choice, 
  19528.    an X appears in the check box to indicate that the choice is in effect. The 
  19529.    user can clear the check box by selecting the choice again. Contrast with 
  19530.    radio button. 
  19531.  
  19532.  check mark  -  (1) (D of C) In SAA Advanced Common User Access architecture, a 
  19533.    symbol that shows that a choice is currently in effect. (2) The symbol that 
  19534.    is used to indicate a selected item on a pull-down menu. 
  19535.  
  19536.  child process  - In the OS/2 operating system, a process started by another 
  19537.    process, which is called the parent process. Contrast with parent process. 
  19538.  
  19539.  child window  - A window that appears within the border of its parent window 
  19540.    (either a primary window or another child window). When the parent window is 
  19541.    resized, moved, or destroyed, the child window also is resized, moved, or 
  19542.    destroyed; however, the child window can be moved or resized independently 
  19543.    from the parent window, within the boundaries of the parent window. Contrast 
  19544.    with parent window. 
  19545.  
  19546.  choice  - (1) An option that can be selected. The choice can be presented as 
  19547.    text, as a symbol (number or letter), or as an icon (a pictorial symbol). 
  19548.    (2) (D of C) In SAA Common User Access architecture, an item that a user can 
  19549.    select. 
  19550.  
  19551.  chord  - (1) To press more than one button on a pointing device while the 
  19552.    pointer is within the limits that the user has specified for the operating 
  19553.    environment. (2) (D of C) In graphics, a short line segment whose end points 
  19554.    lie on a circle. Chords are a means for producing a circular image from 
  19555.    straight lines. The higher the number of chords per circle, the smoother the 
  19556.    circular image. 
  19557.  
  19558.  class  - A way of categorizing objects based on their behavior and shape. A 
  19559.    class is, in effect, a definition of a generic object. In SOM, a class is a 
  19560.    special kind of object that can manufacture other objects that all have a 
  19561.    common shape and exhibit similar behavior (more precisely, all of the 
  19562.    objects manufactured by a class have the same memory layout and share a 
  19563.    common set of methods). New classes can be defined in terms of existing 
  19564.    classes through a technique known as inheritance. 
  19565.  
  19566.  class method  - A class method of class <X> is a method provided by the 
  19567.    metaclass of class <X>. Class methods are executed without requiring any 
  19568.    instances of class <X> to exist, and are frequently used to create 
  19569.    instances. In System Object Model, an action that can be performed on a 
  19570.    class object. 
  19571.  
  19572.  class object  - In System Object Model, the run-time implementation of a 
  19573.    class. 
  19574.  
  19575.  class style  - The set of properties that apply to every window in a window 
  19576.    class. 
  19577.  
  19578.  client  - (1) A functional unit that receives shared services from a 
  19579.    server. (T)  (2) A user, as in a client process that uses a named pipe or 
  19580.    queue that is created and owned by a server process. 
  19581.  
  19582.  client area  - The part of the window, inside the border, that is below the 
  19583.    menu bar. It is the user's work space, where a user types information and 
  19584.    selects choices from selection fields.  In primary windows, it is where an 
  19585.    application programmer presents the objects that a user works on. 
  19586.  
  19587.  client program  - An application that creates and manipulates instances of 
  19588.    classes. 
  19589.  
  19590.  client window  - The window in which the application displays output and 
  19591.    receives input. This window is located inside the frame window, under the 
  19592.    window title bar and any menu bar, and within any scroll bars. 
  19593.  
  19594.  clip limits  - The area of the paper that can be reached by a printer or 
  19595.    plotter. 
  19596.  
  19597.  clipboard  - In SAA Common User Access architecture, an area of computer 
  19598.    memory, or storage, that temporarily holds data. Data in the clipboard is 
  19599.    available to other applications. 
  19600.  
  19601.  clipping  - In computer graphics, removing those parts of a display image that 
  19602.    lie outside a given boundary. (I)  (A)
  19603.  
  19604.  clipping area  - The area in which the window can paint. 
  19605.  
  19606.  clipping path  - A clipping boundary in world-coordinate space. 
  19607.  
  19608.  clock tick  - The minimum unit of time that the system tracks. If the system 
  19609.    timer currently counts at a rate of X Hz, the system tracks the time every 
  19610.    1/X of a second. Also known as time tick. 
  19611.  
  19612.  CLOCK$  - Character-device name reserved for the system clock. 
  19613.  
  19614.  code page  - An assignment of graphic characters and control-function meanings 
  19615.    to all code points. 
  19616.  
  19617.  code point  - (1) Synonym for character code. (2) (D of C) A 1-byte code 
  19618.    representing one of 256 potential characters. 
  19619.  
  19620.  code segment  - An executable section of programming code within a load 
  19621.    module. 
  19622.  
  19623.  color dithering  - See dithering. 
  19624.  
  19625.  color graphics adapter (CGA)  - An adapter that simultaneously provides four 
  19626.    colors and is supported by all IBM Personal Computer and Personal System/2 
  19627.    models. 
  19628.  
  19629.  command  - The name and parameters associated with an action that a program 
  19630.    can perform. 
  19631.  
  19632.  command area  - An area composed of a command field prompt and a command entry 
  19633.    field. 
  19634.  
  19635.  command entry field  - An entry field in which users type commands. 
  19636.  
  19637.  command line  - On a display screen, a display line, sometimes at the bottom 
  19638.    of the screen, in which only commands can be entered. 
  19639.  
  19640.  command mode  - A state of a system or device in which the user can enter 
  19641.    commands. 
  19642.  
  19643.  command prompt  - A field prompt showing the location of the command entry 
  19644.    field in a panel. 
  19645.  
  19646.  Common Programming Interface (CPI)  - Definitions of those application 
  19647.    development languages and services that have, or are intended to have, 
  19648.    implementations on and a high degree of commonality across the SAA 
  19649.    environments. One of the three SAA architectural areas. See also Common User 
  19650.    Access architecture. 
  19651.  
  19652.  Common User Access (CUA) architecture  -  Guidelines for the dialog between a 
  19653.    human and a workstation or terminal. One of the three SAA architectural 
  19654.    areas. See also Common Programming Interface. 
  19655.  
  19656.  compile  - To translate a program written in a higher-level programming 
  19657.    language into a machine language program. 
  19658.  
  19659.  composite window  - A window composed of other windows (such as a frame 
  19660.    window, frame-control windows, and a client window) that are kept together 
  19661.    as a unit and that interact with each other. 
  19662.  
  19663.  computer-aided design (CAD)  - The use of a computer to design or change a 
  19664.    product, tool, or machine, such as using a computer for drafting or 
  19665.    illustrating. 
  19666.  
  19667.  COM1, COM2, COM3  - Character-device names reserved for serial ports 1 through 
  19668.    3. 
  19669.  
  19670.  CON  - Character-device name reserved for the console keyboard and screen. 
  19671.  
  19672.  conditional cascaded menu  - A pull-down menu associated with a menu item that 
  19673.    has a cascade mini-push button beside it in an object's pop-up menu. The 
  19674.    conditional cascaded menu is displayed when the user selects the mini-push 
  19675.    button. 
  19676.  
  19677.  container  - In SAA Common User Access architecture, an object that holds 
  19678.    other objects. A folder is an example of a container object. See also folder 
  19679.    and object. 
  19680.  
  19681.  contextual help  - In SAA Common User Access Architecture, help that gives 
  19682.    specific information about the item the cursor is on. The help is contextual 
  19683.    because it provides information about a specific item as it is currently 
  19684.    being used. Contrast with extended help. 
  19685.  
  19686.  contiguous  - Touching or joining at a common edge or boundary, for example, 
  19687.    an unbroken consecutive series of storage locations. 
  19688.  
  19689.  control  - In SAA Advanced Common User Access architecture, a component of the 
  19690.    user interface that allows a user to select choices or type information; for 
  19691.    example, a check box, an entry field, a radio button. 
  19692.  
  19693.  control area  - A storage area used by a computer program to hold control information. (I)  (A)
  19694.  
  19695.  Control Panel  - In the Presentation Manager, a program used to set up user 
  19696.    preferences that act globally across the system. 
  19697.  
  19698.  Control Program  - (1) The basic functions of the operating system, including 
  19699.    DOS emulation and the support for keyboard, mouse, and video input/output. 
  19700.    (2) A computer program designed to schedule and to supervise the execution 
  19701.    of programs of a computer system. (I)  (A)
  19702.  
  19703.  control window  - A window that is used as part of a composite window to 
  19704.    perform simple input and output tasks. Radio buttons and check boxes are 
  19705.    examples. 
  19706.  
  19707.  control word  - An instruction within a document that identifies its parts or 
  19708.    indicates how to format the document. 
  19709.  
  19710.  coordinate space  - A two-dimensional set of points used to generate output on 
  19711.    a video display of printer. 
  19712.  
  19713.  Copy  - A choice that places onto the clipboard, a copy of what the user has 
  19714.    selected. See also Cut and Paste. 
  19715.  
  19716.  correlation  - The action of determining which element or object within a 
  19717.    picture is at a given position on the display. This follows a pick 
  19718.    operation. 
  19719.  
  19720.  coverpage window  - A window in which the application's help information is 
  19721.    displayed. 
  19722.  
  19723.  CPI  - Common Programming Interface. 
  19724.  
  19725.  critical extended attribute  - An extended attribute that is necessary for the 
  19726.    correct operation of the system or a particular application. 
  19727.  
  19728.  critical section  - (1) In programming languages, a part of an asynchronous 
  19729.    procedure that cannot be executed simultaneously with a certain part of 
  19730.    another asynchronous procedure. (I)
  19731.  
  19732.    Note:  Part of the other asynchronous procedure also is a critical section. 
  19733.    (2) A section of code that is not reentrant; that is, code that can be 
  19734.    executed by only one thread at a time. 
  19735.  
  19736.  CUA architecture  - Common User Access architecture. 
  19737.  
  19738.  current position  - In computer graphics, the position, in user coordinates, 
  19739.    that becomes the starting point for the next graphics routine, if that 
  19740.    routine does not explicitly specify a starting point. 
  19741.  
  19742.  cursor  - A symbol displayed on the screen and associated with an input 
  19743.    device. The cursor indicates where input from the device will be placed. 
  19744.    Types of cursors include text cursors, graphics cursors, and selection 
  19745.    cursors. Contrast with pointer and input focus. 
  19746.  
  19747.  Cut  - In SAA Common User Access architecture, a choice that removes a 
  19748.    selected object, or a part of an object, to the clipboard, usually 
  19749.    compressing the space it occupied in a window. See also Copy and Paste. 
  19750.  
  19751.  
  19752. ΓòÉΓòÉΓòÉ <hidden> Glossary - D ΓòÉΓòÉΓòÉ
  19753.  
  19754.  daisy chain  - A method of device interconnection for determining interrupt 
  19755.    priority by connecting the interrupt sources serially. 
  19756.  
  19757.  data segment  - A nonexecutable section of a program module; that is, a 
  19758.    section of a program that contains data definitions. 
  19759.  
  19760.  data structure  - The syntactic structure of symbolic expressions and their 
  19761.    storage-allocation characteristics. (T)
  19762.  
  19763.  data transfer  - The movement of data from one object to another by way of the 
  19764.    clipboard or by direct manipulation. 
  19765.  
  19766.  DBCS  - Double-byte character set. 
  19767.  
  19768.  DDE  - Dynamic data exchange. 
  19769.  
  19770.  deadlock  - (1) Unresolved contention for the use of a resource. (2) An error 
  19771.    condition in which processing cannot continue because each of two elements 
  19772.    of the process is waiting for an action by, or a response from, the other. 
  19773.    (3) An impasse that occurs when multiple processes are waiting for the 
  19774.    availability of a resource that will not become available because it is 
  19775.    being held by another process that is in a similar wait state. 
  19776.  
  19777.  debug  - To detect, diagnose, and eliminate errors in programs. (T)
  19778.  
  19779.  decipoint  - In printing, one tenth of a point.  There are 72 points in an 
  19780.    inch. 
  19781.  
  19782.  default procedure  - A function provided by the Presentation Manager Interface 
  19783.    that may be used to process standard messages from dialogs or windows. 
  19784.  
  19785.  default value  - A value assumed when no value has been specified. Synonymous 
  19786.    with assumed value. For example, in the graphics programming interface, the 
  19787.    default line-type is 'solid'. 
  19788.  
  19789.  definition list  - A type of list that pairs a term and its description. 
  19790.  
  19791.  delta  - An application-defined threshold, or number of container items, from 
  19792.    either end of the list. 
  19793.  
  19794.  descendant  - See child process. 
  19795.  
  19796.  descriptive text  - Text used in addition to a field prompt to give more 
  19797.    information about a field. 
  19798.  
  19799.  Deselect all  - A choice that cancels the selection of all of the objects that 
  19800.    have been selected in that window. 
  19801.  
  19802.  Desktop Manager  - In the Presentation Manager, a window that displays a list 
  19803.    of groups of programs, each of which can be started or stopped. 
  19804.  
  19805.  desktop window  - The window, corresponding to the physical device, against 
  19806.    which all other types of windows are established. 
  19807.  
  19808.  detached process  - A background process that runs independent of the parent 
  19809.    process. 
  19810.  
  19811.  detent  - A point on a slider that represents an exact value to which a user 
  19812.    can move the slider arm. 
  19813.  
  19814.  device context  - A logical description of a data destination such as memory, 
  19815.    metafile, display, printer, or plotter. See also direct device context, 
  19816.    information device context, memory device context, metafile device context, 
  19817.    queued device context, and screen device context. 
  19818.  
  19819.  device driver  - A file that contains the code needed to attach and use a 
  19820.    device such as a display, printer, or plotter. 
  19821.  
  19822.  device space  - (1) Coordinate space in which graphics are assembled after all 
  19823.    GPI transformations have been applied. Device space is defined in 
  19824.    device-specific units. (2) ( D of C) In computer graphics, a space defined 
  19825.    by the complete set of addressable points of a display device. (A)
  19826.  
  19827.  dialog  - The interchange of information between a computer and its user 
  19828.    through a sequence of requests by the user and the presentation of responses 
  19829.    by the computer. 
  19830.  
  19831.  dialog box  - In SAA Advanced Common User Access architecture, a movable 
  19832.    window, fixed in size, containing controls that a user uses to provide 
  19833.    information required by an application so that it can continue to process a 
  19834.    user request. See also message box, primary window, secondary window. Also 
  19835.    known as a pop-up window. 
  19836.  
  19837.  Dialog Box Editor  - A WYSIWYG editor that creates dialog boxes for 
  19838.    communicating with the application user. 
  19839.  
  19840.  dialog item  - A component (for example, a menu or a button) of a dialog box. 
  19841.    Dialog items are also used when creating dialog templates. 
  19842.  
  19843.  dialog procedure  - A dialog window that is controlled by a window procedure. 
  19844.    It is responsible for responding to all messages sent to the dialog window. 
  19845.  
  19846.  dialog tag language  - A markup language used by the DTL compiler to create 
  19847.    dialog objects. 
  19848.  
  19849.  dialog template  - The definition of a dialog box, which contains details of 
  19850.    its position, appearance, and window ID, and the window ID of each of its 
  19851.    child windows. 
  19852.  
  19853.  direct device context  - A logical description of a data destination that is a 
  19854.    device other than the screen (for example, a printer or plotter), and where 
  19855.    the output is not to go through the spooler. Its purpose is to satisfy 
  19856.    queries. See also device context. 
  19857.  
  19858.  direct manipulation  - The user's ability to interact with an object by using 
  19859.    the mouse, typically by dragging an object around on the Desktop and 
  19860.    dropping it on other objects. 
  19861.  
  19862.  direct memory access (DMA)  - A technique for moving data directly between 
  19863.    main storage and peripheral equipment without requiring processing of the 
  19864.    data by the processing unit.(T)
  19865.  
  19866.  directory  - A type of file containing the names and controlling information 
  19867.    for other files or other directories. 
  19868.  
  19869.  display point  - Synonym for pel. 
  19870.  
  19871.  dithering  - (1) The process used in color displays whereby every other pel is 
  19872.    set to one color, and the intermediate pels are set to another. Together 
  19873.    they produce the effect of a third color at normal viewing distances. This 
  19874.    process can only be used on solid areas of color; it does not work, for 
  19875.    example, on narrow lines. (2) (D of C ) In computer graphics, a technique of 
  19876.    interleaving dark and light pixels so that the resulting image looks 
  19877.    smoothly shaded when viewed from a distance. 
  19878.  
  19879.  DMA  - Direct memory access. 
  19880.  
  19881.  DOS Protect Mode Interface (DPMI)  - An interface between protect mode and 
  19882.    real mode programs. 
  19883.  
  19884.  double-byte character set (DBCS)  - A set of characters in which each 
  19885.    character is represented by two bytes.  Languages such as Japanese, Chinese, 
  19886.    and Korean, which contain more characters than can be represented by 256 
  19887.    code points, require double-byte character sets. Since each character 
  19888.    requires two bytes, the entering, displaying, and printing of DBCS 
  19889.    characters requires hardware and software that can support DBCS. 
  19890.  
  19891.  doubleword  - A contiguous sequence of bits or characters that comprises two 
  19892.    computer words and is capable of being addressed as a unit. (A)
  19893.  
  19894.  DPMI  - DOS Protect Mode Interface. 
  19895.  
  19896.  drag  - In SAA Common User Access, to use a pointing device to move an object; 
  19897.    for example, clicking on a window border, and dragging it to make the window 
  19898.    larger. 
  19899.  
  19900.  dragging  - (1) In computer graphics, moving an object on the display screen 
  19901.    as if it were attached to the pointer. (2) (D of C) In computer graphics, 
  19902.    moving one or more segments on a display surface by translating. (I)  (A)
  19903.  
  19904.  drawing chain  - See segment chain. 
  19905.  
  19906.  drop  - To fix the position of an object that is being dragged, by releasing 
  19907.    the select button of the pointing device. 
  19908.  
  19909.  drop  - To fix the position of an object that is being dragged, by releasing 
  19910.    the select button of the pointing device. See also drag. 
  19911.  
  19912.  DTL  - Dialog tag language. 
  19913.  
  19914.  dual-boot function  - A feature of the OS/2 operating system that allows the 
  19915.    user to start DOS from within the operating system, or an OS/2 session from 
  19916.    within DOS. 
  19917.  
  19918.  duplex  - Pertaining to communication in which data can be sent and received 
  19919.    at the same time. Synonymous with full duplex. 
  19920.  
  19921.  dynamic data exchange (DDE)  - A message protocol used to communicate between 
  19922.    applications that share data. The protocol uses shared memory as the means 
  19923.    of exchanging data between applications. 
  19924.  
  19925.  dynamic data formatting  - A formatting procedure that enables you to 
  19926.    incorporate text, bit maps or metafiles in an IPF window at execution time. 
  19927.  
  19928.  dynamic link library  - A collection of executable programming code and data 
  19929.    that is bound to an application at load time or run time, rather than during 
  19930.    linking. The programming code and data in a dynamic link library can be 
  19931.    shared by several applications simultaneously. 
  19932.  
  19933.  dynamic linking  - The process of resolving external references in a program 
  19934.    module at load time or run time rather than during linking. 
  19935.  
  19936.  dynamic segments  - Graphics segments drawn in exclusive-OR mix mode so that 
  19937.    they can be moved from one screen position to another without affecting the 
  19938.    rest of the displayed picture. 
  19939.  
  19940.  dynamic storage  - (1) A device that stores data in a manner that permits the 
  19941.    data to move or vary with time such that the specified data is not always 
  19942.    available for recovery. (A)  (2) A storage in which the cells require 
  19943.    repetitive application of control signals in order to retain stored data. 
  19944.    Such repetitive application of the control signals is called a refresh 
  19945.    operation. A dynamic storage may use static addressing or sensing 
  19946.    circuits. (A)  (3) See also static storage. 
  19947.  
  19948.  dynamic time slicing  - Varies the size of the time slice depending on system 
  19949.    load and paging activity. 
  19950.  
  19951.  dynamic-link module  - A module that is linked at load time or run time. 
  19952.  
  19953.  
  19954. ΓòÉΓòÉΓòÉ <hidden> Glossary - E ΓòÉΓòÉΓòÉ
  19955.  
  19956.  EBCDIC  - Extended binary-coded decimal interchange code. A coded character 
  19957.    set consisting of 8-bit coded characters (9 bits including parity check), 
  19958.    used for information interchange among data processing systems, data 
  19959.    communications systems, and associated equipment. 
  19960.  
  19961.  edge-triggered  - Pertaining to an event semaphore that is posted then reset 
  19962.    before a waiting thread gets a chance to run. The semaphore is considered to 
  19963.    be posted for the rest of that thread's waiting period; the thread does not 
  19964.    have to wait for the semaphore to be posted again. 
  19965.  
  19966.  EGA  - Extended graphics adapter. 
  19967.  
  19968.  element  - An entry in a graphics segment that comprises one or more graphics 
  19969.    orders and that is addressed by the element pointer. 
  19970.  
  19971.  EMS  - Expanded Memory Specification. 
  19972.  
  19973.  encapsulation  - Hiding an object's implementation, that is, its private, 
  19974.    internal data and methods. Private variables and methods are accessible only 
  19975.    to the object that contains them. 
  19976.  
  19977.  entry field  - In SAA Common User Access architecture, an area where a user 
  19978.    types information. Its boundaries are usually indicated. See also selection 
  19979.    field. 
  19980.  
  19981.  entry panel  - A defined panel type containing one or more entry fields and 
  19982.    protected information such as headings, prompts, and explanatory text. 
  19983.  
  19984.  entry-field control  - The component of a user interface that provides the 
  19985.    means by which the application receives data entered by the user in an entry 
  19986.    field. When it has the input focus, the entry field displays a flashing 
  19987.    pointer at the position where the next typed character will go. 
  19988.  
  19989.  environment segment  - The list of environment variables and their values for 
  19990.    a process. 
  19991.  
  19992.  environment strings  - ASCII text strings that define the value of environment 
  19993.    variables. 
  19994.  
  19995.  environment variables  - Variables that describe the execution environment of 
  19996.    a process. These variables are named by the operating system or by the 
  19997.    application. Environment variables named by the operating system are PATH, 
  19998.    DPATH, INCLUDE, INIT, LIB, PROMPT, and TEMP. The values of environment 
  19999.    variables are defined by the user in the CONFIG.SYS file, or by using the 
  20000.    SET command at the OS/2 command prompt. 
  20001.  
  20002.  error message  - An indication that an error has been detected. (A)
  20003.  
  20004.  event semaphore  - A semaphore that enables a thread to signal a waiting 
  20005.    thread or threads that an event has occurred or that a task has been 
  20006.    completed. The waiting threads can then perform an action that is dependent 
  20007.    on the completion of the signaled event. 
  20008.  
  20009.  exception  - An abnormal condition such as an I/O error encountered in 
  20010.    processing a data set or a file. 
  20011.  
  20012.  exclusive system semaphore  - A system semaphore that can be modified only by 
  20013.    threads within the same process. 
  20014.  
  20015.  executable file  - (1) A file that contains programs or commands that perform 
  20016.    operations or actions to be taken. (2) A collection of related data records 
  20017.    that execute programs. 
  20018.  
  20019.  exit  - To execute an instruction within a portion of a computer program in 
  20020.    order to terminate the execution of that portion. Such portions of computer 
  20021.    programs include loops, subroutines, modules, and so on. (T)  Repeated exit 
  20022.    requests return the user to the point from which all functions provided to 
  20023.    the system are accessible. Contrast with cancel. 
  20024.  
  20025.  expanded memory specification (EMS)  - Enables DOS applications to access 
  20026.    memory above the 1MB real mode addressing limit. 
  20027.  
  20028.  extended attribute  - An additional piece of information about a file object, 
  20029.    such as its data format or category. It consists of a name and a value. A 
  20030.    file object may have more than one extended attribute associated with it. 
  20031.  
  20032.  extended help  - In SAA Common User Access architecture, a help action that 
  20033.    provides information about the contents of the application window from which 
  20034.    a user requested help. Contrast with contextual help. 
  20035.  
  20036.  extended-choice selection  - A mode that allows the user to select more than 
  20037.    one item from a window. Not all windows allow extended choice selection. 
  20038.    Contrast with multiple-choice selection. 
  20039.  
  20040.  extent  - Continuous space on a disk or diskette that is occupied by or 
  20041.    reserved for a particular data set, data space, or file. 
  20042.  
  20043.  external link  - In Information Presentation Facility, a link that connects 
  20044.    external online document files. 
  20045.  
  20046.  
  20047. ΓòÉΓòÉΓòÉ <hidden> Glossary - F ΓòÉΓòÉΓòÉ
  20048.  
  20049.  family-mode application  - An application program that can run in the OS/2 
  20050.    environment and in the DOS environment; however, it cannot take advantage of 
  20051.    many of the OS/2-mode facilities, such as multitasking, interprocess 
  20052.    communication, and dynamic linking. 
  20053.  
  20054.  FAT  - File allocation table. 
  20055.  
  20056.  FEA  - Full extended attribute. 
  20057.  
  20058.  field-level help  - Information specific to the field on which the cursor is 
  20059.    positioned. This help function is "contextual" because it provides 
  20060.    information about a specific item as it is currently used; the information 
  20061.    is dependent upon the context within the work session. 
  20062.  
  20063.  FIFO  - First-in-first-out. (A)
  20064.  
  20065.  file  - A named set of records stored or processed as a unit. (T)
  20066.  
  20067.  file allocation table (FAT)  - In IBM personal computers, a table used by the 
  20068.    operating system to allocate space on a disk for a file, and to locate and 
  20069.    chain together parts of the file that may be scattered on different sectors 
  20070.    so that the file can be used in a random or sequential manner. 
  20071.  
  20072.  file attribute  - Any of the attributes that describe the characteristics of a 
  20073.    file. 
  20074.  
  20075.  File Manager  - In the Presentation Manager, a program that displays 
  20076.    directories and files, and allows various actions on them. 
  20077.  
  20078.  file specification  - The full identifier for a file, which includes its drive 
  20079.    designation, path, file name, and extension. 
  20080.  
  20081.  file system  - The combination of software and hardware that supports storing 
  20082.    information on a storage device. 
  20083.  
  20084.  file system driver (FSD)  - A program that manages file I\O and controls the 
  20085.    format of information on the storage media. 
  20086.  
  20087.  fillet  - A curve that is tangential to the end points of two adjoining lines. 
  20088.    See also polyfillet. 
  20089.  
  20090.  filtering  - An application process that changes the order of data in a queue. 
  20091.  
  20092.  first-in-first-out (FIFO)  - A queuing technique in which the next item to be 
  20093.    retrieved is the item that has been in the queue for the longest time. (A)
  20094.  
  20095.  flag  - (1) An indicator or parameter that shows the setting of a switch. (2) 
  20096.    A character that signals the occurrence of some condition, such as the end 
  20097.    of a word. (A)  (3) (D of C) A characteristic of a file or directory that 
  20098.    enables it to be used in certain ways. See also archive flag, hidden flag, 
  20099.    and read-only flag. 
  20100.  
  20101.  focus  - See input focus. 
  20102.  
  20103.  folder  - A container used to organize objects. 
  20104.  
  20105.  font  - A particular size and style of typeface that contains definitions of 
  20106.    character sets, marker sets, and pattern sets. 
  20107.  
  20108.  Font Editor  - A utility program provided with the IBM Developers Toolkit that 
  20109.    enables the design and creation of new fonts. 
  20110.  
  20111.  foreground program  - (1) The program with which the user is currently 
  20112.    interacting. Also known as interactive program. Contrast with background 
  20113.    program. (2) (D of C) In multiprogramming,  a high-priority program. 
  20114.  
  20115.  frame  - The part of a window that can contain several different visual 
  20116.    elements specified by the application, but drawn and controlled by the 
  20117.    Presentation Manager. The frame encloses the client area. 
  20118.  
  20119.  frame styles  - Standard window layouts provided by the Presentation Manager. 
  20120.  
  20121.  FSD  - File system driver. 
  20122.  
  20123.  full-duplex  - Synonym for duplex. 
  20124.  
  20125.  full-screen application  - An application that has complete control of the 
  20126.    screen. 
  20127.  
  20128.  function  - (1) In a programming language, a block, with or without formal 
  20129.    parameters, whose execution is invoked by means of a call. (2) A set of 
  20130.    related control statements that cause one or more programs to be performed. 
  20131.  
  20132.  function key  - A key that causes a specified sequence of operations to be 
  20133.    performed when it is pressed, for example, F1 and Alt-K. 
  20134.  
  20135.  function key area  - The area at the bottom of a window that contains function 
  20136.    key assignments such as F1=Help. 
  20137.  
  20138.  
  20139. ΓòÉΓòÉΓòÉ <hidden> Glossary - G ΓòÉΓòÉΓòÉ
  20140.  
  20141.  GDT  - Global Descriptor Table. 
  20142.  
  20143.  general protection fault  - An exception condition that occurs when a process 
  20144.    attempts to use storage or a module that has some level of protection 
  20145.    assigned to it, such as I/O privilege level. See also IOPL code segment. 
  20146.  
  20147.  Global Descriptor Table (GDT)  - A table that defines code and data segments 
  20148.    available to all tasks in an application. 
  20149.  
  20150.  global dynamic-link module  - A dynamic-link module that can be shared by all 
  20151.    processes in the system that refer to the module name. 
  20152.  
  20153.  global file-name character  - Either a question mark (?) or an asterisk (*) 
  20154.    used as a variable in a file name or file name extension when referring to a 
  20155.    particular file or group of files. 
  20156.  
  20157.  glyph  - A graphic symbol whose appearance conveys information. 
  20158.  
  20159.  GPI  - Graphics programming interface. 
  20160.  
  20161.  graphic primitive  - In computer graphics, a basic element, such as an arc or 
  20162.    a line, that is not made up of smaller parts and that is used to create 
  20163.    diagrams and pictures. See also graphics segment. 
  20164.  
  20165.  graphics  - (1) A picture defined in terms of graphic primitives and graphics 
  20166.    attributes. (2) (D of C) The making of charts and pictures. (3) Pertaining 
  20167.    to charts, tables, and their creation. (4) See computer graphics, coordinate 
  20168.    graphics, fixed-image graphics, interactive graphics, passive graphics, 
  20169.    raster graphics. 
  20170.  
  20171.  graphics attributes  - Attributes that apply to graphic primitives. Examples 
  20172.    are color, line type, and shading-pattern definition. See also segment 
  20173.    attributes. 
  20174.  
  20175.  graphics field  - The clipping boundary that defines the visible part of the 
  20176.    presentation-page contents. 
  20177.  
  20178.  graphics mode  - One of several states of a display. The mode determines the 
  20179.    resolution and color content of the screen. 
  20180.  
  20181.  graphics model space  - The conceptual coordinate space in which a picture is 
  20182.    constructed after any model transforms have been applied. Also known as 
  20183.    model space. 
  20184.  
  20185.  Graphics programming interface  - The formally defined programming language 
  20186.    that is between an IBM graphics program and the user of the program. 
  20187.  
  20188.  graphics segment  - A sequence of related graphic primitives and graphics 
  20189.    attributes. See also graphic primitive. 
  20190.  
  20191.  graying  - The indication that a choice on a pull-down is unavailable. 
  20192.  
  20193.  group  - A collection of logically connected controls. For example, the 
  20194.    buttons controlling paper size for a printer could be called a group. See 
  20195.    also program group. 
  20196.  
  20197.  
  20198. ΓòÉΓòÉΓòÉ <hidden> Glossary - H ΓòÉΓòÉΓòÉ
  20199.  
  20200.  handle  - (1) An identifier that represents an object, such as a device or 
  20201.    window, to the Presentation Interface. (2) (D of C) In the Advanced DOS and 
  20202.    OS/2 operating systems, a binary value created by the system that identifies 
  20203.    a drive, directory, and file so that the file can be found and opened. 
  20204.  
  20205.  hard error  - An error condition on a network that requires either that the 
  20206.    system be reconfigured or that the source of the error be removed before the 
  20207.    system can resume reliable operation. 
  20208.  
  20209.  header  - (1) System-defined control information that precedes user data. (2) 
  20210.    The portion of a message that contains control information for the message, 
  20211.    such as one or more destination fields, name of the originating station, 
  20212.    input sequence number, character string indicating the type of message, and 
  20213.    priority level for the message. 
  20214.  
  20215.  heading tags  - A document element that enables information to be displayed in 
  20216.    windows, and that controls entries in the contents window controls placement 
  20217.    of push buttons in a window, and defines the shape and size of windows. 
  20218.  
  20219.  heap  - An area of free storage available for dynamic allocation by an 
  20220.    application. Its size varies according to the storage requirements of the 
  20221.    application. 
  20222.  
  20223.  help function  - (1) A function that provides information about a specific 
  20224.    field, an application panel, or information about the help facility. (2) (D 
  20225.    of C) One or more display images that describe how to use application 
  20226.    software or how to do a system operation. 
  20227.  
  20228.  Help index  - In SAA Common User Access architecture, a help action that 
  20229.    provides an index of the help information available for an application. 
  20230.  
  20231.  help panel  - A panel with information to assist users that is displayed in 
  20232.    response to a help request from the user. 
  20233.  
  20234.  help window  - A Common-User-Access-defined secondary window that displays 
  20235.    information when the user requests help. 
  20236.  
  20237.  hidden file  - An operating system file that is not displayed by a directory 
  20238.    listing. 
  20239.  
  20240.  hide button  - In the OS/2 operating system, a small, square button located in 
  20241.    the right-hand corner of the title bar of a window that, when selected, 
  20242.    removes from the screen all the windows associated with that window. 
  20243.    Contrast with maximize button. See also restore button. 
  20244.  
  20245.  hierarchical inheritance  - The relationship between parent and child classes. 
  20246.    An object that is lower in the inheritance hierarchy than another object, 
  20247.    inherits all the characteristics and behaviors of the objects above it in 
  20248.    the hierarchy. 
  20249.  
  20250.  hierarchy  - A tree of segments beginning with the root segment and proceeding 
  20251.    downward to dependent segment types. 
  20252.  
  20253.  high-performance file system (HPFS)  - In the OS/2 operating system, an 
  20254.    installable file system that uses high-speed buffer storage, known as a 
  20255.    cache, to provide fast access to large disk volumes. The file system also 
  20256.    supports the coexistence of multiple, active file systems on a single 
  20257.    personal computer, with the capability of multiple and different storage 
  20258.    devices. File names used with the HPFS can have as many as 254 characters. 
  20259.  
  20260.  hit testing  - The means of identifying which window is associated with which 
  20261.    input device event. 
  20262.  
  20263.  hook  - A point in a system-defined function where an application can supply 
  20264.    additional code that the system processes as though it were part of the 
  20265.    function. 
  20266.  
  20267.  hook chain  - A sequence of hook procedures that are "chained" together so 
  20268.    that each event is passed, in turn, to each procedure in the chain. 
  20269.  
  20270.  hot spot  - The part of the pointer that must touch an object before it can be 
  20271.    selected. This is usually the tip of the pointer. Contrast with action 
  20272.    point. 
  20273.  
  20274.  HPFS  - high-performance file system. 
  20275.  
  20276.  hypergraphic link  - A connection between one piece of information and another 
  20277.    through the use of graphics. 
  20278.  
  20279.  hypertext  - A way of presenting information online with connections between 
  20280.    one piece of information and another, called hypertext links. See also 
  20281.    hypertext link. 
  20282.  
  20283.  hypertext link  - A connection between one piece of information and another. 
  20284.  
  20285.  
  20286. ΓòÉΓòÉΓòÉ <hidden> Glossary - I ΓòÉΓòÉΓòÉ
  20287.  
  20288.  I/O operation  - An input operation to, or output operation from a device 
  20289.    attached to a computer. 
  20290.  
  20291.  I-beam pointer  - A pointer that indicates an area, such as an entry field in 
  20292.    which text can be edited. 
  20293.  
  20294.  icon  - In SAA Advanced Common User Access architecture, a graphical 
  20295.    representation of an object, consisting of an image, image background, and a 
  20296.    label. Icons can represent items (such as a document file) that the user 
  20297.    wants to work on, and actions that the user wants to perform. In the 
  20298.    Presentation Manager, icons are used for data objects, system actions, and 
  20299.    minimized programs. 
  20300.  
  20301.  icon area  - In the Presentation Manager, the area at the bottom of the screen 
  20302.    that is normally used to display the icons for minimized programs. 
  20303.  
  20304.  Icon Editor  - The Presentation Manager-provided tool for creating icons. 
  20305.  
  20306.  IDL  - Interface Definition Language. 
  20307.  
  20308.  image font  - A set of symbols, each of which is described in a rectangular 
  20309.    array of pels. Some of the pels in the array are set to produce the image of 
  20310.    one of the symbols. Contrast with outline font. 
  20311.  
  20312.  implied metaclass  - Subclassing the metaclass of a parent class without a 
  20313.    separate CSC for the resultant metaclass. 
  20314.  
  20315.  indirect manipulation  - Interaction with an object through choices and 
  20316.    controls. 
  20317.  
  20318.  information device context  - A logical description of a data destination 
  20319.    other than the screen (for example, a printer or plotter), but where no 
  20320.    output will occur. Its purpose is to satisfy queries. See also device 
  20321.    context. 
  20322.  
  20323.  information panel  - A defined panel type characterized by a body containing 
  20324.    only protected information. 
  20325.  
  20326.  Information Presentation Facility (IPF)  - A facility provided by the OS/2 
  20327.    operating system, by which application developers can produce online 
  20328.    documentation and context-sensitive online help panels for their 
  20329.    applications. 
  20330.  
  20331.  inheritance  - The technique of specifying the shape and behavior of one class 
  20332.    (called a subclass) as incremental differences from another class (called 
  20333.    the parent class or superclass). The subclass inherits the superclass' state 
  20334.    representation and methods, and can provide additional data elements and 
  20335.    methods. The subclass also can provide new functions with the same method 
  20336.    names used by the superclass. Such a subclass method is said to override the 
  20337.    superclass method, and will be selected automatically by method resolution 
  20338.    on subclass instances. An overriding method can elect to call upon the 
  20339.    superclass' method as part of its own implementation. 
  20340.  
  20341.  input focus  - (1) The area of a window where user interaction is possible 
  20342.    using an input device, such as a mouse or the keyboard. (2) The position in 
  20343.    the active window where a user's normal interaction with the keyboard will 
  20344.    appear. 
  20345.  
  20346.  input router  - An internal OS/2 process that removes messages from the system 
  20347.    queue. 
  20348.  
  20349.  input/output control  - A device-specific command that requests a function of 
  20350.    a device driver. 
  20351.  
  20352.  installable file system (IFS)  - A file system in which software is installed 
  20353.    when the operating system is started. 
  20354.  
  20355.  instance  - (Or object instance). A specific object, as distinguished from the 
  20356.    abstract definition of an object referred to as its class. 
  20357.  
  20358.  instance method  - A method valid for a particular object. 
  20359.  
  20360.  instruction pointer  - In System/38, a pointer that provides addressability 
  20361.    for a machine interface instruction in a program. 
  20362.  
  20363.  integer atom  - An atom that represents a predefined system constant and 
  20364.    carries no storage overhead. For example, names of window classes provided 
  20365.    by Presentation Manager are expressed as integer atoms. 
  20366.  
  20367.  interactive graphics  - Graphics that can be moved or manipulated by a user at 
  20368.    a terminal. 
  20369.  
  20370.  interactive program  - (1) A program that is running (active) and is ready to 
  20371.    receive (or is receiving) input from a user. (2) A running program that can 
  20372.    receive input from the keyboard or another input device. Compare with active 
  20373.    program and contrast with noninteractive program. 
  20374.  
  20375.    Also known as a foreground program. 
  20376.  
  20377.  interchange file  - A file containing data that can be sent from one 
  20378.    Presentation Manager interface application to another. 
  20379.  
  20380.  Interface Definition Language (IDL)  - Language-neutral interface 
  20381.    specification for a SOM class. 
  20382.  
  20383.  interpreter  - A program that translates and executes each instruction of a 
  20384.    high-level programming language before it translates and executes. 
  20385.  
  20386.  interprocess communication (IPC)  - In the OS/2 operating system, the exchange 
  20387.    of information between processes or threads through semaphores, pipes, 
  20388.    queues, and shared memory. 
  20389.  
  20390.  interval timer  - (1) A timer that provides program interruptions on a 
  20391.    program-controlled basis. (2) An electronic counter that counts intervals of 
  20392.    time under program control. 
  20393.  
  20394.  IOCtl  - Input/output control. 
  20395.  
  20396.  IOPL  - Input/output privilege level. 
  20397.  
  20398.  IOPL code segment  - An IOPL executable section of programming code that 
  20399.    enables an application to directly manipulate hardware interrupts and ports 
  20400.    without replacing the device driver. See also privilege level. 
  20401.  
  20402.  IPC  - Interprocess communication. 
  20403.  
  20404.  IPF  - Information Presentation Facility. 
  20405.  
  20406.  IPF compiler  - A text compiler that interpret tags in a source file and 
  20407.    converts the information into the specified format. 
  20408.  
  20409.  IPF tag language  - A markup language that provides the instructions for 
  20410.    displaying online information. 
  20411.  
  20412.  item  - A data object that can be passed in a DDE transaction. 
  20413.  
  20414.  
  20415. ΓòÉΓòÉΓòÉ <hidden> Glossary - J ΓòÉΓòÉΓòÉ
  20416.  
  20417.  journal  - A special-purpose file that is used to record changes made in the 
  20418.    system. 
  20419.  
  20420.  
  20421. ΓòÉΓòÉΓòÉ <hidden> Glossary - K ΓòÉΓòÉΓòÉ
  20422.  
  20423.  Kanji  - A graphic character set used in Japanese ideographic alphabets. 
  20424.  
  20425.  KBD$  - Character-device name reserved for the keyboard. 
  20426.  
  20427.  kernel  - The part of an operating system that performs basic functions, such 
  20428.    as allocating hardware resources. 
  20429.  
  20430.  kerning  - The design of graphics characters so that their character boxes 
  20431.    overlap. Used to space text proportionally. 
  20432.  
  20433.  keyboard accelerator  - A keystroke that generates a command message for an 
  20434.    application. 
  20435.  
  20436.  keyboard augmentation  - A function that enables a user to press a keyboard 
  20437.    key while pressing a mouse button. 
  20438.  
  20439.  keyboard focus  - A temporary attribute of a window. The window that has a 
  20440.    keyboard focus receives all keyboard input until the focus changes to a 
  20441.    different window. 
  20442.  
  20443.  Keys help  - In SAA Common User Access architecture, a help action that 
  20444.    provides a listing of the application keys and their assigned functions. 
  20445.  
  20446.  
  20447. ΓòÉΓòÉΓòÉ <hidden> Glossary - L ΓòÉΓòÉΓòÉ
  20448.  
  20449.  label  - In a graphics segment, an identifier of one or more elements that is 
  20450.    used when editing the segment. 
  20451.  
  20452.  LAN  - local area network. 
  20453.  
  20454.  language support procedure  - A function provided by the Presentation Manager 
  20455.    Interface for applications that do not, or cannot (as in the case of COBOL 
  20456.    and FORTRAN programs), provide their own dialog or window procedures. 
  20457.  
  20458.  lazy drag  - See pickup and drop. 
  20459.  
  20460.  lazy drag set  - See pickup set. 
  20461.  
  20462.  LDT  - In the OS/2 operating system, Local Descriptor Table. 
  20463.  
  20464.  LIFO stack  - A stack from which data is retrieved in last-in, first-out 
  20465.    order. 
  20466.  
  20467.  linear address  - A unique value that identifies the memory object. 
  20468.  
  20469.  linked list  - Synonym for chained list. 
  20470.  
  20471.  list box  - In SAA Advanced Common User Access architecture, a control that 
  20472.    contains scrollable choices from which a user can select one choice. 
  20473.  
  20474.    Note:  In CUA architecture, this is a programmer term. The end user term is 
  20475.    selection list. 
  20476.  
  20477.  list button  - A button labeled with an underlined down-arrow that presents a 
  20478.    list of valid objects or choices that can be selected for that field. 
  20479.  
  20480.  list panel  - A defined panel type that displays a list of items from which 
  20481.    users can select one or more choices and then specify one or more actions to 
  20482.    work on those choices. 
  20483.  
  20484.  load time  - The point in time at which a program module is loaded into main 
  20485.    storage for execution. 
  20486.  
  20487.  load-on-call  - A function of a linkage editor that allows selected segments 
  20488.    of the module to be disk resident while other segments are executing. Disk 
  20489.    resident segments are loaded for execution and given control when any entry 
  20490.    point that they contain is called. 
  20491.  
  20492.  local area network (LAN)  - (1) A computer network located on a user's 
  20493.    premises within a limited geographical area. Communication within a local 
  20494.    area network is not subject to external regulations;  however, communication 
  20495.    across the LAN boundary may be subject to some form of regulation. (T)
  20496.  
  20497.    Note:  A LAN does not use store and forward techniques. (2) A network 
  20498.    inwhich a set of devices are connected to one another for communication and 
  20499.    that can be connected to a larger network. 
  20500.  
  20501.  Local Descriptor Table (LDT)  - Defines code and data segments specific to a 
  20502.    single task. 
  20503.  
  20504.  lock  - A serialization mechanism by means of which a resource is restricted 
  20505.    for use by the holder of the lock. 
  20506.  
  20507.  logical storage device  - A device that the user can map to a physical 
  20508.    (actual) device. 
  20509.  
  20510.  LPT1, LPT2, LPT3  - Character-device names reserved for parallel printers 1 
  20511.    through 3. 
  20512.  
  20513.  
  20514. ΓòÉΓòÉΓòÉ <hidden> Glossary - M ΓòÉΓòÉΓòÉ
  20515.  
  20516.  main window  - The window that is positioned relative to the desktop window. 
  20517.  
  20518.  manipulation button  - The button on a pointing device a user presses to 
  20519.    directly manipulate an object. 
  20520.  
  20521.  map  - (1) A set of values having a defined correspondence with the quantities 
  20522.    or values of another set. (I)  (A)  (2) To establish a set of values having 
  20523.    a defined correspondence with the quantities or values of another set. (I)
  20524.  
  20525.  marker box  - In computer graphics, the boundary that defines, in world 
  20526.    coordinates, the horizontal and vertical space occupied by a single marker 
  20527.    from a marker set. 
  20528.  
  20529.  marker symbol  - A symbol centered on a point. Graphs and charts can use 
  20530.    marker symbols to indicate the plotted points. 
  20531.  
  20532.  marquee box  - The rectangle that appears during a selection technique in 
  20533.    which a user selects objects by drawing a box around them with a pointing 
  20534.    device. 
  20535.  
  20536.  Master Help Index  - In the OS/2 operating system, an alphabetic list of help 
  20537.    topics related to using the operating system. 
  20538.  
  20539.  maximize  - To enlarge a window to its largest possible size. 
  20540.  
  20541.  media window  - The part of the physical device (display, printer, or plotter) 
  20542.    on which a picture is presented. 
  20543.  
  20544.  memory block  - Part memory within a heap. 
  20545.  
  20546.  memory device context  - A logical description of a data destination that is a 
  20547.    memory bit map. See also device context. 
  20548.  
  20549.  memory management  - A feature of the operating system for allocating, 
  20550.    sharing, and freeing main storage. 
  20551.  
  20552.  memory object  - Logical unit of memory requested by an application, which 
  20553.    forms the granular unit of memory manipulation from the application 
  20554.    viewpoint. 
  20555.  
  20556.  menu  - In SAA Advanced Common User Access architecture, an extension of the 
  20557.    menu bar that displays a list of choices available for a selected choice in 
  20558.    the menu bar. After a user selects a choice in menu bar, the corresponding 
  20559.    menu appears. Additional pop-up windows can appear from menu choices. 
  20560.  
  20561.  menu bar  - In SAA Advanced Common User Access architecture, the area near the 
  20562.    top of a window, below the title bar and above the rest of the window, that 
  20563.    contains choices that provide access to other menus. 
  20564.  
  20565.  menu button  - The button on a pointing device that a user presses to view a 
  20566.    pop-up menu associated with an object. 
  20567.  
  20568.  message  - (1) In the Presentation Manager, a packet of data used for 
  20569.    communication between the Presentation Manager interface and Presentation 
  20570.    Manager applications (2) In a user interface, information not requested by 
  20571.    users but presented to users by the computer in response to a user action or 
  20572.    internal process. 
  20573.  
  20574.  message box  - (1) A dialog window predefined by the system and used as a 
  20575.    simple interface for applications, without the necessity of creating 
  20576.    dialog-template resources or dialog procedures. (2) (D of C) In SAA Advanced 
  20577.    Common User Access architecture, a type of window that shows messages to 
  20578.    users. See also dialog box, primary window, secondary window. 
  20579.  
  20580.  message filter  - The means of selecting which messages from a specific window 
  20581.    will be handled by the application. 
  20582.  
  20583.  message queue  - A sequenced collection of messages to be read by the 
  20584.    application. 
  20585.  
  20586.  message stream mode  - A method of operation in which data is treated as a 
  20587.    stream of messages.  Contrast with  byte stream. 
  20588.  
  20589.  metacharacter  - See global file-name character. 
  20590.  
  20591.  metaclass  - A class whose instances are all classes. In SOM, any class 
  20592.    descended from SOMClass is a metaclass. The methods of a metaclass are 
  20593.    sometimes called "class" methods. 
  20594.  
  20595.  metafile  - A file containing a series of attributes that set color, shape and 
  20596.    size, usually of a picture or a drawing. Using a program that can interpret 
  20597.    these attributes, a user can view the assembled image. 
  20598.  
  20599.  metafile device context  - A logical description of a data destination that is 
  20600.    a metafile, which is used for graphics interchange. See also device context. 
  20601.  
  20602.  metalanguage  - A language used to specify another language. For example, data 
  20603.    types can be described using a metalanguage so as to make the descriptions 
  20604.    independent of any one computer language. 
  20605.  
  20606.  method  - One of the units that makes up the behavior of an object. A method 
  20607.    is a combination of a function and a name, such that many different 
  20608.    functions can have the same name. Which function the name refers to at any 
  20609.    point in time depends on the object that is to execute the method and is the 
  20610.    subject of method resolution. 
  20611.  
  20612.  method override  - The replacement, by a child class, of the implementation of 
  20613.    a method inherited from a parent and an ancestor class. 
  20614.  
  20615.  mickey  - A unit of measurement for physical mouse motion whose value depends 
  20616.    on the mouse device driver currently loaded. 
  20617.  
  20618.  micro presentation space  - A graphics presentation space in which a 
  20619.    restricted set of the GPI function calls is available. 
  20620.  
  20621.  minimize  - To remove from the screen all windows associated with an 
  20622.    application and replace them with an icon that represents the application. 
  20623.  
  20624.  mix  - An attribute that determines how the foreground of a graphic primitive 
  20625.    is combined with the existing color of graphics output. Also known as 
  20626.    foreground mix. Contrast with background mix. 
  20627.  
  20628.  mixed character string  - A string containing a mixture of one-byte and Kanji 
  20629.    or Hangeul (two-byte) characters. 
  20630.  
  20631.  mnemonic  - (1) A method of selecting an item on a pull-down by means of 
  20632.    typing the highlighted letter in the menu item. (2) (D of C) In SAA Advanced 
  20633.    Common User Access architecture, usually a single character, within the text 
  20634.    of a choice, identified by an underscore beneath the character. If all 
  20635.    characters in a choice already serve as mnemonics for other choices, another 
  20636.    character, placed in parentheses immediately following the choice, can be 
  20637.    used. When a user types the mnemonic for a choice, the choice is either 
  20638.    selected or the cursor is moved to that choice. 
  20639.  
  20640.  modal dialog box  - In SAA Advanced Common User Access architecture, a type of 
  20641.    movable window, fixed in size, that requires a user to enter information 
  20642.    before continuing to work in the application window from which it was 
  20643.    displayed. Contrast with modeless dialog box. Also known as a serial dialog 
  20644.    box. Contrast with parallel dialog box. 
  20645.  
  20646.    Note:  In CUA architecture, this is a programmer term. The end user term is 
  20647.    pop-up window. 
  20648.  
  20649.  model space  - See graphics model space. 
  20650.  
  20651.  modeless dialog box  - In SAA Advanced Common User Access architecture, a type 
  20652.    of movable window, fixed in size, that allows users to continue their dialog 
  20653.    with the application without entering information in the dialog box. Also 
  20654.    known as a parallel dialog box. Contrast with modal dialog box. 
  20655.  
  20656.    Note:  In CUA architecture, this is a programmer term. The end user term is 
  20657.    pop-up window. 
  20658.  
  20659.  module definition file  - A file that describes the code segments within a 
  20660.    load module. For example, it indicates whether a code segment is loadable 
  20661.    before module execution begins (preload), or loadable only when referred to 
  20662.    at run time (load-on-call). 
  20663.  
  20664.  mouse  - In SAA usage, a device that a user moves on a flat surface to 
  20665.    position a pointer on the screen. It allows a user to select a choice o 
  20666.    function to be performed or to perform operations on the screen, such as 
  20667.    dragging or drawing lines from one position to another. 
  20668.  
  20669.  MOUSE$  - Character-device name reserved for a mouse. 
  20670.  
  20671.  multiple-choice selection  - In SAA Basic Common User Access architecture, a 
  20672.    type of field from which a user can select one or more choices or select 
  20673.    none. See also check box. Contrast with extended-choice selection. 
  20674.  
  20675.  multiple-line entry field  - In SAA Advanced Common User Access architecture, 
  20676.    a control into which a user types more than one line of information. See 
  20677.    also single-line entry field. 
  20678.  
  20679.  multitasking  - The concurrent processing of applications or parts of 
  20680.    applications. A running application and its data are protected from other 
  20681.    concurrently running applications. 
  20682.  
  20683.  mutex semaphore  - (Mutual exclusion semaphore). A semaphore that enables 
  20684.    threads to serialize their access to resources. Only the thread that 
  20685.    currently owns the mutex semaphore can gain access to the resource, thus 
  20686.    preventing one thread from interrupting operations being performed by 
  20687.    another. 
  20688.  
  20689.  muxwait semaphore  - (Multiple wait semaphore). A semaphore that enables a 
  20690.    thread to wait either for multiple event semaphores to be posted or for 
  20691.    multiple mutex semaphores to be released. Alternatively, a muxwait semaphore 
  20692.    can be set to enable a thread to wait for any ONE of the event or mutex 
  20693.    semaphores in the muxwait semaphore's list to be posted or released. 
  20694.  
  20695.  
  20696. ΓòÉΓòÉΓòÉ <hidden> Glossary - N ΓòÉΓòÉΓòÉ
  20697.  
  20698.  named pipe  - A named buffer that provides client-to-server, server-to-client, 
  20699.    or full duplex communication between unrelated processes. Contrast with 
  20700.    unnamed pipe. 
  20701.  
  20702.  national language support (NLS)  - The modification or conversion of a United 
  20703.    States English product to conform to the requirements of another language or 
  20704.    country. This can include the enabling or retrofitting of a product and the 
  20705.    translation of nomenclature, MRI, or documentation of a product. 
  20706.  
  20707.  nested list  - A list that is contained within another list. 
  20708.  
  20709.  NLS  - national language support. 
  20710.  
  20711.  non-8.3 file-name format  - A file-naming convention in which file names can 
  20712.    consist of up to 255 characters. See also 8.3 file-name format. 
  20713.  
  20714.  noncritical extended attribute  - An extended attribute that is not necessary 
  20715.    for the function of an application. 
  20716.  
  20717.  nondestructive read  - Reading that does not erase the data in the source 
  20718.    location. (T)
  20719.  
  20720.  noninteractive program  - A running program that cannot receive input from the 
  20721.    keyboard or other input device. Compare with active program, and contrast 
  20722.    with interactive program. 
  20723.  
  20724.  nonretained graphics  - Graphic primitives that are not remembered by the 
  20725.    Presentation Manager interface when they have been drawn. Contrast with 
  20726.    retained graphics. 
  20727.  
  20728.  null character (NUL)  - (1) Character-device name reserved for a nonexistent 
  20729.    (dummy) device. (2) (D of C) A control character that is used to accomplish 
  20730.    media-fill or time-fill and that may be inserted into or removed from a 
  20731.    sequence of characters without affecting the meaning of the sequence; 
  20732.    however, the control of equipment or the format may be affected by this 
  20733.    character. (I)  (A)
  20734.  
  20735.  null-terminated string  - A string of (n+1) characters where the (n+1)th 
  20736.    character is the 'null' character (0x00) Also known as 'zero-terminated' 
  20737.    string and 'ASCIIZ' string. 
  20738.  
  20739.  
  20740. ΓòÉΓòÉΓòÉ <hidden> Glossary - O ΓòÉΓòÉΓòÉ
  20741.  
  20742.  object  - The elements of data and function that programs create, manipulate, 
  20743.    pass as arguments, and so forth. An object is a way of associating specific 
  20744.    data values with a specific set of named functions (called methods) for a 
  20745.    period of time (referred to as the lifetime of the object). The data values 
  20746.    of an object are referred to as its state. In SOM, objects are created by 
  20747.    other objects called classes. The specification of what comprises the set of 
  20748.    functions and data elements that make up an object is referred to as the 
  20749.    definition of a class. 
  20750.  
  20751.    SOM objects offer a high degree of encapsulation. This property permits many 
  20752.    aspects of the implementation of an object to change without affecting 
  20753.    client programs that depend on the object's behavior. 
  20754.  
  20755.  object definition  - See class. 
  20756.  
  20757.  object instance  - See instance. 
  20758.  
  20759.  Object Interface Definition Language (OIDL)  - Specification language used in 
  20760.    SOM Version 1 for defining classes. Replaced by Interface Definition 
  20761.    Language (IDL). 
  20762.  
  20763.  object window  - A window that does not have a parent but which might have 
  20764.    child windows. An object window cannot be presented on a device. 
  20765.  
  20766.  OIDL  - Object Interface Definition Language. 
  20767.  
  20768.  open  - To start working with a file, directory, or other object. 
  20769.  
  20770.  ordered list  - Vertical arrangements of items, with each item in the list 
  20771.    preceded by a number or letter. 
  20772.  
  20773.  outline font  - A set of symbols, each of which is created as a series of 
  20774.    lines and curves.  Synonymous with vector font. Contrast with image font. 
  20775.  
  20776.  output area  - An area of storage reserved for output. (A)
  20777.  
  20778.  owner window  - A window into which specific events that occur in another 
  20779.    (owned) window are reported. 
  20780.  
  20781.  ownership  - The determination of how windows communicate using messages. 
  20782.  
  20783.  owning process  - The process that owns the resources that might be shared 
  20784.    with other processes. 
  20785.  
  20786.  
  20787. ΓòÉΓòÉΓòÉ <hidden> Glossary - P ΓòÉΓòÉΓòÉ
  20788.  
  20789.  page  - (1) A 4KB segment of contiguous physical memory. (2) (D of C) A 
  20790.    defined unit of space on a storage medium. 
  20791.  
  20792.  page viewport  - A boundary in device coordinates that defines the area of the 
  20793.    output device in which graphics are to be displayed. The presentation-page 
  20794.    contents are transformed automatically to the page viewport in device space. 
  20795.  
  20796.  paint  - (1) The action of drawing or redrawing the contents of a window. (2) 
  20797.    In computer graphics, to shade an area of a display image;  for example, 
  20798.    with crosshatching or color. 
  20799.  
  20800.  panel  - In SAA Basic Common User Access architecture, a particular 
  20801.    arrangement of information that is presented in a window or pop-up. If some 
  20802.    of the information is not visible, a user can scroll through the 
  20803.    information. 
  20804.  
  20805.  panel area  - An area within a panel that contains related information. The 
  20806.    three major Common User Access-defined panel areas are the action bar, the 
  20807.    function key area, and the panel body. 
  20808.  
  20809.  panel area separator  - In SAA Basic Common User Access architecture, a solid, 
  20810.    dashed, or blank line that provides a visual distinction between two 
  20811.    adjacent areas of a panel. 
  20812.  
  20813.  panel body  - The portion of a panel not occupied by the action bar, function 
  20814.    key area, title or scroll bars. The panel body can contain protected 
  20815.    information, selection fields, and entry fields. The layout and content of 
  20816.    the panel body determine the panel type. 
  20817.  
  20818.  panel body area  - See client area. 
  20819.  
  20820.  panel definition  - A description of the contents and characteristics of a 
  20821.    panel. A panel definition is the application developer's mechanism for 
  20822.    predefining the format to be presented to users in a window. 
  20823.  
  20824.  panel ID  - In SAA Basic Common User Access architecture, a panel identifier, 
  20825.    located in the upper-left corner of a panel.  A user can choose whether to 
  20826.    display the panel ID. 
  20827.  
  20828.  panel title  - In SAA Basic Common User Access architecture, a particular 
  20829.    arrangement of information that is presented in a window or pop-up. If some 
  20830.    of the information is not visible, a user can scroll through the 
  20831.    information. 
  20832.  
  20833.  paper size  - The size of paper, defined in either standard U.S. or European 
  20834.    names (for example, A, B, A4), and measured in inches or millimeters 
  20835.    respectively. 
  20836.  
  20837.  parallel dialog box  - See modeless dialog box. 
  20838.  
  20839.  parameter list  - A list of values that provides a means of associating 
  20840.    addressability of data defined in a called program with data in the calling 
  20841.    program. It contains parameter names and the order in which they are to be 
  20842.    associated in the calling and called program. 
  20843.  
  20844.  parent class  - See inheritance. 
  20845.  
  20846.  parent process  - In the OS/2 operating system, a process that creates other 
  20847.    processes. Contrast with child process. 
  20848.  
  20849.  parent window  - In the OS/2 operating system, a window that creates a child 
  20850.    window. The child window is drawn within the parent window. If the parent 
  20851.    window is moved, resized, or destroyed, the child window also will be moved, 
  20852.    resized, or destroyed. However, the child window can be moved and resized 
  20853.    independently from the parent window, within the boundaries of the parent 
  20854.    window. Contrast with child window. 
  20855.  
  20856.  partition  - (1) A fixed-size division of storage. (2) On an IBM personal 
  20857.    computer fixed disk, one of four possible storage areas of variable size; 
  20858.    one may be accessed by DOS, and each of the others may be assigned to 
  20859.    another operating system. 
  20860.  
  20861.  Paste  - A choice in the Edit pull-down that a user selects to move the 
  20862.    contents of the clipboard into a preselected location. See also Copy and 
  20863.    Cut. 
  20864.  
  20865.  path  - The route used to locate files; the storage location of a file. A 
  20866.    fully qualified path lists the drive identifier, directory name, 
  20867.    subdirectory name (if any), and file name with the associated extension. 
  20868.  
  20869.  PDD  - Physical device driver. 
  20870.  
  20871.  peeking  - An action taken by any thread in the process that owns the queue to 
  20872.    examine queue elements without removing them. 
  20873.  
  20874.  pel  - (1) The smallest area of a display screen capable of being addressed 
  20875.    and switched between visible and invisible states. Synonym for display 
  20876.    point, pixel, and picture element. (2) (D of C) Picture element. 
  20877.  
  20878.  persistent object  - An object whose instance data and state are preserved 
  20879.    between system shutdown and system startup. 
  20880.  
  20881.  physical device driver (PDD)  - A system interface that handles hardware 
  20882.    interrupts and supports a set of input and output functions. 
  20883.  
  20884.  pick  - To select part of a displayed object using the pointer. 
  20885.  
  20886.  pickup  - To add an object or set of objects to the pickup set. 
  20887.  
  20888.  pickup and drop  - A drag operation that does not require the direct 
  20889.    manipulation button to be pressed for the duration of the drag. 
  20890.  
  20891.  pickup set  - The set of objects that have been picked up as part of a pickup 
  20892.    and drop operation. 
  20893.  
  20894.  picture chain  - See segment chain. 
  20895.  
  20896.  picture element  - (1) Synonym for pel. (2) (D of C) In computer graphics, the 
  20897.    smallest element of a display surface that can be independently assigned 
  20898.    color and intensity. (T)  . (3) The area of the finest detail that can be 
  20899.    reproduced effectively on the recording medium. 
  20900.  
  20901.  PID  - Process identification. 
  20902.  
  20903.  pipe  - (1) A named or unnamed buffer used to pass data between processes. A 
  20904.    process reads from or writes to a pipe as if the pipe were a standard-input 
  20905.    or standard-output file. See also named pipe and unnamed pipe. (2) (D of C) 
  20906.    To direct data so that the output from one process becomes the input to 
  20907.    another process. The standard output of one command can be connected to the 
  20908.    standard input of another with the pipe operator (|). 
  20909.  
  20910.  pixel  - (1) Synonym for pel. (2) (D of C) Picture element. 
  20911.  
  20912.  plotter  - An output unit that directly produces a hardcopy record of data on 
  20913.    a removable medium, in the form of a two-dimensional graphic representation. (T)
  20914.  
  20915.  PM  - Presentation Manager. 
  20916.  
  20917.  pointer  - (1) The symbol displayed on the screen that is moved by a pointing 
  20918.    device, such as a mouse. The pointer is used to point at items that users 
  20919.    can select. Contrast with cursor. (2) A data element that indicates the 
  20920.    location of another data element. (T)
  20921.  
  20922.  POINTER$  - Character-device name reserved for a pointer device (mouse screen 
  20923.    support). 
  20924.  
  20925.  pointing device  - In SAA Advanced Common User Access architecture, an 
  20926.    instrument, such as a mouse, trackball, or joystick, used to move a pointer 
  20927.    on the screen. 
  20928.  
  20929.  pointings  - Pairs of x-y coordinates produced by an operator defining 
  20930.    positions on a screen with a pointing device, such as a mouse. 
  20931.  
  20932.  polyfillet  - A curve based on a sequence of lines. The curve is tangential to 
  20933.    the end points of the first and last lines, and tangential also to the 
  20934.    midpoints of all other lines. See also fillet. 
  20935.  
  20936.  polygon  - One or more closed figures that can be drawn filled, outlined, or 
  20937.    filled and outlined. 
  20938.  
  20939.  polyline  - A sequence of adjoining lines. 
  20940.  
  20941.  polymorphism  - The ability to have different implementations of the same 
  20942.    method for two or more classes of objects. 
  20943.  
  20944.  pop  - To retrieve an item from a last-in-first-out stack of items. Contrast 
  20945.    with push. 
  20946.  
  20947.  pop-up menu  - A menu that lists the actions that a user can perform on an 
  20948.    object. The contents of the pop-up menu can vary depending on the context, 
  20949.    or state, of the object. 
  20950.  
  20951.  pop-up window  - (1) A window that appears on top of another window in a 
  20952.    dialog. Each pop-up window must be completed before returning to the 
  20953.    underlying window. (2) (D of C) In SAA Advanced Common User Access 
  20954.    architecture, a movable window, fixed in size, in which a user provides 
  20955.    information required by an application so that it can continue to process a 
  20956.    user request. 
  20957.  
  20958.  presentation drivers  - Special purpose I/O routines that handle field 
  20959.    device-independent I/O requests from the PM and its applications. 
  20960.  
  20961.  Presentation Manager (PM)  - The interface of the OS/2 operating system that 
  20962.    presents, in windows a graphics-based interface to applications and files 
  20963.    installed and running under the OS/2 operating system. 
  20964.  
  20965.  presentation page  - The coordinate space in which a picture is assembled for 
  20966.    display. 
  20967.  
  20968.  presentation space (PS)  - (1) Contains the device-independent definition of a 
  20969.    picture. (2) (D of C) The display space on a display device. 
  20970.  
  20971.  primary window  - In SAA Common User Access architecture, the window in which 
  20972.    the main interaction between the user and the application takes place. In a 
  20973.    multiprogramming environment, each application starts in its own primary 
  20974.    window. The primary window remains for the duration of the application, 
  20975.    although the panel displayed will change as the user's dialog moves forward. 
  20976.    See also secondary window. 
  20977.  
  20978.  primitive  - In computer graphics, one of several simple functions for drawing 
  20979.    on the screen, including, for example, the rectangle, line, ellipse, 
  20980.    polygon, and so on. 
  20981.  
  20982.  primitive attribute  - A specifiable characteristic of a graphic primitive. 
  20983.    See graphics attributes. 
  20984.  
  20985.  print job  - The result of sending a document or picture to be printed. 
  20986.  
  20987.  Print Manager  - In the Presentation Manager, the part of the spooler that 
  20988.    manages the spooling process. It also allows users to view print queues and 
  20989.    to manipulate print jobs. 
  20990.  
  20991.  privilege level  - A protection level imposed by the hardware architecture of 
  20992.    the IBM personal computer.  There are four privilege levels (number 0 
  20993.    through 3).  Only certain types of programs are allowed to execute at each 
  20994.    privilege level.  See also IOPL code segment. 
  20995.  
  20996.  procedure call  - In programming languages, a language construct for invoking 
  20997.    execution of a procedure. 
  20998.  
  20999.  process  - An instance of an executing application and the resources it is 
  21000.    using. 
  21001.  
  21002.  program  - A sequence of instructions that a computer can interpret and 
  21003.    execute. 
  21004.  
  21005.  program details  - Information about a program that is specified in the 
  21006.    Program Manager window and is used when the program is started. 
  21007.  
  21008.  program group  - In the Presentation Manager, several programs that can be 
  21009.    acted upon as a single entity. 
  21010.  
  21011.  program name  - The full file specification of a program. Contrast with 
  21012.    program title. 
  21013.  
  21014.  program title  - The name of a program as it is listed in the Program Manager 
  21015.    window. Contrast with program name. 
  21016.  
  21017.  prompt  - A displayed symbol or message that requests input from the user or 
  21018.    gives operational information; for example, on the display screen of an IBM 
  21019.    personal computer, the DOS A> prompt. The user must respond to the prompt in 
  21020.    order to proceed. 
  21021.  
  21022.  protect mode  - A method of program operation that limits or prevents access 
  21023.    to certain instructions or areas of storage. Contrast with real mode. 
  21024.  
  21025.  protocol  - A set of semantic and syntactic rules that determines the behavior 
  21026.    of functional units in achieving communication. (I)
  21027.  
  21028.  pseudocode  - An artificial language used to describe computer program 
  21029.    algorithms without using the syntax of any particular programming language. (A)
  21030.  
  21031.  pull-down  - (1) An action bar extension that displays a list of choices 
  21032.    available for a selected action bar choice. After users select an action bar 
  21033.    choice, the pull-down appears with the list of choices. Additional pop-up 
  21034.    windows may appear from pull-down choices to further extend the actions 
  21035.    available to users. (2) (D of C) In SAA Common User Access architecture, 
  21036.    pertaining to a choice in an action bar pull-down. 
  21037.  
  21038.  push  - To add an item to a last-in-first-out stack of items. Contrast with 
  21039.    pop. 
  21040.  
  21041.  push button  - In SAA Advanced Common User Access architecture, a rectangle 
  21042.    with text inside. Push buttons are used in windows for actions that occur 
  21043.    immediately when the push button is selected. 
  21044.  
  21045.  putback  - To remove an object or set of objects from the lazy drag set. This 
  21046.    has the effect of undoing the pickup operation for those objects 
  21047.  
  21048.  putdown  - To drop the objects in the lazy drag set on the target object. 
  21049.  
  21050.  
  21051. ΓòÉΓòÉΓòÉ <hidden> Glossary - Q ΓòÉΓòÉΓòÉ
  21052.  
  21053.  queue  - (1) A linked list of elements waiting to be processed in FIFO order. 
  21054.    For example, a queue may be a list of print jobs waiting to be printed. (2) 
  21055.    (D of C) A line or list of items waiting to be processed; for example, work 
  21056.    to be performed or messages to be displayed. 
  21057.  
  21058.  queued device context  - A logical description of a data destination (for 
  21059.    example, a printer or plotter) where the output is to go through the 
  21060.    spooler. See also device context. 
  21061.  
  21062.  
  21063. ΓòÉΓòÉΓòÉ <hidden> Glossary - R ΓòÉΓòÉΓòÉ
  21064.  
  21065.  radio button  - (1) A control window, shaped like a round button on the 
  21066.    screen, that can be in a checked or unchecked state. It is used to select a 
  21067.    single item from a list. Contrast with check box. (2) In SAA Advanced Common 
  21068.    User Access architecture, a circle with text beside it. Radio buttons are 
  21069.    combined to show a user a fixed set of choices from which only one can be 
  21070.    selected. The circle is partially filled when a choice is selected. 
  21071.  
  21072.  RAS  - Reliability, availability, and serviceability. 
  21073.  
  21074.  raster  - (1) In computer graphics, a predetermined pattern of lines that 
  21075.    provides uniform coverage of a display space. (T)  (2) The coordinate grid 
  21076.    that divides the display area of a display device.  (A)
  21077.  
  21078.  read-only file  - A file that can be read from but not written to. 
  21079.  
  21080.  real mode  - A method of program operation that does not limit or prevent 
  21081.    access to any instructions or areas of storage.  The operating system loads 
  21082.    the entire program into storage and gives the program access to all system 
  21083.    resources. Contrast with protect mode. 
  21084.  
  21085.  realize  - To cause the system to ensure, wherever possible, that the physical 
  21086.    color table of a device is set to the closest possible match in the logical 
  21087.    color table. 
  21088.  
  21089.  recursive routine  - A routine that can call itself, or be called by another 
  21090.    routine that was called by the recursive routine. 
  21091.  
  21092.  reentrant  - The attribute of a program or routine that allows the same copy 
  21093.    of the program or routine to be used concurrently by two or more tasks. 
  21094.  
  21095.  reference phrase  - (1) A word or phrase that is emphasized in a 
  21096.    device-dependent manner to inform the user that additional information for 
  21097.    the word or phrase is available. (2) (D of C) In hypertext, text that is 
  21098.    highlighted and preceded by a single-character input field used to signify 
  21099.    the existence of a hypertext link. 
  21100.  
  21101.  reference phrase help  - In SAA Common User Access architecture, highlighted 
  21102.    words or phrases within help information that a user selects to get 
  21103.    additional information. 
  21104.  
  21105.  refresh  - To update a window, with changed information, to its current 
  21106.    status. 
  21107.  
  21108.  region  - A clipping boundary in device space. 
  21109.  
  21110.  register  - A part of internal storage having a specified storage capacity and 
  21111.    usually intended for a specific purpose. (T)
  21112.  
  21113.  remote file system  - A file-system driver that gains access to a remote 
  21114.    system without a block device driver. 
  21115.  
  21116.  resource  - The means of providing extra information used in the definition of 
  21117.    a window. A resource can contain definitions of fonts, templates, 
  21118.    accelerators, and mnemonics; the definitions are held in a resource file. 
  21119.  
  21120.  resource file  - A file containing information used in the definition of a 
  21121.    window. Definitions can be of fonts, templates, accelerators, and mnemonics. 
  21122.  
  21123.  restore  - To return a window to its original size or position following a 
  21124.    sizing or moving action. 
  21125.  
  21126.  retained graphics  - Graphic primitives that are remembered by the 
  21127.    Presentation Manager interface after they have been drawn. Contrast with 
  21128.    nonretained graphics. 
  21129.  
  21130.  return code  - (1) A value returned to a program to indicate the results of an 
  21131.    operation requested by that program. (2) A code used to influence the 
  21132.    execution of succeeding instructions.(A) 
  21133.  
  21134.  reverse video  - (1) A form of highlighting a character, field, or cursor by 
  21135.    reversing the color of the character, field, or cursor with its background; 
  21136.    for example, changing a red character on a black background to a black 
  21137.    character on a red background. (2) In SAA Basic Common User Access 
  21138.    architecture, a screen emphasis feature that interchanges the foreground and 
  21139.    background colors of an item. 
  21140.  
  21141.  REXX Language  - Restructured Extended Executor. A procedural language that 
  21142.    provides batch language functions along with structured programming 
  21143.    constructs such as loops; conditional testing and subroutines. 
  21144.  
  21145.  RGB  - (1) Color coding in which the brightness of the additive primary colors 
  21146.    of light, red, green, and blue, are specified as three distinct values of 
  21147.    white light. (2) Pertaining to a color display that accepts signals 
  21148.    representing red, green, and blue. 
  21149.  
  21150.  roman  - Relating to a type style with upright characters. 
  21151.  
  21152.  root segment  - In a hierarchical database, the highest segment in the tree 
  21153.    structure. 
  21154.  
  21155.  round-robin scheduling  - A process that allows each thread to run for a 
  21156.    specified amount of time. 
  21157.  
  21158.  run time  - (1) Any instant at which the execution of a particular computer 
  21159.    program takes place. (T)  (2) The amount of time needed for the execution of 
  21160.    a particular computer program. (T)  (3) The time during which an instruction 
  21161.    in an instruction register is decoded and performed. Synonym for execution 
  21162.    time. 
  21163.  
  21164.  
  21165. ΓòÉΓòÉΓòÉ <hidden> Glossary - S ΓòÉΓòÉΓòÉ
  21166.  
  21167.  SAA  - Systems Application Architecture. 
  21168.  
  21169.  SBCS  - Single-byte character set. 
  21170.  
  21171.  scheduler  - A computer program designed to perform functions such as 
  21172.    scheduling, initiation, and termination of jobs. 
  21173.  
  21174.  screen  - In SAA Basic Common User Access architecture, the physical surface 
  21175.    of a display device upon which information is shown to a user. 
  21176.  
  21177.  screen device context  - A logical description of a data destination that is a 
  21178.    particular window on the screen. See also device context. 
  21179.  
  21180.  SCREEN$  - Character-device name reserved for the display screen. 
  21181.  
  21182.  scroll bar  - In SAA Advanced Common User Access architecture, a part of a 
  21183.    window, associated with a scrollable area, that a user interacts with to see 
  21184.    information that is not currently allows visible. 
  21185.  
  21186.  scrollable entry field  - An entry field larger than the visible field. 
  21187.  
  21188.  scrollable selection field  - A selection field that contains more choices 
  21189.    than are visible. 
  21190.  
  21191.  scrolling  - Moving a display image vertically or horizontally in a manner 
  21192.    such that new data appears at one edge, as existing data disappears at the 
  21193.    opposite edge. 
  21194.  
  21195.  secondary window  - A window that contains information that is dependent on 
  21196.    information in a primary window and is used to supplement the interaction in 
  21197.    the primary window. 
  21198.  
  21199.  sector  - On disk or diskette storage, an addressable subdivision of a track 
  21200.    used to record one block of a program or data. 
  21201.  
  21202.  segment  - See graphics segment. 
  21203.  
  21204.  segment attributes  - Attributes that apply to the segment as an entity, as 
  21205.    opposed to the individual primitives within the segment. For example, the 
  21206.    visibility or detectability of a segment. 
  21207.  
  21208.  segment chain  - All segments in a graphics presentation space that are 
  21209.    defined with the 'chained' attribute. Synonym for picture chain. 
  21210.  
  21211.  segment priority  - The order in which segments are drawn. 
  21212.  
  21213.  segment store  - An area in a normal graphics presentation space where 
  21214.    retained graphics segments are stored. 
  21215.  
  21216.  select  - To mark or choose an item. Note that select means to mark or type in 
  21217.    a choice on the screen; enter means to send all selected choices to the 
  21218.    computer for processing. 
  21219.  
  21220.  select button  - The button on a pointing device, such as a mouse, that is 
  21221.    pressed to select a menu choice.  Also known as button 1. 
  21222.  
  21223.  selection cursor  - In SAA Advanced Common User Access architecture, a visual 
  21224.    indication that a user has selected a choice. It is represented by outlining 
  21225.    the choice with a dotted box. See also text cursor. 
  21226.  
  21227.  selection field  - (1) In SAA Advanced Common User Access architecture, a set 
  21228.    of related choices. See also entry field. (2) In SAA Basic Common User 
  21229.    Access architecture, an area of a panel that cannot be scrolled and contains 
  21230.    a fixed number of choices. 
  21231.  
  21232.  semantics  - The relationships between symbols and their meanings. 
  21233.  
  21234.  semaphore  - An object used by applications for signalling purposes and for 
  21235.    controlling access to serially reusable resources. 
  21236.  
  21237.  separator  - In SAA Advanced Common User Access architecture, a line or color 
  21238.    boundary that provides a visual distinction between two adjacent areas. 
  21239.  
  21240.  serial dialog box  - See modal dialog box. 
  21241.  
  21242.  serialization  - The consecutive ordering of items. 
  21243.  
  21244.  serialize  - To ensure that one or more events occur in a specified sequence. 
  21245.  
  21246.  serially reusable resource (SRR)  - A logical resource or object that can be 
  21247.    accessed by only one task at a time. 
  21248.  
  21249.  session  - (1) A routing mechanism for user interaction via the console; a 
  21250.    complete environment that determines how an application runs and how users 
  21251.    interact with the application. OS/2 can manage more than one session at a 
  21252.    time, and more than one process can run in a session. Each session has its 
  21253.    own set of environment variables that determine where OS/2 looks for 
  21254.    dynamic-link libraries and other important files. (2) (D of C) In the OS/2 
  21255.    operating system, one instance of a started program or command prompt. Each 
  21256.    session is separate from all other sessions that might be running on the 
  21257.    computer. The operating system is responsible for coordinating the resources 
  21258.    that each session uses, such as computer memory, allocation of processor 
  21259.    time, and windows on the screen. 
  21260.  
  21261.  Settings Notebook  - A control window that is used to display the settings for 
  21262.    an object and to enable the user to change them. 
  21263.  
  21264.  shadow  - An object that refers to another object. A shadow is not a copy of 
  21265.    another object, but is another representation of the object. 
  21266.  
  21267.  shadow box  - The area on the screen that follows mouse movements and shows 
  21268.    what shape the window will take if the mouse button is released. 
  21269.  
  21270.  shared data  - Data that is used by two or more programs. 
  21271.  
  21272.  shared memory  - In the OS/2 operating system, a segment that can be used by 
  21273.    more than one program. 
  21274.  
  21275.  shear  - In computer graphics, the forward or backward slant of a graphics 
  21276.    symbol or string of such symbols relative to a line perpendicular to the 
  21277.    baseline of the symbol. 
  21278.  
  21279.  shell  - (1) A software interface between a user and the operating system of a 
  21280.    computer. Shell programs interpret commands and user interactions on devices 
  21281.    such as keyboards, pointing devices, and touch-sensitive screens, and 
  21282.    communicate them to the operating system. (2) Software that allows a kernel 
  21283.    program to run under different operating-system environments. 
  21284.  
  21285.  shutdown  - The process of ending operation of a system or a subsystem, 
  21286.    following a defined procedure. 
  21287.  
  21288.  sibling processes  - Child processes that have the same parent process. 
  21289.  
  21290.  sibling windows  - Child windows that have the same parent window. 
  21291.  
  21292.  simple list  - A list of like values; for example, a list of user names. 
  21293.    Contrast with mixed list. 
  21294.  
  21295.  single-byte character set (SBCS)  - A character set in which each character is 
  21296.    represented by a one-byte code.  Contrast with double-byte character set. 
  21297.  
  21298.  slider box  - In SAA Advanced Common User Access architecture: a part of the 
  21299.    scroll bar that shows the position and size of the visible information in a 
  21300.    window relative to the total amount of information available. Also known as 
  21301.    thumb mark. 
  21302.  
  21303.  SOM  - System Object Model. 
  21304.  
  21305.  source file  - A file that contains source statements for items such as 
  21306.    high-level language programs and data description specifications. 
  21307.  
  21308.  source statement  - A statement written in a programming language. 
  21309.  
  21310.  specific dynamic-link module  - A dynamic-link module created for the 
  21311.    exclusive use of an application. 
  21312.  
  21313.  spin button  - In SAA Advanced Common User Access architecture, a type of 
  21314.    entry field that shows a scrollable ring of choices from which a user can 
  21315.    select a choice. After the last choice is displayed, the first choice is 
  21316.    displayed again.  A user can also type a choice from the scrollable ring 
  21317.    into the entry field without interacting with the spin button. 
  21318.  
  21319.  spline  - A sequence of one or more B╨Æzier curves. 
  21320.  
  21321.  spooler  - A program that intercepts the data going to printer devices and 
  21322.    writes it to disk. The data is printed or plotted when it is complete and 
  21323.    the required device is available.  The spooler prevents output from 
  21324.    different sources from being intermixed. 
  21325.  
  21326.  stack  - A list constructed and maintained so that the next data element to be 
  21327.    retrieved is the most recently stored. This method is characterized as 
  21328.    last-in-first-out (LIFO). 
  21329.  
  21330.  standard window  - A collection of window elements that form a panel. The 
  21331.    standard window can include one or more of the following window elements: 
  21332.    sizing borders, system menu icon, title bar, maximize/minimize/restore 
  21333.    icons, action bar and pull-downs, scroll bars, and client area. 
  21334.  
  21335.  static control  - The means by which the application presents descriptive 
  21336.    information (for example, headings and descriptors) to the user. The user 
  21337.    cannot change this information. 
  21338.  
  21339.  static storage  - (1) A read/write storage unit in which data is retained in 
  21340.    the absence of control signals. (A)  Static storage may use dynamic 
  21341.    addressing or sensing circuits. (2) Storage other than dynamic storage. (A)
  21342.  
  21343.  style  - See window style. 
  21344.  
  21345.  subclass  - A class that inherits from another class. See also Inheritance. 
  21346.  
  21347.  subdirectory  - In an IBM personal computer, a file referred to in a root 
  21348.    directory that contains the names of other files stored on the diskette or 
  21349.    fixed disk. 
  21350.  
  21351.  superclass  - A class from which another class inherits. See also inheritance. 
  21352.  
  21353.  swapping  - (1) A process that interchanges the contents of an area of real 
  21354.    storage with the contents of an area in auxiliary storage. (I)  (A)  (2) In 
  21355.    a system with virtual storage, a paging technique that writes the active 
  21356.    pages of a job to auxiliary storage and reads pages of another job from 
  21357.    auxiliary storage into real storage. (3) The process of temporarily removing 
  21358.    an active job from main storage, saving it on disk, and processing another 
  21359.    job in the area of main storage formerly occupied by the first job. 
  21360.  
  21361.  switch  - (1) In SAA usage, to move the cursor from one point of interest to 
  21362.    another;  for example, to move from one screen or window to another or from 
  21363.    a place within a displayed image to another place on the same displayed 
  21364.    image. (2) In a computer program, a conditional instruction and an indicator 
  21365.    to be interrogated by that instruction. (3) A device or programming 
  21366.    technique for making a selection, for example, a toggle, a conditional jump. 
  21367.  
  21368.  switch list  - See Task List. 
  21369.  
  21370.  symbolic identifier  - A text string that equates to an integer value in an 
  21371.    include file, which is used to identify a programming object. 
  21372.  
  21373.  symbols  - In Information Presentation Facility, a document element used to 
  21374.    produce characters that cannot be entered from the keyboard. 
  21375.  
  21376.  synchronous  - Pertaining to two or more processes that depend upon the 
  21377.    occurrence of specific events such as common timing signals. (T)  See also 
  21378.    asynchronous. 
  21379.  
  21380.  System Menu  - In the Presentation Manager, the pull-down in the top left 
  21381.    corner of a window that allows it to be moved and sized with the keyboard. 
  21382.  
  21383.  System Object Model (SOM)  - A mechanism for language-neutral, object-oriented 
  21384.    programming in the OS/2 environment. 
  21385.  
  21386.  system queue  - The master queue for all pointer device or keyboard events. 
  21387.  
  21388.  system-defined messages  - Messages that control the operations of 
  21389.    applications and provides input an other information for applications to 
  21390.    process. 
  21391.  
  21392.  Systems Application Architecture (SAA)  - A set of IBM software interfaces, 
  21393.    conventions, and protocols that provide a framework for designing and 
  21394.    developing applications that are consistent across systems. 
  21395.  
  21396.  
  21397. ΓòÉΓòÉΓòÉ <hidden> Glossary - T ΓòÉΓòÉΓòÉ
  21398.  
  21399.  table tags  - In Information Presentation Facility, a document element that 
  21400.    formats text in an arrangement of rows and columns. 
  21401.  
  21402.  tag  - (1) One or more characters attached to a set of data that contain 
  21403.    information about the set, including its identification. (I)  (A)  (2) In 
  21404.    Generalized Markup Language markup, a name for a type of document or 
  21405.    document element that is entered in the source document to identify it. 
  21406.  
  21407.  target object  - An object to which the user is transferring information. 
  21408.  
  21409.  Task List  - In the Presentation Manager, the list of programs that are 
  21410.    active. The list can be used to switch to a program and to stop programs. 
  21411.  
  21412.  terminate-and-stay-resident (TSR)  - Pertaining to an application that 
  21413.    modifies an operating system interrupt vector to point to its own location 
  21414.    (known as hooking an interrupt). 
  21415.  
  21416.  text  - Characters or symbols. 
  21417.  
  21418.  text cursor  - A symbol displayed in an entry field that indicates where typed 
  21419.    input will appear. 
  21420.  
  21421.  text window  - Also known as the VIO window. 
  21422.  
  21423.  text-windowed application  - The environment in which the operating system 
  21424.    performs advanced-video input and output operations. 
  21425.  
  21426.  thread  - A unit of execution within a process. It uses the resources of the 
  21427.    process. 
  21428.  
  21429.  thumb mark  - The portion of the scroll bar that describes the range and 
  21430.    properties of the data that is currently visible in a window. Also known as 
  21431.    a slider box. 
  21432.  
  21433.  thunk  - Term used to describe the process of address conversion, stack and 
  21434.    structure realignment, etc., necessary when passing control between 16-bit 
  21435.    and 32-bit modules. 
  21436.  
  21437.  tilde  - A mark used to denote the character that is to be used as a mnemonic 
  21438.    when selecting text items within a menu. 
  21439.  
  21440.  time slice  - (1) An interval of time on the processing unit allocated for use 
  21441.    in performing a task. After the interval has expired, processing-unit time 
  21442.    is allocated to another task, so a task cannot monopolize processing-unit 
  21443.    time beyond a fixed limit. (2) In systems with time sharing, a segment of 
  21444.    time allocated to a terminal job. 
  21445.  
  21446.  time-critical process  - A process that must be performed within a specified 
  21447.    time after an event has occurred. 
  21448.  
  21449.  timer  - A facility provided under the Presentation Manager, whereby 
  21450.    Presentation Manager will dispatch a message of class WM_TIMER to a 
  21451.    particular window at specified intervals. This capability may be used by an 
  21452.    application to perform a specific processing task at predetermined 
  21453.    intervals, without the necessity for the application to explicitly keep 
  21454.    track of the passage of time. 
  21455.  
  21456.  timer tick  - See clock tick. 
  21457.  
  21458.  title bar  - In SAA Advanced Common User Access architecture, the area at the 
  21459.    top of each window that contains the window title and system menu icon. When 
  21460.    appropriate, it also contains the minimize, maximize, and restore icons. 
  21461.    Contrast with panel title. 
  21462.  
  21463.  TLB  - Translation lookaside buffer. 
  21464.  
  21465.  transaction  - An exchange between a workstation and another device that 
  21466.    accomplishes a particular action or result. 
  21467.  
  21468.  transform  - (1) The action of modifying a picture by scaling, shearing, 
  21469.    reflecting, rotating, or translating. (2) The object that performs or 
  21470.    defines such a modification; also referred to as a transformation. 
  21471.  
  21472.  Translation lookaside buffer (TLB)  - A hardware-based address caching 
  21473.    mechanism for paging information. 
  21474.  
  21475.  Tree  - In the Presentation Manager, the window in the File Manager that shows 
  21476.    the organization of drives and directories. 
  21477.  
  21478.  truncate  - (1) To terminate a computational process in accordance with some 
  21479.    rule (A)  (2) To remove the beginning or ending elements of a string. (3) To 
  21480.    drop data that cannot be printed or displayed in the line width specified or 
  21481.    available. (4) To shorten a field or statement to a specified length. 
  21482.  
  21483.  TSR  - Terminate-and-stay-resident. 
  21484.  
  21485.  unnamed pipe  - A circular buffer, created in memory, used by related 
  21486.    processes to communicate with one another. Contrast with named pipe. 
  21487.  
  21488.  unordered list  - In Information Presentation Facility, a vertical arrangement 
  21489.    of items in a list, with each item in the list preceded by a special 
  21490.    character or bullet. 
  21491.  
  21492.  update region  - A system-provided area of dynamic storage containing one or 
  21493.    more (not necessarily contiguous) rectangular areas of a window that are 
  21494.    visually invalid or incorrect, and therefore are in need of repainting. 
  21495.  
  21496.  user interface  - Hardware, software, or both that allows a user to interact 
  21497.    with and perform operations on a system, program, or device. 
  21498.  
  21499.  User Shell  - A component of OS/2 that uses a graphics-based, windowed 
  21500.    interface to allow the user to manage applications and files installed and 
  21501.    running under OS/2. 
  21502.  
  21503.  utility program  - (1) A computer program in general support of computer 
  21504.    processes; for example, a diagnostic program, a trace program, a sort 
  21505.    program. (T)  (2) A program designed to perform an everyday task such as 
  21506.    copying data from one storage device to another. (A)
  21507.  
  21508.  
  21509. ΓòÉΓòÉΓòÉ <hidden> Glossary - U ΓòÉΓòÉΓòÉ
  21510.  
  21511. There are no glossary terms for this starting letter. 
  21512.  
  21513.  
  21514. ΓòÉΓòÉΓòÉ <hidden> Glossary - V ΓòÉΓòÉΓòÉ
  21515.  
  21516.  value set control  - A visual component that enables a user to select one 
  21517.    choice from a group of mutually exclusive choices. 
  21518.  
  21519.  vector font  - A set of symbols, each of which is created as a series of lines 
  21520.    and curves. Synonymous with outline font. Contrast with image font. 
  21521.  
  21522.  VGA  - Video graphics array. 
  21523.  
  21524.  view  - A way of looking at an object's information. 
  21525.  
  21526.  viewing pipeline  - The series of transformations applied to a graphic object 
  21527.    to map the object to the device on which it is to be presented. 
  21528.  
  21529.  viewing window  - A clipping boundary that defines the visible part of model 
  21530.    space. 
  21531.  
  21532.  VIO  - Video Input/Output. 
  21533.  
  21534.  virtual memory (VM)  - Synonymous with virtual storage. 
  21535.  
  21536.  virtual storage  - (1) The storage space that may be regarded as addressable 
  21537.    main storage by the user of a computer system in which virtual addresses are 
  21538.    mapped into real addresses. The size of virtual storage is limited by the 
  21539.    addressing scheme of the computer system and by the amount of auxiliary 
  21540.    storage available, not by the actual number of main storage 
  21541.    locations. (I)  (A)  (2) Addressable space that is apparent to the user as 
  21542.    the processor storage space, from which the instructions and the data are 
  21543.    mapped into the processor storage locations. (3) Synonymous with virtual 
  21544.    memory. 
  21545.  
  21546.  visible region  - A window's presentation space, clipped to the boundary of 
  21547.    the window and the boundaries of any overlying window. 
  21548.  
  21549.  volume  - (1) A file-system driver that uses a block device driver for input 
  21550.    and output operations to a local or remote device. (I)  (2) A portion of 
  21551.    data, together with its data carrier, that can be handled conveniently as a 
  21552.    unit. 
  21553.  
  21554.  
  21555. ΓòÉΓòÉΓòÉ <hidden> Glossary - W ΓòÉΓòÉΓòÉ
  21556.  
  21557.  wildcard character  - Synonymous with global file-name character. 
  21558.  
  21559.  window  - (1) A portion of a display surface in which display images 
  21560.    pertaining to a particular application can be presented. Different 
  21561.    applications can be displayed simultaneously in different windows. (A)  (2) 
  21562.    An area of the screen with visible boundaries within which information is 
  21563.    displayed. A window can be smaller than or the same size as the screen. 
  21564.    Windows can appear to overlap on the screen. 
  21565.  
  21566.  window class  - The grouping of windows whose processing needs conform to the 
  21567.    services provided by one window procedure. 
  21568.  
  21569.  window coordinates  - A set of coordinates by which a window position or size 
  21570.    is defined; measured in device units, or pels. 
  21571.  
  21572.  window handle  - Unique identifier of a window, generated by Presentation 
  21573.    Manager when the window is created, and used by applications to direct 
  21574.    messages to the window. 
  21575.  
  21576.  window procedure  - Code that is activated in response to a message. The 
  21577.    procedure controls the appearance and behavior of its associated windows. 
  21578.  
  21579.  window rectangle  - The means by which the size and position of a window is 
  21580.    described in relation to the desktop window. 
  21581.  
  21582.  window resource  - A read-only data segment stored in the .EXE file of an 
  21583.    application o the .DLL file of a dynamic link library. 
  21584.  
  21585.  window style  - The set of properties that influence how events related to a 
  21586.    particular window will be processed. 
  21587.  
  21588.  window title  - In SAA Advanced Common User Access architecture, the area in 
  21589.    the title bar that contains the name of the application and the OS/2 
  21590.    operating system file name, if applicable. 
  21591.  
  21592.  Workplace Shell  - The OS/2 object-oriented, graphical user interface. 
  21593.  
  21594.  workstation  - (1) A display screen together with attachments such as a 
  21595.    keyboard, a local copy device, or a tablet. (2) (D of C) One or more 
  21596.    programmable or nonprogrammable devices that allow a user to do work. 
  21597.  
  21598.  world coordinates  - A device-independent Cartesian coordinate system used by 
  21599.    the application program for specifying graphical input and output. (I)  (A)
  21600.  
  21601.  world-coordinate space  - Coordinate space in which graphics are defined 
  21602.    before transformations are applied. 
  21603.  
  21604.  WYSIWYG  - What-You-See-Is-What-You-Get. A capability of a text editor to 
  21605.    continually display pages exactly as they will be printed. 
  21606.  
  21607.  
  21608. ΓòÉΓòÉΓòÉ <hidden> Glossary - X ΓòÉΓòÉΓòÉ
  21609.  
  21610. There are no glossary terms for this starting letter. 
  21611.  
  21612.  
  21613. ΓòÉΓòÉΓòÉ <hidden> Glossary - Y ΓòÉΓòÉΓòÉ
  21614.  
  21615. There are no glossary terms for this starting letter. 
  21616.  
  21617.  
  21618. ΓòÉΓòÉΓòÉ <hidden> Glossary - Z ΓòÉΓòÉΓòÉ
  21619.  
  21620.  z-order  - The order in which sibling windows are presented. The topmost 
  21621.    sibling window obscures any portion of the siblings that it overlaps; the 
  21622.    same effect occurs down through the order of lower sibling windows. 
  21623.  
  21624.  zooming  - The progressive scaling of an entire display image in order to give 
  21625.    the visual impression of movement of all or part of a display group toward 
  21626.    or away from an observer. (I)  (A)
  21627.  
  21628.  8.3 file-name format  - A file-naming convention in which file names are 
  21629.    limited to eight characters before and three characters after a single dot. 
  21630.    Usually pronounced "eight-dot-three." See also non-8.3 file-name format. 
  21631.