mirror of https://github.com/fltk/fltk
94 lines
3.1 KiB
C++
94 lines
3.1 KiB
C++
//
|
|
|
|
#ifndef _FL_TREE_ITEM_ARRAY_H
|
|
#define _FL_TREE_ITEM_ARRAY_H
|
|
|
|
#include <FL/Fl.H>
|
|
#include "Fl_Export.H"
|
|
|
|
class FL_EXPORT Fl_Tree_Item; // forward decl must *precede* first doxygen comment block
|
|
// or doxygen will not document our class..
|
|
|
|
//////////////////////////
|
|
// FL/Fl_Tree_Item_Array.H
|
|
//////////////////////////
|
|
//
|
|
// Fl_Tree -- This file is part of the Fl_Tree widget for FLTK
|
|
// Copyright (C) 2009-2010 by Greg Ercolano.
|
|
//
|
|
// This library is free software. Distribution and use rights are outlined in
|
|
// the file "COPYING" which should have been included with this file. If this
|
|
// file is missing or damaged, see the license at:
|
|
//
|
|
// https://www.fltk.org/COPYING.php
|
|
//
|
|
// Please see the following page on how to report bugs and issues:
|
|
//
|
|
// https://www.fltk.org/bugs.php
|
|
//
|
|
|
|
///
|
|
/// \file
|
|
/// \brief This file defines a class that manages an array of Fl_Tree_Item pointers.
|
|
///
|
|
|
|
/// \brief Manages an array of Fl_Tree_Item pointers.
|
|
///
|
|
/// Because FLTK 1.x.x. has mandated that templates and STL not be used,
|
|
/// we use this class to dynamically manage the arrays.
|
|
///
|
|
/// None of the methods do range checking on index values; the caller
|
|
/// must be sure that index values are within the range 0<index<total()
|
|
/// (unless otherwise noted).
|
|
///
|
|
|
|
class FL_EXPORT Fl_Tree_Item_Array {
|
|
Fl_Tree_Item **_items; // items array
|
|
int _total; // #items in array
|
|
int _size; // #items *allocated* for array
|
|
int _chunksize; // #items to enlarge mem allocation
|
|
enum {
|
|
MANAGE_ITEM = 1 ///> manage the Fl_Tree_Item's internals (internal use only)
|
|
};
|
|
char _flags; // flags to control behavior
|
|
void enlarge(int count);
|
|
public:
|
|
Fl_Tree_Item_Array(int new_chunksize = 10); // CTOR
|
|
~Fl_Tree_Item_Array(); // DTOR
|
|
Fl_Tree_Item_Array(const Fl_Tree_Item_Array *o); // COPY CTOR
|
|
/// Return the item and index \p i.
|
|
Fl_Tree_Item *operator[](int i) {
|
|
return(_items[i]);
|
|
}
|
|
/// Const version of operator[](int i)
|
|
const Fl_Tree_Item *operator[](int i) const {
|
|
return(_items[i]);
|
|
}
|
|
/// Return the total items in the array, or 0 if empty.
|
|
int total() const {
|
|
return(_total);
|
|
}
|
|
/// Swap the two items at index positions \p ax and \p bx.
|
|
void swap(int ax, int bx);
|
|
int move(int to, int from);
|
|
int deparent(int pos);
|
|
int reparent(Fl_Tree_Item *item, Fl_Tree_Item *newparent, int pos);
|
|
void clear();
|
|
void add(Fl_Tree_Item *val);
|
|
void insert(int pos, Fl_Tree_Item *new_item);
|
|
void replace(int pos, Fl_Tree_Item *new_item);
|
|
void remove(int index);
|
|
int remove(Fl_Tree_Item *item);
|
|
/// Option to control if Fl_Tree_Item_Array's destructor will also destroy the Fl_Tree_Item's.
|
|
/// If set: items and item array is destroyed.
|
|
/// If clear: only the item array is destroyed, not items themselves.
|
|
void manage_item_destroy(int val) {
|
|
if ( val ) _flags |= MANAGE_ITEM; else _flags &= ~MANAGE_ITEM;
|
|
}
|
|
int manage_item_destroy() const {
|
|
return _flags & MANAGE_ITEM ? 1 : 0;
|
|
}
|
|
};
|
|
|
|
#endif /*_FL_TREE_ITEM_ARRAY_H*/
|