blob: 20dc6cdef2454bd7e04ec6f48b71a73cbaf270b0 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
|
// Copyright (c) 2012 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef UI_BASE_MODELS_TREE_MODEL_H_
#define UI_BASE_MODELS_TREE_MODEL_H_
#include <vector>
#include "base/component_export.h"
#include "base/strings/string16.h"
namespace gfx {
class ImageSkia;
}
namespace ui {
class TreeModel;
// TreeModelNode --------------------------------------------------------------
// Type of class returned from the model. This is a low-level interface.
// Generally you will want to use TreeNode or TreeNodeWithValue which provides
// a basic implementation for storing the tree hierarchy. See
// tree_node_model.h.
class TreeModelNode {
public:
// Returns the title for the node.
virtual const base::string16& GetTitle() const = 0;
protected:
virtual ~TreeModelNode() {}
};
// Observer for the TreeModel. Notified of significant events to the model.
class COMPONENT_EXPORT(UI_BASE) TreeModelObserver {
public:
// Notification that nodes were added to the specified parent.
virtual void TreeNodesAdded(TreeModel* model,
TreeModelNode* parent,
size_t start,
size_t count) = 0;
// Notification that nodes were removed from the specified parent.
virtual void TreeNodesRemoved(TreeModel* model,
TreeModelNode* parent,
size_t start,
size_t count) = 0;
// Notification that the contents of a node has changed.
virtual void TreeNodeChanged(TreeModel* model, TreeModelNode* node) = 0;
protected:
virtual ~TreeModelObserver() {}
};
// TreeModel ------------------------------------------------------------------
// The model for TreeView. This is a low-level interface and requires a lot
// of bookkeeping for the tree to be implemented. Generally you will want to
// use TreeNodeModel which provides a standard implementation for basic
// hierarchy and observer notification. See tree_node_model.h.
class COMPONENT_EXPORT(UI_BASE) TreeModel {
public:
using Nodes = std::vector<TreeModelNode*>;
// Returns the root of the tree. This may or may not be shown in the tree,
// see SetRootShown for details.
virtual TreeModelNode* GetRoot() = 0;
// Returns the children of |parent|.
virtual Nodes GetChildren(const TreeModelNode* parent) const = 0;
// Returns the index of |child| in |parent|.
virtual int GetIndexOf(TreeModelNode* parent, TreeModelNode* child) const = 0;
// Returns the parent of |node|, or NULL if |node| is the root.
virtual TreeModelNode* GetParent(TreeModelNode* node) const = 0;
// Adds an observer of the model.
virtual void AddObserver(TreeModelObserver* observer) = 0;
// Removes an observer of the model.
virtual void RemoveObserver(TreeModelObserver* observer) = 0;
// Sets the title of |node|.
// This is only invoked if the node is editable and the user edits a node.
virtual void SetTitle(TreeModelNode* node, const base::string16& title);
// Returns the set of icons for the nodes in the tree. You only need override
// this if you don't want to use the default folder icons.
virtual void GetIcons(std::vector<gfx::ImageSkia>* icons) {}
// Returns the index of the icon to use for |node|. Return -1 to use the
// default icon. The index is relative to the list of icons returned from
// GetIcons.
virtual int GetIconIndex(TreeModelNode* node);
protected:
virtual ~TreeModel() {}
};
} // namespace ui
#endif // UI_BASE_MODELS_TREE_MODEL_H_
|
