https://github.com/mfreiholz/Qt-Advanced-Docking-System

Advanced Docking System for Qt
https://github.com/mfreiholz/Qt-Advanced-Docking-System

cpp docking qt qt4 qt5 widget window wtfpl

Last synced: 3 months ago
JSON representation

Advanced Docking System for Qt

• Host: GitHub
• URL: https://github.com/mfreiholz/Qt-Advanced-Docking-System
• Owner: mfreiholz
• License: other
• Created: 2015-12-09T12:11:06.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2024-06-03T06:30:03.000Z (5 months ago)
• Last Synced: 2024-06-12T07:17:03.061Z (5 months ago)
• Topics: cpp, docking, qt, qt4, qt5, widget, window, wtfpl
• Language: C++
• Size: 486 KB
• Stars: 716
• Watchers: 51
• Forks: 698
• Open Issues: 27
• Metadata Files:
  • Readme: README.md
  • License: license.png

Awesome Lists containing this project

README

        
# Advanced Docking System for Qt

[![Gitter](https://badges.gitter.im/mfreiholz/Qt-Advanced-Docking-System.svg)](https://gitter.im/mfreiholz/Qt-Advanced-Docking-System?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)

Manages content widgets more like Visual Studio or similar programs.

I also try to get everything done with basic Qt functionality.

Basic usage of QWidgets an QLayouts and using basic styles as much as possible.

![Layout of widgets](preview.png)

![Dropping widgets](preview-dragndrop.png)

## Tested Compatible Environments

- Windows 7 / 8 / 8.1 / 10

- Ubuntu 15.10

## Build

Open the `build.pro` with QtCreator and start the build, that's it.

You can run the demo project and test it yourself.

## Release & Development

The `master` branch is not guaranteed to be stable or does not even build, since it is the main working branch.

If you want a version that builds, you should always use a release/beta tag.

## Getting started / Example

The following example shows the minimum code required to use ADS.

_MyWindow.h_

```cpp

#include 

#include "ads/API.h"

#include "ads/ContainerWidget.h"

#include "ads/SectionContent.h"

class MyWindow : public QMainWindow

{

	Q_OBJECT

public:

	MyWindow(QWidget* parent);

	

private:

	// The main container for dockings.

	ADS_NS::ContainerWidget* _container;

	

	// You always want to keep a reference of your content,

	// in case you need to perform any action on it (show, hide, ...)

	ADS_NS::SectionContent::RefPtr _sc1; 

};

```

_MyWindow.cpp_

```cpp

#include "MyWindow.h"

#include 

MyWindow::MyWindow(QWidget* parent) : QMainWindow(parent)

{

	_container = new ADS_NS::ContainerWidget();

	setCentralWidget(_container);

	

	_sc1 = ADS_NS::SectionContent::newSectionContent(QString("Unique-Internal-Name"), _container, new QLabel("Visible Title"), new QLabel("Content Widget"));

	_container->addSectionContent(_sc1, NULL, ADS_NS::CenterDropArea);

}

static void initStyleSheet(QApplication& a)

{

	//Q_INIT_RESOURCE(ads); // If static linked.

	QFile f(":ads/stylesheets/default-windows.css");

	if (f.open(QFile::ReadOnly))

	{

		const QByteArray ba = f.readAll();

		f.close();

		a.setStyleSheet(QString(ba));

	}

}

int main(int argc, char *argv[])

{

	QApplication a(argc, argv);

	a.setQuitOnLastWindowClosed(true);

	initStyleSheet(a);

	MainWindow mw;

	mw.show();

	return a.exec();

}

```

## Developers

[Manuel Freiholz](https://mfreiholz.de), Project Maintainer

## License information

![WTFPL](license.png)

This projects uses the [WTFPL license](http://www.wtfpl.net/)

(Do **W**hat **T**he **F**uck You Want To **P**ublic **L**icense)

Using it? Let us know by creating a [new issue](https://github.com/mfreiholz/qt-docks/issues/new) (You don't have to, of course).