aboutsummaryrefslogtreecommitdiffstats
path: root/Software/Visual_Studio/MachineStudio/Tango.MachineStudio.Common/StudioApplication/IStudioApplicationManager.cs
blob: fabe3e02fb281cf7ec61d5254aa266c3c570f11a (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
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows;
using Tango.BL.Entities;
using Tango.Integration.ExternalBridge;

namespace Tango.MachineStudio.Common.StudioApplication
{
    /// <summary>
    /// Represents the Machine Studio application manager.
    /// </summary>
    public interface IStudioApplicationManager : INotifyPropertyChanged
    {
        /// <summary>
        /// Occurs when the application is ready.
        /// </summary>
        event EventHandler ApplicationReady;

        /// <summary>
        /// Occurs when the connected machine session has been lost and an automatic reconnection with the last machine is required.
        /// </summary>
        event EventHandler ReconnectionRequired;

        /// <summary>
        /// Occurs when the connected machine property has changed.
        /// </summary>
        event EventHandler<IExternalBridgeClient> ConnectedMachineChanged;

        /// <summary>
        /// Gets a value indicating whether Machine Studio is shutting down.
        /// </summary>
        bool IsShuttingDown { get; }

        /// <summary>
        /// Shutdown the application.
        /// </summary>
        void ShutDown();

        /// <summary>
        /// Gets or sets the currently connected machine if any.
        /// </summary>
        IExternalBridgeClient ConnectedMachine { get; }

        /// <summary>
        /// Gets or sets the machine.
        /// </summary>
        Machine Machine { get; }

        /// <summary>
        /// Gets a value indicating whether the <see cref="ConnectedMachine"/> is valid.
        /// </summary>
        bool IsMachineConnected { get; }

        /// <summary>
        /// Gets a value indicating whether the <see cref="ConnectedMachine"/> is valid and connected through TCP/IP.
        /// </summary>
        bool IsMachineConnectedViaTCP { get; }

        /// <summary>
        /// Gets the machine studio application version.
        /// </summary>
        Version Version { get; }

        /// <summary>
        /// Gets the core libraries version.
        /// </summary>
        Version CoreVersion { get; }

        /// <summary>
        /// Gets the build date.
        /// </summary>
        String BuildDate { get; }

        /// <summary>
        /// Gets the change log.
        /// </summary>
        String ChangeLog { get;  }

        /// <summary>
        /// Notify the application manager about an external opened window.
        /// When application exists. All registered windows will be closed.
        /// </summary>
        /// <param name="window">The window.</param>
        void RegisterOpenedWindow(Window window);

        /// <summary>
        /// Raises the application ready event.
        /// </summary>
        void NotifyApplicationReady();

        /// <summary>
        /// Sets the connected machine.
        /// </summary>
        /// <param name="connectedMachine">The connected machine.</param>
        void SetConnectedMachine(IExternalBridgeClient connectedMachine);
    }
}
span class="c1">/// The length of the segment (do not confuse with nodeLength). /// </summary> internal int segmentLength; /// <summary> /// distanceToMaxEnd = Max(segmentLength, /// left.distanceToMaxEnd + left.Offset - Offset, /// left.distanceToMaxEnd + right.Offset - Offset) /// </summary> internal int distanceToMaxEnd; int ISegment.Offset { get { return StartOffset; } } /// <summary> /// Gets whether this segment is connected to a TextSegmentCollection and will automatically /// update its offsets. /// </summary> protected bool IsConnectedToCollection { get { return ownerTree != null; } } /// <summary> /// Gets/Sets the start offset of the segment. /// </summary> /// <remarks> /// When setting the start offset, the end offset will change, too: the Length of the segment will stay constant. /// </remarks> public int StartOffset { get { // If the segment is not connected to a tree, we store the offset in "nodeLength". // Otherwise, "nodeLength" contains the distance to the start offset of the previous node Debug.Assert(!(ownerTree == null && parent != null)); Debug.Assert(!(ownerTree == null && left != null)); TextSegment n = this; int offset = n.nodeLength; if (n.left != null) offset += n.left.totalNodeLength; while (n.parent != null) { if (n == n.parent.right) { if (n.parent.left != null) offset += n.parent.left.totalNodeLength; offset += n.parent.nodeLength; } n = n.parent; } return offset; } set { if (value < 0) throw new ArgumentOutOfRangeException("value", "Offset must not be negative"); if (this.StartOffset != value) { // need a copy of the variable because ownerTree.Remove() sets this.ownerTree to null ISegmentTree ownerTree = this.ownerTree; if (ownerTree != null) { ownerTree.Remove(this); nodeLength = value; ownerTree.Add(this); } else { nodeLength = value; } OnSegmentChanged(); } } } /// <summary> /// Gets/Sets the end offset of the segment. /// </summary> /// <remarks> /// Setting the end offset will change the length, the start offset will stay constant. /// </remarks> public int EndOffset { get { return StartOffset + Length; } set { int newLength = value - StartOffset; if (newLength < 0) throw new ArgumentOutOfRangeException("value", "EndOffset must be greater or equal to StartOffset"); Length = newLength; } } /// <summary> /// Gets/Sets the length of the segment. /// </summary> /// <remarks> /// Setting the length will change the end offset, the start offset will stay constant. /// </remarks> public int Length { get { return segmentLength; } set { if (value < 0) throw new ArgumentOutOfRangeException("value", "Length must not be negative"); if (segmentLength != value) { segmentLength = value; if (ownerTree != null) ownerTree.UpdateAugmentedData(this); OnSegmentChanged(); } } } /// <summary> /// This method gets called when the StartOffset/Length/EndOffset properties are set. /// It is not called when StartOffset/Length/EndOffset change due to document changes /// </summary> protected virtual void OnSegmentChanged() { } internal TextSegment LeftMost { get { TextSegment node = this; while (node.left != null) node = node.left; return node; } } internal TextSegment RightMost { get { TextSegment node = this; while (node.right != null) node = node.right; return node; } } /// <summary> /// Gets the inorder successor of the node. /// </summary> internal TextSegment Successor { get { if (right != null) { return right.LeftMost; } else { TextSegment node = this; TextSegment oldNode; do { oldNode = node; node = node.parent; // go up until we are coming out of a left subtree } while (node != null && node.right == oldNode); return node; } } } /// <summary> /// Gets the inorder predecessor of the node. /// </summary> internal TextSegment Predecessor { get { if (left != null) { return left.RightMost; } else { TextSegment node = this; TextSegment oldNode; do { oldNode = node; node = node.parent; // go up until we are coming out of a right subtree } while (node != null && node.left == oldNode); return node; } } } #if DEBUG internal string ToDebugString() { return "[nodeLength=" + nodeLength + " totalNodeLength=" + totalNodeLength + " distanceToMaxEnd=" + distanceToMaxEnd + " MaxEndOffset=" + (StartOffset + distanceToMaxEnd) + "]"; } #endif /// <inheritdoc/> public override string ToString() { return "[" + GetType().Name + " Offset=" + StartOffset + " Length=" + Length + " EndOffset=" + EndOffset + "]"; } } }