osx man page for iwidgets_dialog

iwidgets::dialog(1)						  [incr Widgets]					       iwidgets::dialog(1)

__________________________________________________________________________________________________________________________________________________

NAME
       iwidgets::dialog - Create and manipulate a dialog widget

SYNOPSIS
       iwidgets::dialog pathName ?options?

INHERITANCE
       itk::Toplevel <- iwidgets::Shell <- iwidgets::Dialogshell <- iwidgets::Dialog

STANDARD OPTIONS
       background      cursor	      foreground

       See the "options" manual entry for details on the standard options.

INHERITED OPTIONS
       buttonBoxPadX   buttonBoxPadY  buttonBoxPos    padX
       padY	       separator      thickness

       See the "dialogshell" manual entry for details on the above inherited options.

       height	       master	      modality	      width

       See the "shell" manual entry for details on the above inherited options.

       title

       See the "Toplevel" manual entry for details on the above inherited options.
__________________________________________________________________________________________________________________________________________________

DESCRIPTION
       The  iwidgets::dialog  command  creates	a  dialog box providing standard buttons and a child site for use in derived classes.  The buttons
       include ok, apply, cancel, and help.  Methods and Options exist to configure the buttons and their containing box.

METHODS
       The iwidgets::dialog command creates a new Tcl command whose name is pathName.  This command may be used to invoke  various  operations	on
       the widget.  It has the following general form: pathName option ?arg arg ...?  Option and the args determine the exact behavior of the com-
       mand.  The following commands are possible for dialog widgets:

INHERITED METHODS
       add	       buttonconfigure		      defaulthide
       index	       insert	      invoke	      show

       See the "buttonbox" manual entry for details on the above inherited methods.

       childsite

       See the "dialogshell" manual entry for details on the above inherited methods.

       activate        center	      deactivate

       See the "shell" manual entry for details on the above inherited methods.

WIDGET-SPECIFIC METHODS
       pathName cget option
	      Returns the current value of the configuration option given by option.  Option may have any of the  values  accepted  by	the  iwid-
	      gets::dialog command.

       pathName configure ?option? ?value option value ...?
	      Query  or modify the configuration options of the widget.  If no option is specified, returns a list describing all of the available
	      options for pathName (see Tk_ConfigureInfo for information on the format of this list).  If option is specified with no value,  then
	      the  command  returns  a list describing the one named option (this list will be identical to the corresponding sublist of the value
	      returned if no option is specified).  If one or more option-value pairs are specified, then the command modifies	the  given  widget
	      option(s) to have the given value(s);  in this case the command returns an empty string.	Option may have any of the values accepted
	      by the iwidgets::dialog command.

EXAMPLE
	package require Iwidgets 4.0
	iwidgets::dialog .d -modality global
	.d buttonconfigure OK -command {puts OK; .d deactivate 1}
	.d buttonconfigure Apply -command {puts Apply}
	.d buttonconfigure Cancel -command {puts Cancel; .d deactivate 0}
	.d buttonconfigure Help -command {puts Help}

	listbox [.d childsite].lb -relief sunken
	pack [.d childsite].lb -expand yes -fill both

	if {[.d activate]} {
	    puts "Exit via OK button"
	} else {
	    puts "Exit via Cancel button"
	}

AUTHOR
       Mark L. Ulferts Bret A. Schuhmacher

KEYWORDS
       dialog, dialogshell, shell, widget

Tk															       iwidgets::dialog(1)