iwidgets::messagedialog(1)

✨ NAME ✨

iwidgets::messagedialog — bestie, this is the one that creates and manipulates a message dialog widget 💬💖

---

🦋 SYNOPSIS 🦋

iwidgets::messagedialog pathName ?options?

---

👑 INHERITANCE 👑

Okay so this widget has a whole family tree and it's giving royalty, no cap:

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

---

🌸 STANDARD OPTIONS 🌸

The usual suspects, the ones every Tk widget shows up with:

background      bitmap         cursor          font
foreground      image          text

If you wanna know what these do, go read the options manual entry — it's got the details, periodt 📖✨

---

💅 INHERITED OPTIONS 💅

These got handed down like a really good thrifted jacket:

buttonBoxPadX   buttonBoxPadY  buttonBoxPos    padX
padY            separator      thickness

Hit up the dialogshell widget manual entry for the tea on all of the above ☕

master          modality

Those two? shell widget manual entry, bestie 🐚

title

And title comes from the Toplevel widget manual entry, iykyk 🎀

---

🎀 WIDGET-SPECIFIC OPTIONS 🎀

These are hers. Her own little options. Obsessed 💜

• 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. 📏

Not me noticing the Y option also says X direction in the original — bestie I am reporting, not editing. That's literally what the page says, and we do not rewrite the source, fr fr 🙈

---

🌈 DESCRIPTION 🌈

The iwidgets::messagedialog command creates a message dialog composite widget. 🎉

The messagedialog is derived from the Dialog class, and it's composed of an image and associated message text, plus commands to manipulate the dialog buttons. It's a whole little ensemble and it serves 💅

---

💖 METHODS 💖

The iwidgets::messagedialog command creates a new Tcl command whose name is pathName. You use that command to invoke various operations on the widget. The general form is:

pathName option ?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

Details on all of those live in the buttonbox widget manual entry 📚

childsite

That one's in the dialogshell widget manual entry 🐚

activate        center         deactivate

And these three? Also the dialogshell widget manual entry 💫

---

⭐ 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 iwidgets::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 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::messagedialog command. 🛠️

---

🍓 COMPONENTS 🍓

• Name: image
• Class: Label

The image component is the bitmap or image of the message dialog. See the label widget manual entry for details on the image component item. 🖼️

• Name: message
• Class: Label

The message component provides the textual portion of the message 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
-imagepos 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

---

Okay that's the whole page, bestie — every flag, every option, every method, every word, all of it preserved, none of it skipped, and honestly? Iconic behavior. 🫶

This one came to you from Tk, in the manual page iwidgets::messagedialog(1) — go forth and pop dialogs, mwah 💅✨