TableOfContents.h

Go to the documentation of this file.

// -*- mode: c++; c-file-style: "linux"; c-basic-offset: 2; indent-tabs-mode: nil -*-
//
//  Copyright (C) 2009-2015 Andrej Vodopivec <andrej.vodopivec@gmail.com>
//            (C) 2014-2018 Gunter Königsmann <wxMaxima@physikbuch.de>
//
//  This program is free software; you can redistribute it and/or modify
//  it under the terms of the GNU General Public License as published by
//  the Free Software Foundation; either version 2 of the License, or
//  (at your option) any later version.
//
//  This program 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 General Public License for more details.
//
//
//  You should have received a copy of the GNU General Public License
//  along with this program; if not, write to the Free Software
//  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
//
//  SPDX-License-Identifier: GPL-2.0+
 
#include <memory>
#include <wx/wx.h>
#include <wx/timer.h>
#include <wx/listctrl.h>
#include <wx/dragimag.h>
#include <vector>
#include "precomp.h"
#include "Configuration.h"
#include "RegexCtrl.h"
#include "cells/GroupCell.h"
 
#ifndef TABLEOFCONTENTS_H
#define TABLEOFCONTENTS_H
 
enum
{
  structure_ctrl_id = 4,
  structure_regex_id
};
 
class TableOfContents : public wxPanel
{
public:
  TableOfContents(wxWindow *parent, int id, Configuration *config, std::unique_ptr<GroupCell> *tree);
 
  /* The destructor
   */
  ~TableOfContents();
 
  void OnMouseRightDown(wxListEvent &event);
 
  void OnRegExEvent(wxCommandEvent &ev);
 
  void UpdateTableOfContents(GroupCell *pos);
 
  GroupCell *GetCell(std::size_t index);
 
  GroupCell *RightClickedOn()
    { return m_cellRightClickedOn; }
 
  GroupCell *DNDStart() {return m_dndStartCell;}
  GroupCell *DNDEnd() {return m_dndEndCell;}
 
  static long ClampDropIndex(long hitIndex, int itemCount,
                             std::size_t numberOfCaptionsDragged);
protected:
  void OnSize(wxSizeEvent &event);
  void OnDragStart(wxListEvent &evt);
  void OnMouseUp(wxMouseEvent &evt);
  void OnMouseCaptureLost(wxMouseCaptureLostEvent &event);
  void OnMouseMotion(wxMouseEvent &event);
  void OnTimer(wxTimerEvent &event);
 
  wxString TocEntryString(GroupCell *cell);
private:
  void UpdateStruct();
  std::unique_ptr<GroupCell> *m_tree;
  // CellPtrs, not raw pointers: the TOC is rebuilt asynchronously, so a cell
  // recorded during a drag/right-click can be destroyed before the resulting
  // menu/drop command reads it back via the getters below. Auto-nulling means a
  // stale reference reads as nullptr (see "Long-lived cell references" in
  // CellPtr.h); the consumers in wxMaxima.cpp null-check / GetTree()->Contains().
  CellPtr<GroupCell> m_dndStartCell;
  CellPtr<GroupCell> m_dndEndCell;
  wxTimer m_scrollUpTimer;
  wxTimer m_scrollDownTimer;
  wxDragImage *m_dragImage = NULL;
  // CellPtrs, not raw pointers: these caches can lag the worksheet tree, so an
  // entry may refer to a cell that has since been deleted. Auto-nulling turns a
  // stale entry into nullptr rather than a dangling pointer (see "Long-lived
  // cell references" in CellPtr.h). Callers must therefore null-check entries.
  std::vector<CellPtr<GroupCell>> m_displayedGroupCells;
  std::size_t m_numberOfCaptionsDragged = 0;
  CellPtr<GroupCell> m_cellRightClickedOn;
  long m_dragStart = -1;
  long m_dragStop = -1;
  signed long m_dragCurrentPos = -1;
  int m_dragFeedback_Last = -1;
  long m_lastSelection;
 
  void UpdateDisplay();
 
  wxListCtrl *m_displayedItems;
  RegexCtrl *m_regex;
  wxArrayString m_items_old;
  Configuration *m_configuration;
 
  // CellPtrs for the same reason as m_displayedGroupCells above.
  std::vector<CellPtr<GroupCell>> m_structure;
};
 
#endif // TABLEOFCONTENTS_H