diff options
Diffstat (limited to 'doc/man/man3/tqdockwindow.3qt')
-rw-r--r-- | doc/man/man3/tqdockwindow.3qt | 152 |
1 files changed, 76 insertions, 76 deletions
diff --git a/doc/man/man3/tqdockwindow.3qt b/doc/man/man3/tqdockwindow.3qt index 5cc94d3f0..140caba3b 100644 --- a/doc/man/man3/tqdockwindow.3qt +++ b/doc/man/man3/tqdockwindow.3qt @@ -1,5 +1,5 @@ '\" t -.TH QDockWindow 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQDockWindow 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. @@ -7,9 +7,9 @@ .ad l .nh .SH NAME -QDockWindow \- Widget which can be docked inside a QDockArea or floated as a top level window on the desktop +TQDockWindow \- Widget which can be docked inside a TQDockArea or floated as a top level window on the desktop .SH SYNOPSIS -\fC#include <ntqdockwindow.h>\fR +\fC#include <tqdockwindow.h>\fR .PP Inherits TQFrame. .PP @@ -24,10 +24,10 @@ Inherited by TQToolBar. .BI "enum \fBCloseMode\fR { Never = 0, Docked = 1, Undocked = 2, Always = Docked | Undocked }" .br .ti -1c -.BI "\fBQDockWindow\fR ( Place p = InDock, TQWidget * parent = 0, const char * name = 0, WFlags f = 0 )" +.BI "\fBTQDockWindow\fR ( Place p = InDock, TQWidget * parent = 0, const char * name = 0, WFlags f = 0 )" .br .ti -1c -.BI "\fBQDockWindow\fR ( TQWidget * parent, const char * name = 0, WFlags f = 0 )" +.BI "\fBTQDockWindow\fR ( TQWidget * parent, const char * name = 0, WFlags f = 0 )" .br .ti -1c .BI "virtual void \fBsetWidget\fR ( TQWidget * w )" @@ -39,7 +39,7 @@ Inherited by TQToolBar. .BI "Place \fBplace\fR () const" .br .ti -1c -.BI "QDockArea * \fBarea\fR () const" +.BI "TQDockArea * \fBarea\fR () const" .br .ti -1c .BI "virtual void \fBsetCloseMode\fR ( int m )" @@ -141,7 +141,7 @@ Inherited by TQToolBar. .BI "void \fBorientationChanged\fR ( Orientation o )" .br .ti -1c -.BI "void \fBplaceChanged\fR ( QDockWindow::Place p )" +.BI "void \fBplaceChanged\fR ( TQDockWindow::Place p )" .br .ti -1c .BI "void \fBvisibilityChanged\fR ( bool visible )" @@ -181,27 +181,27 @@ Inherited by TQToolBar. .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. +The TQDockWindow class provides a widget which can be docked inside a TQDockArea or floated as a top level window on the desktop. .PP -This class handles moving, resizing, docking and undocking dock windows. TQToolBar is a subclass of QDockWindow so the functionality provided for dock windows is available with the same API for toolbars. +This class handles moving, resizing, docking and undocking dock windows. TQToolBar is a subclass of TQDockWindow so the functionality provided for dock windows is available with the same API for toolbars. .PP <center> .ce 1 .B "[Image Omitted]" .PP -</center> <blockquote><p align="center">\fI Two QDockWindows (TQToolBars) in a QDockArea \fR</p> </blockquote> +</center> <blockquote><p align="center">\fI Two TQDockWindows (TQToolBars) in a TQDockArea \fR</p> </blockquote> .PP <center> .ce 1 .B "[Image Omitted]" .PP -</center> <blockquote><p align="center">\fI A Floating QDockWindow \fR</p> </blockquote> +</center> <blockquote><p align="center">\fI A Floating TQDockWindow \fR</p> </blockquote> .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 -TQMainWindow 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 TQMainWindow is sufficient. (See the QDockArea documentation if you want to create your own dock areas.) In TQMainWindow 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.) +TQMainWindow 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 TQMainWindow is sufficient. (See the TQDockArea documentation if you want to create your own dock areas.) In TQMainWindow 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 TQMainWindow as its parent if you want it docked. Pass 0 for the parent if you want it floated. +When you construct a dock window you \fImust\fR pass it a TQDockArea or a TQMainWindow as its parent if you want it docked. Pass 0 for the parent if you want it floated. .PP .nf .br @@ -217,7 +217,7 @@ A dock window is often used to contain a single widget. In these cases the widge .PP Although a common use of dock windows is for toolbars, they can be used with any widgets. (See the TQt Designer and TQt 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 TQMainWindow, TQMainWindow::moveDockWindow() and TQMainWindow::removeDockWindow() are available. +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 TQDockArea::moveDockWindow(). If you're using a TQMainWindow, TQMainWindow::moveDockWindow() and TQMainWindow::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 @@ -225,138 +225,138 @@ When a dock window's visibility changes, i.e. it is shown or hidden, the visibil .PP See also Main Window and Related Classes. .SS "Member Type Documentation" -.SH "QDockWindow::CloseMode" +.SH "TQDockWindow::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. +\fCTQDockWindow::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. +\fCTQDockWindow::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. +\fCTQDockWindow::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: +\fCTQDockWindow::Always\fR - The dock window always has a close button. +.SH "TQDockWindow::Place" +This enum specifies the possible locations for a TQDockWindow: .TP -\fCQDockWindow::InDock\fR - Inside a QDockArea. +\fCTQDockWindow::InDock\fR - Inside a TQDockArea. .TP -\fCQDockWindow::OutsideDock\fR - Floating as a top level window on the desktop. +\fCTQDockWindow::OutsideDock\fR - Floating as a top level window on the desktop. .SH MEMBER FUNCTION DOCUMENTATION -.SH "QDockWindow::QDockWindow ( Place p = InDock, TQWidget * 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. +.SH "TQDockWindow::TQDockWindow ( Place p = InDock, TQWidget * parent = 0, const char * name = 0, WFlags f = 0 )" +Constructs a TQDockWindow 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 TQMainWindow. If the \fIparent\fR is a TQMainWindow the dock window will be docked in the main window's Top dock area. +If \fIp\fR is InDock, the dock window is docked into a dock area and \fIparent\fR \fImust\fR be a TQDockArea or a TQMainWindow. If the \fIparent\fR is a TQMainWindow 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 TQMainWindow as parent then calling TQMainWindow::moveDockWindow() to move the dock window where you want it. -.SH "QDockWindow::QDockWindow ( TQWidget * 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" +.SH "TQDockWindow::TQDockWindow ( TQWidget * parent, const char * name = 0, WFlags f = 0 )" +Constructs a TQDockWindow with parent \fIparent\fR, called \fIname\fR and with widget flags \fIf\fR. +.SH "TQDockArea * TQDockWindow::area () const" Returns the dock area in which this dock window is docked, or 0 if the dock window is floating. -.SH "TQBoxLayout * QDockWindow::boxLayout ()" +.SH "TQBoxLayout * TQDockWindow::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 TQBoxLayout::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" +.SH "int TQDockWindow::closeMode () const" Returns the close mode of a dock window. See the "closeMode" property for details. -.SH "void QDockWindow::dock ()\fC [virtual slot]\fR" +.SH "void TQDockWindow::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(). +The dock window will dock with the dock area regardless of the return value of TQDockArea::isDockWindowAccepted(). .PP -See also undock(), QDockArea::moveDockWindow(), QDockArea::removeDockWindow(), TQMainWindow::moveDockWindow(), TQMainWindow::removeDockWindow(), and QDockArea::isDockWindowAccepted(). -.SH "TQSize QDockWindow::fixedExtent () const" +See also undock(), TQDockArea::moveDockWindow(), TQDockArea::removeDockWindow(), TQMainWindow::moveDockWindow(), TQMainWindow::removeDockWindow(), and TQDockArea::isDockWindowAccepted(). +.SH "TQSize TQDockWindow::fixedExtent () const" Returns the dock window's preferred size (fixed extent). .PP See also setFixedExtentWidth() and setFixedExtentHeight(). -.SH "bool QDockWindow::isCloseEnabled () const" +.SH "bool TQDockWindow::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" +.SH "bool TQDockWindow::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" +.SH "bool TQDockWindow::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" +.SH "bool TQDockWindow::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" +.SH "bool TQDockWindow::isResizeEnabled () const" Returns TRUE if the dock window is resizeable; otherwise returns FALSE. See the "resizeEnabled" property for details. -.SH "bool QDockWindow::isStretchable () const" +.SH "bool TQDockWindow::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" +.SH "bool TQDockWindow::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" +.SH "bool TQDockWindow::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" +.SH "bool TQDockWindow::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" +.SH "int TQDockWindow::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" +.SH "bool TQDockWindow::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 "TQt::Orientation QDockWindow::orientation () const" +.SH "TQt::Orientation TQDockWindow::orientation () const" Returns the orientation of the dock window. .PP See also orientationChanged(). -.SH "void QDockWindow::orientationChanged ( Orientation o )\fC [signal]\fR" +.SH "void TQDockWindow::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" +.SH "Place TQDockWindow::place () const" This function returns where the dock window is placed. This is either InDock or OutsideDock. .PP -See also QDockArea::moveDockWindow(), QDockArea::removeDockWindow(), TQMainWindow::moveDockWindow(), and TQMainWindow::removeDockWindow(). -.SH "void QDockWindow::placeChanged ( QDockWindow::Place p )\fC [signal]\fR" +See also TQDockArea::moveDockWindow(), TQDockArea::removeDockWindow(), TQMainWindow::moveDockWindow(), and TQMainWindow::removeDockWindow(). +.SH "void TQDockWindow::placeChanged ( TQDockWindow::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(), TQMainWindow::moveDockWindow(), and TQMainWindow::removeDockWindow(). -.SH "void QDockWindow::setCloseMode ( int m )\fC [virtual]\fR" +See also TQDockArea::moveDockWindow(), TQDockArea::removeDockWindow(), TQMainWindow::moveDockWindow(), and TQMainWindow::removeDockWindow(). +.SH "void TQDockWindow::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" +.SH "void TQDockWindow::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" +.SH "void TQDockWindow::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 )" +.SH "void TQDockWindow::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" +.SH "void TQDockWindow::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" +.SH "void TQDockWindow::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" +.SH "void TQDockWindow::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" +.SH "void TQDockWindow::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" +.SH "void TQDockWindow::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" +.SH "void TQDockWindow::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 TQToolBars will always have a horizontal orientation. -.SH "void QDockWindow::setResizeEnabled ( bool b )\fC [virtual]\fR" +.SH "void TQDockWindow::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 )" +.SH "void TQDockWindow::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" +.SH "void TQDockWindow::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 ( TQWidget * w )\fC [virtual]\fR" +.SH "void TQDockWindow::setWidget ( TQWidget * 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. +.SH "void TQDockWindow::undock ()\fC [virtual slot]\fR" +Undocks the TQDockWindow from its current dock area if it is docked; otherwise does nothing. .PP -See also dock(), QDockArea::moveDockWindow(), QDockArea::removeDockWindow(), TQMainWindow::moveDockWindow(), and TQMainWindow::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. +See also dock(), TQDockArea::moveDockWindow(), TQDockArea::removeDockWindow(), TQMainWindow::moveDockWindow(), and TQMainWindow::removeDockWindow(). +.SH "void TQDockWindow::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 TQDockWindow 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 TQMainWindow a dock window can have its visibility changed (hidden or shown) by clicking its name in the dock window menu that lists the TQMainWindow's dock windows. -.SH "TQWidget * QDockWindow::widget () const" +.SH "TQWidget * TQDockWindow::widget () const" Returns the dock window's main widget. .PP See also setWidget(). @@ -378,7 +378,7 @@ 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. +Strecthability is broken. You must call setResizeEnabled(TRUE) to get proper behavior and even then TQDockWindow does not limit stretchablilty. .PP Set this property's value with setHorizontallyStretchable() and get this property's value with isHorizontallyStretchable(). .SH "bool movingEnabled" @@ -428,7 +428,7 @@ 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. +Strecthability is broken. You must call setResizeEnabled(TRUE) to get proper behavior and even then TQDockWindow does not limit stretchablilty. .PP Get this property's value with isStretchable(). .SH "bool verticallyStretchable" @@ -440,12 +440,12 @@ 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. +Strecthability is broken. You must call setResizeEnabled(TRUE) to get proper behavior and even then TQDockWindow 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/ntqdockwindow.html +.BR http://doc.trolltech.com/tqdockwindow.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the |