home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 4 / DATAFILE_PDCD4.iso / utilities / utilsd / evntshell / Docs / FontMenu < prev    next >
Encoding:
Text File  |  1995-11-05  |  2.9 KB  |  118 lines
  1. FN_shell_FontMenu_Init
  2. =>    None
  3.  
  4. <=    bool    TRUE if module initialised correctly
  5.          FALSE otherwise
  6.  
  7. Normally called automatically when the library file
  8. is loaded by FNshell_InstallLib. If the library
  9. code is appended to the main program instead it will
  10. need to be called to initialise the fontmenu module.
  11.  
  12. --------------------------------------------------------
  13.  
  14. FNshell_FontMenu_IsInitialised
  15. =>    none
  16.  
  17. <=    bool    TRUE if fontmenu module has
  18.          been initialised, otherwise FALSE.
  19.  
  20. --------------------------------------------------------
  21.  
  22. FNshell_FontMenu_GetHandle
  23. =>    none
  24.  
  25. <=    int    menu handle
  26.  
  27. --------------------------------------------------------
  28.  
  29. FNshell_FontMenu_OffersSystemFont
  30. =>    none
  31.  
  32. <=    bool    TRUE if fontmenu module contains a
  33.          'SystemFont' item, otherwise FALSE.
  34.  
  35. --------------------------------------------------------
  36.  
  37. FNshell_FontMenu_GetLastSelectedFont
  38. =>    none
  39.  
  40. <=    str    name of last valid font selected from
  41.          the menu i.e. 'Trinity.Medium'
  42.  
  43. If no valid font menu selection has been made
  44. the function will return "" and no action should
  45. be taken.
  46.  
  47. --------------------------------------------------------
  48.  
  49. FNshell_FontMenu_GetNrFonts
  50. =>    none
  51.  
  52. <=    int    nr of fonts in menu
  53.  
  54. --------------------------------------------------------
  55.  
  56. PROCshell_AttachFontMenu()
  57. =>    int    window handle
  58.     int    icon handle to attach menu to
  59.     int    icon handle to display selection
  60.     str    function to call when menu_select
  61.          event occurs (optional, may be "")
  62.     str    function to call before the menu
  63.          opens (optional, may be "")
  64.  
  65. Use this routine to attach the FontMenu to an icon or
  66. a window. Attach the FontMenu to an existing menu
  67. structure with <PROCshell_AttachFontSubMenu>.
  68.  
  69. This routine will NOT attempt to load the necessary
  70. 'FontMenu' support module if it is not already
  71. loaded. Add an entry in the !Run file to load it.
  72.  
  73. Selection FN (PROCshell_AttachFontMenu)
  74. =>    int    window handle
  75.     int    display icon handle
  76.     str    name of selected font i.e
  77.          'Trinity.Medium'.
  78.  
  79. <=    int    no meaning
  80.  
  81. PreOpen FN (PROCshell_AttachFontMenu)
  82. =>    int    handle of menu
  83.  
  84. <=    int    no meaning
  85.  
  86. Example !Run file entry (FontMenu)
  87. RMEnsure FontMenu 1.16 RMLoad <EvntShell$Path>FontMenu
  88. RMEnsure FontMenu 1.16 Error Couldn't load FontMenu Module
  89.  
  90. --------------------------------------------------------
  91.  
  92. PROCshell_FontMenu_SelectFont()
  93. =>    str    name of font to select i.e.
  94.          'Trinity.Medium'
  95.  
  96. The font name is used by the library routines
  97. to decide which font name to select when the
  98. font menu opens. As the same font menu can be
  99. used by different applications it is important
  100. to set this up just before the menu opens.
  101.  
  102. --------------------------------------------------------
  103.  
  104. PROCshell_FontMenu_AllowSystemFont
  105. =>    none
  106.  
  107. The 'SystemFont' item appears in the menu after this
  108. call.
  109.  
  110. --------------------------------------------------------
  111.  
  112. PROCshell_FontMenu_DisallowSystemFont
  113. =>    none
  114.  
  115. The 'SystemFont' item does not appear in the menu after
  116. this call.
  117.  
  118. --------------------------------------------------------