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

FreeBSD Manual Pages

  
 
  

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

______________________________________________________________________________

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

SYNOPSIS
       iwidgets::messagedialog pathName	?options?

INHERITANCE
       itk::Toplevel  <-  iwidgets::Shell  <-  iwidgets::Dialogshell  <- iwid-
       gets::Dialog <- iwidgets::Messagedialog

STANDARD OPTIONS
       background      bitmap	      cursor	      font
       foreground      image	      text

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

INHERITED OPTIONS
       buttonBoxPadX   buttonBoxPadY  buttonBoxPos    padX
       padY	       separator      thickness

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

       master	       modality

       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.

WIDGET-SPECIFIC	OPTIONS
       Name:	       imagePos
       Class:	       Position
       Command-Line Switch:	      -imagepos

	      Specifies	the image position relative to the message text: n, s,
	      e, or w.	The default is w.

       Name:	       textPadX
       Class:	       Pad
       Command-Line Switch:	      -textpadx

	      Specifies	a non-negative value indicating	how much  extra	 space
	      to  request  for the message text	in the X direction.  The value
	      may have any of the forms	acceptable to Tk_GetPixels.

       Name:	       textPadY
       Class:	       Pad
       Command-Line Switch:	      -textpady

	      Specifies	a non-negative value indicating	how much  extra	 space
	      to  request  for the message text	in the X direction.  The value
	      may have any of the forms	acceptable to Tk_GetPixels.

______________________________________________________________________________

DESCRIPTION
       The iwidgets::messagedialog command creates a message dialog  composite
       widget.	The messagedialog is derived from the Dialog class and is com-
       posed of	an image and associated	message	text with commands to  manipu-
       late the	dialog buttons.

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

INHERITED METHODS
       add	       buttonconfigure		      defaulthide
       insert	       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 "dialogshell" widget manual entry for details on	the above  in-
       herited 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::messagedialog 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::messagedialog command.

COMPONENTS
       Name:	       image
       Class:	       Label

	      The  image  component is the bitmap or image of the message dia-
	      log.  See	the "label" widget manual entry	for details on the im-
	      age component item.

       Name:	       message
       Class:	       Label

	      The  message  component provides the textual portion of the mes-
	      sage dialog.  See	the "label" widget manual entry	for details on
	      the message component item.

EXAMPLE
	package	require	Iwidgets 4.0
	#
	# Standard question message dialog used	for confirmation.
	#
	iwidgets::messagedialog	 .md  -title  "Message	Dialog"	-text "Are you
       sure ?" \		 -bitmap questhead -modality global

	.md buttonconfigure OK -text Yes
	.md buttonconfigure Cancel -text No

	if {[.md activate]} {
	   .md configure -text "Are you	really sure ?"
	   if {[.md activate]} {		 puts stdout "Yes"
	   } else {		    puts stdout	"No"
	   }
	} else {
	   puts	stdout "No"
	}

	destroy	.md

	#
	# Copyright notice with	automatic deactivation.
	#
	iwidgets::messagedialog	.cr -title "Copyright" -bitmap	@dsc.xbm  -im-
       agepos n	\
	    -text   "Copyright	 1995	DSC   Communications  Corporation\n  \
			   All rights reserved"

	.cr hide Cancel

	.cr activate
	after 10000 ".cr deactivate"

AUTHOR
       Mark L. Ulferts

KEYWORDS
       messagedialog, dialog, dialogshell, shell, widget

Tk						    iwidgets::messagedialog(1)

NAME | SYNOPSIS | INHERITANCE | STANDARD OPTIONS | INHERITED OPTIONS | WIDGET-SPECIFIC OPTIONS | DESCRIPTION | 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_messagedialog&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help