VkColorChooserDialog(3x)

NAME
     VkColorChooserDialog - A dialog manager for color chooser dialogs


INHERITS FROM
     VkDialogManager : VkComponent : VkCallbackObject


HEADER FILE
     #include <Vk/VkColorChooserDialog.h>


PUBLIC PROTOCOL SUMMARY
   Constructor/Destructor
           VkColorChooserDialog(const char*);
           virtual ~VkColorChooserDialog(void);



   Manipulating the Colors
           XColor* getXColor(void);
           void setXColor(unsigned short,
                          unsigned short, unsigned short);
           void setCurrentXColor(unsigned short,
                                 unsigned short, unsigned short);
           void setStoredXColor(unsigned short,
                                unsigned short, unsigned short);


     The following functions do not follow the X model.  They accept and
     return rgb values in the lower eight bits.  In particular, getColor(void)
     returns a shifted XColor structure.

           XColor* getColor(void);
           void setColor(short,short,short);
           void setCurrentColor(short,short,short);
           void setStoredColor(short,short,short);



CLASS DESCRIPTION
     This class displays an SGI color chooser dialog, using the caching
     facilities of VkDialogManager class.  Applications typically use the
     globally available dialog theColorChooserDialog to post their errors.


FUNCTION DESCRIPTIONS
   VkColorChooserDialog()
          VkColorChooserDialog(const char*);

          Initialize a VkColorChooserDialog.  VkColorChooserDialog is not
          normally instantiated by applications.  Use the globally-
          instantiated theColorChooserDialog instead.

   ~VkColorChooserDialog()
          virtual ~VkColorChooserDialog(void);


          Free memory used by the VkColorChooserDialog class.  The global
          instance should not be deleted.

   getColor()
          XColor* getColor(void);


          Returns a pointer to the current color.  Note that the return value
          is not truly an XColor, because the color values are from 0-255.

   getXColor()
          XColor* getXColor(void);


          Returns a pointer to the current color.

   setColor()
          void setColor(short,short,short);


          Sets both the current and stored colors.  This function requires
          colors whose value is 0-255.

   setXColor()
          void setXColor(unsigned short, unsigned short,
                         unsigned short);


          Sets both the current and stored colors.  This function requires
          standard XColor colors.

   setCurrentColor()
          void setCurrentColor(short,short,short);


          Sets just the current color.  This function requires colors whose
          value is 0-255.

   setCurrentXColor()
          void setCurrentXColor(unsigned short, unsigned short,
                                unsigned short);

          Sets just the current color.  This function requires standard XColor
          colors.

   setStoredColor()
          void setStoredColor(short,short,short);


          Sets just the stored color.  This function requires colors whose
          value is 0-255.

   setStoredXColor()
          void setStoredXColor(unsigned short, unsigned short,
                               unsigned short);


          Sets just the stored color.  This function requires standard XColor
          colors.


DATA MEMBER DESCRIPTIONS
   const const char* valueChangedCallback;
          static const const char* valueChangedCallback;


          The name of the value changed callback.


INHERITED MEMBER FUNCTIONS
   Inherited from VkDialogManager
          _action, _allowMultipleDialogs, _minimizeMultipleDialogs,
          _showApply, _showCancel, _showOK, prepostCallback,
          centerOnScreen(), hide(), lastPosted(), post(), postAndWait(),
          postBlocked(), postModal(), prepost(), setButtonLabels(),
          setTitle(), setUpWindowManagerProperties(), show(), unpost(),
          unpostAll(), waitForDialog()


   Inherited from VkComponent
          _baseWidget, _extension, _name, _w, deleteCallback,
          afterRealizeHook(), attributeList(), baseWidget(), getAttribute(),
          getResources(), installDestroyHandler(), isComponent(),
          loadObject(), manage(), name(), okToQuit(), realize(),
          removeDestroyHandler(), setAttribute(), setDefaultResources(),
          unmanage(), widgetDestroyed(), Widget()


   Inherited from VkCallbackObject
          addCallback(), callCallbacks(), cloneCallback(), cloneCallbacks(),
          getMethodArgType(), getMethods(), hasCallbacks(), invokeMethod(),
          loadObject(), registerLoadedObject(), removeAllCallbacks()
          removeCallback(),
VIEWKIT 2.1 CHANGES
     In multi-screen enabled applications or components, references to
     theColorChooserDialog will only be valid for the default screen in the
     application.  The following new function API will return the
     VkColorChooserDialog associated with the appropriate screen and should be
     used instead of theColorChooserDialog;


           VkColorChooserDialog *getAppColorChooserDialog(VkComponent *comp);


CLASSES USED BY THIS CLASS
     VkDialogManager


SEE ALSO
     VkCallbackObject, VkComponent, VkDialogManager