dialog.n
上传用户:rrhhcc
上传日期:2015-12-11
资源大小:54129k
文件大小:2k
- '"
- '" Copyright (c) 1992 The Regents of the University of California.
- '" Copyright (c) 1994-1996 Sun Microsystems, Inc.
- '"
- '" See the file "license.terms" for information on usage and redistribution
- '" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
- '"
- '" RCS: @(#) $Id: dialog.n,v 1.2.26.1 2004/10/28 10:19:29 dkf Exp $
- '"
- .so man.macros
- .TH tk_dialog n 4.1 Tk "Tk Built-In Commands"
- .BS
- '" Note: do not modify the .SH NAME line immediately below!
- .SH NAME
- tk_dialog - Create modal dialog and wait for response
- .SH SYNOPSIS
- fBtk_dialog fIwindow title text bitmap default string string ...fR
- .BE
- .SH DESCRIPTION
- .PP
- This procedure is part of the Tk script library.
- Its arguments describe a dialog box:
- .TP
- fIwindowfR
- Name of top-level window to use for dialog. Any existing window
- by this name is destroyed.
- .TP
- fItitlefR
- Text to appear in the window manager's title bar for the dialog.
- .TP
- fItextfR
- Message to appear in the top portion of the dialog box.
- .TP
- fIbitmapfR
- If non-empty, specifies a bitmap to display in the top portion of
- the dialog, to the left of the text.
- If this is an empty string then no bitmap is displayed in the dialog.
- .TP
- fIdefaultfR
- If this is an integer greater than or equal to zero, then it gives
- the index of the button that is to be the default button for the dialog
- (0 for the leftmost button, and so on).
- If less than zero or an empty string then there won't be any default
- button.
- .TP
- fIstringfR
- There will be one button for each of these arguments.
- Each fIstringfR specifies text to display in a button,
- in order from left to right.
- .PP
- After creating a dialog box, fBtk_dialogfR waits for the user to
- select one of the buttons either by clicking on the button with the
- mouse or by typing return to invoke the default button (if any).
- Then it returns the index of the selected button: 0 for the leftmost
- button, 1 for the button next to it, and so on.
- If the dialog's window is destroyed before the user selects one
- of the buttons, then -1 is returned.
- .PP
- While waiting for the user to respond, fBtk_dialogfR sets a local
- grab. This prevents the user from interacting with the application
- in any way except to invoke the dialog box.
- .SH EXAMPLE
- .CS
- set reply [fBtk_dialogfR .foo "The Title" "Do you want to say yes?" \
- questhead 0 Yes No "I'm not sure"]
- .CE
- .SH "SEE ALSO"
- tk_messageBox(n)
- .SH KEYWORDS
- bitmap, dialog, modal