home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 4 / DATAFILE_PDCD4.iso / utilities / utilsd / evntshell / Docs / FontPick < prev    next >
Encoding:
Text File  |  1995-11-12  |  1.9 KB  |  67 lines
  1. This extension library should be installed using the
  2. FNshell_InstallLib routine so that the variables
  3. and storage space can be set up. Alternatively append
  4. the library to your program and call
  5. FN_shell_FontPick_Init.
  6.  
  7. Additionally the messages from the file 'Resources.UK.
  8. colourpick' should be added to the application's message
  9. file.
  10.  
  11. This library implements a font selector dialog box
  12. similar to the one specified in the Style Guide.
  13.  
  14. ------------------------------------------------------------------------------
  15.  
  16. PROCshell_AttachPopupFontPicker()
  17. =>    int    window handle
  18.     int    menu icon handle
  19.     int    display icon handle (optional, may be -1)
  20.     str    selection function (optional, may be "")
  21.     str    preopen function (optional, may be "")
  22.  
  23. Provides for automatic updating of a display
  24. icon when a selection is made from the
  25. fontpicker dbox.
  26.  
  27. The button type of the menu icon is changed
  28. to 3 to ensure the menu opens when <SELECT>
  29. is used.
  30.  
  31. Selection FN (PROCshell_AttachPopupFontPicker)
  32. =>    str    selected font name
  33.     real    font width in pts
  34.     real    font height in pts
  35.  
  36. <=    int    no meaning
  37.  
  38. Called when a valid selection has been made from
  39. the fontpicker dbox.
  40.  
  41. Preopen FN (PROCshell_AttachPopupFontPicker)
  42. =>    int    window handle of fontpicker dbox
  43.  
  44. <=    int    no meaning
  45.  
  46. Called just before the fontpicker opens so that the
  47. appearance of the dbox can be adjusted. For example
  48. the title can be changed with PROCshell_FontPicker_SetTitle,
  49. and the current font can be set with a call to the
  50. routine PROCshell_FontPicker_SelectFont.
  51.  
  52. ------------------------------------------------------------------------------
  53.  
  54. PROCshell_FontPicker_SelectFont()
  55. =>    str    font name
  56.     int    width in pts
  57.     int    height in pts
  58.  
  59. This routine sets the state of the fontpicker
  60. dbox before it opens.
  61.  
  62. ------------------------------------------------------------------------------
  63.  
  64. PROCshell_FontPicker_SetTitle()
  65. =>    str    new title for dbox
  66.  
  67. ------------------------------------------------------------------------------