# FarPoint.Win.ClipboardChangeNotifier

## Content

<div class="doc-site-dotnet-api-container">



  <h1 id="FarPoint_Win_ClipboardChangeNotifier" data-uid="FarPoint.Win.ClipboardChangeNotifier" class="text-break">ClipboardChangeNotifier Class
</h1>
  <div class="markdown level0 summary"><p>Provides a way to receive notifications of changes to the
content of the Clipboard using the Windows API.</p>
</div>
  <div class="markdown level0 conceptual"></div>
  <div class="inheritance">
    <h5>Inheritance</h5>
    <div class="level0"><a class="xref" href="https://learn.microsoft.com/dotnet/api/system.object">object</a></div>
    <div class="level1"><a class="xref" href="https://learn.microsoft.com/dotnet/api/system.marshalbyrefobject">MarshalByRefObject</a></div>
    <div class="level2"><a class="xref" href="https://learn.microsoft.com/dotnet/api/system.windows.forms.nativewindow">NativeWindow</a></div>
    <div class="level3"><span class="xref">ClipboardChangeNotifier</span></div>
  </div>
  <div class="implements">
    <h5>Implements</h5>
    <div><a class="xref" href="https://learn.microsoft.com/dotnet/api/system.windows.forms.iwin32window">IWin32Window</a></div>
    <div><a class="xref" href="https://learn.microsoft.com/dotnet/api/system.idisposable">IDisposable</a></div>
  </div>
  <h6><strong>Namespace</strong>: <a class="xref" href="FarPoint.Win.html">FarPoint.Win</a></h6>
  <h6><strong>Assembly</strong>: FarPoint.Win.dll</h6>
  <h5 id="FarPoint_Win_ClipboardChangeNotifier_syntax">Syntax</h5>
  <div class="codewrapper">
    <pre><code class="lang-csharp hljs">public class ClipboardChangeNotifier : NativeWindow, IWin32Window, IDisposable</code></pre>
  </div>
  <div class="codewrapper">
    <pre><code class="lang-vbnet hljs">Public Class ClipboardChangeNotifier
    Inherits NativeWindow
    Implements IWin32Window, IDisposable</code></pre>
  </div>
  <h5 id="FarPoint_Win_ClipboardChangeNotifier_remarks"><strong>Remarks</strong></h5>
  <div class="markdown level0 remarks"><p>To be a part of the change notification you need to register a
window in the Clipboard Viewer Chain.  This provides
notification messages to the window whenever the
Clipboard changes, and also messages associated with managing
the chain.  This class manages the detail of keeping the
chain intact and ensuring that the application is removed
from the chain at the right point.</p>
</div>
  <h3 id="constructors">Constructors
</h3>
  <table class="table table-bordered table-condensed">
    <thead>
      <tr>
        <th>Name</th>
        <th>Description</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td id="FarPoint_Win_ClipboardChangeNotifier__ctor" data-uid="FarPoint.Win.ClipboardChangeNotifier.#ctor">
          <a class="xref" href="FarPoint.Win.ClipboardChangeNotifier.-ctor.html#FarPoint_Win_ClipboardChangeNotifier__ctor">ClipboardChangeNotifier()</a>
        </td>
        <td class="markdown level1 summary"><p>Constructs a new instance of this class.</p>
</td>
      </tr>
    </tbody>
  </table>
  <h3 id="fields">Fields
</h3>
  <table class="table table-bordered table-condensed">
    <thead>
      <tr>
        <th>Name</th>
        <th>Description</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td id="FarPoint_Win_ClipboardChangeNotifier_disposed" data-uid="FarPoint.Win.ClipboardChangeNotifier.disposed">
          <a class="xref" href="FarPoint.Win.ClipboardChangeNotifier.disposed.html">disposed</a>
        </td>
        <td class="markdown level1 summary"><p>Whether this class has been disposed or not.</p>
</td>
      </tr>
      <tr>
        <td id="FarPoint_Win_ClipboardChangeNotifier_installedHandle" data-uid="FarPoint.Win.ClipboardChangeNotifier.installedHandle">
          <a class="xref" href="FarPoint.Win.ClipboardChangeNotifier.installedHandle.html">installedHandle</a>
        </td>
        <td class="markdown level1 summary"><p>Window for which Clipboard change notification was installed.</p>
</td>
      </tr>
      <tr>
        <td id="FarPoint_Win_ClipboardChangeNotifier_nextViewerHandle" data-uid="FarPoint.Win.ClipboardChangeNotifier.nextViewerHandle">
          <a class="xref" href="FarPoint.Win.ClipboardChangeNotifier.nextViewerHandle.html">nextViewerHandle</a>
        </td>
        <td class="markdown level1 summary"><p>The next handle in the Clipboard viewer chain when the
Clipboard notification is installed, otherwise <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.intptr.zero">Zero</a>.</p>
</td>
      </tr>
    </tbody>
  </table>
  <h3 id="methods">Methods
</h3>
  <table class="table table-bordered table-condensed">
    <thead>
      <tr>
        <th>Name</th>
        <th>Description</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td id="FarPoint_Win_ClipboardChangeNotifier_Dispose" data-uid="FarPoint.Win.ClipboardChangeNotifier.Dispose">
          <a class="xref" href="FarPoint.Win.ClipboardChangeNotifier.Dispose.html#FarPoint_Win_ClipboardChangeNotifier_Dispose">Dispose()</a>
        </td>
        <td class="markdown level1 summary"><p>Uninstalls Clipboard event notifications if necessary
during dispose of this object.</p>
</td>
      </tr>
      <tr>
        <td id="FarPoint_Win_ClipboardChangeNotifier_Install" data-uid="FarPoint.Win.ClipboardChangeNotifier.Install">
          <a class="xref" href="FarPoint.Win.ClipboardChangeNotifier.Install.html#FarPoint_Win_ClipboardChangeNotifier_Install">Install()</a>
        </td>
        <td class="markdown level1 summary"><p>Installs Clipboard change notification.<br>
The AssignHandle method of this class must have been called first.</p>
</td>
      </tr>
      <tr>
        <td id="FarPoint_Win_ClipboardChangeNotifier_OnClipboardChanged_System_EventArgs_" data-uid="FarPoint.Win.ClipboardChangeNotifier.OnClipboardChanged(System.EventArgs)">
          <a class="xref" href="FarPoint.Win.ClipboardChangeNotifier.OnClipboardChanged.html#FarPoint_Win_ClipboardChangeNotifier_OnClipboardChanged_System_EventArgs_">OnClipboardChanged(EventArgs)</a>
        </td>
        <td class="markdown level1 summary"><p>Raises the <code>ClipboardChanged</code> event.</p>
</td>
      </tr>
      <tr>
        <td id="FarPoint_Win_ClipboardChangeNotifier_OnHandleChange" data-uid="FarPoint.Win.ClipboardChangeNotifier.OnHandleChange">
          <a class="xref" href="FarPoint.Win.ClipboardChangeNotifier.OnHandleChange.html#FarPoint_Win_ClipboardChangeNotifier_OnHandleChange">OnHandleChange()</a>
        </td>
        <td class="markdown level1 summary"><p>Responds to Window Handle change events and uninstalls
the Clipboard change notification if it is installed.</p>
</td>
      </tr>
      <tr>
        <td id="FarPoint_Win_ClipboardChangeNotifier_Uninstall" data-uid="FarPoint.Win.ClipboardChangeNotifier.Uninstall">
          <a class="xref" href="FarPoint.Win.ClipboardChangeNotifier.Uninstall.html#FarPoint_Win_ClipboardChangeNotifier_Uninstall">Uninstall()</a>
        </td>
        <td class="markdown level1 summary"><p>Uninstalls Clipboard change notification.</p>
</td>
      </tr>
      <tr>
        <td id="FarPoint_Win_ClipboardChangeNotifier_WndProc_System_Windows_Forms_Message__" data-uid="FarPoint.Win.ClipboardChangeNotifier.WndProc(System.Windows.Forms.Message@)">
          <a class="xref" href="FarPoint.Win.ClipboardChangeNotifier.WndProc.html#FarPoint_Win_ClipboardChangeNotifier_WndProc_System_Windows_Forms_Message__">WndProc(ref Message)</a>
        </td>
        <td class="markdown level1 summary"><p>Provides default WndProc processing and responds to
Clipboard change notifications.</p>
</td>
      </tr>
    </tbody>
  </table>
  <h3 id="events">Events
</h3>
  <table class="table table-bordered table-condensed">
    <thead>
      <tr>
        <th>Name</th>
        <th>Description</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td id="FarPoint_Win_ClipboardChangeNotifier_ClipboardChanged" data-uid="FarPoint.Win.ClipboardChangeNotifier.ClipboardChanged">
          <a class="xref" href="FarPoint.Win.ClipboardChangeNotifier.ClipboardChanged.html">ClipboardChanged</a>
        </td>
        <td class="markdown level1 summary"><p>Notifies of a change to the clipboard's content.</p>
</td>
      </tr>
    </tbody>
  </table>

</div>
