Q3DockArea Class Reference

Member Function Documentation

Q3DockArea::Q3DockArea ( Qt::Orientation o, HandlePosition h = Normal, QWidget * parent = 0, const char * name = 0 )

Constructs a Q3DockArea with orientation o, HandlePosition h, parent parent and called name.

Q3DockArea::~Q3DockArea ()

Destroys the dock area and all the dock windows docked in the dock area.

Does not affect any floating dock windows or dock windows in other dock areas, even if they first appeared in this dock area. Floating dock windows are effectively top level windows and are not child windows of the dock area. When a floating dock window is docked (dragged into a dock area) its parent becomes the dock area.

QList<Q3DockWindow *> Q3DockArea::dockWindowList () const

Returns a list of the dock windows in the dock area.

bool Q3DockArea::eventFilter ( QObject * o, QEvent * e ) [virtual]

Reimplemented from QObject::eventFilter().

bool Q3DockArea::hasDockWindow ( Q3DockWindow * w, int * index = 0 )

Returns true if the dock area contains the dock window w; otherwise returns false. If index is not 0 it will be set as follows: if the dock area contains the dock window *index is set to w's index position; otherwise *index is set to -1.

bool Q3DockArea::isDockWindowAccepted ( Q3DockWindow * dw )

Returns true if dock window dw could be docked into the dock area; otherwise returns false.

See also setAcceptDockWindow().

void Q3DockArea::lineUp ( bool keepNewLines ) [slot]

Lines up the dock windows in this dock area to minimize wasted space. If keepNewLines is true, only space within lines is cleaned up. If keepNewLines is false the number of lines might be changed.

void Q3DockArea::moveDockWindow ( Q3DockWindow * w, int index = -1 )

Moves the Q3DockWindow w within the dock area. If w is not already docked in this area, w is docked first. If index is -1 or larger than the number of docked widgets, w is appended at the end, otherwise it is inserted at the position index.

void Q3DockArea::moveDockWindow ( Q3DockWindow * w, const QPoint & p, const QRect & r, bool swap )

This is an overloaded function.

Moves the dock window w inside the dock area where p is the new position (in global screen coordinates), r is the suggested rectangle of the dock window and swap specifies whether or not the orientation of the docked widget needs to be changed.

This function is used internally by Q3DockWindow. You shouldn't need to call it yourself.

void Q3DockArea::removeDockWindow ( Q3DockWindow * w, bool makeFloating, bool swap, bool fixNewLines = true )

Removes the dock window w from the dock area. If makeFloating is true, w gets floated, and if swap is true, the orientation of w gets swapped. If fixNewLines is true (the default) newlines in the area will be fixed.

You should never need to call this function yourself. Use Q3DockWindow::dock() and Q3DockWindow::undock() instead.

void Q3DockArea::setAcceptDockWindow ( Q3DockWindow * dw, bool accept )

If accept is true, dock window dw can be docked in the dock area. If accept is false, dock window dw cannot be docked in the dock area.

See also isDockWindowAccepted().