VkPrefDialog(3x)VkPrefDialog(3x)NAMEVkPrefDialog - 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 DESCRIPTIONSVkPrefDialog()
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
_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
Page 2
VkPrefDialog(3x)VkPrefDialog(3x)
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
Page 3