From 8c6fc1f8e35fd264dd01c582ca5e7549b32ab731 Mon Sep 17 00:00:00 2001 From: Timothy Pearson Date: Tue, 8 Nov 2011 00:35:13 -0600 Subject: Fix accidental conversion of dockwin (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 0 -> 1212 bytes doc/html/qdoctwindow-h.html | 282 --------------------- doc/html/qdoctwindow-members.html | 393 ----------------------------- doc/html/qdoctwindow.html | 509 -------------------------------------- doc/html/qdoctwindow.png | Bin 1212 -> 0 bytes 8 files changed, 1184 insertions(+), 1184 deletions(-) create mode 100644 doc/html/qdockwindow-h.html create mode 100644 doc/html/qdockwindow-members.html create mode 100644 doc/html/qdockwindow.html create mode 100644 doc/html/qdockwindow.png delete mode 100644 doc/html/qdoctwindow-h.html delete mode 100644 doc/html/qdoctwindow-members.html delete mode 100644 doc/html/qdoctwindow.html delete mode 100644 doc/html/qdoctwindow.png (limited to 'doc/html') diff --git a/doc/html/qdockwindow-h.html b/doc/html/qdockwindow-h.html new file mode 100644 index 0000000..329ad1c --- /dev/null +++ b/doc/html/qdockwindow-h.html @@ -0,0 +1,282 @@ + + + + + +qdockwindow.h Include File + + + + + + + +
+ +Home + | +All Classes + | +Main Classes + | +Annotated + | +Grouped Classes + | +Functions +

qdockwindow.h

+ +

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


+
+/****************************************************************************
+** $Id: qt/qdockwindow.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 new file mode 100644 index 0000000..cf34fa3 --- /dev/null +++ b/doc/html/qdockwindow-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/qdockwindow.html b/doc/html/qdockwindow.html new file mode 100644 index 0000000..80a657f --- /dev/null +++ b/doc/html/qdockwindow.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 <qdockwindow.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 new file mode 100644 index 0000000..75ccaa4 Binary files /dev/null and b/doc/html/qdockwindow.png differ diff --git a/doc/html/qdoctwindow-h.html b/doc/html/qdoctwindow-h.html deleted file mode 100644 index 329ad1c..0000000 --- a/doc/html/qdoctwindow-h.html +++ /dev/null @@ -1,282 +0,0 @@ - - - - - -qdockwindow.h Include File - - - - - - - -
- -Home - | -All Classes - | -Main Classes - | -Annotated - | -Grouped Classes - | -Functions -

qdockwindow.h

- -

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


-
-/****************************************************************************
-** $Id: qt/qdockwindow.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 deleted file mode 100644 index cf34fa3..0000000 --- a/doc/html/qdoctwindow-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/qdoctwindow.html b/doc/html/qdoctwindow.html deleted file mode 100644 index 80a657f..0000000 --- a/doc/html/qdoctwindow.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 <qdockwindow.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 deleted file mode 100644 index 75ccaa4..0000000 Binary files a/doc/html/qdoctwindow.png and /dev/null differ -- cgit v1.2.3