Free cookie consent management tool by TermsFeed Policy Generator

source: branches/NewItemDialog/HeuristicLab.Optimizer/3.3/NewItemDialog.cs @ 12246

Last change on this file since 12246 was 12246, checked in by pfleck, 9 years ago

#2025 Added a Priority for the CreatableAttribute to manually define an ordering for the NewItemDialog.

File size: 15.7 KB
Line 
1#region License Information
2/* HeuristicLab
3 * Copyright (C) 2002-2015 Heuristic and Evolutionary Algorithms Laboratory (HEAL)
4 *
5 * This file is part of HeuristicLab.
6 *
7 * HeuristicLab is free software: you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation, either version 3 of the License, or
10 * (at your option) any later version.
11 *
12 * HeuristicLab is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15 * GNU General Public License for more details.
16 *
17 * You should have received a copy of the GNU General Public License
18 * along with HeuristicLab. If not, see <http://www.gnu.org/licenses/>.
19 */
20#endregion
21
22using System;
23using System.Collections;
24using System.Collections.Generic;
25using System.Drawing;
26using System.Linq;
27using System.Windows.Forms;
28using HeuristicLab.Core;
29using HeuristicLab.PluginInfrastructure;
30
31namespace HeuristicLab.Optimizer {
32  internal partial class NewItemDialog : Form {
33    private bool isInitialized;
34
35    private List<TreeNode> treeNodes;
36    private string currentSearchString;
37
38    private Type selectedType;
39    public Type SelectedType {
40      get { return selectedType; }
41      private set {
42        if (value != selectedType) {
43          selectedType = value;
44          OnSelectedTypeChanged();
45        }
46      }
47    }
48
49    private IItem item;
50    public IItem Item {
51      get { return item; }
52    }
53
54    public NewItemDialog() {
55      InitializeComponent();
56      treeNodes = new List<TreeNode>();
57      currentSearchString = string.Empty;
58      item = null;
59      SelectedTypeChanged += this_SelectedTypeChanged;
60    }
61
62    private void NewItemDialog_Load(object sender, EventArgs e) {
63      if (isInitialized) return;
64
65      var categories =
66        from type in ApplicationManager.Manager.GetTypes(typeof(IItem))
67        let category = CreatableAttribute.GetCategory(type)
68        let name = ItemAttribute.GetName(type)
69        let priority = CreatableAttribute.GetPriority(type)
70        let version = ItemAttribute.GetVersion(type)
71        where CreatableAttribute.IsCreatable(type)
72        orderby category, priority, name, version ascending
73        group type by category into categoryGroup
74        select categoryGroup;
75
76      var rootNode = CreateCategoryTree(categories);
77      CreateItemNodes(rootNode, categories);
78
79      foreach (TreeNode topNode in rootNode.Nodes)
80        treeNodes.Add(topNode);
81      foreach (var node in treeNodes)
82        typesTreeView.Nodes.Add((TreeNode)node.Clone());
83
84      typesTreeView.TreeViewNodeSorter = new ItemTreeNodeComparer();
85      typesTreeView.Sort();
86
87      isInitialized = true;
88    }
89
90    private TreeNode CreateCategoryTree(IEnumerable<IGrouping<string, Type>> categories) {
91      imageList.Images.Add(HeuristicLab.Common.Resources.VSImageLibrary.Class);      // default icon
92      imageList.Images.Add(HeuristicLab.Common.Resources.VSImageLibrary.Namespace);  // plugins
93
94      var rootNode = new TreeNode();
95
96      foreach (var category in categories) {
97        var fullName = category.Key;
98        var tokens = fullName.Split('#');
99        var name = tokens.Last();
100        var parents = tokens.Take(tokens.Length - 1);
101
102        var categoryNode = new TreeNode(name, 1, 1) {
103          Name = fullName,
104          Tag = fullName
105        };
106
107        var parentNode = FindOrCreateParentNode(rootNode, parents);
108        if (parentNode != null)
109          parentNode.Nodes.Add(categoryNode);
110        else
111          rootNode.Nodes.Add(categoryNode);
112      }
113
114      return rootNode;
115    }
116    private TreeNode FindOrCreateParentNode(TreeNode node, IEnumerable<string> parentCategories) {
117      TreeNode parentNode = null;
118      string fullName = null;
119      foreach (string parentCategory in parentCategories) {
120        fullName = fullName == null ? parentCategory : fullName + "#" + parentCategory;
121        parentNode = node.Nodes.Find(fullName, searchAllChildren: false).SingleOrDefault();
122        if (parentNode == null) {
123          parentNode = new TreeNode(parentCategory, 1, 1) {
124            Name = fullName,
125            Tag = fullName
126          };
127          node.Nodes.Add(parentNode);
128        }
129        node = parentNode;
130      }
131      return parentNode;
132    }
133    private void CreateItemNodes(TreeNode node, IEnumerable<IGrouping<string, Type>> categories) {
134      foreach (var category in categories) {
135        var categoryNode = node.Nodes.Find(category.Key, searchAllChildren: true).Single();
136        foreach (var creatable in category) {
137          var itemNode = CreateItemNode(creatable);
138          itemNode.Name = itemNode.Name + ":" + category.Key;
139          categoryNode.Nodes.Add(itemNode);
140        }
141      }
142    }
143    private TreeNode CreateItemNode(Type creatable) {
144      string name = ItemAttribute.GetName(creatable);
145
146      var itemNode = new TreeNode(name) {
147        ImageIndex = 0,
148        Tag = creatable,
149        Name = name
150      };
151
152      var image = ItemAttribute.GetImage(creatable);
153      if (image != null) {
154        imageList.Images.Add(image);
155        itemNode.ImageIndex = imageList.Images.Count - 1;
156      }
157      itemNode.SelectedImageIndex = itemNode.ImageIndex;
158
159      return itemNode;
160    }
161
162    private void NewItemDialog_Shown(object sender, EventArgs e) {
163      searchTextBox.Text = string.Empty;
164      searchTextBox.Focus();
165      SelectedType = null;
166      typesTreeView.SelectedNode = null;
167      typesTreeView.CollapseAll();
168      UpdateDescription();
169    }
170
171    public virtual void Filter(string searchString) {
172      if (InvokeRequired) {
173        Invoke(new Action<string>(Filter), searchString);
174      } else {
175        searchString = searchString.ToLower();
176
177        if (!searchString.Contains(currentSearchString)) {
178          typesTreeView.BeginUpdate();
179          // expand search -> restore all tree nodes
180          var selectedNode = typesTreeView.SelectedNode;
181          typesTreeView.Nodes.Clear();
182          foreach (TreeNode node in treeNodes)
183            typesTreeView.Nodes.Add((TreeNode)node.Clone());
184          RestoreSelectedNode(selectedNode);
185          typesTreeView.EndUpdate();
186        }
187
188        // remove nodes
189        typesTreeView.BeginUpdate();
190        var searchTokens = searchString.Split(' ');
191
192        int i = 0;
193        while (i < typesTreeView.Nodes.Count) {
194          var categoryNode = typesTreeView.Nodes[i];
195          bool remove = FilterNode(categoryNode, searchTokens);
196          if (remove)
197            typesTreeView.Nodes.RemoveAt(i);
198          else i++;
199        }
200        typesTreeView.EndUpdate();
201        currentSearchString = searchString;
202
203        // select first item
204        var firstNode = FirstVisibleNode;
205        while (firstNode != null && !(firstNode.Tag is Type))
206          firstNode = firstNode.NextVisibleNode;
207        if (firstNode != null)
208          typesTreeView.SelectedNode = firstNode;
209
210        if (typesTreeView.Nodes.Count == 0) {
211          SelectedType = null;
212          typesTreeView.Enabled = false;
213        } else {
214          SetTreeNodeVisibility();
215          typesTreeView.Enabled = true;
216        }
217        UpdateDescription();
218      }
219    }
220
221    private bool FilterNode(TreeNode node, string[] searchTokens) {
222      if (node.Tag is string) { // Category node
223        int i = 0;
224        while (i < node.Nodes.Count) {
225          bool remove = FilterNode(node.Nodes[i], searchTokens);
226          if (remove)
227            node.Nodes.RemoveAt(i);
228          else i++;
229        }
230        return node.Nodes.Count == 0;
231      }
232      if (node.Tag is Type) { // Type node
233        var text = node.Text;
234        if (searchTokens.Any(searchToken => !text.ToLower().Contains(searchToken))) {
235          var typeTag = (Type)node.Tag;
236          if (typeTag.Equals(SelectedType)) {
237            SelectedType = null;
238            typesTreeView.SelectedNode = null;
239          }
240          return true;
241        }
242        return false;
243      }
244      return true;
245    }
246
247    protected virtual void UpdateDescription() {
248      itemDescriptionTextBox.Text = string.Empty;
249      pluginDescriptionTextBox.Text = string.Empty;
250      pluginTextBox.Text = string.Empty;
251      versionTextBox.Text = string.Empty;
252
253      if (typesTreeView.SelectedNode != null) {
254        string category = typesTreeView.SelectedNode.Tag as string;
255        if (category != null) {
256          itemDescriptionTextBox.Text = category;
257        }
258        Type type = typesTreeView.SelectedNode.Tag as Type;
259        if (type != null) {
260          string description = ItemAttribute.GetDescription(type);
261          var version = ItemAttribute.GetVersion(type);
262          var plugin = ApplicationManager.Manager.GetDeclaringPlugin(type);
263          if (description != null)
264            itemDescriptionTextBox.Text = description;
265          if (plugin != null) {
266            pluginTextBox.Text = plugin.Name;
267            pluginDescriptionTextBox.Text = plugin.Description;
268          }
269          if (version != null)
270            versionTextBox.Text = version.ToString();
271        }
272      } else if (typesTreeView.Nodes.Count == 0) {
273        itemDescriptionTextBox.Text = "No types found";
274      }
275    }
276
277    #region Events
278    public event EventHandler SelectedTypeChanged;
279    protected virtual void OnSelectedTypeChanged() {
280      if (SelectedTypeChanged != null)
281        SelectedTypeChanged(this, EventArgs.Empty);
282    }
283    #endregion
284
285    #region Control Events
286    protected virtual void searchTextBox_TextChanged(object sender, EventArgs e) {
287      Filter(searchTextBox.Text);
288    }
289
290    protected virtual void itemsTreeView_AfterSelect(object sender, TreeViewEventArgs e) {
291      if (typesTreeView.SelectedNode == null) SelectedType = null;
292      else SelectedType = typesTreeView.SelectedNode.Tag as Type;
293      UpdateDescription();
294    }
295
296    protected virtual void itemsTreeView_VisibleChanged(object sender, EventArgs e) {
297      if (Visible) SetTreeNodeVisibility();
298    }
299    #endregion
300
301    #region Helpers
302    private void RestoreSelectedNode(TreeNode selectedNode) {
303      if (selectedNode != null) {
304        var node = typesTreeView.Nodes.Find(selectedNode.Name, searchAllChildren: true).SingleOrDefault();
305        typesTreeView.SelectedNode = node;
306        if (typesTreeView.SelectedNode == null) SelectedType = null;
307      }
308    }
309    private void SetTreeNodeVisibility() {
310      TreeNode selectedNode = typesTreeView.SelectedNode;
311      if (string.IsNullOrEmpty(currentSearchString) && (typesTreeView.Nodes.Count > 1)) {
312        typesTreeView.CollapseAll();
313        if (selectedNode != null) typesTreeView.SelectedNode = selectedNode;
314      } else {
315        typesTreeView.ExpandAll();
316      }
317      if (selectedNode != null) selectedNode.EnsureVisible();
318    }
319    #endregion
320
321    private void okButton_Click(object sender, EventArgs e) {
322      if (SelectedType != null) {
323        item = (IItem)Activator.CreateInstance(SelectedType);
324        DialogResult = DialogResult.OK;
325        Close();
326      }
327    }
328    private void itemTreeView_DoubleClick(object sender, EventArgs e) {
329      if (SelectedType != null) {
330        item = (IItem)Activator.CreateInstance(SelectedType);
331        DialogResult = DialogResult.OK;
332        Close();
333      }
334    }
335    private void this_SelectedTypeChanged(object sender, EventArgs e) {
336      okButton.Enabled = SelectedType != null;
337    }
338
339    private void expandAllButton_Click(object sender, EventArgs e) {
340      typesTreeView.ExpandAll();
341    }
342    private void collapseAllButton_Click(object sender, EventArgs e) {
343      typesTreeView.CollapseAll();
344    }
345
346    private TreeNode toolStripMenuNode = null;
347    private void typesTreeView_MouseDown(object sender, MouseEventArgs e) {
348      if (e.Button == MouseButtons.Right) {
349        Point coordinates = typesTreeView.PointToClient(Cursor.Position);
350        toolStripMenuNode = typesTreeView.GetNodeAt(coordinates);
351
352        if (toolStripMenuNode != null && coordinates.X >= toolStripMenuNode.Bounds.Left &&
353            coordinates.X <= toolStripMenuNode.Bounds.Right) {
354          typesTreeView.SelectedNode = toolStripMenuNode;
355
356          expandToolStripMenuItem.Enabled =
357            expandToolStripMenuItem.Visible = !toolStripMenuNode.IsExpanded && toolStripMenuNode.Nodes.Count > 0;
358          collapseToolStripMenuItem.Enabled = collapseToolStripMenuItem.Visible = toolStripMenuNode.IsExpanded;
359        } else {
360          expandToolStripMenuItem.Enabled = expandToolStripMenuItem.Visible = false;
361          collapseToolStripMenuItem.Enabled = collapseToolStripMenuItem.Visible = false;
362        }
363        expandAllToolStripMenuItem.Enabled =
364          expandAllToolStripMenuItem.Visible =
365            !typesTreeView.Nodes.OfType<TreeNode>().All(x => TreeNodeIsFullyExpanded(x));
366        collapseAllToolStripMenuItem.Enabled =
367          collapseAllToolStripMenuItem.Visible = typesTreeView.Nodes.OfType<TreeNode>().Any(x => x.IsExpanded);
368        if (contextMenuStrip.Items.Cast<ToolStripMenuItem>().Any(item => item.Enabled))
369          contextMenuStrip.Show(Cursor.Position);
370      }
371    }
372    private bool TreeNodeIsFullyExpanded(TreeNode node) {
373      return (node.Nodes.Count == 0) || (node.IsExpanded && node.Nodes.OfType<TreeNode>().All(x => TreeNodeIsFullyExpanded(x)));
374    }
375
376    private void expandToolStripMenuItem_Click(object sender, EventArgs e) {
377      if (toolStripMenuNode != null) toolStripMenuNode.ExpandAll();
378    }
379    private void expandAllToolStripMenuItem_Click(object sender, EventArgs e) {
380      typesTreeView.ExpandAll();
381    }
382    private void collapseToolStripMenuItem_Click(object sender, EventArgs e) {
383      if (toolStripMenuNode != null) toolStripMenuNode.Collapse();
384    }
385    private void collapseAllToolStripMenuItem_Click(object sender, EventArgs e) {
386      typesTreeView.CollapseAll();
387    }
388
389    private void clearSearchButton_Click(object sender, EventArgs e) {
390      searchTextBox.Text = string.Empty;
391      searchTextBox.Focus();
392    }
393
394    private void searchTextBox_KeyDown(object sender, KeyEventArgs e) {
395      if (typesTreeView.Nodes.Count == 0)
396        return;
397
398      if (e.KeyCode == Keys.Up || e.KeyCode == Keys.Down) {
399        var selectedNode = typesTreeView.SelectedNode;
400
401        if (selectedNode == null) { // nothing selected => select first or last
402          if (e.KeyCode == Keys.Down) typesTreeView.SelectedNode = FirstVisibleNode;
403          if (e.KeyCode == Keys.Up) typesTreeView.SelectedNode = LastVisibleNode;
404        } else {
405          if (e.KeyCode == Keys.Down)
406            typesTreeView.SelectedNode = selectedNode.NextVisibleNode ?? FirstVisibleNode; // select next or cycle to first
407          if (e.KeyCode == Keys.Up)
408            typesTreeView.SelectedNode = selectedNode.PrevVisibleNode ?? LastVisibleNode; // select prev or cycle to last
409        }
410        e.Handled = true;
411      }
412    }
413
414    private TreeNode FirstVisibleNode {
415      get {
416        return typesTreeView.Nodes.Count > 0 ? typesTreeView.Nodes[0] : null;
417      }
418    }
419    private TreeNode LastVisibleNode {
420      get {
421        var node = FirstVisibleNode;
422        while (node != null && node.NextVisibleNode != null) node = node.NextVisibleNode;
423        return node;
424      }
425    }
426
427    private class ItemTreeNodeComparer : IComparer {
428      public int Compare(object x, object y) {
429        var lhs = (TreeNode)x;
430        var rhs = (TreeNode)y;
431
432        if (lhs.Tag is string && rhs.Tag is string) {
433          return lhs.Name.CompareTo(rhs.Name);
434        } else if (lhs.Tag is string) {
435          return -1;
436        } else
437          return 1;
438      }
439    }
440  }
441}
Note: See TracBrowser for help on using the repository browser.