qMRMLViewControllerBar.h

Go to the documentation of this file.

/*==============================================================================

  Program: 3D Slicer

  Copyright (c) Kitware Inc.

  See COPYRIGHT.txt
  or http://www.slicer.org/copyright/copyright.txt for details.

  Unless required by applicable law or agreed to in writing, software
  distributed under the License is distributed on an "AS IS" BASIS,
  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  See the License for the specific language governing permissions and
  limitations under the License.

  This file was originally developed by Julien Finet, Kitware Inc.
  and was partially funded by NIH grant 3P41RR013218-12S1

==============================================================================*/

#ifndef __qMRMLViewControllerBar_h
#define __qMRMLViewControllerBar_h

// Qt includes
class QLabel;
class QLayout;
class QToolButton;

// qMRMLWidget includes
#include "qMRMLWidget.h"
#include "qMRMLWidgetsExport.h"
class qMRMLViewControllerBarPrivate;

//
// Widget layout:
//   VBoxLayout (ControllerLayout)
//      Widget (BarWidget)
//        HBoxLayout (BarLayout)
//      Optional PopupWidget (can be statically displayed under BarWidget if ControllerBar is a panel)
//
//
// To add widgets to the "bar" section, add them to the barLayout().
// To add widgets to the "controller" section (when not using a
// popup), add them to the layout().
//
class QMRML_WIDGETS_EXPORT qMRMLViewControllerBar
  : public qMRMLWidget
{
  Q_OBJECT
public:
  typedef qMRMLWidget Superclass;

  explicit qMRMLViewControllerBar(QWidget* parent = nullptr);
  ~qMRMLViewControllerBar() override;

  enum LayoutBehavior {
    Popup=0,
    Panel
  };

  Q_INVOKABLE void setLayoutBehavior(LayoutBehavior behavior);

  Q_INVOKABLE QLayout* barLayout();

  Q_INVOKABLE QWidget* barWidget();

  Q_INVOKABLE QToolButton* pinButton();

  Q_INVOKABLE QLabel* viewLabel();

protected:
  QScopedPointer<qMRMLViewControllerBarPrivate> d_ptr;
  qMRMLViewControllerBar(qMRMLViewControllerBarPrivate* pimpl, QWidget* parent = nullptr);

private:
  Q_DECLARE_PRIVATE(qMRMLViewControllerBar);
  Q_DISABLE_COPY(qMRMLViewControllerBar);
};

#endif