Added the property 'ObserveLastEntry' that enables/disables auto-pick…

…ing of the last clipboard item once monitoring is enabled.

README.md

@@ -1,5 +1,5 @@
 # SharpClipboard
-[![sc-nuget](/Assets/nuget-package-2.0.5-brightgreen.svg)](https://www.nuget.org/packages/SharpClipboard/) [![sc-donate](/Assets/Donate-PayPal-blue.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=DJ8D9CE8BWA3J&source=url)
+[![sc-nuget](/Assets/nuget-package-2.0.7-brightgreen.svg)](https://www.nuget.org/packages/SharpClipboard/) [![sc-donate](/Assets/Donate-PayPal-blue.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=DJ8D9CE8BWA3J&source=url)
 
 **SharpClipboard** is a clipboard-monitoring library for .NET that listens to the system's clipboard entries,
 allowing developers to tap into the rich capabilities of determining the clipboard's contents at runtime.
@@ -12,7 +12,7 @@ Here's a screenshot and below a usage-preview of the library's features:
 # Installation
 To install via the NuGet Package Manager Console, type:
 
-> `Install-Package SharpClipboard -Version 2.0.5`
+> `Install-Package SharpClipboard -Version 2.0.7`
 
 You can also [download](https://github.com/Willy-Kimura/SharpClipboard/releases/download/v2.0.5/SharpClipboard.dll) the assembly and add it to Visual Studio's Toolbox; plus not forgetting its [documentation](https://github.com/Willy-Kimura/SharpClipboard/releases/download/v2.0.5/SharpClipboard.xml).
 

SharpClipboard/Properties/AssemblyInfo.cs

@@ -32,5 +32,5 @@
 // You can specify all the values or you can default the Build and Revision Numbers
 // by using the '*' as shown below:
 // [assembly: AssemblyVersion("1.0.*")]
-[assembly: AssemblyVersion("2.0.5.0")]
-[assembly: AssemblyFileVersion("2.0.5.0")]
+[assembly: AssemblyVersion("2.0.7.0")]
+[assembly: AssemblyFileVersion("2.0.7.0")]

SharpClipboard/SharpClipboard.cs

@@ -23,7 +23,6 @@
 using System.Runtime.InteropServices;
 
 using WK.Libraries.SharpClipboardNS.Views;
-using System.Text;
 
 namespace WK.Libraries.SharpClipboardNS
 {
@@ -59,14 +58,10 @@ public SharpClipboard(IContainer container)
         #endregion
 
         #region Fields
-
+    
         private bool _monitorClipboard;
+        private bool _observeLastEntry;
 
-        private string _clipboardText;
-        private string _clipboardFile;
-        private List<string> _clipboardFiles = new List<string>();
-
-        private Image _clipboardImage;
         private Timer _timer = new Timer();
         private ClipboardHandle _handle = new ClipboardHandle();
         private ObservableDataFormats _observableFormats = new ObservableDataFormats();
@@ -104,7 +99,7 @@ public enum ContentTypes
         #endregion
 
         #region Properties
-
+    
         #region Browsable
 
         /// <summary>
@@ -125,6 +120,28 @@ public bool MonitorClipboard
             }
         }
 
+        /// <summary>
+        /// When set to true, the last cut/copied clipboard item will
+        /// not be auto-picked once monitoring is enabled. However when 
+        /// set to false, the last cut/copied clipboard item will be 
+        /// auto-picked once monitoring is enabled.
+        /// </summary>
+        [Category("#Clipboard: Behaviour")]
+        [Description("When set to true, the last cut/copied clipboard item will " +
+                     "not be auto-picked once monitoring is enabled. However when " +
+                     "set to false, the last cut/copied clipboard item will be " +
+                     "auto-picked once monitoring is enabled.")]
+        public bool ObserveLastEntry
+        {
+            get { return _observeLastEntry; }
+            set {
+
+                _observeLastEntry = value;
+                ObserveLastEntryChanged?.Invoke(this, EventArgs.Empty);
+
+            }
+        }
+
         /// <summary>
         /// Gets or sets the data formats that will be observed
         /// or monitored when cut/copy actions are triggered.
@@ -163,41 +180,25 @@ public ObservableDataFormats ObservableFormats
         /// Gets the currently cut/copied clipboard text.
         /// </summary>
         [Browsable(false)]
-        public string ClipboardText
-        {
-            get { return _clipboardText; }
-            internal set { _clipboardText = value; }
-        }
+        public string ClipboardText { get; internal set; }
 
         /// <summary>
         /// Gets the currently cut/copied clipboard file-path.
         /// </summary>
         [Browsable(false)]
-        public string ClipboardFile
-        {
-            get { return _clipboardFile; }
-            internal set { _clipboardFile = value; }
-        }
+        public string ClipboardFile { get; internal set; }
 
         /// <summary>
         /// Gets the currently cut/copied clipboard file-paths.
         /// </summary>
         [Browsable(false)]
-        public List<string> ClipboardFiles
-        {
-            get { return _clipboardFiles; }
-            internal set { _clipboardFiles = value; }
-        }
+        public List<string> ClipboardFiles { get; internal set; } = new List<string>();
 
         /// <summary>
         /// Gets the currently cut/copied clipboard image.
         /// </summary>
         [Browsable(false)]
-        public Image ClipboardImage
-        {
-            get { return _clipboardImage; }
-            internal set { _clipboardImage = value; }
-        }
+        public Image ClipboardImage { get; internal set; }
 
         #endregion
 
@@ -214,8 +215,9 @@ private void SetDefaults()
             _timer.Enabled = true;
             _timer.Interval = 1000;
             _timer.Tick += OnLoad;
-
+        
             MonitorClipboard = true;
+            ObserveLastEntry = true;
         }
 
         [DllImport("user32.dll")]
@@ -295,6 +297,13 @@ internal void Invoke(object content, ContentTypes type, SourceApplication source
         [Description("Occurs whenever the allowed observable formats have been changed.")]
         public event EventHandler<EventArgs> ObservableFormatsChanged = null;
 
+        /// <summary>
+        /// Occurs whenever the 'ObserveLastEntry' property has been changed.
+        /// </summary>
+        [Category("#Clipboard: Events")]
+        [Description("Occurs whenever the allowed observable formats have been changed.")]
+        public event EventHandler<EventArgs> ObserveLastEntryChanged = null;
+
         #endregion
 
         #region Event Arguments

SharpClipboard/Views/ClipboardHandle.cs

@@ -1,28 +1,34 @@
 /*
  * The SharpClipboard Handle.
- * ----------------------------------------
+ * ---------------------------------------+
  * Please preserve this window.
  * It acts as the message-processing
  * handle with regards to the clipboard. 
  *
  * The window however will not be visible
  * to the users both via the Taskbar or 
  * the Task Manager so don't you worry :)
- * ----------------------------------------
+ * ---------------------------------------+
  * 
  */
 
 
 using System;
 using System.Text;
 using System.Drawing;
+using System.Diagnostics;
 using System.Windows.Forms;
 using System.ComponentModel;
 using System.Runtime.InteropServices;
-using System.Diagnostics;
 
 namespace WK.Libraries.SharpClipboardNS.Views
 {
+    /// <summary>
+    /// This window acts as a handle to the clipboard-monitoring process and 
+    /// thus will be launched in the background once the component has started 
+    /// the monitoring service. However, it won't be visible to anyone even via 
+    /// the Task Manager.
+    /// </summary>
     public partial class ClipboardHandle : Form
     {
         #region Constructor
@@ -41,6 +47,8 @@ public ClipboardHandle()
         const int WM_DRAWCLIPBOARD = 0x0308;
         const int WM_CHANGECBCHAIN = 0x030D;
 
+        private bool _ready;
+
         private string _processName = string.Empty;
         private string _executableName = string.Empty;
         private string _executablePath = string.Empty;
@@ -49,12 +57,31 @@ public ClipboardHandle()
 
         #region Properties
 
+        /// <summary>
+        /// Checks if the handle is ready to monitor the system clipboard.
+        /// It is used to provide a final value for use whenever the property 
+        /// 'ObserveLastEntry' is enabled.
+        /// </summary>
+        [Browsable(false)]
+        internal bool Ready
+        {
+            get {
+
+                if (SharpClipboardInstance.ObserveLastEntry)
+                    _ready = true;
+
+                return _ready;
+
+            }
+            set { _ready = value; }
+        }
+
         /// <summary>
         /// Gets or sets an active <see cref="SharpClipboard"/> instance
         /// for use when managing the current clipboard handle.
         /// </summary>
         [Browsable(false)]
-        public SharpClipboard SharpClipboardInstance { get; set; }
+        internal SharpClipboard SharpClipboardInstance { get; set; }
 
         #endregion
 
@@ -111,7 +138,7 @@ protected override void WndProc(ref Message m)
                 case WM_DRAWCLIPBOARD:
 
                     // If clipboard-monitoring is enabled, proceed to listening.
-                    if (SharpClipboardInstance.MonitorClipboard)
+                    if (Ready && SharpClipboardInstance.MonitorClipboard)
                     {
                         IDataObject dataObj = Clipboard.GetDataObject();
 
@@ -271,6 +298,7 @@ private void OnLoad(object sender, EventArgs e)
         {
             // Start listening for clipboard changes.
             _chainedWnd = SetClipboardViewer(this.Handle);
+            Ready = true;
         }
 
         private void OnFormClosing(object sender, FormClosingEventArgs e)