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

FreeBSD Manual Pages

  
 
  

home | help
iwidgets::promptdialog(1)	[incr Widgets]	     iwidgets::promptdialog(1)

______________________________________________________________________________

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

SYNOPSIS
       iwidgets::promptdialog pathName ?options?

INHERITANCE
       itk::Toplevel  <-  iwidgets::Dialogshell	 <-  iwidgets::Dialog <- iwid-
       gets::Promptdialog

STANDARD OPTIONS
       background	  borderWidth	    cursor		exportSelection
       foreground	  highlightColor    highlightThickness	insertBackground
       insertBorderWidth  insertOffTime	    insertOnTime	insertWidth
       relief		  selectBackground  selectBorderWidth	selectForeground

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

ASSOCIATED OPTIONS
       show

       See the "entry" widget manual entry for details on the above associated
       options.

       invalid	       textBackground textFont	      validate

       See the "entryfield" widget manual entry	for details on the above asso-
       ciated options.

       labelFont       labelPos	      labelText

       See the "labeledwidget" widget manual entry for details	on  the	 above
       associated options.

INHERITED OPTIONS
       buttonBoxPadX   buttonBoxPadY  buttonBoxPos    padX
       padY	       separator      thickness

       See  the	"dialogshell" widget manual entry for details on the above in-
       herited options.

       height	       master	      modality	      width

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

       title

       See  the	"Toplevel" widget manual entry for details on the above	inher-
       ited options.

______________________________________________________________________________

DESCRIPTION
       The iwidgets::promptdialog command creates a prompt dialog  similar  to
       the  OSF/Motif standard prompt dialog composite widget.	The promptdia-
       log is derived from the dialog class and	is composed  of	 a  EntryField
       with commands to	manipulate the dialog buttons.

METHODS
       The iwidgets::promptdialog 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 promptdialog widgets:

ASSOCIATED METHODS
       delete	       get	      icursor	      index
       insert	       scan	      selection	      xview

       See the "entry" widget manual entry for details on the above associated
       methods.

       clear

       See the "entryfield" widget manual entry	for details on the above asso-
       ciated methods.

INHERITED METHODS
       add	       buttonconfigure		      defaulthide
       invoke	       show

       See the "buttonbox" widget manual entry for details on the above	inher-
       ited methods.

       childsite

       See the "dialogshell" widget manual entry for details on	the above  in-
       herited methods.

       activate	       center	      deactivate

       See  the	"shell"	widget 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::promptdialog 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::promptdialog command.

COMPONENTS
       Name:	       prompt
       Class:	       Entryfield

	      The prompt component is the entry	field for user	input  in  the
	      prompt dialog.  See the "entryfield" widget manual entry for de-
	      tails on the prompt component item.

EXAMPLE
	package	require	Iwidgets 4.0
	option add *textBackground white

	iwidgets::promptdialog .pd -modality global -title Password -labeltext
       Password: -show *
	.pd hide Apply

	if {[.pd activate]} {
	    puts "Password entered: [.pd get]"
	} else {
	    puts "Password prompt cancelled"
	}

AUTHOR
       Mark L. Ulferts

KEYWORDS
       promptdialog, dialog, dialogshell, shell, widget

Tk						     iwidgets::promptdialog(1)

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

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

home | help