Free cookie consent management tool by TermsFeed Policy Generator

source: trunk/sources/HeuristicLab.MainForm/3.3/Interfaces/IProgress.cs @ 11970

Last change on this file since 11970 was 11171, checked in by ascheibe, 10 years ago

#2115 merged r11170 (copyright update) into trunk

File size: 3.3 KB
Line 
1#region License Information
2/* HeuristicLab
3 * Copyright (C) 2002-2014 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 HeuristicLab.Common;
24
25namespace HeuristicLab.MainForm {
26  public enum ProgressState { Started = 1, Canceled = 2, Finished = 3 };
27
28  public interface IProgress : IContent {
29    /// <summary>
30    /// Gets or sets the currently associated status text with the progress.
31    /// </summary>
32    string Status { get; set; }
33    /// <summary>
34    /// Gets or sets the currently associated progress value in the range (0;1].
35    ///  Values outside this range are permitted and need to be handled in some feasible manner.
36    /// </summary>
37    double ProgressValue { get; set; }
38    /// <summary>
39    /// Gets or sets the current state of the progress. Every progress starts in state
40    /// Started and then becomes either Canceled or Finished.
41    /// If it is reused it may be Started again.
42    /// </summary>
43    ProgressState ProgressState { get; }
44    /// <summary>
45    /// Returns whether the operation can be canceled or not.
46    /// This can change during the course of the progress.
47    /// </summary>
48    bool CanBeCanceled { get; }
49
50    /// <summary>
51    /// Requests the operation behind the process to cancel.
52    /// Check the !ProgressState property when the cancellation succeeded.
53    /// The corresponding event will also notify of a success.
54    /// </summary>
55    /// <exception cref="NotSupportedException">Thrown when cancellation is not supported.</exception>
56    void Cancel();
57    /// <summary>
58    /// Sets the ProgressValue to 1 and the ProgressState to Finished.
59    /// </summary>
60    void Finish();
61
62    /// <summary>
63    /// Starts or restarts a Progress.
64    /// </summary>
65    void Start();
66
67    void Start(string status);
68
69    /// <summary>
70    /// The status text changed.
71    /// </summary>
72    event EventHandler StatusChanged;
73    /// <summary>
74    /// The value of the progress changed. This is the (0;1] progress value from starting to finish. Values outside this range are permitted and need to be handled in some feasible manner.
75    /// </summary>
76    event EventHandler ProgressValueChanged;
77    /// <summary>
78    /// The state of the progress changed. The handler is supposed to query the ProgressState property.
79    /// </summary>
80    event EventHandler ProgressStateChanged;
81    /// <summary>
82    /// The progress' ability to cancel changed.
83    /// </summary>
84    event EventHandler CanBeCanceledChanged;
85    /// <summary>
86    /// A cancelation is requested.
87    /// </summary>
88    event EventHandler CancelRequested;
89  }
90}
Note: See TracBrowser for help on using the repository browser.