Warning, file /office/calligra/libs/main/KoDocumentSectionView.h was not indexed or was modified since last indexation (in which case cross-reference links may be missing, inaccurate or erroneous).

 /*
   Copyright (c) 2006 Gábor Lehel <illissius@gmail.com>
 
   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Library General Public
   License as published by the Free Software Foundation; either
   version 2 of the License, or (at your option) any later version.
 
   This library is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   Library General Public License for more details.
 
   You should have received a copy of the GNU Library General Public License
   along with this library; see the file COPYING.LIB.  If not, write to
   the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
   Boston, MA 02110-1301, USA.
 */
 
 #ifndef KO_DOCUMENT_SECTION_VIEW_H
 #define KO_DOCUMENT_SECTION_VIEW_H
 
 #include <QTreeView>
 #include "komain_export.h"
 
 class QStyleOptionViewItem;
 class KoDocumentSectionModel;
 
 /**
  * A View widget on document sections (for example, layers, pages,
  * sheets...). The widget can show the document sections as big
  * thumbnails, in a listview with two rows of informative text and
  * icons per document section or as single rows of text and property
  * icons.
  *
  * The KoDocumentSectionView is designed as a Qt4 model-view widget.
  * See the relevant (extensive) Qt documentation about the design
  * basis for this widget.
  *
  * Usage: simply use this widget in your designer .ui file. Karbon's
  * layerboxes are KoDocumentSectionView based.
  */
 class KOMAIN_EXPORT KoDocumentSectionView: public QTreeView
 {
     Q_OBJECT
 Q_SIGNALS:
     /**
      * Emitted whenever the user clicks with the secondary mouse
      * button on an item. It is up to the application to design the
      * contents of the context menu and show it.
      */
     void contextMenuRequested(const QPoint &globalPos, const QModelIndex &index);
     void selectionChanged(const QModelIndexList &);
 public:
 
     /**
      * Create a new KoDocumentSectionView.
      */
     explicit KoDocumentSectionView(QWidget *parent = 0);
     ~KoDocumentSectionView() override;
 
     /// how items should be displayed
     enum DisplayMode {
         /// large fit-to-width thumbnails, with only titles or page numbers
         ThumbnailMode,
 
         /// smaller thumbnails, with titles and property icons in two rows
         DetailedMode,
 
         /// no thumbnails, with titles and property icons in a single row
         MinimalMode
     };
 
     void paintEvent (QPaintEvent *event) override;
 
     void dropEvent(QDropEvent *ev) override;
 
     void dragEnterEvent(QDragEnterEvent *e) override;
 
     void dragMoveEvent(QDragMoveEvent *ev) override;
 
     void dragLeaveEvent(QDragLeaveEvent *e) override;
 
     /**
      * Set the display mode of the view to one of the options.
      *
      * @param mode The KoDocumentSectionView::DisplayMode mode
      */
     void setDisplayMode(DisplayMode mode);
 
     /**
      * @return the currently active display mode
      */
     DisplayMode displayMode() const;
 
     /**
      * Add toggle actions for all the properties associated with the
      * current document section associated with the model index to the
      * specified menu.
      *
      * For instance, if a document section can be locked and visible,
      * the menu will be expanded with locked and visible toggle
      * actions.
      *
      * For instance
      @code
      KoDocumentSectionView * sectionView;
      QModelIndex index = getCurrentDocumentSection();
      QMenu menu;
      if (index.isValid()) {
          sectionView->addPropertyActions(&menu, index);
      } else {
          menu.addAction(...); // Something to create a new document section, for example.
      }
 
      @endcode
      *
      * @param menu A pointer to the menu that will be expanded with
      * the toggle actions
      * @param index The model index associated with the document
      * section that may or may not provide a number of toggle actions.
      */
     void addPropertyActions(QMenu *menu, const QModelIndex &index);
 
 
 protected:
     bool viewportEvent(QEvent *event) override;
     void contextMenuEvent(QContextMenuEvent *event) override;
     virtual void showContextMenu(const QPoint &globalPos, const QModelIndex &index);
     void startDrag (Qt::DropActions supportedActions) override;
     QPixmap createDragPixmap() const;
 
     /**
      * Calculates the index of the nearest item to the cursor position
      */
     int cursorPageIndex() const;
 
 protected Q_SLOTS:
     void currentChanged(const QModelIndex &current, const QModelIndex &previous) override;
     void dataChanged(const QModelIndex &topLeft, const QModelIndex &bottomRight, const QVector<int> &roles = QVector<int>()) override;
     void selectionChanged(const QItemSelection &selected, const QItemSelection &deselected) override;
 
 private Q_SLOTS:
     void slotActionToggled(bool on, const QPersistentModelIndex &index, int property);
 
 private:
 
     /**
      * Permit to know if a slide is dragging
      *
      * @return boolean
      */
     bool isDragging() const;
 
     /**
      * Setter for the dragging flag
      *
      * @param flag boolean
      */
     void setDraggingFlag(bool flag = true);
 
     bool m_draggingFlag;
 
     QStyleOptionViewItem optionForIndex(const QModelIndex &index) const;
     typedef KoDocumentSectionModel Model;
     class PropertyAction;
     class Private;
     Private* const d;
 };
 
 #endif