VkPrefDialog(3x)

NAME
     VkPrefDialog - Preference dialog interface for preference package

INHERITS FROM
     VkGenericDialog : VkDialogManager : VkComponent : VkCallbackObject

HEADER FILE
     #include <Vk/VkPrefDialog.h>

PUBLIC PROTOCOL SUMMARY
   Constructor/Destructor
           VkPrefDialog(const char* name,
                        VkPrefItem* item = NULL);
           virtual void ~VkPrefDialog(void);


   Access Functions
           VkPrefItem* item(void);


   Setting Item
           void setItem(VkPrefItem* i);


CLASS DESCRIPTION
          The VkPrefDialog class is an abstract class that supports easy-to-
          use preference dialogs using VkPrefItem and its subclasses.
          Applications pay attention only to the preference item values and
          let VkPrefItem and VkPrefDialog handle formatting and user
          interaction.  Applications can also use the VkPrefDialog class
          without subclassing, by using the VkPrefDialog::prefCallback
          instead.



DERIVING SUBCLASSES
          Derived classes should override the ok(), cancel(), and apply()
          member functions.  These are called when the user presses the OK,
          Cancel, and Apply buttons, respectively.  VkPrefDialog will not call
          VkPrefItem::updateValue() until after these callbacks are invoked,
          so the derived code can call VkPrefItem::changed() to see if
          individual preference item values have changed since the last
          activation.



FUNCTION DESCRIPTIONS
   VkPrefDialog()
           VkPrefDialog(const char* name,
                        VkPrefItem* item = NULL);
           virtual void ~VkPrefDialog(void);
          Create a preference dialog.  The second argument is the single
          preference item for the dialog.  Usually, this item will be a
          VkPrefList containing multiple preference objects.

   item()
           VkPrefItem* item(void);


          Returns the preference item associated with this preference dialog.

   setItem()
           void setItem(VkPrefItem* i);


          Changes the preference item associated with this preference dialog.

DATA MEMBER DESCRIPTIONS
   _item
           VkPrefItem* _item;


          The preference item for this dialog

   prefCallback
          static const const char* prefCallback;


          A callback function providing an alternative to subclassing
          VkPrefDialog.  The callback will be called with reasons of
          VkDialogManager::OK, VkDialogManager::APPLY, and
          VkDialogManager::CANCEL.

INHERITED MEMBER FUNCTIONS
   Inherited from VkGenericDialog
           VkGenericDialog(),  ~VkGenericDialog(),


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


   Inherited from VkComponent
          installDestroyHandler(), removeDestroyHandler(), widgetDestroyed(),
          setDefaultResources(), getResources(), manage(), unmanage(),
          baseWidget(), okToQuit(), _name, _baseWidget, _w, deleteCallback

   Inherited from VkCallbackObject
          callCallbacks(), addCallback(), removeCallback(),
          removeAllCallbacks()


CLASSES USED BY THIS CLASS
     VkPrefItem

SEE ALSO
     VkGenericDialog, VkDialogManager, VkComponent, VkPrefItem
     ViewKit Programmer's Guide
     The X Window System, DEC Press, Bob Sheifler and Jim Gettys
     The X Window System Toolkit, DEC Press, Paul Asente and Ralph Swick
     The OSF/Motif Programmers Reference, Prentice Hall, OSF