VkPromptDialog(3x)

NAME
     VkPromptDialog - A dialog manager for prompt dialogs


INHERITS FROM
     VkDialogManager : VkComponent : VkCallbackObject


HEADER FILE
     #include <Vk/VkPromptDialog.h>


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


   Information
          const char* text(void);


   Setting Information
          void setText(const char *text);



PROTECTED PROTOCOL SUMMARY
   Protected Data Members
          char* _text;



X RESOURCES ASSOCIATED WITH THIS CLASS
          No new X resources are added by this class.



CLASS DESCRIPTION
     This class displays a Motif prompt dialog, using the caching facilities
     of VkDialogManager class.  Applications typically use the globally
     available dialog thePromptDialog to post their errors.



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

          Initialize a VkPromptDialog.  VkPromptDialog is not normally
          instantiated by applications.  Use the globally-instantiated
          thePromptDialog instead.


   ~VkPromptDialog()
          virtual ~VkPromptDialog(void);


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


   void setText()
          void setText(const char *text);


          Sets the initial contents of the text field.  This will be the text
          that is returned, unless the user edits it.


   char* text()
          const char* text(void);


          Returns the last text the user entered.


DATA MEMBER DESCRIPTIONS
   char* _text;
          char* _text;


          Pointer to the last text the user entered.


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


   Inherited from VkComponent
          _baseWidget, _extension, _name, _w,
          afterRealizeHook(), attributeList(), baseWidget(), deleteCallback,
          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
     thePromptDialog will only be valid for the default screen in the
     application.  The following new function API will return the
     VkPromptDialog associated with the appropriate screen and should be used
     instead of thePromptDialog;


           VkPromptDialog *getAppPromptDialog(VkComponent *comp);


CLASSES USED BY THIS CLASS
     VkDialogManager


KNOWN CLASSES THAT USE THIS CLASS
     VkLicense


SEE ALSO
     VkCallbackObject, VkComponent, VkDialogManager, VkLicense