Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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  <- iwid-
       gets::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 op-
       tions.

       title

       See the "Toplevel" manual entry for details on the above	inherited  op-
       tions.
______________________________________________________________________________

DESCRIPTION
       The  iwidgets::dialog  command  creates a dialog	box providing standard
       buttons and a child site	for use	in derived classes.  The  buttons  in-
       clude  ok,  apply, cancel, and help.  Methods and Options exist to con-
       figure 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 command.
       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	 meth-
       ods.

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	avail-
	      able  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)

NAME | SYNOPSIS | INHERITANCE | STANDARD OPTIONS | INHERITED OPTIONS | DESCRIPTION | METHODS | INHERITED METHODS | WIDGET-SPECIFIC METHODS | EXAMPLE | AUTHOR | KEYWORDS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=iwidgets_dialog&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help