rwlogo
Rogue Wave Views 5.5.1

Rogue Wave Views
Foundation Package API Reference Guide

Product Documentation:

Rogue Wave Views
Documentation Home

IlvPromptDialog Class Reference

String entry dialog. More...

#include <ilviews/util/dialogs.h>

List of all members.

Public Member Functions

 IlvPromptDialog (IlvSystemView parent, const char *message, IlUInt count=0, const char **strings=0)
 Constructor.
 ~IlvPromptDialog ()
 Destructor.
void setString (const char *string)
 Sets the user choice to a string.
void setStrings (IlUInt count, const char **strings)
 Sets the user choice to a list of strings.
void setTitle (const char *title)
 Sets the dialog's title.
const char * show (IlvPos x, IlvPos y)
 Displays the dialog at a given location.
const char * show ()
 Displays the dialog.

Detailed Description

String entry dialog.

Library: display

This class builds a dialog box that asks the user to specify a string by typing it in a field or choosing from a list of valid values.

IlvPromptDialog.png


- An IlvPromptDialog on a Windows platform -

This class is dependent on the standard toolkit used in conjunction with Rogue Wave Views. It can be used only if you link your final application with the system toolkit supported by Rogue Wave Views (on Unix platforms, you must use the library libmviews instead of libxviews and link with the Motif library). If you do not want to use these libraries, you can use a dialog box class based on Rogue Wave Views gadgets (IlvIPromptString) that does not need the system toolkit, but that depends on the gadgets library of Rogue Wave Views.

See also:
IlvIPromptString, IlvInformationDialog, IlvQuestionDialog, IlvIQuestionDialog.

Constructor & Destructor Documentation

IlvPromptDialog::IlvPromptDialog ( IlvSystemView  parent,
const char *  message,
IlUInt  count = 0,
const char **  strings = 0 
)

Constructor.

Initializes a new IlvPromptDialog with a predefined message and optionally a list of strings that specifies the domain of the valid answers. A standard Widget (to use the X Window terminology) is created.

Parameters:
parent The system view (that you usually get by calling the method IlvAbstractView::getSystemView of an existing view) for which this dialog is created. The dialog, when displayed, is transient for this view.
message The message that is displayed next to the entry field.
count The number of initial strings that are proposed to the end user. Note that if no string is provided, only the message will be displayed.
strings An array of count strings that are proposed to the user. This array and its contents are copied.
IlvPromptDialog::~IlvPromptDialog (  ) 

Destructor.

The encapsulated widget is destroyed.


Member Function Documentation

void IlvPromptDialog::setString ( const char *  string  ) 

Sets the user choice to a string.

Parameters:
string The string that is presented to the user when the dialog box is displayed. This string is copied.
void IlvPromptDialog::setStrings ( IlUInt  count,
const char **  strings 
)

Sets the user choice to a list of strings.

The initial choice is set to the first string of the list.

Parameters:
count The number of strings that are proposed.
strings The array of count strings that define the new domain of valid answers.
void IlvPromptDialog::setTitle ( const char *  title  ) 

Sets the dialog's title.

The default title is "Text chooser". Use this method to change this to whatever you need.

Parameters:
title The new title of this dialog. The string is copied.
const char* IlvPromptDialog::show ( IlvPos  x,
IlvPos  y 
)

Displays the dialog at a given location.

This member function is similar to show(), but you can specify the location of the dialog box.

Parameters:
x The x coordinate, relative to the upper-left corner of the screen, where the dialogs appears.
y The y coordinate, relative to the upper-left corner of the screen, where the dialogs appears.
Returns:
The string that was chosen, or 0 if the user has pressed the Cancel button. The returned string must not be modified or deleted.
const char* IlvPromptDialog::show (  ) 

Displays the dialog.

Pops the dialog box on the screen, and waits until the user has chosen a string and pressed the OK or Cancel buttons.

Returns:
The string that was chosen, or 0 if the user has pressed the Cancel button. The returned string must not be modified or deleted.

© Copyright 2012, Rogue Wave Software, Inc. All Rights Reserved.
Rogue Wave is a registered trademark of Rogue Wave Software, Inc. in the United States and other countries. All other trademarks are the property of their respective owners.