PIAnnotationEditor Control



The PI Annotations editor for Recorded (Compressed) Values consists of a Tagname, event value, event timestamp and a table (DataGrid) for the current annotation.

The DataGrid is the main component of the control, it shows the most important details of the annotation.


What the control looks like in the Visual Studio.NET toolbox.



What the control looks like in an application.



When to Use This Control

The PIAnnotationEditor control can be used to view and maintain annotations for a specified Archive/Compressed value.


How to Use This Control

Site this control on a Windows Form (see instructions below) and set the properties to match your application.


Configuration Options

The control has numerous properties that can be used to adapt the editor to a given application, see Properties for a complete list of available features.


Other features

The editor supports traditional "string" annotations and structured PIAnnotations collections. The editor adapts the User Interface to match the type, the DataGrid is replaced with a simple TextBox and certain features are disabled for string annotations.



    Assembly: OSIsoft.PISDK.Controls.PIAnnotationEditor (in OSIsoft.PISDK.Controls.PIArchiveEditor.dll)



How to add the control to VS.NET toolbox and site it on a Windows form:


These instructions apply when the control and all referenced assemblies are present in the Global Assembly Cache (GAC).

1. Create a new windows application with VS.NET.

2. Add the OSIsoft.PISDK.Controls.PIAnnotationEditor user control to the toolbox (right-click on the toolbar -> Add/Remove items -> scroll down the .NET Framework Components list/tab -> check PIAnnotationEditor -> OK). You may may want to sort the toolbox items alphabetically, right-click the toolbox and select "sort....").

3. Click on the toolbox icon of the PIAnnotationEditor control and place it on the form. The name of the control will be piAnnotationEditor1, please don't change it if you plan to use the provided examples.



Enabling Operational Intelligence