QMotifDialog(3qt)

📦 version 3.3.8b, in fedora 43, fedora 44

💖 QMotifDialog — the qmotifdialog manual page, bestie edition 💖

okay so welcome to QMotifDialog(3qt), the man page you're reading rn. grab a snack, we're going to Motif town 🦋

✨ NAME ✨

QMotifDialog — the QDialog API for Motif-based dialogs. that's it, that's the whole vibe 💅

🌸 SYNOPSIS 🌸

This class is part of the Qt Motif Extension.

#include <qmotifdialog.h>

Inherits QDialog.

🎀 Public Members 🎀

enum DialogType { Prompt, Selection, Command, FileSelection, Template,
    Error, Information, Message, Question, Warning, Working }
    (obsolete)
QMotifDialog ( DialogType dialogtype, Widget parent, ArgList args =
    NULL, Cardinal argcount = 0, const char * name = 0, bool modal =
    FALSE, WFlags flags = 0 )  (obsolete)
QMotifDialog ( Widget parent, ArgList args = NULL, Cardinal argcount =
    0, const char * name = 0, bool modal = FALSE, WFlags flags = 0 )
    (obsolete)
QMotifDialog ( Widget parent, const char * name = 0, bool modal = FALSE,
    WFlags flags = 0 )
QMotifDialog ( QWidget * parent, const char * name = 0, bool modal =
    FALSE, WFlags flags = 0 )
virtual ~QMotifDialog ()
Widget shell () const
Widget dialog () const

⭐ Static Public Members ⭐

void acceptCallback ( Widget, XtPointer client_data, XtPointer )
void rejectCallback ( Widget, XtPointer client_data, XtPointer )

👑 DESCRIPTION 👑

okay so listen. This class is defined in the Qt Motif Extension, which lives in the qt/extensions directory. It is not included in the main Qt API. noted. 📝

The QMotifDialog class provides the QDialog API for Motif-based dialogs. iconic behavior honestly.

QMotifDialog gives you two separate modes of operation, choose your fighter:

  • You can use QMotifDialog with an existing Motif-based dialog and a QWidget parent, or
  • You can use QMotifDialog with a custom Qt-based dialog and a Motif-based parent.

Either way, modality continues to work as expected. we love a consistent queen 💅

Motif-based dialogs must have a Shell widget parent with a single child, due to requirements of the Motif toolkit. The Shell widget, which is a special subclass of XmDialogShell, is created during construction. You can get to it with the shell() member function. 🐚

The single child of the Shell can be accessed using the dialog() member function — but only after it has been created. no peeking early bestie 🙈

The acceptCallback() and rejectCallback() functions are your convenient little way to call QDialog::accept() and QDialog::reject() through callbacks. Pass a pointer to the QMotifDialog as the client_data argument to the callback. easy ✨

The API and behavior of QMotifDialog is identical to that of QDialog when you're using a custom Qt-based dialog with a Motif-based parent. The only difference: a Motif-based parent argument gets passed to the constructor, instead of a QWidget parent. that's it. that's the difference. 💖

🧚 Member Type Documentation 🧚

QMotifDialog::DialogType

⚠️ This function is obsolete. It is provided to keep old source working. We strongly advise against using it in new code. fr fr, do not build new stuff on this. 💀

This enum lists the predefined Motif dialog types:

  • QMotifDialog::Prompt
  • QMotifDialog::Selection
  • QMotifDialog::Command
  • QMotifDialog::FileSelection
  • QMotifDialog::Template
  • QMotifDialog::Error
  • QMotifDialog::Information
  • QMotifDialog::Message
  • QMotifDialog::Question
  • QMotifDialog::Warning
  • QMotifDialog::Working

🫶 MEMBER FUNCTION DOCUMENTATION 🫶

QMotifDialog::QMotifDialog ( DialogType dialogtype, Widget parent, ArgList args = NULL, Cardinal argcount = 0, const char * name = 0, bool modal = FALSE, WFlags flags = 0 )

⚠️ This function is obsolete. It is provided to keep old source working. We strongly advise against using it in new code. bestie please, move on 🥲

Creates a QMotifDialog using one of the predefined Motif dialog types. The name, modal and flags arguments are passed to the QDialog constructor.

This constructor creates a Shell widget, which is a special subclass of XmDialogShell. The parent, args and argcount arguments are passed to XtCreatePopupShell() when creating the subclass. You can access the Shell widget with the shell() member function. 🐚

This constructor also creates the dialog widget, with the Shell widget as its parent. The type of dialog created is specified by the dialogtype argument. See the DialogType enum for the list of available dialog types. You can access the dialog widget with the dialog() member function. 💅

Warning: QMotifDialog takes ownership of the child widget and destroys it during destruction. You should not destroy the dialog widget yourself. hands off, it's hers now 👑

See also DialogType, shell(), and dialog().

QMotifDialog::QMotifDialog ( Widget parent, ArgList args = NULL, Cardinal argcount = 0, const char * name = 0, bool modal = FALSE, WFlags flags = 0 )

⚠️ This function is obsolete. It is provided to keep old source working. We strongly advise against using it in new code.

Creates a QMotifDialog which lets the application programmer use the Motif-based parent for a custom QDialog. The name, modal and flags arguments are passed to the QDialog constructor.

This constructor creates a Shell widget, which is a special subclass of XmDialogShell. The args and argcount arguments are passed to XtCreatePopupShell() when creating the subclass. You can access the Shell widget with the shell() member function. 🐚

The dialog widget is not created by the constructor. You must create the dialog widget as a child of the widget returned by shell(). You can access the child widget with the dialog() member function.

A dialog widget is not created by this constructor. Instead, you should create the dialog widget as a child of this dialog. QMotifDialog will take ownership of your custom dialog, and you can access it with the dialog() member function. ✨

Warning: QMotifDialog takes ownership of the child widget and destroys it during destruction. You should not destroy the dialog widget yourself. 💀

See also shell() and dialog().

QMotifDialog::QMotifDialog ( Widget parent, const char * name = 0, bool modal = FALSE, WFlags flags = 0 )

Creates a QMotifDialog which lets the application programmer use the Motif-based parent for a custom QDialog. The name, modal and flags arguments are passed to the QDialog constructor.

This constructor creates a Shell widget, which is a special subclass of XmDialogShell. You can access the Shell widget with the shell() member function. 🐚

See also shell().

QMotifDialog::QMotifDialog ( QWidget * parent, const char * name = 0, bool modal = FALSE, WFlags flags = 0 )

Creates a QMotifDialog which lets the application programmer use a QWidget parent for an existing Motif-based dialog. The parent, name, modal and flags arguments are passed to the QDialog constructor.

This constructor creates a Shell widget, which is a special subclass of XmDialogShell. You can access the Shell widget with the shell() member functon. (yes, that's exactly how it's spelled in the source, i'm keeping it, character for character 🫡)

A dialog widget is not created by this constructor. Instead, you should create the dialog widget as a child of this dialog. QMotifDialog will take ownership of your custom dialog, and you can access it with the dialog() member function. 🌈

Warning: QMotifDialog takes ownership of the child widget and destroys it during destruction. You should not destroy the dialog widget yourself. 🙅

See also shell() and dialog().

QMotifDialog::~QMotifDialog () [virtual]

Destroys the QDialog, the dialog widget and the Shell widget. everything goes. full send 💥

void QMotifDialog::acceptCallback ( Widget, XtPointer client_data, XtPointer ) [static]

Convenient Xt/Motif callback to accept the QMotifDialog. slay ✅

The data is passed in client_data.

Widget QMotifDialog::dialog () const

Returns the Motif widget embedded in this dialog. that's your girl 🎀

void QMotifDialog::rejectCallback ( Widget, XtPointer client_data, XtPointer ) [static]

Convenient Xt/Motif callback to reject the QMotifDialog. nope, not today ❌

The data is passed in client_data.

Widget QMotifDialog::shell () const

Returns the Shell widget embedded in this dialog. 🐚

Example: dialog/mainwindow.cpp.

🌈 SEE ALSO 🌈

Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the license file included in the distribution for a complete license statement. 📜

🦋 AUTHOR 🦋

Generated automatically from the source code. (so technically the author is... the computer. no cap. 🤖)

🍓 BUGS 🍓

If you find a bug in Qt, please report it as described in http://doc.trolltech.com/bughowto.html. Good bug reports help us to help you. Thank you. 🫶

The definitive Qt documentation is provided in HTML format; it is located at $QTDIR/doc/html and can be read using Qt Assistant or with a web browser. This man page is provided as a convenience for those users who prefer man pages, although this format is not officially supported by Trolltech. iykyk 😭

If you find errors in this manual page, please report them to qt-bugs@trolltech.com. Please include the name of the manual page (qmotifdialog.3qt) and the Qt version (3.3.8). 📬

and that's the whole page bestie!! this absolute icon was brought to you by Trolltech AS, dated 2 February 2007, documenting Qt version 3.3.8 — periodt. 💅✨🎀

📦 where this page comes from