From f9999295436181941bd9c185c880ffcffe15b3d1 Mon Sep 17 00:00:00 2001 From: Timothy Pearson Date: Mon, 7 Nov 2011 21:50:31 -0600 Subject: Rename kwin to twin (Part 2 of 2) --- doc/html/qdockwindow-h.html | 282 --------------------- doc/html/qdockwindow-members.html | 393 ----------------------------- doc/html/qdockwindow.html | 509 -------------------------------------- doc/html/qdockwindow.png | Bin 1212 -> 0 bytes doc/html/qdoctwindow-h.html | 282 +++++++++++++++++++++ doc/html/qdoctwindow-members.html | 393 +++++++++++++++++++++++++++++ doc/html/qdoctwindow.html | 509 ++++++++++++++++++++++++++++++++++++++ doc/html/qdoctwindow.png | Bin 0 -> 1212 bytes doc/man/man3/qdockwindow.3qt | 470 ----------------------------------- doc/man/man3/qdoctwindow.3qt | 470 +++++++++++++++++++++++++++++++++++ 10 files changed, 1654 insertions(+), 1654 deletions(-) delete mode 100644 doc/html/qdockwindow-h.html delete mode 100644 doc/html/qdockwindow-members.html delete mode 100644 doc/html/qdockwindow.html delete mode 100644 doc/html/qdockwindow.png create mode 100644 doc/html/qdoctwindow-h.html create mode 100644 doc/html/qdoctwindow-members.html create mode 100644 doc/html/qdoctwindow.html create mode 100644 doc/html/qdoctwindow.png delete mode 100644 doc/man/man3/qdockwindow.3qt create mode 100644 doc/man/man3/qdoctwindow.3qt (limited to 'doc') diff --git a/doc/html/qdockwindow-h.html b/doc/html/qdockwindow-h.html deleted file mode 100644 index aac895a..0000000 --- a/doc/html/qdockwindow-h.html +++ /dev/null @@ -1,282 +0,0 @@ - - - - - -qdoctwindow.h Include File - - - - - - - -
- -Home - | -All Classes - | -Main Classes - | -Annotated - | -Grouped Classes - | -Functions -

qdoctwindow.h

- -

This is the verbatim text of the qdoctwindow.h include file. It is provided only for illustration; the copyright remains with Trolltech. -

-
-/****************************************************************************
-** $Id: qt/qdoctwindow.h   3.3.8   edited Jan 11 14:38 $
-**
-** Definition of the QDockWindow class
-**
-** Created : 001010
-**
-** Copyright (C) 1992-2007 Trolltech ASA.  All rights reserved.
-**
-** This file is part of the workspace module of the Qt GUI Toolkit.
-**
-** This file may be used under the terms of the GNU General Public
-** License versions 2.0 or 3.0 as published by the Free Software
-** Foundation and appearing in the file LICENSE.GPL included in the
-** packaging of this file. Alternatively you may (at your option) use any
-** later version of the GNU General Public License if such license has
-** been publicly approved by Trolltech ASA (or its successors, if any)
-** and the KDE Free Qt Foundation.
-**
-** Please review the following information to ensure GNU General
-** Public Licensing requirements will be met:
-** http://trolltech.com/products/qt/licenses/licensing/opensource/.
-** If you are unsure which license is appropriate for your use, please
-** review the following information:
-** http://trolltech.com/products/qt/licenses/licensing/licensingoverview
-** or contact the sales department at sales@trolltech.com.
-**
-** This file may be used under the terms of the Q Public License as
-** defined by Trolltech ASA and appearing in the file LICENSE.QPL
-** included in the packaging of this file.  Licensees holding valid Qt
-** Commercial licenses may use this file in accordance with the Qt
-** Commercial License Agreement provided with the Software.
-**
-** This file is provided "AS IS" with NO WARRANTY OF ANY KIND,
-** INCLUDING THE WARRANTIES OF DESIGN, MERCHANTABILITY AND FITNESS FOR
-** A PARTICULAR PURPOSE. Trolltech reserves all rights not granted
-** herein.
-**
-**********************************************************************/
-
-#ifndef QDOCKWINDOW_H
-#define QDOCKWINDOW_H
-
-#ifndef QT_H
-#include "qframe.h"
-#endif // QT_H
-
-#ifndef QT_NO_MAINWINDOW
-
-class QDockWindowHandle;
-class QDockWindowTitleBar;
-class QPainter;
-class QDockWindowResizeHandle;
-class QBoxLayout;
-class QHBoxLayout;
-class QVBoxLayout;
-class QDockArea;
-class QWidgetResizeHandler;
-class QMainWindow;
-class QDockAreaLayout;
-class QDockWindowPrivate;
-class QToolBar;
-class QWindowsXPStyle;
-
-class Q_EXPORT QDockWindow : public QFrame
-{
-    Q_OBJECT
-    Q_ENUMS( CloseMode Place )
-    Q_PROPERTY( int closeMode READ closeMode  WRITE setCloseMode ) //### this shouldn't be of type int?!
-    Q_PROPERTY( bool resizeEnabled READ isResizeEnabled  WRITE setResizeEnabled )
-    Q_PROPERTY( bool movingEnabled READ isMovingEnabled  WRITE setMovingEnabled )
-    Q_PROPERTY( bool horizontallyStretchable READ isHorizontallyStretchable  WRITE setHorizontallyStretchable )
-    Q_PROPERTY( bool verticallyStretchable READ isVerticallyStretchable  WRITE setVerticallyStretchable )
-    Q_PROPERTY( bool stretchable READ isStretchable )
-    Q_PROPERTY( bool newLine READ newLine  WRITE setNewLine )
-    Q_PROPERTY( bool opaqueMoving READ opaqueMoving  WRITE setOpaqueMoving )
-    Q_PROPERTY( int offset READ offset  WRITE setOffset )
-    Q_PROPERTY( Place place READ place )
-
-    friend class QDockWindowHandle;
-    friend class QDockWindowTitleBar;
-    friend class QDockArea;
-    friend class QDockAreaLayout;
-    friend class QMainWindow;
-    friend class QCEMainWindow;
-    friend class QToolBar;
-    friend class QWindowsXPStyle;
-
-public:
-    enum Place { InDock, OutsideDock };
-    enum CloseMode { Never = 0, Docked = 1, Undocked = 2, Always = Docked | Undocked };
-
-    QDockWindow( Place p = InDock, QWidget* parent=0, const char* name=0, WFlags f = 0 );
-    QDockWindow( QWidget* parent, const char* name=0, WFlags f = 0 );
-    ~QDockWindow();
-
-    virtual void setWidget( QWidget *w );
-    QWidget *widget() const;
-
-    Place place() const { return curPlace; }
-
-    QDockArea *area() const;
-
-    virtual void setCloseMode( int m );
-    bool isCloseEnabled() const;
-    int closeMode() const;
-
-    virtual void setResizeEnabled( bool b );
-    virtual void setMovingEnabled( bool b );
-    bool isResizeEnabled() const;
-    bool isMovingEnabled() const;
-
-    virtual void setHorizontallyStretchable( bool b );
-    virtual void setVerticallyStretchable( bool b );
-    bool isHorizontallyStretchable() const;
-    bool isVerticallyStretchable() const;
-    void setHorizontalStretchable( bool b ) { setHorizontallyStretchable( b ); }
-    void setVerticalStretchable( bool b ) { setVerticallyStretchable( b ); }
-    bool isHorizontalStretchable() const { return isHorizontallyStretchable(); }
-    bool isVerticalStretchable() const { return isVerticallyStretchable(); }
-    bool isStretchable() const;
-
-    virtual void setOffset( int o );
-    int offset() const;
-
-    virtual void setFixedExtentWidth( int w );
-    virtual void setFixedExtentHeight( int h );
-    QSize fixedExtent() const;
-
-    virtual void setNewLine( bool b );
-    bool newLine() const;
-
-    Qt::Orientation orientation() const;
-
-    QSize sizeHint() const;
-    QSize minimumSize() const;
-    QSize minimumSizeHint() const;
-
-    QBoxLayout *boxLayout();
-
-    virtual void setOpaqueMoving( bool b );
-    bool opaqueMoving() const;
-
-    bool eventFilter( QObject *o, QEvent *e );
-
-#ifdef QT_NO_WIDGET_TOPEXTRA
-    QString caption() const;
-#endif
-
-signals:
-    void orientationChanged( Orientation o );
-    void placeChanged( QDockWindow::Place p );
-    void visibilityChanged( bool );
-
-public slots:
-    virtual void undock( QWidget *w );
-    virtual void undock() { undock( 0 ); }
-    virtual void dock();
-    virtual void setOrientation( Orientation o );
-    void setCaption( const QString &s );
-
-protected:
-    void resizeEvent( QResizeEvent *e );
-    void showEvent( QShowEvent *e );
-    void hideEvent( QHideEvent *e );
-    void contextMenuEvent( QContextMenuEvent *e );
-
-    void drawFrame( QPainter * );
-    void drawContents( QPainter * );
-
-    bool event( QEvent *e );
-
-private slots:
-    void toggleVisible() { if ( !isVisible() ) show(); else hide(); }
-
-private:
-    QDockWindow( Place p, QWidget* parent, const char* name, WFlags f, bool toolbar );
-
-    void handleMove( const QPoint &pos, const QPoint &gp, bool drawRect );
-    void updateGui();
-    void updateSplitterVisibility( bool visible );
-
-    void startRectDraw( const QPoint &so, bool drawRect );
-    void endRectDraw( bool drawRect );
-    void updatePosition( const QPoint &globalPos  );
-    QWidget *areaAt( const QPoint &gp );
-    void removeFromDock( bool fixNewLines = TRUE );
-    void swapRect( QRect &r, Qt::Orientation o, const QPoint &offset, QDockArea *area );
-    void init();
-
-private:
-    QDockWindowHandle *horHandle, *verHandle;
-    QDockWindowTitleBar *titleBar;
-    QWidget *wid;
-    QPainter *unclippedPainter;
-    QDockArea *dockArea, *tmpDockArea;
-    QRect currRect;
-    Place curPlace;
-    Place state;
-    bool resizeEnabled : 1;
-    bool moveEnabled : 1;
-    bool nl : 1;
-    bool opaque : 1;
-    bool isToolbar : 1;
-    bool stretchable[ 3 ];
-    Orientation startOrientation;
-    int cMode;
-    QPoint startOffset;
-    int offs;
-    QSize fExtent;
-    QDockWindowResizeHandle *hHandleTop, *hHandleBottom, *vHandleLeft, *vHandleRight;
-    QVBoxLayout *hbox;
-    QHBoxLayout *vbox;
-    QBoxLayout *childBox;
-    void *dockWindowData;
-    QPoint lastPos;
-    QSize lastSize;
-    QWidgetResizeHandler *widgetResizeHandler;
-    QDockWindowPrivate *d;
-
-private:	// Disabled copy constructor and operator=
-#if defined(Q_DISABLE_COPY)
-    QDockWindow( const QDockWindow & );
-    QDockWindow& operator=( const QDockWindow & );
-#endif
-};
-
-inline QDockArea *QDockWindow::area() const
-{
-    return dockArea;
-}
-
-#define Q_DEFINED_QDOCKWINDOW
-#include "qwinexport.h"
-#endif
-
-#endif // QDOCKWINDOW_H
-
- -

- -
Copyright © 2007 -TrolltechTrademarks -
Qt 3.3.8
-
- diff --git a/doc/html/qdockwindow-members.html b/doc/html/qdockwindow-members.html deleted file mode 100644 index a3d30d9..0000000 --- a/doc/html/qdockwindow-members.html +++ /dev/null @@ -1,393 +0,0 @@ - - - - - -QDockWindow Member List - - - - - - - -
- -Home - | -All Classes - | -Main Classes - | -Annotated - | -Grouped Classes - | -Functions -

Complete Member List for QDockWindow

- -

This is the complete list of member functions for -QDockWindow, including inherited members. - -

- -

- -
Copyright © 2007 -TrolltechTrademarks -
Qt 3.3.8
-
- diff --git a/doc/html/qdockwindow.html b/doc/html/qdockwindow.html deleted file mode 100644 index 091f4a0..0000000 --- a/doc/html/qdockwindow.html +++ /dev/null @@ -1,509 +0,0 @@ - - - - - -QDockWindow Class - - - - - - - -
- -Home - | -All Classes - | -Main Classes - | -Annotated - | -Grouped Classes - | -Functions -

QDockWindow Class Reference

- -

The QDockWindow class provides a widget which can be docked -inside a QDockArea or floated as a top level window on the -desktop. -More... -

#include <qdoctwindow.h> -

Inherits QFrame. -

Inherited by QToolBar. -

List of all member functions. -

Public Members

- -

Public Slots

- -

Signals

- -

Properties

- -

Detailed Description

- - -The QDockWindow class provides a widget which can be docked -inside a QDockArea or floated as a top level window on the -desktop. -

- -

This class handles moving, resizing, docking and undocking dock -windows. QToolBar is a subclass of QDockWindow so the -functionality provided for dock windows is available with the same -API for toolbars. -

QDockWindows in a QDockArea

Two QDockWindows (QToolBars) in a QDockArea -

-

A QDockWindow

A Floating QDockWindow -

-

If the user drags the dock window into the dock area the dock -window will be docked. If the user drags the dock area outside any -dock areas the dock window will be undocked (floated) and will -become a top level window. Double clicking a floating dock -window's titlebar will dock the dock window to the last dock area -it was docked in. Double clicking a docked dock window's handle -will undock (float) the dock window. - -If the user clicks the close button (which does not appear on -dock windows by default - see closeMode) the dock window will -disappear. You can control whether or not a dock window has a -close button with setCloseMode(). -

QMainWindow provides four dock areas (top, left, right and bottom) -which can be used by dock windows. For many applications using the -dock areas provided by QMainWindow is sufficient. (See the QDockArea documentation if you want to create your own dock -areas.) In QMainWindow a right-click popup menu (the dock window -menu) is available which lists dock windows and can be used to -show or hide them. (The popup menu only lists dock windows that -have a caption.) -

When you construct a dock window you must pass it a QDockArea -or a QMainWindow as its parent if you want it docked. Pass 0 for -the parent if you want it floated. -

-    QToolBar *fileTools = new QToolBar( this, "File Actions" );
-    moveDockWindow( fileTools, Left );
-
- -

In the example above we create a new QToolBar in the constructor -of a QMainWindow subclass (so that the this pointer points to -the QMainWindow). By default the toolbar will be added to the Top dock area, but we've moved it to the Left dock area. -

A dock window is often used to contain a single widget. In these -cases the widget can be set by calling setWidget(). If you're -constructing a dock window that contains multiple widgets, e.g. a -toolbar, arrange the widgets within a box layout inside the dock -window. To do this use the boxLayout() function to get a pointer -to the dock window's box layout, then add widgets to the layout -using the box layout's QBoxLayout::addWidget() function. The dock -window will dynamically set the orientation of the layout to be -vertical or horizontal as necessary, although you can control this -yourself with setOrientation(). -

Although a common use of dock windows is for toolbars, they can be -used with any widgets. (See the Qt - Designer and Qt - Linguist applications, for example.) When using larger -widgets it may make sense for the dock window to be resizable by -calling setResizeEnabled(). Resizable dock windows are given -splitter-like handles to allow the user to resize them within -their dock area. When resizable dock windows are undocked they -become top level windows and can be resized like any other top -level windows, e.g. by dragging a corner or edge. -

Dock windows can be docked and undocked using dock() and undock(). -A dock window's orientation can be set with setOrientation(). You -can also use QDockArea::moveDockWindow(). If you're using a -QMainWindow, QMainWindow::moveDockWindow() and -QMainWindow::removeDockWindow() are available. -

A dock window can have some preferred settings, for example, you -can set a preferred offset from the left edge (or top edge for -vertical dock areas) of the dock area using setOffset(). If you'd -prefer a dock window to start on a new line when it is docked use setNewLine(). The -setFixedExtentWidth() and setFixedExtentHeight() functions can be -used to define the dock window's preferred size, and the -setHorizontallyStretchable() and setVerticallyStretchable() -functions set whether the dock window can be stretched or not. -Dock windows can be moved by default, but this can be changed with -setMovingEnabled(). When a dock window is moved it is shown as a -rectangular outline, but it can be shown normally using -setOpaqueMoving(). -

When a dock window's visibility changes, i.e. it is shown or -hidden, the visibilityChanged() signal is emitted. When a dock -window is docked, undocked or moved inside the dock area the -placeChanged() signal is emitted. -

See also Main Window and Related Classes. - -

Member Type Documentation

-

QDockWindow::CloseMode

- -

This enum type specifies when (if ever) a dock window has a close -button. -

-

QDockWindow::Place

- -

This enum specifies the possible locations for a QDockWindow: -

-

Member Function Documentation

-

QDockWindow::QDockWindow ( Place p = InDock, QWidget * parent = 0, const char * name = 0, WFlags f = 0 ) -

-Constructs a QDockWindow with parent parent, called name and -with widget flags f. -

If p is InDock, the dock window is docked into a dock area -and parent must be a QDockArea or a QMainWindow. If the parent is a QMainWindow the dock window will be docked in the main -window's Top dock area. -

If p is OutsideDock, the dock window is created as a floating -window. -

We recommend creating the dock area InDock with a QMainWindow -as parent then calling QMainWindow::moveDockWindow() to move the -dock window where you want it. - -

QDockWindow::QDockWindow ( QWidget * parent, const char * name = 0, WFlags f = 0 ) -

-Constructs a QDockWindow with parent parent, called name and -with widget flags f. - -

QDockArea * QDockWindow::area () const -

- -

Returns the dock area in which this dock window is docked, or 0 if -the dock window is floating. - -

QBoxLayout * QDockWindow::boxLayout () -

-Returns the layout which is used for adding widgets to the dock -window. The layout's orientation is set automatically to match the -orientation of the dock window. You can add widgets to the layout -using the box layout's QBoxLayout::addWidget() function. -

If the dock window only needs to contain a single widget use -setWidget() instead. -

See also setWidget() and setOrientation(). - -

int QDockWindow::closeMode () const -

Returns the close mode of a dock window. -See the "closeMode" property for details. -

void QDockWindow::dock () [virtual slot] -

-Docks the dock window into the last dock area in which it was -docked. -

If the dock window has no last dock area (e.g. it was created as a -floating window and has never been docked), or if the last dock -area it was docked in does not exist (e.g. the dock area has been -deleted), nothing happens. -

The dock window will dock with the dock area regardless of the return value -of QDockArea::isDockWindowAccepted(). -

See also undock(), QDockArea::moveDockWindow(), QDockArea::removeDockWindow(), QMainWindow::moveDockWindow(), QMainWindow::removeDockWindow(), and QDockArea::isDockWindowAccepted(). - -

-

QSize QDockWindow::fixedExtent () const -

-Returns the dock window's preferred size (fixed extent). -

See also setFixedExtentWidth() and setFixedExtentHeight(). - -

bool QDockWindow::isCloseEnabled () const -

-Returns TRUE if the dock window has a close button; otherwise -returns FALSE. The result depends on the dock window's Place -and its CloseMode. -

See also closeMode. - -

bool QDockWindow::isHorizontalStretchable () const -

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

-

bool QDockWindow::isHorizontallyStretchable () const -

Returns TRUE if the dock window is horizontally stretchable; otherwise returns FALSE. -See the "horizontallyStretchable" property for details. -

bool QDockWindow::isMovingEnabled () const -

Returns TRUE if the user can move the dock window within the dock area, move the dock window to another dock area, or float the dock window; otherwise returns FALSE. -See the "movingEnabled" property for details. -

bool QDockWindow::isResizeEnabled () const -

Returns TRUE if the dock window is resizeable; otherwise returns FALSE. -See the "resizeEnabled" property for details. -

bool QDockWindow::isStretchable () const -

Returns TRUE if the dock window is stretchable in the current orientation(); otherwise returns FALSE. -See the "stretchable" property for details. -

bool QDockWindow::isVerticalStretchable () const -

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

-

bool QDockWindow::isVerticallyStretchable () const -

Returns TRUE if the dock window is vertically stretchable; otherwise returns FALSE. -See the "verticallyStretchable" property for details. -

bool QDockWindow::newLine () const -

Returns TRUE if the dock window prefers to start a new line in the dock area; otherwise returns FALSE. -See the "newLine" property for details. -

int QDockWindow::offset () const -

Returns the dock window's preferred offset from the dock area's left edge (top edge for vertical dock areas). -See the "offset" property for details. -

bool QDockWindow::opaqueMoving () const -

Returns TRUE if the dock window will be shown normally whilst it is being moved; otherwise returns FALSE. -See the "opaqueMoving" property for details. -

Qt::Orientation QDockWindow::orientation () const -

-Returns the orientation of the dock window. -

See also orientationChanged(). - -

void QDockWindow::orientationChanged ( Orientation o ) [signal] -

- -

This signal is emitted when the orientation of the dock window is -changed. The new orientation is o. - -

Place QDockWindow::place () const -

- -

This function returns where the dock window is placed. This is -either InDock or OutsideDock. -

See also QDockArea::moveDockWindow(), QDockArea::removeDockWindow(), QMainWindow::moveDockWindow(), and QMainWindow::removeDockWindow(). - -

void QDockWindow::placeChanged ( QDockWindow::Place p ) [signal] -

- -

This signal is emitted when the dock window is docked (p is InDock), undocked (p is OutsideDock) or moved inside the -the dock area. -

See also QDockArea::moveDockWindow(), QDockArea::removeDockWindow(), QMainWindow::moveDockWindow(), and QMainWindow::removeDockWindow(). - -

void QDockWindow::setCloseMode ( int m ) [virtual] -

Sets the close mode of a dock window to m. -See the "closeMode" property for details. -

void QDockWindow::setFixedExtentHeight ( int h ) [virtual] -

-Sets the dock window's preferred height for its fixed extent -(size) to h. -

See also setFixedExtentWidth(). - -

void QDockWindow::setFixedExtentWidth ( int w ) [virtual] -

-Sets the dock window's preferred width for its fixed extent (size) -to w. -

See also setFixedExtentHeight(). - -

void QDockWindow::setHorizontalStretchable ( bool b ) -

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

-

void QDockWindow::setHorizontallyStretchable ( bool b ) [virtual] -

Sets whether the dock window is horizontally stretchable to b. -See the "horizontallyStretchable" property for details. -

void QDockWindow::setMovingEnabled ( bool b ) [virtual] -

Sets whether the user can move the dock window within the dock area, move the dock window to another dock area, or float the dock window to b. -See the "movingEnabled" property for details. -

void QDockWindow::setNewLine ( bool b ) [virtual] -

Sets whether the dock window prefers to start a new line in the dock area to b. -See the "newLine" property for details. -

void QDockWindow::setOffset ( int o ) [virtual] -

Sets the dock window's preferred offset from the dock area's left edge (top edge for vertical dock areas) to o. -See the "offset" property for details. -

void QDockWindow::setOpaqueMoving ( bool b ) [virtual] -

Sets whether the dock window will be shown normally whilst it is being moved to b. -See the "opaqueMoving" property for details. -

void QDockWindow::setOrientation ( Orientation o ) [virtual slot] -

-Sets the orientation of the dock window to o. The orientation -is propagated to the layout boxLayout(). -

Warning: All undocked QToolBars will always have a horizontal orientation. - -

void QDockWindow::setResizeEnabled ( bool b ) [virtual] -

Sets whether the dock window is resizeable to b. -See the "resizeEnabled" property for details. -

void QDockWindow::setVerticalStretchable ( bool b ) -

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

-

void QDockWindow::setVerticallyStretchable ( bool b ) [virtual] -

Sets whether the dock window is vertically stretchable to b. -See the "verticallyStretchable" property for details. -

void QDockWindow::setWidget ( QWidget * w ) [virtual] -

-Sets the dock window's main widget to w. -

See also boxLayout(). - -

void QDockWindow::undock () [virtual slot] -

- -

Undocks the QDockWindow from its current dock area if it is -docked; otherwise does nothing. -

See also dock(), QDockArea::moveDockWindow(), QDockArea::removeDockWindow(), QMainWindow::moveDockWindow(), and QMainWindow::removeDockWindow(). - -

void QDockWindow::visibilityChanged ( bool visible ) [signal] -

- -

This signal is emitted when the visibility of the dock window -relatively to its dock area is changed. If visible is TRUE, the -QDockWindow is now visible to the dock area, otherwise it has been -hidden. -

A dock window can be hidden if it has a close button which the -user has clicked. In the case of a QMainWindow a dock window can -have its visibility changed (hidden or shown) by clicking its name -in the dock window menu that lists the QMainWindow's dock windows. - -

QWidget * QDockWindow::widget () const -

-Returns the dock window's main widget. -

See also setWidget(). - -

Property Documentation

-

int closeMode

-

This property holds the close mode of a dock window. -

Defines when (if ever) the dock window has a close button. The -choices are Never, Docked (i.e. only when docked), Undocked (only when undocked, i.e. floated) or Always. -

The default is Never. - -

Set this property's value with setCloseMode() and get this property's value with closeMode(). -

bool horizontallyStretchable

-

This property holds whether the dock window is horizontally stretchable. -

A dock window is horizontally stretchable if you call -setHorizontallyStretchable(TRUE) or setResizeEnabled(TRUE). -

See also resizeEnabled. - -

Bugs and limitations: -

-

Set this property's value with setHorizontallyStretchable() and get this property's value with isHorizontallyStretchable(). -

bool movingEnabled

-

This property holds whether the user can move the dock window within the dock area, move the dock window to another dock area, or float the dock window. -

This property is TRUE by default. - -

Set this property's value with setMovingEnabled() and get this property's value with isMovingEnabled(). -

bool newLine

-

This property holds whether the dock window prefers to start a new line in the dock area. -

The default is FALSE, i.e. the dock window doesn't require a new -line in the dock area. - -

Set this property's value with setNewLine() and get this property's value with newLine(). -

int offset

-

This property holds the dock window's preferred offset from the dock area's left edge (top edge for vertical dock areas). -

The default is 0. - -

Set this property's value with setOffset() and get this property's value with offset(). -

bool opaqueMoving

-

This property holds whether the dock window will be shown normally whilst it is being moved. -

If this property is FALSE, (the default), the dock window will be -represented by an outline rectangle whilst it is being moved. -

Warning: Currently opaque moving has some problems and we do not -recommend using it at this time. We expect to fix these problems -in a future release. - -

Set this property's value with setOpaqueMoving() and get this property's value with opaqueMoving(). -

bool resizeEnabled

-

This property holds whether the dock window is resizeable. -

A resizeable dock window can be resized using splitter-like -handles inside a dock area and like every other top level window -when floating. -

A dock window is both horizontally and vertically stretchable if -you call setResizeEnabled(TRUE). -

This property is FALSE by default. -

See also verticallyStretchable and horizontallyStretchable. - -

Set this property's value with setResizeEnabled() and get this property's value with isResizeEnabled(). -

bool stretchable

-

This property holds whether the dock window is stretchable in the current orientation(). -

This property can be set using setHorizontallyStretchable() and -setVerticallyStretchable(), or with setResizeEnabled(). -

See also resizeEnabled. - -

Bugs and limitations: -

-

Get this property's value with isStretchable(). -

bool verticallyStretchable

-

This property holds whether the dock window is vertically stretchable. -

A dock window is vertically stretchable if you call -setVerticallyStretchable(TRUE) or setResizeEnabled(TRUE). -

See also resizeEnabled. - -

Bugs and limitations: -

-

Set this property's value with setVerticallyStretchable() and get this property's value with isVerticallyStretchable(). - -

-This file is part of the Qt toolkit. -Copyright © 1995-2007 -Trolltech. All Rights Reserved.

- -
Copyright © 2007 -TrolltechTrademarks -
Qt 3.3.8
-
- diff --git a/doc/html/qdockwindow.png b/doc/html/qdockwindow.png deleted file mode 100644 index 75ccaa4..0000000 Binary files a/doc/html/qdockwindow.png and /dev/null differ diff --git a/doc/html/qdoctwindow-h.html b/doc/html/qdoctwindow-h.html new file mode 100644 index 0000000..aac895a --- /dev/null +++ b/doc/html/qdoctwindow-h.html @@ -0,0 +1,282 @@ + + + + + +qdoctwindow.h Include File + + + + + + + +
+ +Home + | +All Classes + | +Main Classes + | +Annotated + | +Grouped Classes + | +Functions +

qdoctwindow.h

+ +

This is the verbatim text of the qdoctwindow.h include file. It is provided only for illustration; the copyright remains with Trolltech. +

+
+/****************************************************************************
+** $Id: qt/qdoctwindow.h   3.3.8   edited Jan 11 14:38 $
+**
+** Definition of the QDockWindow class
+**
+** Created : 001010
+**
+** Copyright (C) 1992-2007 Trolltech ASA.  All rights reserved.
+**
+** This file is part of the workspace module of the Qt GUI Toolkit.
+**
+** This file may be used under the terms of the GNU General Public
+** License versions 2.0 or 3.0 as published by the Free Software
+** Foundation and appearing in the file LICENSE.GPL included in the
+** packaging of this file. Alternatively you may (at your option) use any
+** later version of the GNU General Public License if such license has
+** been publicly approved by Trolltech ASA (or its successors, if any)
+** and the KDE Free Qt Foundation.
+**
+** Please review the following information to ensure GNU General
+** Public Licensing requirements will be met:
+** http://trolltech.com/products/qt/licenses/licensing/opensource/.
+** If you are unsure which license is appropriate for your use, please
+** review the following information:
+** http://trolltech.com/products/qt/licenses/licensing/licensingoverview
+** or contact the sales department at sales@trolltech.com.
+**
+** This file may be used under the terms of the Q Public License as
+** defined by Trolltech ASA and appearing in the file LICENSE.QPL
+** included in the packaging of this file.  Licensees holding valid Qt
+** Commercial licenses may use this file in accordance with the Qt
+** Commercial License Agreement provided with the Software.
+**
+** This file is provided "AS IS" with NO WARRANTY OF ANY KIND,
+** INCLUDING THE WARRANTIES OF DESIGN, MERCHANTABILITY AND FITNESS FOR
+** A PARTICULAR PURPOSE. Trolltech reserves all rights not granted
+** herein.
+**
+**********************************************************************/
+
+#ifndef QDOCKWINDOW_H
+#define QDOCKWINDOW_H
+
+#ifndef QT_H
+#include "qframe.h"
+#endif // QT_H
+
+#ifndef QT_NO_MAINWINDOW
+
+class QDockWindowHandle;
+class QDockWindowTitleBar;
+class QPainter;
+class QDockWindowResizeHandle;
+class QBoxLayout;
+class QHBoxLayout;
+class QVBoxLayout;
+class QDockArea;
+class QWidgetResizeHandler;
+class QMainWindow;
+class QDockAreaLayout;
+class QDockWindowPrivate;
+class QToolBar;
+class QWindowsXPStyle;
+
+class Q_EXPORT QDockWindow : public QFrame
+{
+    Q_OBJECT
+    Q_ENUMS( CloseMode Place )
+    Q_PROPERTY( int closeMode READ closeMode  WRITE setCloseMode ) //### this shouldn't be of type int?!
+    Q_PROPERTY( bool resizeEnabled READ isResizeEnabled  WRITE setResizeEnabled )
+    Q_PROPERTY( bool movingEnabled READ isMovingEnabled  WRITE setMovingEnabled )
+    Q_PROPERTY( bool horizontallyStretchable READ isHorizontallyStretchable  WRITE setHorizontallyStretchable )
+    Q_PROPERTY( bool verticallyStretchable READ isVerticallyStretchable  WRITE setVerticallyStretchable )
+    Q_PROPERTY( bool stretchable READ isStretchable )
+    Q_PROPERTY( bool newLine READ newLine  WRITE setNewLine )
+    Q_PROPERTY( bool opaqueMoving READ opaqueMoving  WRITE setOpaqueMoving )
+    Q_PROPERTY( int offset READ offset  WRITE setOffset )
+    Q_PROPERTY( Place place READ place )
+
+    friend class QDockWindowHandle;
+    friend class QDockWindowTitleBar;
+    friend class QDockArea;
+    friend class QDockAreaLayout;
+    friend class QMainWindow;
+    friend class QCEMainWindow;
+    friend class QToolBar;
+    friend class QWindowsXPStyle;
+
+public:
+    enum Place { InDock, OutsideDock };
+    enum CloseMode { Never = 0, Docked = 1, Undocked = 2, Always = Docked | Undocked };
+
+    QDockWindow( Place p = InDock, QWidget* parent=0, const char* name=0, WFlags f = 0 );
+    QDockWindow( QWidget* parent, const char* name=0, WFlags f = 0 );
+    ~QDockWindow();
+
+    virtual void setWidget( QWidget *w );
+    QWidget *widget() const;
+
+    Place place() const { return curPlace; }
+
+    QDockArea *area() const;
+
+    virtual void setCloseMode( int m );
+    bool isCloseEnabled() const;
+    int closeMode() const;
+
+    virtual void setResizeEnabled( bool b );
+    virtual void setMovingEnabled( bool b );
+    bool isResizeEnabled() const;
+    bool isMovingEnabled() const;
+
+    virtual void setHorizontallyStretchable( bool b );
+    virtual void setVerticallyStretchable( bool b );
+    bool isHorizontallyStretchable() const;
+    bool isVerticallyStretchable() const;
+    void setHorizontalStretchable( bool b ) { setHorizontallyStretchable( b ); }
+    void setVerticalStretchable( bool b ) { setVerticallyStretchable( b ); }
+    bool isHorizontalStretchable() const { return isHorizontallyStretchable(); }
+    bool isVerticalStretchable() const { return isVerticallyStretchable(); }
+    bool isStretchable() const;
+
+    virtual void setOffset( int o );
+    int offset() const;
+
+    virtual void setFixedExtentWidth( int w );
+    virtual void setFixedExtentHeight( int h );
+    QSize fixedExtent() const;
+
+    virtual void setNewLine( bool b );
+    bool newLine() const;
+
+    Qt::Orientation orientation() const;
+
+    QSize sizeHint() const;
+    QSize minimumSize() const;
+    QSize minimumSizeHint() const;
+
+    QBoxLayout *boxLayout();
+
+    virtual void setOpaqueMoving( bool b );
+    bool opaqueMoving() const;
+
+    bool eventFilter( QObject *o, QEvent *e );
+
+#ifdef QT_NO_WIDGET_TOPEXTRA
+    QString caption() const;
+#endif
+
+signals:
+    void orientationChanged( Orientation o );
+    void placeChanged( QDockWindow::Place p );
+    void visibilityChanged( bool );
+
+public slots:
+    virtual void undock( QWidget *w );
+    virtual void undock() { undock( 0 ); }
+    virtual void dock();
+    virtual void setOrientation( Orientation o );
+    void setCaption( const QString &s );
+
+protected:
+    void resizeEvent( QResizeEvent *e );
+    void showEvent( QShowEvent *e );
+    void hideEvent( QHideEvent *e );
+    void contextMenuEvent( QContextMenuEvent *e );
+
+    void drawFrame( QPainter * );
+    void drawContents( QPainter * );
+
+    bool event( QEvent *e );
+
+private slots:
+    void toggleVisible() { if ( !isVisible() ) show(); else hide(); }
+
+private:
+    QDockWindow( Place p, QWidget* parent, const char* name, WFlags f, bool toolbar );
+
+    void handleMove( const QPoint &pos, const QPoint &gp, bool drawRect );
+    void updateGui();
+    void updateSplitterVisibility( bool visible );
+
+    void startRectDraw( const QPoint &so, bool drawRect );
+    void endRectDraw( bool drawRect );
+    void updatePosition( const QPoint &globalPos  );
+    QWidget *areaAt( const QPoint &gp );
+    void removeFromDock( bool fixNewLines = TRUE );
+    void swapRect( QRect &r, Qt::Orientation o, const QPoint &offset, QDockArea *area );
+    void init();
+
+private:
+    QDockWindowHandle *horHandle, *verHandle;
+    QDockWindowTitleBar *titleBar;
+    QWidget *wid;
+    QPainter *unclippedPainter;
+    QDockArea *dockArea, *tmpDockArea;
+    QRect currRect;
+    Place curPlace;
+    Place state;
+    bool resizeEnabled : 1;
+    bool moveEnabled : 1;
+    bool nl : 1;
+    bool opaque : 1;
+    bool isToolbar : 1;
+    bool stretchable[ 3 ];
+    Orientation startOrientation;
+    int cMode;
+    QPoint startOffset;
+    int offs;
+    QSize fExtent;
+    QDockWindowResizeHandle *hHandleTop, *hHandleBottom, *vHandleLeft, *vHandleRight;
+    QVBoxLayout *hbox;
+    QHBoxLayout *vbox;
+    QBoxLayout *childBox;
+    void *dockWindowData;
+    QPoint lastPos;
+    QSize lastSize;
+    QWidgetResizeHandler *widgetResizeHandler;
+    QDockWindowPrivate *d;
+
+private:	// Disabled copy constructor and operator=
+#if defined(Q_DISABLE_COPY)
+    QDockWindow( const QDockWindow & );
+    QDockWindow& operator=( const QDockWindow & );
+#endif
+};
+
+inline QDockArea *QDockWindow::area() const
+{
+    return dockArea;
+}
+
+#define Q_DEFINED_QDOCKWINDOW
+#include "qwinexport.h"
+#endif
+
+#endif // QDOCKWINDOW_H
+
+ +

+ +
Copyright © 2007 +TrolltechTrademarks +
Qt 3.3.8
+
+ diff --git a/doc/html/qdoctwindow-members.html b/doc/html/qdoctwindow-members.html new file mode 100644 index 0000000..a3d30d9 --- /dev/null +++ b/doc/html/qdoctwindow-members.html @@ -0,0 +1,393 @@ + + + + + +QDockWindow Member List + + + + + + + +
+ +Home + | +All Classes + | +Main Classes + | +Annotated + | +Grouped Classes + | +Functions +

Complete Member List for QDockWindow

+ +

This is the complete list of member functions for +QDockWindow, including inherited members. + +

+ +

+ +
Copyright © 2007 +TrolltechTrademarks +
Qt 3.3.8
+
+ diff --git a/doc/html/qdoctwindow.html b/doc/html/qdoctwindow.html new file mode 100644 index 0000000..091f4a0 --- /dev/null +++ b/doc/html/qdoctwindow.html @@ -0,0 +1,509 @@ + + + + + +QDockWindow Class + + + + + + + +
+ +Home + | +All Classes + | +Main Classes + | +Annotated + | +Grouped Classes + | +Functions +

QDockWindow Class Reference

+ +

The QDockWindow class provides a widget which can be docked +inside a QDockArea or floated as a top level window on the +desktop. +More... +

#include <qdoctwindow.h> +

Inherits QFrame. +

Inherited by QToolBar. +

List of all member functions. +

Public Members

+ +

Public Slots

+ +

Signals

+ +

Properties

+ +

Detailed Description

+ + +The QDockWindow class provides a widget which can be docked +inside a QDockArea or floated as a top level window on the +desktop. +

+ +

This class handles moving, resizing, docking and undocking dock +windows. QToolBar is a subclass of QDockWindow so the +functionality provided for dock windows is available with the same +API for toolbars. +

QDockWindows in a QDockArea

Two QDockWindows (QToolBars) in a QDockArea +

+

A QDockWindow

A Floating QDockWindow +

+

If the user drags the dock window into the dock area the dock +window will be docked. If the user drags the dock area outside any +dock areas the dock window will be undocked (floated) and will +become a top level window. Double clicking a floating dock +window's titlebar will dock the dock window to the last dock area +it was docked in. Double clicking a docked dock window's handle +will undock (float) the dock window. + +If the user clicks the close button (which does not appear on +dock windows by default - see closeMode) the dock window will +disappear. You can control whether or not a dock window has a +close button with setCloseMode(). +

QMainWindow provides four dock areas (top, left, right and bottom) +which can be used by dock windows. For many applications using the +dock areas provided by QMainWindow is sufficient. (See the QDockArea documentation if you want to create your own dock +areas.) In QMainWindow a right-click popup menu (the dock window +menu) is available which lists dock windows and can be used to +show or hide them. (The popup menu only lists dock windows that +have a caption.) +

When you construct a dock window you must pass it a QDockArea +or a QMainWindow as its parent if you want it docked. Pass 0 for +the parent if you want it floated. +

+    QToolBar *fileTools = new QToolBar( this, "File Actions" );
+    moveDockWindow( fileTools, Left );
+
+ +

In the example above we create a new QToolBar in the constructor +of a QMainWindow subclass (so that the this pointer points to +the QMainWindow). By default the toolbar will be added to the Top dock area, but we've moved it to the Left dock area. +

A dock window is often used to contain a single widget. In these +cases the widget can be set by calling setWidget(). If you're +constructing a dock window that contains multiple widgets, e.g. a +toolbar, arrange the widgets within a box layout inside the dock +window. To do this use the boxLayout() function to get a pointer +to the dock window's box layout, then add widgets to the layout +using the box layout's QBoxLayout::addWidget() function. The dock +window will dynamically set the orientation of the layout to be +vertical or horizontal as necessary, although you can control this +yourself with setOrientation(). +

Although a common use of dock windows is for toolbars, they can be +used with any widgets. (See the Qt + Designer and Qt + Linguist applications, for example.) When using larger +widgets it may make sense for the dock window to be resizable by +calling setResizeEnabled(). Resizable dock windows are given +splitter-like handles to allow the user to resize them within +their dock area. When resizable dock windows are undocked they +become top level windows and can be resized like any other top +level windows, e.g. by dragging a corner or edge. +

Dock windows can be docked and undocked using dock() and undock(). +A dock window's orientation can be set with setOrientation(). You +can also use QDockArea::moveDockWindow(). If you're using a +QMainWindow, QMainWindow::moveDockWindow() and +QMainWindow::removeDockWindow() are available. +

A dock window can have some preferred settings, for example, you +can set a preferred offset from the left edge (or top edge for +vertical dock areas) of the dock area using setOffset(). If you'd +prefer a dock window to start on a new line when it is docked use setNewLine(). The +setFixedExtentWidth() and setFixedExtentHeight() functions can be +used to define the dock window's preferred size, and the +setHorizontallyStretchable() and setVerticallyStretchable() +functions set whether the dock window can be stretched or not. +Dock windows can be moved by default, but this can be changed with +setMovingEnabled(). When a dock window is moved it is shown as a +rectangular outline, but it can be shown normally using +setOpaqueMoving(). +

When a dock window's visibility changes, i.e. it is shown or +hidden, the visibilityChanged() signal is emitted. When a dock +window is docked, undocked or moved inside the dock area the +placeChanged() signal is emitted. +

See also Main Window and Related Classes. + +

Member Type Documentation

+

QDockWindow::CloseMode

+ +

This enum type specifies when (if ever) a dock window has a close +button. +

+

QDockWindow::Place

+ +

This enum specifies the possible locations for a QDockWindow: +

+

Member Function Documentation

+

QDockWindow::QDockWindow ( Place p = InDock, QWidget * parent = 0, const char * name = 0, WFlags f = 0 ) +

+Constructs a QDockWindow with parent parent, called name and +with widget flags f. +

If p is InDock, the dock window is docked into a dock area +and parent must be a QDockArea or a QMainWindow. If the parent is a QMainWindow the dock window will be docked in the main +window's Top dock area. +

If p is OutsideDock, the dock window is created as a floating +window. +

We recommend creating the dock area InDock with a QMainWindow +as parent then calling QMainWindow::moveDockWindow() to move the +dock window where you want it. + +

QDockWindow::QDockWindow ( QWidget * parent, const char * name = 0, WFlags f = 0 ) +

+Constructs a QDockWindow with parent parent, called name and +with widget flags f. + +

QDockArea * QDockWindow::area () const +

+ +

Returns the dock area in which this dock window is docked, or 0 if +the dock window is floating. + +

QBoxLayout * QDockWindow::boxLayout () +

+Returns the layout which is used for adding widgets to the dock +window. The layout's orientation is set automatically to match the +orientation of the dock window. You can add widgets to the layout +using the box layout's QBoxLayout::addWidget() function. +

If the dock window only needs to contain a single widget use +setWidget() instead. +

See also setWidget() and setOrientation(). + +

int QDockWindow::closeMode () const +

Returns the close mode of a dock window. +See the "closeMode" property for details. +

void QDockWindow::dock () [virtual slot] +

+Docks the dock window into the last dock area in which it was +docked. +

If the dock window has no last dock area (e.g. it was created as a +floating window and has never been docked), or if the last dock +area it was docked in does not exist (e.g. the dock area has been +deleted), nothing happens. +

The dock window will dock with the dock area regardless of the return value +of QDockArea::isDockWindowAccepted(). +

See also undock(), QDockArea::moveDockWindow(), QDockArea::removeDockWindow(), QMainWindow::moveDockWindow(), QMainWindow::removeDockWindow(), and QDockArea::isDockWindowAccepted(). + +

+

QSize QDockWindow::fixedExtent () const +

+Returns the dock window's preferred size (fixed extent). +

See also setFixedExtentWidth() and setFixedExtentHeight(). + +

bool QDockWindow::isCloseEnabled () const +

+Returns TRUE if the dock window has a close button; otherwise +returns FALSE. The result depends on the dock window's Place +and its CloseMode. +

See also closeMode. + +

bool QDockWindow::isHorizontalStretchable () const +

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

+

bool QDockWindow::isHorizontallyStretchable () const +

Returns TRUE if the dock window is horizontally stretchable; otherwise returns FALSE. +See the "horizontallyStretchable" property for details. +

bool QDockWindow::isMovingEnabled () const +

Returns TRUE if the user can move the dock window within the dock area, move the dock window to another dock area, or float the dock window; otherwise returns FALSE. +See the "movingEnabled" property for details. +

bool QDockWindow::isResizeEnabled () const +

Returns TRUE if the dock window is resizeable; otherwise returns FALSE. +See the "resizeEnabled" property for details. +

bool QDockWindow::isStretchable () const +

Returns TRUE if the dock window is stretchable in the current orientation(); otherwise returns FALSE. +See the "stretchable" property for details. +

bool QDockWindow::isVerticalStretchable () const +

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

+

bool QDockWindow::isVerticallyStretchable () const +

Returns TRUE if the dock window is vertically stretchable; otherwise returns FALSE. +See the "verticallyStretchable" property for details. +

bool QDockWindow::newLine () const +

Returns TRUE if the dock window prefers to start a new line in the dock area; otherwise returns FALSE. +See the "newLine" property for details. +

int QDockWindow::offset () const +

Returns the dock window's preferred offset from the dock area's left edge (top edge for vertical dock areas). +See the "offset" property for details. +

bool QDockWindow::opaqueMoving () const +

Returns TRUE if the dock window will be shown normally whilst it is being moved; otherwise returns FALSE. +See the "opaqueMoving" property for details. +

Qt::Orientation QDockWindow::orientation () const +

+Returns the orientation of the dock window. +

See also orientationChanged(). + +

void QDockWindow::orientationChanged ( Orientation o ) [signal] +

+ +

This signal is emitted when the orientation of the dock window is +changed. The new orientation is o. + +

Place QDockWindow::place () const +

+ +

This function returns where the dock window is placed. This is +either InDock or OutsideDock. +

See also QDockArea::moveDockWindow(), QDockArea::removeDockWindow(), QMainWindow::moveDockWindow(), and QMainWindow::removeDockWindow(). + +

void QDockWindow::placeChanged ( QDockWindow::Place p ) [signal] +

+ +

This signal is emitted when the dock window is docked (p is InDock), undocked (p is OutsideDock) or moved inside the +the dock area. +

See also QDockArea::moveDockWindow(), QDockArea::removeDockWindow(), QMainWindow::moveDockWindow(), and QMainWindow::removeDockWindow(). + +

void QDockWindow::setCloseMode ( int m ) [virtual] +

Sets the close mode of a dock window to m. +See the "closeMode" property for details. +

void QDockWindow::setFixedExtentHeight ( int h ) [virtual] +

+Sets the dock window's preferred height for its fixed extent +(size) to h. +

See also setFixedExtentWidth(). + +

void QDockWindow::setFixedExtentWidth ( int w ) [virtual] +

+Sets the dock window's preferred width for its fixed extent (size) +to w. +

See also setFixedExtentHeight(). + +

void QDockWindow::setHorizontalStretchable ( bool b ) +

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

+

void QDockWindow::setHorizontallyStretchable ( bool b ) [virtual] +

Sets whether the dock window is horizontally stretchable to b. +See the "horizontallyStretchable" property for details. +

void QDockWindow::setMovingEnabled ( bool b ) [virtual] +

Sets whether the user can move the dock window within the dock area, move the dock window to another dock area, or float the dock window to b. +See the "movingEnabled" property for details. +

void QDockWindow::setNewLine ( bool b ) [virtual] +

Sets whether the dock window prefers to start a new line in the dock area to b. +See the "newLine" property for details. +

void QDockWindow::setOffset ( int o ) [virtual] +

Sets the dock window's preferred offset from the dock area's left edge (top edge for vertical dock areas) to o. +See the "offset" property for details. +

void QDockWindow::setOpaqueMoving ( bool b ) [virtual] +

Sets whether the dock window will be shown normally whilst it is being moved to b. +See the "opaqueMoving" property for details. +

void QDockWindow::setOrientation ( Orientation o ) [virtual slot] +

+Sets the orientation of the dock window to o. The orientation +is propagated to the layout boxLayout(). +

Warning: All undocked QToolBars will always have a horizontal orientation. + +

void QDockWindow::setResizeEnabled ( bool b ) [virtual] +

Sets whether the dock window is resizeable to b. +See the "resizeEnabled" property for details. +

void QDockWindow::setVerticalStretchable ( bool b ) +

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

+

void QDockWindow::setVerticallyStretchable ( bool b ) [virtual] +

Sets whether the dock window is vertically stretchable to b. +See the "verticallyStretchable" property for details. +

void QDockWindow::setWidget ( QWidget * w ) [virtual] +

+Sets the dock window's main widget to w. +

See also boxLayout(). + +

void QDockWindow::undock () [virtual slot] +

+ +

Undocks the QDockWindow from its current dock area if it is +docked; otherwise does nothing. +

See also dock(), QDockArea::moveDockWindow(), QDockArea::removeDockWindow(), QMainWindow::moveDockWindow(), and QMainWindow::removeDockWindow(). + +

void QDockWindow::visibilityChanged ( bool visible ) [signal] +

+ +

This signal is emitted when the visibility of the dock window +relatively to its dock area is changed. If visible is TRUE, the +QDockWindow is now visible to the dock area, otherwise it has been +hidden. +

A dock window can be hidden if it has a close button which the +user has clicked. In the case of a QMainWindow a dock window can +have its visibility changed (hidden or shown) by clicking its name +in the dock window menu that lists the QMainWindow's dock windows. + +

QWidget * QDockWindow::widget () const +

+Returns the dock window's main widget. +

See also setWidget(). + +

Property Documentation

+

int closeMode

+

This property holds the close mode of a dock window. +

Defines when (if ever) the dock window has a close button. The +choices are Never, Docked (i.e. only when docked), Undocked (only when undocked, i.e. floated) or Always. +

The default is Never. + +

Set this property's value with setCloseMode() and get this property's value with closeMode(). +

bool horizontallyStretchable

+

This property holds whether the dock window is horizontally stretchable. +

A dock window is horizontally stretchable if you call +setHorizontallyStretchable(TRUE) or setResizeEnabled(TRUE). +

See also resizeEnabled. + +

Bugs and limitations: +

+

Set this property's value with setHorizontallyStretchable() and get this property's value with isHorizontallyStretchable(). +

bool movingEnabled

+

This property holds whether the user can move the dock window within the dock area, move the dock window to another dock area, or float the dock window. +

This property is TRUE by default. + +

Set this property's value with setMovingEnabled() and get this property's value with isMovingEnabled(). +

bool newLine

+

This property holds whether the dock window prefers to start a new line in the dock area. +

The default is FALSE, i.e. the dock window doesn't require a new +line in the dock area. + +

Set this property's value with setNewLine() and get this property's value with newLine(). +

int offset

+

This property holds the dock window's preferred offset from the dock area's left edge (top edge for vertical dock areas). +

The default is 0. + +

Set this property's value with setOffset() and get this property's value with offset(). +

bool opaqueMoving

+

This property holds whether the dock window will be shown normally whilst it is being moved. +

If this property is FALSE, (the default), the dock window will be +represented by an outline rectangle whilst it is being moved. +

Warning: Currently opaque moving has some problems and we do not +recommend using it at this time. We expect to fix these problems +in a future release. + +

Set this property's value with setOpaqueMoving() and get this property's value with opaqueMoving(). +

bool resizeEnabled

+

This property holds whether the dock window is resizeable. +

A resizeable dock window can be resized using splitter-like +handles inside a dock area and like every other top level window +when floating. +

A dock window is both horizontally and vertically stretchable if +you call setResizeEnabled(TRUE). +

This property is FALSE by default. +

See also verticallyStretchable and horizontallyStretchable. + +

Set this property's value with setResizeEnabled() and get this property's value with isResizeEnabled(). +

bool stretchable

+

This property holds whether the dock window is stretchable in the current orientation(). +

This property can be set using setHorizontallyStretchable() and +setVerticallyStretchable(), or with setResizeEnabled(). +

See also resizeEnabled. + +

Bugs and limitations: +

+

Get this property's value with isStretchable(). +

bool verticallyStretchable

+

This property holds whether the dock window is vertically stretchable. +

A dock window is vertically stretchable if you call +setVerticallyStretchable(TRUE) or setResizeEnabled(TRUE). +

See also resizeEnabled. + +

Bugs and limitations: +

+

Set this property's value with setVerticallyStretchable() and get this property's value with isVerticallyStretchable(). + +

+This file is part of the Qt toolkit. +Copyright © 1995-2007 +Trolltech. All Rights Reserved.

+ +
Copyright © 2007 +TrolltechTrademarks +
Qt 3.3.8
+
+ diff --git a/doc/html/qdoctwindow.png b/doc/html/qdoctwindow.png new file mode 100644 index 0000000..75ccaa4 Binary files /dev/null and b/doc/html/qdoctwindow.png differ diff --git a/doc/man/man3/qdockwindow.3qt b/doc/man/man3/qdockwindow.3qt deleted file mode 100644 index 9931e8c..0000000 --- a/doc/man/man3/qdockwindow.3qt +++ /dev/null @@ -1,470 +0,0 @@ -'\" t -.TH QDockWindow 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- -.\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the -.\" license file included in the distribution for a complete license -.\" statement. -.\" -.ad l -.nh -.SH NAME -QDockWindow \- Widget which can be docked inside a QDockArea or floated as a top level window on the desktop -.SH SYNOPSIS -\fC#include \fR -.PP -Inherits QFrame. -.PP -Inherited by QToolBar. -.PP -.SS "Public Members" -.in +1c -.ti -1c -.BI "enum \fBPlace\fR { InDock, OutsideDock }" -.br -.ti -1c -.BI "enum \fBCloseMode\fR { Never = 0, Docked = 1, Undocked = 2, Always = Docked | Undocked }" -.br -.ti -1c -.BI "\fBQDockWindow\fR ( Place p = InDock, QWidget * parent = 0, const char * name = 0, WFlags f = 0 )" -.br -.ti -1c -.BI "\fBQDockWindow\fR ( QWidget * parent, const char * name = 0, WFlags f = 0 )" -.br -.ti -1c -.BI "virtual void \fBsetWidget\fR ( QWidget * w )" -.br -.ti -1c -.BI "QWidget * \fBwidget\fR () const" -.br -.ti -1c -.BI "Place \fBplace\fR () const" -.br -.ti -1c -.BI "QDockArea * \fBarea\fR () const" -.br -.ti -1c -.BI "virtual void \fBsetCloseMode\fR ( int m )" -.br -.ti -1c -.BI "bool \fBisCloseEnabled\fR () const" -.br -.ti -1c -.BI "int \fBcloseMode\fR () const" -.br -.ti -1c -.BI "virtual void \fBsetResizeEnabled\fR ( bool b )" -.br -.ti -1c -.BI "virtual void \fBsetMovingEnabled\fR ( bool b )" -.br -.ti -1c -.BI "bool \fBisResizeEnabled\fR () const" -.br -.ti -1c -.BI "bool \fBisMovingEnabled\fR () const" -.br -.ti -1c -.BI "virtual void \fBsetHorizontallyStretchable\fR ( bool b )" -.br -.ti -1c -.BI "virtual void \fBsetVerticallyStretchable\fR ( bool b )" -.br -.ti -1c -.BI "bool \fBisHorizontallyStretchable\fR () const" -.br -.ti -1c -.BI "bool \fBisVerticallyStretchable\fR () const" -.br -.ti -1c -.BI "void setHorizontalStretchable ( bool b ) \fI(obsolete)\fR" -.br -.ti -1c -.BI "void setVerticalStretchable ( bool b ) \fI(obsolete)\fR" -.br -.ti -1c -.BI "bool isHorizontalStretchable () const \fI(obsolete)\fR" -.br -.ti -1c -.BI "bool isVerticalStretchable () const \fI(obsolete)\fR" -.br -.ti -1c -.BI "bool \fBisStretchable\fR () const" -.br -.ti -1c -.BI "virtual void \fBsetOffset\fR ( int o )" -.br -.ti -1c -.BI "int \fBoffset\fR () const" -.br -.ti -1c -.BI "virtual void \fBsetFixedExtentWidth\fR ( int w )" -.br -.ti -1c -.BI "virtual void \fBsetFixedExtentHeight\fR ( int h )" -.br -.ti -1c -.BI "QSize \fBfixedExtent\fR () const" -.br -.ti -1c -.BI "virtual void \fBsetNewLine\fR ( bool b )" -.br -.ti -1c -.BI "bool \fBnewLine\fR () const" -.br -.ti -1c -.BI "Qt::Orientation \fBorientation\fR () const" -.br -.ti -1c -.BI "QBoxLayout * \fBboxLayout\fR ()" -.br -.ti -1c -.BI "virtual void \fBsetOpaqueMoving\fR ( bool b )" -.br -.ti -1c -.BI "bool \fBopaqueMoving\fR () const" -.br -.in -1c -.SS "Public Slots" -.in +1c -.ti -1c -.BI "virtual void \fBundock\fR ()" -.br -.ti -1c -.BI "virtual void \fBdock\fR ()" -.br -.ti -1c -.BI "virtual void \fBsetOrientation\fR ( Orientation o )" -.br -.in -1c -.SS "Signals" -.in +1c -.ti -1c -.BI "void \fBorientationChanged\fR ( Orientation o )" -.br -.ti -1c -.BI "void \fBplaceChanged\fR ( QDockWindow::Place p )" -.br -.ti -1c -.BI "void \fBvisibilityChanged\fR ( bool visible )" -.br -.in -1c -.SS "Properties" -.in +1c -.ti -1c -.BI "int \fBcloseMode\fR - the close mode of a dock window" -.br -.ti -1c -.BI "bool \fBhorizontallyStretchable\fR - whether the dock window is horizontally stretchable" -.br -.ti -1c -.BI "bool \fBmovingEnabled\fR - whether the user can move the dock window within the dock " "area" ", move the dock window to another dock " "area" ", or float the dock window" -.br -.ti -1c -.BI "bool \fBnewLine\fR - whether the dock window prefers to start a new line in the dock area" -.br -.ti -1c -.BI "int \fBoffset\fR - the dock window's preferred offset from the dock area's left edge (top edge for vertical dock " "areas" ")" -.br -.ti -1c -.BI "bool \fBopaqueMoving\fR - whether the dock window will be shown normally whilst it is being moved" -.br -.ti -1c -.BI "Place \fBplace\fR \fI(read " "only" ")\fR" -.br -.ti -1c -.BI "bool \fBresizeEnabled\fR - whether the dock window is resizeable" -.br -.ti -1c -.BI "bool \fBstretchable\fR - whether the dock window is stretchable in the current orientation() \fI(read " "only" ")\fR" -.br -.ti -1c -.BI "bool \fBverticallyStretchable\fR - whether the dock window is vertically stretchable" -.br -.in -1c -.SH DESCRIPTION -The QDockWindow class provides a widget which can be docked inside a QDockArea or floated as a top level window on the desktop. -.PP -This class handles moving, resizing, docking and undocking dock windows. QToolBar is a subclass of QDockWindow so the functionality provided for dock windows is available with the same API for toolbars. -.PP -
-.ce 1 -.B "[Image Omitted]" -.PP -

\fI Two QDockWindows (QToolBars) in a QDockArea \fR

-.PP -
-.ce 1 -.B "[Image Omitted]" -.PP -

\fI A Floating QDockWindow \fR

-.PP -If the user drags the dock window into the dock area the dock window will be docked. If the user drags the dock area outside any dock areas the dock window will be undocked (floated) and will become a top level window. Double clicking a floating dock window's titlebar will dock the dock window to the last dock area it was docked in. Double clicking a docked dock window's handle will undock (float) the dock window. If the user clicks the close button (which does not appear on dock windows by default - see closeMode) the dock window will disappear. You can control whether or not a dock window has a close button with setCloseMode(). -.PP -QMainWindow provides four dock areas (top, left, right and bottom) which can be used by dock windows. For many applications using the dock areas provided by QMainWindow is sufficient. (See the QDockArea documentation if you want to create your own dock areas.) In QMainWindow a right-click popup menu (the dock window menu) is available which lists dock windows and can be used to show or hide them. (The popup menu only lists dock windows that have a caption.) -.PP -When you construct a dock window you \fImust\fR pass it a QDockArea or a QMainWindow as its parent if you want it docked. Pass 0 for the parent if you want it floated. -.PP -.nf -.br - QToolBar *fileTools = new QToolBar( this, "File Actions" ); -.br - moveDockWindow( fileTools, Left ); -.br -.fi -.PP -In the example above we create a new QToolBar in the constructor of a QMainWindow subclass (so that the \fIthis\fR pointer points to the QMainWindow). By default the toolbar will be added to the Top dock area, but we've moved it to the Left dock area. -.PP -A dock window is often used to contain a single widget. In these cases the widget can be set by calling setWidget(). If you're constructing a dock window that contains multiple widgets, e.g. a toolbar, arrange the widgets within a box layout inside the dock window. To do this use the boxLayout() function to get a pointer to the dock window's box layout, then add widgets to the layout using the box layout's QBoxLayout::addWidget() function. The dock window will dynamically set the orientation of the layout to be vertical or horizontal as necessary, although you can control this yourself with setOrientation(). -.PP -Although a common use of dock windows is for toolbars, they can be used with any widgets. (See the Qt Designer and Qt Linguist applications, for example.) When using larger widgets it may make sense for the dock window to be resizable by calling setResizeEnabled(). Resizable dock windows are given splitter-like handles to allow the user to resize them within their dock area. When resizable dock windows are undocked they become top level windows and can be resized like any other top level windows, e.g. by dragging a corner or edge. -.PP -Dock windows can be docked and undocked using dock() and undock(). A dock window's orientation can be set with setOrientation(). You can also use QDockArea::moveDockWindow(). If you're using a QMainWindow, QMainWindow::moveDockWindow() and QMainWindow::removeDockWindow() are available. -.PP -A dock window can have some preferred settings, for example, you can set a preferred offset from the left edge (or top edge for vertical dock areas) of the dock area using setOffset(). If you'd prefer a dock window to start on a new line when it is docked use setNewLine(). The setFixedExtentWidth() and setFixedExtentHeight() functions can be used to define the dock window's preferred size, and the setHorizontallyStretchable() and setVerticallyStretchable() functions set whether the dock window can be stretched or not. Dock windows can be moved by default, but this can be changed with setMovingEnabled(). When a dock window is moved it is shown as a rectangular outline, but it can be shown normally using setOpaqueMoving(). -.PP -When a dock window's visibility changes, i.e. it is shown or hidden, the visibilityChanged() signal is emitted. When a dock window is docked, undocked or moved inside the dock area the placeChanged() signal is emitted. -.PP -See also Main Window and Related Classes. -.SS "Member Type Documentation" -.SH "QDockWindow::CloseMode" -This enum type specifies when (if ever) a dock window has a close button. -.TP -\fCQDockWindow::Never\fR - The dock window never has a close button and cannot be closed by the user. -.TP -\fCQDockWindow::Docked\fR - The dock window has a close button only when docked. -.TP -\fCQDockWindow::Undocked\fR - The dock window has a close button only when floating. -.TP -\fCQDockWindow::Always\fR - The dock window always has a close button. -.SH "QDockWindow::Place" -This enum specifies the possible locations for a QDockWindow: -.TP -\fCQDockWindow::InDock\fR - Inside a QDockArea. -.TP -\fCQDockWindow::OutsideDock\fR - Floating as a top level window on the desktop. -.SH MEMBER FUNCTION DOCUMENTATION -.SH "QDockWindow::QDockWindow ( Place p = InDock, QWidget * parent = 0, const char * name = 0, WFlags f = 0 )" -Constructs a QDockWindow with parent \fIparent\fR, called \fIname\fR and with widget flags \fIf\fR. -.PP -If \fIp\fR is InDock, the dock window is docked into a dock area and \fIparent\fR \fImust\fR be a QDockArea or a QMainWindow. If the \fIparent\fR is a QMainWindow the dock window will be docked in the main window's Top dock area. -.PP -If \fIp\fR is OutsideDock, the dock window is created as a floating window. -.PP -We recommend creating the dock area InDock with a QMainWindow as parent then calling QMainWindow::moveDockWindow() to move the dock window where you want it. -.SH "QDockWindow::QDockWindow ( QWidget * parent, const char * name = 0, WFlags f = 0 )" -Constructs a QDockWindow with parent \fIparent\fR, called \fIname\fR and with widget flags \fIf\fR. -.SH "QDockArea * QDockWindow::area () const" -Returns the dock area in which this dock window is docked, or 0 if the dock window is floating. -.SH "QBoxLayout * QDockWindow::boxLayout ()" -Returns the layout which is used for adding widgets to the dock window. The layout's orientation is set automatically to match the orientation of the dock window. You can add widgets to the layout using the box layout's QBoxLayout::addWidget() function. -.PP -If the dock window only needs to contain a single widget use setWidget() instead. -.PP -See also setWidget() and setOrientation(). -.SH "int QDockWindow::closeMode () const" -Returns the close mode of a dock window. See the "closeMode" property for details. -.SH "void QDockWindow::dock ()\fC [virtual slot]\fR" -Docks the dock window into the last dock area in which it was docked. -.PP -If the dock window has no last dock area (e.g. it was created as a floating window and has never been docked), or if the last dock area it was docked in does not exist (e.g. the dock area has been deleted), nothing happens. -.PP -The dock window will dock with the dock area regardless of the return value of QDockArea::isDockWindowAccepted(). -.PP -See also undock(), QDockArea::moveDockWindow(), QDockArea::removeDockWindow(), QMainWindow::moveDockWindow(), QMainWindow::removeDockWindow(), and QDockArea::isDockWindowAccepted(). -.SH "QSize QDockWindow::fixedExtent () const" -Returns the dock window's preferred size (fixed extent). -.PP -See also setFixedExtentWidth() and setFixedExtentHeight(). -.SH "bool QDockWindow::isCloseEnabled () const" -Returns TRUE if the dock window has a close button; otherwise returns FALSE. The result depends on the dock window's Place and its CloseMode. -.PP -See also closeMode. -.SH "bool QDockWindow::isHorizontalStretchable () const" -\fBThis function is obsolete.\fR It is provided to keep old source working. We strongly advise against using it in new code. -.SH "bool QDockWindow::isHorizontallyStretchable () const" -Returns TRUE if the dock window is horizontally stretchable; otherwise returns FALSE. See the "horizontallyStretchable" property for details. -.SH "bool QDockWindow::isMovingEnabled () const" -Returns TRUE if the user can move the dock window within the dock area, move the dock window to another dock area, or float the dock window; otherwise returns FALSE. See the "movingEnabled" property for details. -.SH "bool QDockWindow::isResizeEnabled () const" -Returns TRUE if the dock window is resizeable; otherwise returns FALSE. See the "resizeEnabled" property for details. -.SH "bool QDockWindow::isStretchable () const" -Returns TRUE if the dock window is stretchable in the current orientation(); otherwise returns FALSE. See the "stretchable" property for details. -.SH "bool QDockWindow::isVerticalStretchable () const" -\fBThis function is obsolete.\fR It is provided to keep old source working. We strongly advise against using it in new code. -.SH "bool QDockWindow::isVerticallyStretchable () const" -Returns TRUE if the dock window is vertically stretchable; otherwise returns FALSE. See the "verticallyStretchable" property for details. -.SH "bool QDockWindow::newLine () const" -Returns TRUE if the dock window prefers to start a new line in the dock area; otherwise returns FALSE. See the "newLine" property for details. -.SH "int QDockWindow::offset () const" -Returns the dock window's preferred offset from the dock area's left edge (top edge for vertical dock areas). See the "offset" property for details. -.SH "bool QDockWindow::opaqueMoving () const" -Returns TRUE if the dock window will be shown normally whilst it is being moved; otherwise returns FALSE. See the "opaqueMoving" property for details. -.SH "Qt::Orientation QDockWindow::orientation () const" -Returns the orientation of the dock window. -.PP -See also orientationChanged(). -.SH "void QDockWindow::orientationChanged ( Orientation o )\fC [signal]\fR" -This signal is emitted when the orientation of the dock window is changed. The new orientation is \fIo\fR. -.SH "Place QDockWindow::place () const" -This function returns where the dock window is placed. This is either InDock or OutsideDock. -.PP -See also QDockArea::moveDockWindow(), QDockArea::removeDockWindow(), QMainWindow::moveDockWindow(), and QMainWindow::removeDockWindow(). -.SH "void QDockWindow::placeChanged ( QDockWindow::Place p )\fC [signal]\fR" -This signal is emitted when the dock window is docked (\fIp\fR is InDock), undocked (\fIp\fR is OutsideDock) or moved inside the the dock area. -.PP -See also QDockArea::moveDockWindow(), QDockArea::removeDockWindow(), QMainWindow::moveDockWindow(), and QMainWindow::removeDockWindow(). -.SH "void QDockWindow::setCloseMode ( int m )\fC [virtual]\fR" -Sets the close mode of a dock window to \fIm\fR. See the "closeMode" property for details. -.SH "void QDockWindow::setFixedExtentHeight ( int h )\fC [virtual]\fR" -Sets the dock window's preferred height for its fixed extent (size) to \fIh\fR. -.PP -See also setFixedExtentWidth(). -.SH "void QDockWindow::setFixedExtentWidth ( int w )\fC [virtual]\fR" -Sets the dock window's preferred width for its fixed extent (size) to \fIw\fR. -.PP -See also setFixedExtentHeight(). -.SH "void QDockWindow::setHorizontalStretchable ( bool b )" -\fBThis function is obsolete.\fR It is provided to keep old source working. We strongly advise against using it in new code. -.SH "void QDockWindow::setHorizontallyStretchable ( bool b )\fC [virtual]\fR" -Sets whether the dock window is horizontally stretchable to \fIb\fR. See the "horizontallyStretchable" property for details. -.SH "void QDockWindow::setMovingEnabled ( bool b )\fC [virtual]\fR" -Sets whether the user can move the dock window within the dock area, move the dock window to another dock area, or float the dock window to \fIb\fR. See the "movingEnabled" property for details. -.SH "void QDockWindow::setNewLine ( bool b )\fC [virtual]\fR" -Sets whether the dock window prefers to start a new line in the dock area to \fIb\fR. See the "newLine" property for details. -.SH "void QDockWindow::setOffset ( int o )\fC [virtual]\fR" -Sets the dock window's preferred offset from the dock area's left edge (top edge for vertical dock areas) to \fIo\fR. See the "offset" property for details. -.SH "void QDockWindow::setOpaqueMoving ( bool b )\fC [virtual]\fR" -Sets whether the dock window will be shown normally whilst it is being moved to \fIb\fR. See the "opaqueMoving" property for details. -.SH "void QDockWindow::setOrientation ( Orientation o )\fC [virtual slot]\fR" -Sets the orientation of the dock window to \fIo\fR. The orientation is propagated to the layout boxLayout(). -.PP -\fBWarning:\fR All undocked QToolBars will always have a horizontal orientation. -.SH "void QDockWindow::setResizeEnabled ( bool b )\fC [virtual]\fR" -Sets whether the dock window is resizeable to \fIb\fR. See the "resizeEnabled" property for details. -.SH "void QDockWindow::setVerticalStretchable ( bool b )" -\fBThis function is obsolete.\fR It is provided to keep old source working. We strongly advise against using it in new code. -.SH "void QDockWindow::setVerticallyStretchable ( bool b )\fC [virtual]\fR" -Sets whether the dock window is vertically stretchable to \fIb\fR. See the "verticallyStretchable" property for details. -.SH "void QDockWindow::setWidget ( QWidget * w )\fC [virtual]\fR" -Sets the dock window's main widget to \fIw\fR. -.PP -See also boxLayout(). -.SH "void QDockWindow::undock ()\fC [virtual slot]\fR" -Undocks the QDockWindow from its current dock area if it is docked; otherwise does nothing. -.PP -See also dock(), QDockArea::moveDockWindow(), QDockArea::removeDockWindow(), QMainWindow::moveDockWindow(), and QMainWindow::removeDockWindow(). -.SH "void QDockWindow::visibilityChanged ( bool visible )\fC [signal]\fR" -This signal is emitted when the visibility of the dock window relatively to its dock area is changed. If \fIvisible\fR is TRUE, the QDockWindow is now visible to the dock area, otherwise it has been hidden. -.PP -A dock window can be hidden if it has a close button which the user has clicked. In the case of a QMainWindow a dock window can have its visibility changed (hidden or shown) by clicking its name in the dock window menu that lists the QMainWindow's dock windows. -.SH "QWidget * QDockWindow::widget () const" -Returns the dock window's main widget. -.PP -See also setWidget(). -.SS "Property Documentation" -.SH "int closeMode" -This property holds the close mode of a dock window. -.PP -Defines when (if ever) the dock window has a close button. The choices are Never, Docked (i.e. only when docked), Undocked (only when undocked, i.e. floated) or Always. -.PP -The default is Never. -.PP -Set this property's value with setCloseMode() and get this property's value with closeMode(). -.SH "bool horizontallyStretchable" -This property holds whether the dock window is horizontally stretchable. -.PP -A dock window is horizontally stretchable if you call setHorizontallyStretchable(TRUE) or setResizeEnabled(TRUE). -.PP -See also resizeEnabled. -.PP -Bugs and limitations: -.TP -Strecthability is broken. You must call setResizeEnabled(TRUE) to get proper behavior and even then QDockWindow does not limit stretchablilty. -.PP -Set this property's value with setHorizontallyStretchable() and get this property's value with isHorizontallyStretchable(). -.SH "bool movingEnabled" -This property holds whether the user can move the dock window within the dock area, move the dock window to another dock area, or float the dock window. -.PP -This property is TRUE by default. -.PP -Set this property's value with setMovingEnabled() and get this property's value with isMovingEnabled(). -.SH "bool newLine" -This property holds whether the dock window prefers to start a new line in the dock area. -.PP -The default is FALSE, i.e. the dock window doesn't require a new line in the dock area. -.PP -Set this property's value with setNewLine() and get this property's value with newLine(). -.SH "int offset" -This property holds the dock window's preferred offset from the dock area's left edge (top edge for vertical dock areas). -.PP -The default is 0. -.PP -Set this property's value with setOffset() and get this property's value with offset(). -.SH "bool opaqueMoving" -This property holds whether the dock window will be shown normally whilst it is being moved. -.PP -If this property is FALSE, (the default), the dock window will be represented by an outline rectangle whilst it is being moved. -.PP -\fBWarning:\fR Currently opaque moving has some problems and we do not recommend using it at this time. We expect to fix these problems in a future release. -.PP -Set this property's value with setOpaqueMoving() and get this property's value with opaqueMoving(). -.SH "bool resizeEnabled" -This property holds whether the dock window is resizeable. -.PP -A resizeable dock window can be resized using splitter-like handles inside a dock area and like every other top level window when floating. -.PP -A dock window is both horizontally and vertically stretchable if you call setResizeEnabled(TRUE). -.PP -This property is FALSE by default. -.PP -See also verticallyStretchable and horizontallyStretchable. -.PP -Set this property's value with setResizeEnabled() and get this property's value with isResizeEnabled(). -.SH "bool stretchable" -This property holds whether the dock window is stretchable in the current orientation(). -.PP -This property can be set using setHorizontallyStretchable() and setVerticallyStretchable(), or with setResizeEnabled(). -.PP -See also resizeEnabled. -.PP -Bugs and limitations: -.TP -Strecthability is broken. You must call setResizeEnabled(TRUE) to get proper behavior and even then QDockWindow does not limit stretchablilty. -.PP -Get this property's value with isStretchable(). -.SH "bool verticallyStretchable" -This property holds whether the dock window is vertically stretchable. -.PP -A dock window is vertically stretchable if you call setVerticallyStretchable(TRUE) or setResizeEnabled(TRUE). -.PP -See also resizeEnabled. -.PP -Bugs and limitations: -.TP -Strecthability is broken. You must call setResizeEnabled(TRUE) to get proper behavior and even then QDockWindow does not limit stretchablilty. -.PP -Set this property's value with setVerticallyStretchable() and get this property's value with isVerticallyStretchable(). - -.SH "SEE ALSO" -.BR http://doc.trolltech.com/qdoctwindow.html -.BR http://www.trolltech.com/faq/tech.html -.SH COPYRIGHT -Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the -license file included in the distribution for a complete license -statement. -.SH AUTHOR -Generated automatically from the source code. -.SH BUGS -If you find a bug in Qt, please report it as described in -.BR http://doc.trolltech.com/bughowto.html . -Good bug reports help us to help you. Thank you. -.P -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. -.P -If you find errors in this manual page, please report them to -.BR qt-bugs@trolltech.com . -Please include the name of the manual page (qdoctwindow.3qt) and the Qt -version (3.3.8). diff --git a/doc/man/man3/qdoctwindow.3qt b/doc/man/man3/qdoctwindow.3qt new file mode 100644 index 0000000..9931e8c --- /dev/null +++ b/doc/man/man3/qdoctwindow.3qt @@ -0,0 +1,470 @@ +'\" t +.TH QDockWindow 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the +.\" license file included in the distribution for a complete license +.\" statement. +.\" +.ad l +.nh +.SH NAME +QDockWindow \- Widget which can be docked inside a QDockArea or floated as a top level window on the desktop +.SH SYNOPSIS +\fC#include \fR +.PP +Inherits QFrame. +.PP +Inherited by QToolBar. +.PP +.SS "Public Members" +.in +1c +.ti -1c +.BI "enum \fBPlace\fR { InDock, OutsideDock }" +.br +.ti -1c +.BI "enum \fBCloseMode\fR { Never = 0, Docked = 1, Undocked = 2, Always = Docked | Undocked }" +.br +.ti -1c +.BI "\fBQDockWindow\fR ( Place p = InDock, QWidget * parent = 0, const char * name = 0, WFlags f = 0 )" +.br +.ti -1c +.BI "\fBQDockWindow\fR ( QWidget * parent, const char * name = 0, WFlags f = 0 )" +.br +.ti -1c +.BI "virtual void \fBsetWidget\fR ( QWidget * w )" +.br +.ti -1c +.BI "QWidget * \fBwidget\fR () const" +.br +.ti -1c +.BI "Place \fBplace\fR () const" +.br +.ti -1c +.BI "QDockArea * \fBarea\fR () const" +.br +.ti -1c +.BI "virtual void \fBsetCloseMode\fR ( int m )" +.br +.ti -1c +.BI "bool \fBisCloseEnabled\fR () const" +.br +.ti -1c +.BI "int \fBcloseMode\fR () const" +.br +.ti -1c +.BI "virtual void \fBsetResizeEnabled\fR ( bool b )" +.br +.ti -1c +.BI "virtual void \fBsetMovingEnabled\fR ( bool b )" +.br +.ti -1c +.BI "bool \fBisResizeEnabled\fR () const" +.br +.ti -1c +.BI "bool \fBisMovingEnabled\fR () const" +.br +.ti -1c +.BI "virtual void \fBsetHorizontallyStretchable\fR ( bool b )" +.br +.ti -1c +.BI "virtual void \fBsetVerticallyStretchable\fR ( bool b )" +.br +.ti -1c +.BI "bool \fBisHorizontallyStretchable\fR () const" +.br +.ti -1c +.BI "bool \fBisVerticallyStretchable\fR () const" +.br +.ti -1c +.BI "void setHorizontalStretchable ( bool b ) \fI(obsolete)\fR" +.br +.ti -1c +.BI "void setVerticalStretchable ( bool b ) \fI(obsolete)\fR" +.br +.ti -1c +.BI "bool isHorizontalStretchable () const \fI(obsolete)\fR" +.br +.ti -1c +.BI "bool isVerticalStretchable () const \fI(obsolete)\fR" +.br +.ti -1c +.BI "bool \fBisStretchable\fR () const" +.br +.ti -1c +.BI "virtual void \fBsetOffset\fR ( int o )" +.br +.ti -1c +.BI "int \fBoffset\fR () const" +.br +.ti -1c +.BI "virtual void \fBsetFixedExtentWidth\fR ( int w )" +.br +.ti -1c +.BI "virtual void \fBsetFixedExtentHeight\fR ( int h )" +.br +.ti -1c +.BI "QSize \fBfixedExtent\fR () const" +.br +.ti -1c +.BI "virtual void \fBsetNewLine\fR ( bool b )" +.br +.ti -1c +.BI "bool \fBnewLine\fR () const" +.br +.ti -1c +.BI "Qt::Orientation \fBorientation\fR () const" +.br +.ti -1c +.BI "QBoxLayout * \fBboxLayout\fR ()" +.br +.ti -1c +.BI "virtual void \fBsetOpaqueMoving\fR ( bool b )" +.br +.ti -1c +.BI "bool \fBopaqueMoving\fR () const" +.br +.in -1c +.SS "Public Slots" +.in +1c +.ti -1c +.BI "virtual void \fBundock\fR ()" +.br +.ti -1c +.BI "virtual void \fBdock\fR ()" +.br +.ti -1c +.BI "virtual void \fBsetOrientation\fR ( Orientation o )" +.br +.in -1c +.SS "Signals" +.in +1c +.ti -1c +.BI "void \fBorientationChanged\fR ( Orientation o )" +.br +.ti -1c +.BI "void \fBplaceChanged\fR ( QDockWindow::Place p )" +.br +.ti -1c +.BI "void \fBvisibilityChanged\fR ( bool visible )" +.br +.in -1c +.SS "Properties" +.in +1c +.ti -1c +.BI "int \fBcloseMode\fR - the close mode of a dock window" +.br +.ti -1c +.BI "bool \fBhorizontallyStretchable\fR - whether the dock window is horizontally stretchable" +.br +.ti -1c +.BI "bool \fBmovingEnabled\fR - whether the user can move the dock window within the dock " "area" ", move the dock window to another dock " "area" ", or float the dock window" +.br +.ti -1c +.BI "bool \fBnewLine\fR - whether the dock window prefers to start a new line in the dock area" +.br +.ti -1c +.BI "int \fBoffset\fR - the dock window's preferred offset from the dock area's left edge (top edge for vertical dock " "areas" ")" +.br +.ti -1c +.BI "bool \fBopaqueMoving\fR - whether the dock window will be shown normally whilst it is being moved" +.br +.ti -1c +.BI "Place \fBplace\fR \fI(read " "only" ")\fR" +.br +.ti -1c +.BI "bool \fBresizeEnabled\fR - whether the dock window is resizeable" +.br +.ti -1c +.BI "bool \fBstretchable\fR - whether the dock window is stretchable in the current orientation() \fI(read " "only" ")\fR" +.br +.ti -1c +.BI "bool \fBverticallyStretchable\fR - whether the dock window is vertically stretchable" +.br +.in -1c +.SH DESCRIPTION +The QDockWindow class provides a widget which can be docked inside a QDockArea or floated as a top level window on the desktop. +.PP +This class handles moving, resizing, docking and undocking dock windows. QToolBar is a subclass of QDockWindow so the functionality provided for dock windows is available with the same API for toolbars. +.PP +
+.ce 1 +.B "[Image Omitted]" +.PP +

\fI Two QDockWindows (QToolBars) in a QDockArea \fR

+.PP +
+.ce 1 +.B "[Image Omitted]" +.PP +

\fI A Floating QDockWindow \fR

+.PP +If the user drags the dock window into the dock area the dock window will be docked. If the user drags the dock area outside any dock areas the dock window will be undocked (floated) and will become a top level window. Double clicking a floating dock window's titlebar will dock the dock window to the last dock area it was docked in. Double clicking a docked dock window's handle will undock (float) the dock window. If the user clicks the close button (which does not appear on dock windows by default - see closeMode) the dock window will disappear. You can control whether or not a dock window has a close button with setCloseMode(). +.PP +QMainWindow provides four dock areas (top, left, right and bottom) which can be used by dock windows. For many applications using the dock areas provided by QMainWindow is sufficient. (See the QDockArea documentation if you want to create your own dock areas.) In QMainWindow a right-click popup menu (the dock window menu) is available which lists dock windows and can be used to show or hide them. (The popup menu only lists dock windows that have a caption.) +.PP +When you construct a dock window you \fImust\fR pass it a QDockArea or a QMainWindow as its parent if you want it docked. Pass 0 for the parent if you want it floated. +.PP +.nf +.br + QToolBar *fileTools = new QToolBar( this, "File Actions" ); +.br + moveDockWindow( fileTools, Left ); +.br +.fi +.PP +In the example above we create a new QToolBar in the constructor of a QMainWindow subclass (so that the \fIthis\fR pointer points to the QMainWindow). By default the toolbar will be added to the Top dock area, but we've moved it to the Left dock area. +.PP +A dock window is often used to contain a single widget. In these cases the widget can be set by calling setWidget(). If you're constructing a dock window that contains multiple widgets, e.g. a toolbar, arrange the widgets within a box layout inside the dock window. To do this use the boxLayout() function to get a pointer to the dock window's box layout, then add widgets to the layout using the box layout's QBoxLayout::addWidget() function. The dock window will dynamically set the orientation of the layout to be vertical or horizontal as necessary, although you can control this yourself with setOrientation(). +.PP +Although a common use of dock windows is for toolbars, they can be used with any widgets. (See the Qt Designer and Qt Linguist applications, for example.) When using larger widgets it may make sense for the dock window to be resizable by calling setResizeEnabled(). Resizable dock windows are given splitter-like handles to allow the user to resize them within their dock area. When resizable dock windows are undocked they become top level windows and can be resized like any other top level windows, e.g. by dragging a corner or edge. +.PP +Dock windows can be docked and undocked using dock() and undock(). A dock window's orientation can be set with setOrientation(). You can also use QDockArea::moveDockWindow(). If you're using a QMainWindow, QMainWindow::moveDockWindow() and QMainWindow::removeDockWindow() are available. +.PP +A dock window can have some preferred settings, for example, you can set a preferred offset from the left edge (or top edge for vertical dock areas) of the dock area using setOffset(). If you'd prefer a dock window to start on a new line when it is docked use setNewLine(). The setFixedExtentWidth() and setFixedExtentHeight() functions can be used to define the dock window's preferred size, and the setHorizontallyStretchable() and setVerticallyStretchable() functions set whether the dock window can be stretched or not. Dock windows can be moved by default, but this can be changed with setMovingEnabled(). When a dock window is moved it is shown as a rectangular outline, but it can be shown normally using setOpaqueMoving(). +.PP +When a dock window's visibility changes, i.e. it is shown or hidden, the visibilityChanged() signal is emitted. When a dock window is docked, undocked or moved inside the dock area the placeChanged() signal is emitted. +.PP +See also Main Window and Related Classes. +.SS "Member Type Documentation" +.SH "QDockWindow::CloseMode" +This enum type specifies when (if ever) a dock window has a close button. +.TP +\fCQDockWindow::Never\fR - The dock window never has a close button and cannot be closed by the user. +.TP +\fCQDockWindow::Docked\fR - The dock window has a close button only when docked. +.TP +\fCQDockWindow::Undocked\fR - The dock window has a close button only when floating. +.TP +\fCQDockWindow::Always\fR - The dock window always has a close button. +.SH "QDockWindow::Place" +This enum specifies the possible locations for a QDockWindow: +.TP +\fCQDockWindow::InDock\fR - Inside a QDockArea. +.TP +\fCQDockWindow::OutsideDock\fR - Floating as a top level window on the desktop. +.SH MEMBER FUNCTION DOCUMENTATION +.SH "QDockWindow::QDockWindow ( Place p = InDock, QWidget * parent = 0, const char * name = 0, WFlags f = 0 )" +Constructs a QDockWindow with parent \fIparent\fR, called \fIname\fR and with widget flags \fIf\fR. +.PP +If \fIp\fR is InDock, the dock window is docked into a dock area and \fIparent\fR \fImust\fR be a QDockArea or a QMainWindow. If the \fIparent\fR is a QMainWindow the dock window will be docked in the main window's Top dock area. +.PP +If \fIp\fR is OutsideDock, the dock window is created as a floating window. +.PP +We recommend creating the dock area InDock with a QMainWindow as parent then calling QMainWindow::moveDockWindow() to move the dock window where you want it. +.SH "QDockWindow::QDockWindow ( QWidget * parent, const char * name = 0, WFlags f = 0 )" +Constructs a QDockWindow with parent \fIparent\fR, called \fIname\fR and with widget flags \fIf\fR. +.SH "QDockArea * QDockWindow::area () const" +Returns the dock area in which this dock window is docked, or 0 if the dock window is floating. +.SH "QBoxLayout * QDockWindow::boxLayout ()" +Returns the layout which is used for adding widgets to the dock window. The layout's orientation is set automatically to match the orientation of the dock window. You can add widgets to the layout using the box layout's QBoxLayout::addWidget() function. +.PP +If the dock window only needs to contain a single widget use setWidget() instead. +.PP +See also setWidget() and setOrientation(). +.SH "int QDockWindow::closeMode () const" +Returns the close mode of a dock window. See the "closeMode" property for details. +.SH "void QDockWindow::dock ()\fC [virtual slot]\fR" +Docks the dock window into the last dock area in which it was docked. +.PP +If the dock window has no last dock area (e.g. it was created as a floating window and has never been docked), or if the last dock area it was docked in does not exist (e.g. the dock area has been deleted), nothing happens. +.PP +The dock window will dock with the dock area regardless of the return value of QDockArea::isDockWindowAccepted(). +.PP +See also undock(), QDockArea::moveDockWindow(), QDockArea::removeDockWindow(), QMainWindow::moveDockWindow(), QMainWindow::removeDockWindow(), and QDockArea::isDockWindowAccepted(). +.SH "QSize QDockWindow::fixedExtent () const" +Returns the dock window's preferred size (fixed extent). +.PP +See also setFixedExtentWidth() and setFixedExtentHeight(). +.SH "bool QDockWindow::isCloseEnabled () const" +Returns TRUE if the dock window has a close button; otherwise returns FALSE. The result depends on the dock window's Place and its CloseMode. +.PP +See also closeMode. +.SH "bool QDockWindow::isHorizontalStretchable () const" +\fBThis function is obsolete.\fR It is provided to keep old source working. We strongly advise against using it in new code. +.SH "bool QDockWindow::isHorizontallyStretchable () const" +Returns TRUE if the dock window is horizontally stretchable; otherwise returns FALSE. See the "horizontallyStretchable" property for details. +.SH "bool QDockWindow::isMovingEnabled () const" +Returns TRUE if the user can move the dock window within the dock area, move the dock window to another dock area, or float the dock window; otherwise returns FALSE. See the "movingEnabled" property for details. +.SH "bool QDockWindow::isResizeEnabled () const" +Returns TRUE if the dock window is resizeable; otherwise returns FALSE. See the "resizeEnabled" property for details. +.SH "bool QDockWindow::isStretchable () const" +Returns TRUE if the dock window is stretchable in the current orientation(); otherwise returns FALSE. See the "stretchable" property for details. +.SH "bool QDockWindow::isVerticalStretchable () const" +\fBThis function is obsolete.\fR It is provided to keep old source working. We strongly advise against using it in new code. +.SH "bool QDockWindow::isVerticallyStretchable () const" +Returns TRUE if the dock window is vertically stretchable; otherwise returns FALSE. See the "verticallyStretchable" property for details. +.SH "bool QDockWindow::newLine () const" +Returns TRUE if the dock window prefers to start a new line in the dock area; otherwise returns FALSE. See the "newLine" property for details. +.SH "int QDockWindow::offset () const" +Returns the dock window's preferred offset from the dock area's left edge (top edge for vertical dock areas). See the "offset" property for details. +.SH "bool QDockWindow::opaqueMoving () const" +Returns TRUE if the dock window will be shown normally whilst it is being moved; otherwise returns FALSE. See the "opaqueMoving" property for details. +.SH "Qt::Orientation QDockWindow::orientation () const" +Returns the orientation of the dock window. +.PP +See also orientationChanged(). +.SH "void QDockWindow::orientationChanged ( Orientation o )\fC [signal]\fR" +This signal is emitted when the orientation of the dock window is changed. The new orientation is \fIo\fR. +.SH "Place QDockWindow::place () const" +This function returns where the dock window is placed. This is either InDock or OutsideDock. +.PP +See also QDockArea::moveDockWindow(), QDockArea::removeDockWindow(), QMainWindow::moveDockWindow(), and QMainWindow::removeDockWindow(). +.SH "void QDockWindow::placeChanged ( QDockWindow::Place p )\fC [signal]\fR" +This signal is emitted when the dock window is docked (\fIp\fR is InDock), undocked (\fIp\fR is OutsideDock) or moved inside the the dock area. +.PP +See also QDockArea::moveDockWindow(), QDockArea::removeDockWindow(), QMainWindow::moveDockWindow(), and QMainWindow::removeDockWindow(). +.SH "void QDockWindow::setCloseMode ( int m )\fC [virtual]\fR" +Sets the close mode of a dock window to \fIm\fR. See the "closeMode" property for details. +.SH "void QDockWindow::setFixedExtentHeight ( int h )\fC [virtual]\fR" +Sets the dock window's preferred height for its fixed extent (size) to \fIh\fR. +.PP +See also setFixedExtentWidth(). +.SH "void QDockWindow::setFixedExtentWidth ( int w )\fC [virtual]\fR" +Sets the dock window's preferred width for its fixed extent (size) to \fIw\fR. +.PP +See also setFixedExtentHeight(). +.SH "void QDockWindow::setHorizontalStretchable ( bool b )" +\fBThis function is obsolete.\fR It is provided to keep old source working. We strongly advise against using it in new code. +.SH "void QDockWindow::setHorizontallyStretchable ( bool b )\fC [virtual]\fR" +Sets whether the dock window is horizontally stretchable to \fIb\fR. See the "horizontallyStretchable" property for details. +.SH "void QDockWindow::setMovingEnabled ( bool b )\fC [virtual]\fR" +Sets whether the user can move the dock window within the dock area, move the dock window to another dock area, or float the dock window to \fIb\fR. See the "movingEnabled" property for details. +.SH "void QDockWindow::setNewLine ( bool b )\fC [virtual]\fR" +Sets whether the dock window prefers to start a new line in the dock area to \fIb\fR. See the "newLine" property for details. +.SH "void QDockWindow::setOffset ( int o )\fC [virtual]\fR" +Sets the dock window's preferred offset from the dock area's left edge (top edge for vertical dock areas) to \fIo\fR. See the "offset" property for details. +.SH "void QDockWindow::setOpaqueMoving ( bool b )\fC [virtual]\fR" +Sets whether the dock window will be shown normally whilst it is being moved to \fIb\fR. See the "opaqueMoving" property for details. +.SH "void QDockWindow::setOrientation ( Orientation o )\fC [virtual slot]\fR" +Sets the orientation of the dock window to \fIo\fR. The orientation is propagated to the layout boxLayout(). +.PP +\fBWarning:\fR All undocked QToolBars will always have a horizontal orientation. +.SH "void QDockWindow::setResizeEnabled ( bool b )\fC [virtual]\fR" +Sets whether the dock window is resizeable to \fIb\fR. See the "resizeEnabled" property for details. +.SH "void QDockWindow::setVerticalStretchable ( bool b )" +\fBThis function is obsolete.\fR It is provided to keep old source working. We strongly advise against using it in new code. +.SH "void QDockWindow::setVerticallyStretchable ( bool b )\fC [virtual]\fR" +Sets whether the dock window is vertically stretchable to \fIb\fR. See the "verticallyStretchable" property for details. +.SH "void QDockWindow::setWidget ( QWidget * w )\fC [virtual]\fR" +Sets the dock window's main widget to \fIw\fR. +.PP +See also boxLayout(). +.SH "void QDockWindow::undock ()\fC [virtual slot]\fR" +Undocks the QDockWindow from its current dock area if it is docked; otherwise does nothing. +.PP +See also dock(), QDockArea::moveDockWindow(), QDockArea::removeDockWindow(), QMainWindow::moveDockWindow(), and QMainWindow::removeDockWindow(). +.SH "void QDockWindow::visibilityChanged ( bool visible )\fC [signal]\fR" +This signal is emitted when the visibility of the dock window relatively to its dock area is changed. If \fIvisible\fR is TRUE, the QDockWindow is now visible to the dock area, otherwise it has been hidden. +.PP +A dock window can be hidden if it has a close button which the user has clicked. In the case of a QMainWindow a dock window can have its visibility changed (hidden or shown) by clicking its name in the dock window menu that lists the QMainWindow's dock windows. +.SH "QWidget * QDockWindow::widget () const" +Returns the dock window's main widget. +.PP +See also setWidget(). +.SS "Property Documentation" +.SH "int closeMode" +This property holds the close mode of a dock window. +.PP +Defines when (if ever) the dock window has a close button. The choices are Never, Docked (i.e. only when docked), Undocked (only when undocked, i.e. floated) or Always. +.PP +The default is Never. +.PP +Set this property's value with setCloseMode() and get this property's value with closeMode(). +.SH "bool horizontallyStretchable" +This property holds whether the dock window is horizontally stretchable. +.PP +A dock window is horizontally stretchable if you call setHorizontallyStretchable(TRUE) or setResizeEnabled(TRUE). +.PP +See also resizeEnabled. +.PP +Bugs and limitations: +.TP +Strecthability is broken. You must call setResizeEnabled(TRUE) to get proper behavior and even then QDockWindow does not limit stretchablilty. +.PP +Set this property's value with setHorizontallyStretchable() and get this property's value with isHorizontallyStretchable(). +.SH "bool movingEnabled" +This property holds whether the user can move the dock window within the dock area, move the dock window to another dock area, or float the dock window. +.PP +This property is TRUE by default. +.PP +Set this property's value with setMovingEnabled() and get this property's value with isMovingEnabled(). +.SH "bool newLine" +This property holds whether the dock window prefers to start a new line in the dock area. +.PP +The default is FALSE, i.e. the dock window doesn't require a new line in the dock area. +.PP +Set this property's value with setNewLine() and get this property's value with newLine(). +.SH "int offset" +This property holds the dock window's preferred offset from the dock area's left edge (top edge for vertical dock areas). +.PP +The default is 0. +.PP +Set this property's value with setOffset() and get this property's value with offset(). +.SH "bool opaqueMoving" +This property holds whether the dock window will be shown normally whilst it is being moved. +.PP +If this property is FALSE, (the default), the dock window will be represented by an outline rectangle whilst it is being moved. +.PP +\fBWarning:\fR Currently opaque moving has some problems and we do not recommend using it at this time. We expect to fix these problems in a future release. +.PP +Set this property's value with setOpaqueMoving() and get this property's value with opaqueMoving(). +.SH "bool resizeEnabled" +This property holds whether the dock window is resizeable. +.PP +A resizeable dock window can be resized using splitter-like handles inside a dock area and like every other top level window when floating. +.PP +A dock window is both horizontally and vertically stretchable if you call setResizeEnabled(TRUE). +.PP +This property is FALSE by default. +.PP +See also verticallyStretchable and horizontallyStretchable. +.PP +Set this property's value with setResizeEnabled() and get this property's value with isResizeEnabled(). +.SH "bool stretchable" +This property holds whether the dock window is stretchable in the current orientation(). +.PP +This property can be set using setHorizontallyStretchable() and setVerticallyStretchable(), or with setResizeEnabled(). +.PP +See also resizeEnabled. +.PP +Bugs and limitations: +.TP +Strecthability is broken. You must call setResizeEnabled(TRUE) to get proper behavior and even then QDockWindow does not limit stretchablilty. +.PP +Get this property's value with isStretchable(). +.SH "bool verticallyStretchable" +This property holds whether the dock window is vertically stretchable. +.PP +A dock window is vertically stretchable if you call setVerticallyStretchable(TRUE) or setResizeEnabled(TRUE). +.PP +See also resizeEnabled. +.PP +Bugs and limitations: +.TP +Strecthability is broken. You must call setResizeEnabled(TRUE) to get proper behavior and even then QDockWindow does not limit stretchablilty. +.PP +Set this property's value with setVerticallyStretchable() and get this property's value with isVerticallyStretchable(). + +.SH "SEE ALSO" +.BR http://doc.trolltech.com/qdoctwindow.html +.BR http://www.trolltech.com/faq/tech.html +.SH COPYRIGHT +Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the +license file included in the distribution for a complete license +statement. +.SH AUTHOR +Generated automatically from the source code. +.SH BUGS +If you find a bug in Qt, please report it as described in +.BR http://doc.trolltech.com/bughowto.html . +Good bug reports help us to help you. Thank you. +.P +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. +.P +If you find errors in this manual page, please report them to +.BR qt-bugs@trolltech.com . +Please include the name of the manual page (qdoctwindow.3qt) and the Qt +version (3.3.8). -- cgit v1.2.1