VkPrefDialog(3x)					      VkPrefDialog(3x)

NAME    [Toc]    [Back]

     VkPrefDialog - Preference dialog interface	for preference package

INHERITS FROM    [Toc]    [Back]

     VkGenericDialog : VkDialogManager : VkComponent : VkCallbackObject

HEADER FILE    [Toc]    [Back]

     #include <Vk/VkPrefDialog.h>

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


   Access Functions    [Toc]    [Back]
	   VkPrefItem* item(void);


   Setting Item    [Toc]    [Back]
	   void	setItem(VkPrefItem* i);

CLASS DESCRIPTION    [Toc]    [Back]

	  The VkPrefDialog class is an abstract	class that supports easy-touse
 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    [Toc]    [Back]

	  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    [Toc]    [Back]

   VkPrefDialog()
	   VkPrefDialog(const char* name,
			VkPrefItem* item = NULL);
	   virtual void	~VkPrefDialog(void);




									Page 1






VkPrefDialog(3x)					      VkPrefDialog(3x)



	  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    [Toc]    [Back]

   _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    [Toc]    [Back]

   Inherited from VkGenericDialog
	   VkGenericDialog(),  ~VkGenericDialog(),


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


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






									Page 2






VkPrefDialog(3x)					      VkPrefDialog(3x)



   Inherited from VkCallbackObject    [Toc]    [Back]
	  callCallbacks(), addCallback(), removeCallback(),
	  removeAllCallbacks()


CLASSES	USED BY	THIS CLASS
     VkPrefItem

SEE ALSO    [Toc]    [Back]

     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


									PPPPaaaaggggeeee 3333