GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  XMTDISPLAYERRORANDASK (3)

NAME

XmtDisplayErrorAndAsk(), XmtDisplayWarningAndAsk() - display an error or warning message, ask a yes-or-no question and return the user’s response.

CONTENTS

SYNOPSIS

   #include <Xmt/Dialogs.h>

   Boolean XmtDisplayErrorAndAsk(Widget w, String query_name, String message_default, String yes_default, String no_default, XmtButtonType default_button_default, String help_text_default)

   Boolean XmtDisplayWarningAndAsk(Widget w, String query_name, String message_default, String yes_default, String no_default, XmtButtonType default_button_default, String help_text_default)

ARGUMENTS

INPUTS
w The shell widget over which the dialog will be displayed, or any descendant of that shell.
query_name The name of this instantiation of the dialog, used to look up resources. NULL may be specified, but will result in a dialog that cannot be customized through the resource database.
prompt_default The prompt message to be displayed in the dialog, unless an overriding value is found in the resource database.
yes_default The string to be displayed in the Yes button, unless an overriding value is found in the resource database. NULL may be specified.
no_default The string to be displayed in the No button, unless an overriding value is found in the resource database. NULL may be specified.
default_button_default The default button (ie. the button that will be activated if the user presses the Return key), unless an overriding value is found in the resource database. Legal values are: XmtYesButton and Xmt NoButton.
help_text_default The help text to display when the user clicks the Help button, unless an overriding value is found in resource database. NULL may be specified.

RETURNS

True if the user clicked the Yes button; False if the user clicked the No button.

DESCRIPTION

XmtDisplayErrorAndAsk() and XmtDisplayWarningAndAsk() are simplified interfaces to XmtAskForBoolean(). They display a modal dialog box displaying a warning or error message and asking the user for a yes or no response to a question. Then they enter an internal event loop until the user selects either the Yes or No buttons. They return True if the user answers Yes and False if the user answers with the No button. Unlike XmtAskForBoolean(), which returns False when the user clicks the Cancel button, these functions do not display a Cancel button, so they directly return the user’s response to the question.

If help text is found in the resource database for this dialog, or if the help_text_default argument is non-NULL, then this text will be displayed (using XmtDisplayInformation()) when the user clicks on the Help button. If there is no help available for the dialog, then the Help button will be insensitive.

If you specify a query_name argument to these functions, then you can customize a number of attributes of the resulting dialogs through the resource database. See XmtAskForBoolean() for more information. Also note that these functions use the same cached dialog widgets that XmtAskForBoolean() does, and you can set resources on them as described for that function.

SEE ALSO

Chapter 26, Simple Input Dialogs,
XmtAskForBoolean(), XmtDisplayErrorMsg(), XmtDisplayErrorAndAsk(), XmtDisplayWarningMsg(), XmtDisplayWarningAndAsk().
Search for    or go to Top of page |  Section 3 |  Main Index


Xmt XMTDISPLAYERRORANDASK (3) Motif Tools

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.