|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.trolltech.qt.internal.QSignalEmitterInternal
com.trolltech.qt.QSignalEmitter
com.trolltech.qt.QtJambiObject
com.trolltech.qt.core.QObject
com.trolltech.qt.gui.QWidget
com.trolltech.qt.gui.QWorkspace
public class QWorkspace
The QWorkspace widget provides a workspace window that can be used in an MDI application. This class is deprecated. Use QMdiArea
instead.
Multiple Document Interface (MDI) applications are typically composed of a main window containing a menu bar, a toolbar, and a central QWorkspace widget. The workspace itself is used to display a number of child windows, each of which is a widget.
The workspace itself is an ordinary Qt widget. It has a standard constructor that takes a parent widget. Workspaces can be placed in any layout, but are typically given as the central widget in a QMainWindow
:
public MainWindow() { workspace = new QWorkspace(); setCentralWidget(workspace); // ... }Child windows (MDI windows) are standard Qt widgets that are inserted into the workspace with
addWindow()
. As with top-level widgets, you can call functions such as show()
, hide()
, showMaximized()
, and setWindowTitle() on a child window to change its appearance within the workspace. You can also provide widget flags to determine the layout of the decoration or the behavior of the widget itself. To change or retrieve the geometry of a child window, you must operate on its parentWidget()
. The parentWidget()
provides access to the decorated frame that contains the child window widget. When a child window is maximised, its decorated frame is hidden. If the top-level widget contains a menu bar, it will display the maximised window's operations menu to the left of the menu entries, and the window's controls to the right.
A child window becomes active when it gets the keyboard focus, or when setFocus()
is called. The user can activate a window by moving focus in the usual ways, for example by clicking a window or by pressing Tab. The workspace emits a signal windowActivated()
when the active window changes, and the function activeWindow()
returns a pointer to the active child window, or 0 if no window is active.
The convenience function windowList()
returns a list of all child windows. This information could be used in a popup menu containing a list of windows, for example. This feature is also available as part of the Window Menu Solution.
QWorkspace provides two built-in layout strategies for child windows: cascade()
and tile()
. Both are slots so you can easily connect menu entries to them.
![]() | ![]() |
scrollBarsEnabled
property to true. QDockWidget
, and MDI Example.
Nested Class Summary | |
---|---|
static class |
QWorkspace.WindowOrder
Specifies the order in which child windows are returned from windowList() . |
Nested classes/interfaces inherited from class com.trolltech.qt.gui.QWidget |
---|
QWidget.RenderFlag, QWidget.RenderFlags |
Nested classes/interfaces inherited from class com.trolltech.qt.internal.QSignalEmitterInternal |
---|
com.trolltech.qt.internal.QSignalEmitterInternal.AbstractSignalInternal |
Field Summary | |
---|---|
QSignalEmitter.Signal1 |
windowActivated
This signal takes 1 generic argument(s). |
Fields inherited from class com.trolltech.qt.gui.QWidget |
---|
customContextMenuRequested |
Fields inherited from class com.trolltech.qt.internal.QSignalEmitterInternal |
---|
currentSender |
Constructor Summary | |
---|---|
QWorkspace()
Constructs a workspace with the given parent. |
|
QWorkspace(QWidget parent)
Constructs a workspace with the given parent. |
Method Summary | |
---|---|
void |
activateNextWindow()
Gives the input focus to the next window in the list of child windows. |
void |
activatePreviousWindow()
Gives the input focus to the previous window in the list of child windows. |
QWidget |
activeWindow()
Returns a pointer to the widget corresponding to the active child window, or 0 if no window is active. |
QWidget |
addWindow(QWidget w)
Adds widget w as new sub window to the workspace. |
QWidget |
addWindow(QWidget w,
Qt.WindowFlags flags)
Adds widget w as new sub window to the workspace. |
QWidget |
addWindow(QWidget w,
Qt.WindowType[] flags)
This is an overloaded method provided for convenience. |
void |
arrangeIcons()
Arranges all iconified windows at the bottom of the workspace. |
QBrush |
background()
This property holds the workspace's background. |
void |
cascade()
Arranges all the child windows in a cascade pattern. |
void |
closeActiveWindow()
Closes the child window that is currently active. |
void |
closeAllWindows()
Closes all child windows. |
boolean |
scrollBarsEnabled()
This property holds whether the workspace provides scroll bars. |
void |
setActiveWindow(QWidget w)
Makes the child window that contains w the active child window. |
void |
setBackground(QBrush background)
This property holds the workspace's background. |
void |
setScrollBarsEnabled(boolean enable)
This property holds whether the workspace provides scroll bars. |
void |
tile()
Arranges all child windows in a tile pattern. |
java.util.List |
windowList()
Returns a list of all visible or minimized child windows. |
java.util.List |
windowList(QWorkspace.WindowOrder order)
Returns a list of all visible or minimized child windows. |
Methods inherited from class com.trolltech.qt.core.QObject |
---|
childEvent, children, connectSlotsByName, customEvent, disposeLater, dumpObjectInfo, dumpObjectTree, dynamicPropertyNames, event, eventFilter, findChild, findChild, findChild, findChildren, findChildren, findChildren, findChildren, indexOfProperty, installEventFilter, isWidgetType, killTimer, moveToThread, objectName, parent, properties, property, removeEventFilter, setObjectName, setParent, setProperty, startTimer, timerEvent, toString, userProperty |
Methods inherited from class com.trolltech.qt.QtJambiObject |
---|
dispose, disposed, equals, finalize, reassignNativeResources, tr, tr, tr |
Methods inherited from class com.trolltech.qt.QSignalEmitter |
---|
blockSignals, disconnect, disconnect, signalsBlocked, signalSender, thread |
Methods inherited from class com.trolltech.qt.internal.QSignalEmitterInternal |
---|
__qt_signalInitialization |
Methods inherited from class java.lang.Object |
---|
clone, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Methods inherited from interface com.trolltech.qt.QtJambiInterface |
---|
disableGarbageCollection, nativeId, nativePointer, reenableGarbageCollection, setJavaOwnership |
Field Detail |
---|
public final QSignalEmitter.Signal1 windowActivated
This signal takes 1 generic argument(s). We list their type and the name they go by in the description of this signal. <com.trolltech.qt.gui.QWidget(named: w)>:
This signal is emitted when the child window w becomes active. Note that w can be 0, and that more than one signal may be emitted for a single activation event.
activeWindow()
, and windowList()
.
Constructor Detail |
---|
public QWorkspace()
public QWorkspace(QWidget parent)
Method Detail |
---|
public final void activateNextWindow()
activatePreviousWindow()
.
public final void activatePreviousWindow()
activateNextWindow()
.
public final QWidget activeWindow()
setActiveWindow()
.
public final QWidget addWindow(QWidget w, Qt.WindowType[] flags)
public final QWidget addWindow(QWidget w)
Returns the widget used for the window frame.
To remove the widget w from the workspace, simply call setParent()
with the new parent (or 0 to make it a stand-alone window).
public final QWidget addWindow(QWidget w, Qt.WindowFlags flags)
Returns the widget used for the window frame.
To remove the widget w from the workspace, simply call setParent()
with the new parent (or 0 to make it a stand-alone window).
public final void arrangeIcons()
cascade()
, and tile()
.
public final QBrush background()
public final void cascade()
tile()
, and arrangeIcons()
.
public final void closeActiveWindow()
closeAllWindows()
.
public final void closeAllWindows()
If any child window fails to accept the close event, the remaining windows will remain open.
closeActiveWindow()
.
public final boolean scrollBarsEnabled()
If this property is false (the default), resizing child windows out of the visible area of the workspace is not permitted, although it is still possible to position them partially outside the visible area.
public final void setActiveWindow(QWidget w)
activeWindow()
.
public final void setBackground(QBrush background)
public final void setScrollBarsEnabled(boolean enable)
If this property is false (the default), resizing child windows out of the visible area of the workspace is not permitted, although it is still possible to position them partially outside the visible area.
public final void tile()
cascade()
, and arrangeIcons()
.
public final java.util.List windowList()
public final java.util.List windowList(QWorkspace.WindowOrder order)
CreationOrder
(the default), the windows are listed in the order in which they were inserted into the workspace. If order is StackingOrder
, the windows are listed in their stacking order, with the topmost window as the last item in the list.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |