home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Extra 1997 #2 / Amiga Plus Extra 1997 #2.iso / system / mui / developer / autodocs / mui_poppen.doc < prev    next >
Encoding:
Text File  |  1997-02-16  |  1.5 KB  |  41 lines
  1. TABLE OF CONTENTS
  2.  
  3. Poppen.mui/Poppen.mui
  4. Poppen.mui/Poppen.mui
  5.  
  6.     Poppen class adds input capabilities to its super class
  7.     Pendisplay. It should be used if your application allows 
  8.     users to configure some custom pens for rendering.
  9.  
  10.     A Poppen object will appear as kind of a button which 
  11.     displays the currently selected color. When the user hits 
  12.     the button, a Popup window containing a Penadjust object 
  13.     opens up and lets the user choose change the color.
  14.  
  15.     You can control the window title of the popup window using 
  16.     the MUIA_Window_Title on the Poppen object. It will remember 
  17.     its value and use it when creating the popup window.
  18.  
  19.     As most MUI popups, the Penadjust popup window runs 
  20.     asynchronously and stays there until the user terminates 
  21.     it with "OK" or "Cancel". Furthermore, if the popup window 
  22.     is automatically cancelled if the pop button receives a 
  23.     MUIM_Cleanup method.
  24.  
  25.     Anyway, you dont have to care about the internals of this class.
  26.     Just create it like
  27.  
  28.     obj = MUI_NewObject(MUIC_Poppen,
  29.         MUIA_CycleChain  , 1,
  30.         MUIA_Window_Title, "Followed Links Color",
  31.         TAG_DONE);
  32.  
  33.     somewhere in your prefs window and everything will be fine. You
  34.     can get/set the current color from a Poppen object by using
  35.     the MUIA_Pendisplay_Spec attribute. The resulting struct
  36.     MUI_SpenSpec may then be saved somewhere in your preferences
  37.     and used as parameter for MUI_ObtainPen() and MUI_ReleasePen().
  38.  
  39.     You can find some example code on using this class in the
  40.     Class2 demo of the MUI distribution.
  41.