Widgets in conjoon provide access to often needed data from main modules, or provide functionality which otherwise wouldn't be justified to be implemented as a full-fledged main module. On the other hand, widgets extending or supporting the functionality of main modules provide access to data even if the corresponding main module is not started or loaded yet.

Widgets are placed in so called Widget Docks, which can be horizontally resized. Those widget docks are sitting in the left and right side of the main content panel and appear invisible to the user as long as they do not contain any widget; you have also the possibility to switch the docks visibility by hand.

Screenshot above: The layout of a widget in conjoon. The different areas are colorized to give a better impression of the layout.

On this page:

Changing a widget's height

In case you want to give a widget more space, you can resize it vertically. This is done by moving the mouse to the top of the widget's header which appears pierced - you will know you have hit the right spot when your mouse cursor changes to a so called *row resize" cursor, which looks similiar to this:
You can now click the mouse button and drag the bar up or down. Release the mouse button, and the widget's height changes according to the last position of the drag-bar.

Screenshot above: A widget's height gets changed by dragging it's pierced bar to a new position.

Some widgets have a minimum height and/or a maximum height. If you drag the bar out of any one of those bounds, the widget automatically adjusts to it's proper height. A widget will also hint to a maximum height if it's drag bar cannot be moved any further.

Some widgets cannot be changed in height and may only be minified using the minimize button.

Changing a widgets's width

A widget's width cannot be changed using the widget itself. This has to be done using the drag bar of a widget dock.

Minimizing a widget

A widget can be minimmized using the tool button in it's header, which looks like this: By clicking this button, you can minimize a widget. Minimizing a widget will hide it's body, leaving only the header visible. The "minimize" icon will change to this icon: When a widget gets minimized, the remaining space will be shared among other widgets which are sitting in the same dock as the minimized widget.
After you have minimized a widget, you can resize it bei either clicking the "maximize" button in it's header or by dragging the pierced bar to the desired size.

Reordering widgets

Widgets can be reordered by dragging them to another position in the dock. To do so, simply move the mouse cursor over a header until it changes to a cursor similiar to this: . This indicates that you can now grab the header and move it to another position: Click the mouse and drag the widget. If it can be dropped somewhere in the dock, it will be indicated by a rectangular matching the widget's header size. Release the mouse button to place the widget at the new position. If possible, the size of the widget will be restored to it's size before it was dragged; if there is not enough space, the widget or it's neighbour widgets will get resized, so that all widgets fit into the dock.

Screenshot above: A widget is dragged to a new position. The new position is indicated by a rectangular matching the size of the widget's header.

Moving widgets to another dock

The workbench has two docks, and each of them can be found at the left and the right side of the workbench. Docks will not be visible until a widget is placed into them - if you don't see a dock simply drag a widget to the approximate area of the dock to make it visible. The position of the widget will be indicated just as if you are moving it within it's original dock. A dock will dissappear if it does not contain any more widgets or if all of it's widgets are set to invisible.

Changing the width of a widget dock

Widget docks can be horizontally resized. To change the width of a dock, simply move the mouse cursor over the vertical border of a dock, until the mouse cursor changes to a so called "column-resize cursor", which should look similiar to this: You can now click the mouse button and move the bar to the left or right. If you release the mouse button, the dock width's gets changed accordingly.

Screenshot above: The dock on the left side gets resized.

Docks define their own maximum and minimum width. You won't be able to move the drag-border any further if you cut across these bounds.

Using the View menu to show/hide widgets and docks

Amongst other things, the View Menu provides access to functionality related to setting the visibility of widgets and docks. If you open the View Menu from the menubar, you will find a menu item named "Quick Panel", which refers to the widget docks. This menu item itself holds a sub menu which lists all availabe docks and widgets.

_Screenshot above: The View Menu with it's Quick Panels' sub menu.

If a widget or a dock currently does not provide interactions, it's corresponding menu item is greyed out and cannot be clicked.

Each menu item in the Quick Panels' sub menu can be activated or deactivated. States are represented here by a checkbox which is either checked or unchecked: A checked box in this menu translates to "Element is visible", whereas an unchecked box in this menu translates to "Element is not visible".

The menu items "Left Quick Panel" and "Right Quick Panel" will be disabled if any of this docks are not used, i.e. if any of those docks does not hold any widget. As soon as a widget is placed into one of these docks, the corresponding menu item will be available for clicking.

If you hide a dock which owns a hidden widget, and then set this widget's state to visible, it's dock will be made visible, too.