209 lines
6.0 KiB
HTML
209 lines
6.0 KiB
HTML
<HTML>
|
|
<HEAD><TITLE>MessageDlg</TITLE></HEAD>
|
|
<BODY BGCOLOR=white>
|
|
<DL><DT><I><A HREF="#descr">NAME</A></I></DT>
|
|
<DD><B>MessageDlg</B>
|
|
- Message dialog box
|
|
</DD></DL>
|
|
<DL>
|
|
<DT><I>CREATION</I></DT>
|
|
<DD><A HREF="#descr"><B>MessageDlg</B></A> <I>pathName</I> ?<I>option value...</I>?</DD>
|
|
</DL>
|
|
<DL>
|
|
<DT><I>STANDARD OPTIONS</I></DT>
|
|
<DD><TABLE CELLSPACING=0 CELLSPACING=0 BORDER=0>
|
|
<TR>
|
|
<TD> <A HREF="options.htm#M-anchor">-anchor</A></TR>
|
|
<TD> <A HREF="options.htm#M-font">-font</A></TR>
|
|
</TR>
|
|
<TR>
|
|
<TD> <A HREF="options.htm#M-foreground">-foreground or -fg</A></TD>
|
|
<TD> <A HREF="options.htm#M-padx">-padx</A></TR>
|
|
</TR>
|
|
<TR>
|
|
<TD> <A HREF="options.htm#M-pady">-pady</A></TR>
|
|
</TABLE></DD>
|
|
</DL>
|
|
<DL>
|
|
<DT><I><A HREF="Dialog.html">OPTIONS from <B>Dialog</B></A></I></DT>
|
|
<DD><TABLE CELLSPACING=0 CELLPADDING=0 BORDER=0>
|
|
<TR>
|
|
<TD> -background or -bg</TD>
|
|
<TD> -cancel</TD>
|
|
</TR>
|
|
<TR>
|
|
<TD> -default</TD>
|
|
<TD> -parent</TD>
|
|
</TR>
|
|
</TABLE></DD>
|
|
</DL>
|
|
<DL>
|
|
<DT><I><A HREF="#wso">WIDGET-SPECIFIC OPTIONS</A></I></DT>
|
|
<DD><TABLE CELLSPACING=0 CELLSPACING=0 BORDER=0>
|
|
<TR>
|
|
<TD> <A HREF="#-aspect">-aspect</A></TR>
|
|
<TD> <A HREF="#-buttons">-buttons</A></TR>
|
|
</TR>
|
|
<TR>
|
|
<TD> <A HREF="#-icon">-icon</A></TR>
|
|
<TD> <A HREF="#-justify">-justify</A></TR>
|
|
</TR>
|
|
<TR>
|
|
<TD> <A HREF="#-message">-message</A></TR>
|
|
<TD> <A HREF="#-title">-title</A></TR>
|
|
</TR>
|
|
<TR>
|
|
<TD> <A HREF="#-type">-type</A></TR>
|
|
<TD> <A HREF="#-width">-width</A></TR>
|
|
</TR>
|
|
</TABLE></DD>
|
|
</DL>
|
|
<BR><HR WIDTH="100%"><BR>
|
|
<B><A NAME="descr"></A>DESCRIPTION</B><BR>
|
|
<P>
|
|
|
|
MessageDlg provides a simple way to display a message dialog.
|
|
MessageDlg::<B>create</B> creates the message dialog, displays
|
|
it and return the index of the pressed button, or -1 if it is destroyed.
|
|
When returning, the dialog no longer exists.
|
|
|
|
</P>
|
|
<BR><HR WIDTH="50%"><BR>
|
|
<B><A NAME="wso">WIDGET-SPECIFIC OPTIONS</A></B><BR>
|
|
<DL><DT><A NAME="-aspect"><B>-aspect</B></A></DT>
|
|
<DD>
|
|
|
|
Specifies a non-negative integer value indicating desired
|
|
aspect ratio for the text. The aspect ratio is specified as
|
|
100*width/height. 100 means the text should
|
|
be as wide as it is tall, 200 means the text should
|
|
be twice as wide as it is tall, 50 means the text should
|
|
be twice as tall as it is wide, and so on.
|
|
Used to choose line length for text if <B>width</B> option
|
|
isn't specified.
|
|
Defaults to 150.
|
|
|
|
</DD>
|
|
</DL>
|
|
<DL><DT><A NAME="-buttons"><B>-buttons</B></A></DT>
|
|
<DD>
|
|
|
|
Specifies a list of buttons to display when <B>type</B> option is <I>user</I>.
|
|
If a button has a symbolic name, its associated text will be displayed.
|
|
|
|
</DD>
|
|
</DL>
|
|
<DL><DT><A NAME="-icon"><B>-icon</B></A></DT>
|
|
<DD>
|
|
|
|
Specifies an icon to display. Must be one of the following: <B>error</B>, <B>info</B>,
|
|
<B>question</B> or <B>warning</B>.
|
|
|
|
</DD>
|
|
</DL>
|
|
<DL><DT><A NAME="-justify"><B>-justify</B></A></DT>
|
|
<DD>
|
|
|
|
Specifies how to justify lines of text.
|
|
Must be one of <B>left</B>, <B>center</B>, or <B>right</B>. Defaults
|
|
to <B>left</B>.
|
|
This option works together with the <B>anchor</B>, <B>aspect</B>,
|
|
<B>padx</B>, <B>pady</B>, and <B>width</B> options to provide a variety
|
|
of arrangements of the text within the window.
|
|
The <B>aspect</B> and <B>width</B> options determine the amount of
|
|
screen space needed to display the text.
|
|
The <B>anchor</B>, <B>padx</B>, and <B>pady</B> options determine where this
|
|
rectangular area is displayed within the widget's window, and the
|
|
<B>justify</B> option determines how each line is displayed within that
|
|
rectangular region.
|
|
For example, suppose <B>anchor</B> is <B>e</B> and <B>justify</B> is
|
|
<B>left</B>, and that the message window is much larger than needed
|
|
for the text.
|
|
The the text will displayed so that the left edges of all the lines
|
|
line up and the right edge of the longest line is <B>padx</B> from
|
|
the right side of the window; the entire text block will be centered
|
|
in the vertical span of the window.
|
|
|
|
</DD>
|
|
</DL>
|
|
<DL><DT><A NAME="-message"><B>-message</B></A></DT>
|
|
<DD>
|
|
|
|
Specifies the message to display in this message box.
|
|
|
|
</DD>
|
|
</DL>
|
|
<DL><DT><A NAME="-title"><B>-title</B></A></DT>
|
|
<DD>
|
|
|
|
Specifies a string to display as the title of the message box.
|
|
If the value is empty (the default), a default title will be set corresponding
|
|
to the <B>icon</B> option.
|
|
The default associated title is in english, and can be modified to set it in
|
|
another language by specifying the resource:
|
|
<PRE> *MessageDlg.<I>name</I>Title: <I>value</I></PRE>
|
|
or the equivalent tcl command:
|
|
<PRE> option add *MessageDlg.<I>name</I>Title <I>value</I></PRE>
|
|
where <I>name</I> is the name of an icon as defined in the <B>icon</B> option.
|
|
<BR>For example, for french language, you can specify for a warning dialog:
|
|
<PRE> option add *MessageDlg.warningTitle "Attention"</PRE>
|
|
|
|
</DD>
|
|
</DL>
|
|
<DL><DT><A NAME="-type"><B>-type</B></A></DT>
|
|
<DD>
|
|
|
|
Specifies a set of buttons to be displayed. The following values are possible:
|
|
<DD>
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT>
|
|
<B>abortretryignore</B>
|
|
<DD>
|
|
Displays three buttons whose symbolic names are <B>abort</B>,
|
|
<B>retry</B> and <B>ignore</B>.<P>
|
|
<DT>
|
|
<B>ok</B>
|
|
<DD>
|
|
Displays one button whose symbolic name is <B>ok</B>.<P>
|
|
<DT>
|
|
<B>okcancel</B>
|
|
<DD>
|
|
Displays two buttons whose symbolic names are <B>ok</B> and <B>cancel</B>.<P>
|
|
<DT>
|
|
<B>retrycancel</B>
|
|
<DD>
|
|
Displays two buttons whose symbolic names are <B>retry</B> and <B>cancel</B>.<P>
|
|
<DT>
|
|
<B>yesno</B>
|
|
<DD>
|
|
Displays two buttons whose symbolic names are <B>yes</B> and <B>no</B>.<P>
|
|
<DT>
|
|
<B>yesnocancel</B>
|
|
<DD>
|
|
Displays three buttons whose symbolic names are <B>yes</B>, <B>no</B>
|
|
and <B>cancel</B>.
|
|
<P>
|
|
<DT>
|
|
<B>user</B>
|
|
<DD>
|
|
Displays buttons of <B>-buttons</B> option.<P>
|
|
<DT>
|
|
</DL COMPACT>
|
|
|
|
</DD>
|
|
</DL>
|
|
<DL><DT><A NAME="-width"><B>-width</B></A></DT>
|
|
<DD>
|
|
|
|
Specifies the length of lines in the window.
|
|
If this option has a value greater than zero then the <B>aspect</B>
|
|
option is ignored and the <B>width</B> option determines the line
|
|
length.
|
|
If this option has a value less than or equal to zero, then
|
|
the <B>aspect</B> option determines the line length.
|
|
|
|
</DD>
|
|
</DL>
|
|
</BODY></HTML>
|