Viadeo Twitter Google Bookmarks ! Facebook Digg del.icio.us MySpace Yahoo MyWeb Blinklist Netvouz Reddit Simpy StumbleUpon Bookmarks Windows Live Favorites 
Logo Documentation Qt ·  Page d'accueil  ·  Toutes les classes  ·  Classes principales  ·  Annotées  ·  Classes groupées  ·  Fonctions  · 

Toplevel Widgets

This example demonstrates the use of Qt's widget flags to provide toplevel widgets with customized window decorations.

It provides a graphical user interface for selecting different options for widget decoration and behavior, and passes the appropriate widget flags to the QWidget constructor. QWidget::reparent() is used to change the widget flags at runtime.

Warning: Note that the interpretation and functionality of the widget flags depends on the window manager used when running the application. Many window managers do not support every possible flag combination.

The user interface providing the different options was created using Qt Designer. The different options are explained in the user interface through the use of tooltips and What's This help. Load the options.ui file into Qt Designer for more details.

    #include <qapplication.h>
    #include "options.h"

    int main( int argc, char ** argv )
    {
        QApplication a( argc, argv );
        OptionsDialog dlg;
        return dlg.exec();
    }

The main function creates and displays the dialog for the user interface. Note that this dialog is modal.

The code relevant for this example is in the options.ui.h file.

    void OptionsDialog::apply()
    {
        WFlags f = WDestructiveClose | WType_TopLevel | WStyle_Customize;

The apply() slot declares the widget flag variable f and initializes it with the values

  • WDestructiveClose - the widget will be automatically destroyed when it is closed,
  • WType_TopLevel - the widget will be top level even if it has a parent widget, and
  • WStyle_Customize - the flags override the default values
Other flags are used depending on the options selected in the user interface.

        if ( bgBorder->isChecked() ) {
            if ( rbBorderNormal->isChecked() )
                f |= WStyle_NormalBorder;
            else if ( rbBorderDialog->isChecked() )
                f |= WStyle_DialogBorder;
The window gets a normal or dialog border depending on the selected option.

            if ( bgTitle->isChecked() ) {
                f |= WStyle_Title;
                if ( cbTitleSystem->isChecked() )
                    f |= WStyle_SysMenu;
                if ( cbTitleMinimize->isChecked() )
                    f |= WStyle_Minimize;
                if ( cbTitleMaximize->isChecked() )
                    f |= WStyle_Maximize;
                if ( cbTitleContext->isChecked() )
                    f |= WStyle_ContextHelp;
            }
A titlebar with controls is provided if the appropriate options have been checked.

        } else {
            f |= WStyle_NoBorder;
        }
If the window should not have a border it cannot have a titlebar. Widgets that provide their own (e.g. themed) window decoration should use this flag.

        QWidget *parent = this;
        if ( cbBehaviorTaskbar->isChecked() ) {
            parent = 0;
            f |= WGroupLeader;
        }
If a toplevel widget has a parent it will not have a taskbar entry, and on most window managers it will always stay on top of the parent widget. This is the standard behavior for dialog boxes, especially if they are modeless, and for other secondary toplevel widgets.

To provide a taskbar entry the widget must have no parent, in which case we need to use the WGroupLeader flag to prevent blocking through the modal main dialog. Applications that can have multiple toplevel windows open simultaneously should use this combination.

        if ( cbBehaviorStays->isChecked() )
            f |= WStyle_StaysOnTop /*| WX11BypassWM*/;
A toplevel widget can stay on top of the whole desktop if the window manager supports this functionality. (1)

Widgets that display important or realtime information (i.e. IRC clients) might benefit from using that flag.

        if ( cbBehaviorPopup->isChecked() )
            f |= WType_Popup;
A popup widget is a short lived modal widget that closes automatically. Popup menus are a typical example for such widgets.

        if ( cbBehaviorModal->isChecked() )
            f |= WShowModal;
A modal widget blocks input to other toplevel widgets, unless those are in a different modal group (see WGroupLeader). Dialogs are often modal, and the QDialog class provides an easy API to create and display them without the need to explicitly use this flag.

        if ( cbBehaviorTool->isChecked() )
            f |= WStyle_Tool;
A tool window will never have a task bar entry (even if it has no parent widget), and often has a smaller window decoration. Tool windows are frequently used instead of modeless dialogs.

        if ( !widget ) {
            widget = new QVBox( parent, 0, f );
            widget->setMargin( 20 );
            QPushButton *okButton = new QPushButton( "Close", widget );
            connect( okButton, SIGNAL(clicked()), widget, SLOT(close()) );
            widget->move( pos() );
            widget->show();
The widget is created if it has not been created yet, or if it was closed (since we use the WDestructiveClose flag). (2)

        } else {
            widget->reparent( parent, f, widget->geometry().topLeft(), TRUE );
        }
If the widget has already been created the reparent() function is used to modify the widget's flags. The widget's geometry is not changed, and the widget is shown again immediately.

        widget->setCaption( leCaption->text() );
        widget->setIcon( leIcon->text() );
    }
Finally the higher level properties such as the window's caption and icon are set.

To build the example go to the toplevel directory (QTDIR/examples/toplevel) (3) and run qmake to generate the makefile, then use the make tool to build the library.


  1. Unfortunately some X11 window managers also require the WX11BypassWM flag to be set in addition; but some other X11 window managers will have problems if this flag is set. Back...
  2. The example uses QGuardedPtr to make sure that the pointer is reset to zero when the widget object is destroyed due to the WDestructiveClose flag. Back...
  3. We use QTDIR to stand for the directory where Qt is installed. Back...

    See also Examples.

Publicité

Best Of

Actualités les plus lues

Semaine
Mois
Année
  1. « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 94
  2. Apercevoir la troisième dimension ou l'utilisation multithreadée d'OpenGL dans Qt, un article des Qt Quarterly traduit par Guillaume Belz 0
  3. Les développeurs ignorent-ils trop les failles découvertes dans leur code ? Prenez-vous en compte les remarques des autres ? 17
  4. Pourquoi les programmeurs sont-ils moins payés que les gestionnaires de programmes ? Manquent-ils de pouvoir de négociation ? 42
  5. Quelles nouveautés de C++11 Visual C++ doit-il rapidement intégrer ? Donnez-nous votre avis 10
  6. Adieu qmake, bienvenue qbs : Qt Building Suite, un outil déclaratif et extensible pour la compilation de projets Qt 17
  7. 2017 : un quinquennat pour une nouvelle version du C++ ? Possible, selon Herb Sutter 6
Page suivante

Le Qt Labs au hasard

Logo

Le moteur de rendu OpenGL

Les Qt Labs sont les laboratoires des développeurs de Qt, où ils peuvent partager des impressions sur le framework, son utilisation, ce que pourrait être son futur. Lire l'article.

Communauté

Ressources

Liens utiles

Contact

  • Vous souhaitez rejoindre la rédaction ou proposer un tutoriel, une traduction, une question... ? Postez dans le forum Contribuez ou contactez-nous par MP ou par email (voir en bas de page).

Qt dans le magazine

Cette page est une traduction d'une page de la documentation de Qt, écrite par Nokia Corporation and/or its subsidiary(-ies). Les éventuels problèmes résultant d'une mauvaise traduction ne sont pas imputables à Nokia. Qt 3.2
Copyright © 2012 Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon, vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD.
Vous avez déniché une erreur ? Un bug ? Une redirection cassée ? Ou tout autre problème, quel qu'il soit ? Ou bien vous désirez participer à ce projet de traduction ? N'hésitez pas à nous contacter ou par MP !
 
 
 
 
Partenaires

Hébergement Web