1998-08-11 02:40:22 +08:00
|
|
|
\section{\module{EasyDialogs} ---
|
1999-03-03 00:37:17 +08:00
|
|
|
Basic Macintosh dialogs}
|
1998-07-24 01:55:31 +08:00
|
|
|
|
1999-03-03 00:37:17 +08:00
|
|
|
\declaremodule{standard}{EasyDialogs}
|
|
|
|
\platform{Mac}
|
1998-07-24 01:55:31 +08:00
|
|
|
\modulesynopsis{Basic Macintosh dialogs.}
|
|
|
|
|
1995-10-10 22:43:20 +08:00
|
|
|
|
1998-04-04 14:23:02 +08:00
|
|
|
The \module{EasyDialogs} module contains some simple dialogs for
|
2000-08-30 22:33:02 +08:00
|
|
|
the Macintosh. All routines have an optional parameter \var{id} with
|
|
|
|
which you can override the DLOG resource used for the dialog, as long
|
|
|
|
as the item numbers correspond. See the source for details.
|
|
|
|
|
1998-04-04 14:23:02 +08:00
|
|
|
The \module{EasyDialogs} module defines the following functions:
|
1995-10-10 22:43:20 +08:00
|
|
|
|
|
|
|
|
|
|
|
\begin{funcdesc}{Message}{str}
|
|
|
|
A modal dialog with the message text \var{str}, which should be at
|
|
|
|
most 255 characters long, is displayed. Control is returned when the
|
|
|
|
user clicks ``OK''.
|
|
|
|
\end{funcdesc}
|
|
|
|
|
1998-03-17 14:33:25 +08:00
|
|
|
\begin{funcdesc}{AskString}{prompt\optional{, default}}
|
1998-04-04 14:23:02 +08:00
|
|
|
Ask the user to input a string value, in a modal dialog. \var{prompt}
|
2000-10-14 12:56:52 +08:00
|
|
|
is the prompt message, the optional \var{default} arg is the initial
|
|
|
|
value for the string. All strings can be at most 255 bytes
|
|
|
|
long. \function{AskString()} returns the string entered or \code{None}
|
|
|
|
in case the user cancelled.
|
|
|
|
\end{funcdesc}
|
|
|
|
|
|
|
|
\begin{funcdesc}{AskPassword}{prompt\optional{, default}}
|
|
|
|
Ask the user to input a string value, in a modal dialog. Like
|
|
|
|
\method{AskString}, but with the text shown as bullets. \var{prompt}
|
|
|
|
is the prompt message, the optional \var{default} arg is the initial
|
1995-10-10 22:43:20 +08:00
|
|
|
value for the string. All strings can be at most 255 bytes
|
1998-04-04 14:23:02 +08:00
|
|
|
long. \function{AskString()} returns the string entered or \code{None}
|
|
|
|
in case the user cancelled.
|
1995-10-10 22:43:20 +08:00
|
|
|
\end{funcdesc}
|
|
|
|
|
1998-03-17 14:33:25 +08:00
|
|
|
\begin{funcdesc}{AskYesNoCancel}{question\optional{, default}}
|
1995-10-10 22:43:20 +08:00
|
|
|
Present a dialog with text \var{question} and three buttons labelled
|
|
|
|
``yes'', ``no'' and ``cancel''. Return \code{1} for yes, \code{0} for
|
|
|
|
no and \code{-1} for cancel. The default return value chosen by
|
|
|
|
hitting return is \code{0}. This can be changed with the optional
|
|
|
|
\var{default} argument.
|
|
|
|
\end{funcdesc}
|
|
|
|
|
2000-10-14 12:56:52 +08:00
|
|
|
\begin{funcdesc}{ProgressBar}{\optional{title \optional{, maxval\optional{,label}}}}
|
|
|
|
Display a modeless progress dialog with a thermometer bar. \var{title}
|
1998-04-04 14:23:02 +08:00
|
|
|
is the text string displayed (default ``Working...''), \var{maxval} is
|
2000-10-14 12:56:52 +08:00
|
|
|
the value at which progress is complete (default
|
|
|
|
\code{100}). \var{label} is the text that is displayed over the progress
|
|
|
|
bar itself. The returned object has two methods,
|
|
|
|
\code{set(\var{value})}, which sets the value of the progress bar, and
|
|
|
|
\code{label(\var{text})}, which sets the text of the label. The bar
|
|
|
|
remains visible until the object returned is discarded.
|
|
|
|
|
|
|
|
The progress bar has a ``cancel'' button. [NOTE: how does the cancel
|
|
|
|
button behave?]
|
1995-11-14 18:30:27 +08:00
|
|
|
\end{funcdesc}
|