dialog.n
上传用户:rrhhcc
上传日期:2015-12-11
资源大小:54129k
文件大小:2k
源码类别:

通讯编程

开发平台:

Visual C++

  1. '"
  2. '" Copyright (c) 1992 The Regents of the University of California.
  3. '" Copyright (c) 1994-1996 Sun Microsystems, Inc.
  4. '"
  5. '" See the file "license.terms" for information on usage and redistribution
  6. '" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
  7. '" 
  8. '" RCS: @(#) $Id: dialog.n,v 1.2.26.1 2004/10/28 10:19:29 dkf Exp $
  9. '" 
  10. .so man.macros
  11. .TH tk_dialog n 4.1 Tk "Tk Built-In Commands"
  12. .BS
  13. '" Note:  do not modify the .SH NAME line immediately below!
  14. .SH NAME
  15. tk_dialog - Create modal dialog and wait for response
  16. .SH SYNOPSIS
  17. fBtk_dialog fIwindow title text bitmap default string string ...fR
  18. .BE
  19. .SH DESCRIPTION
  20. .PP
  21. This procedure is part of the Tk script library.
  22. Its arguments describe a dialog box:
  23. .TP
  24. fIwindowfR
  25. Name of top-level window to use for dialog.  Any existing window
  26. by this name is destroyed.
  27. .TP
  28. fItitlefR
  29. Text to appear in the window manager's title bar for the dialog.
  30. .TP
  31. fItextfR
  32. Message to appear in the top portion of the dialog box.
  33. .TP
  34. fIbitmapfR
  35. If non-empty, specifies a bitmap to display in the top portion of
  36. the dialog, to the left of the text.
  37. If this is an empty string then no bitmap is displayed in the dialog.
  38. .TP
  39. fIdefaultfR
  40. If this is an integer greater than or equal to zero, then it gives
  41. the index of the button that is to be the default button for the dialog
  42. (0 for the leftmost button, and so on).
  43. If less than zero or an empty string then there won't be any default
  44. button.
  45. .TP
  46. fIstringfR
  47. There will be one button for each of these arguments.
  48. Each fIstringfR specifies text to display in a button,
  49. in order from left to right.
  50. .PP
  51. After creating a dialog box, fBtk_dialogfR waits for the user to
  52. select one of the buttons either by clicking on the button with the
  53. mouse or by typing return to invoke the default button (if any).
  54. Then it returns the index of the selected button:  0 for the leftmost
  55. button, 1 for the button next to it, and so on.
  56. If the dialog's window is destroyed before the user selects one
  57. of the buttons, then -1 is returned.
  58. .PP
  59. While waiting for the user to respond, fBtk_dialogfR sets a local
  60. grab.  This prevents the user from interacting with the application
  61. in any way except to invoke the dialog box.
  62. .SH EXAMPLE
  63. .CS
  64. set reply [fBtk_dialogfR .foo "The Title" "Do you want to say yes?" \
  65.         questhead 0 Yes No "I'm not sure"]
  66. .CE
  67. .SH "SEE ALSO"
  68. tk_messageBox(n)
  69. .SH KEYWORDS
  70. bitmap, dialog, modal