Pegasus Imaging Corporation
Accusoft Pegasus

imaging SDKs that accelerate development

NotateXpress v9 .NET FAQ

Contact Support



Q1How can I determine if I have the latest version of an Accusoft Pegasus control?
Q2How do I disconnect the ImagXpress and NotateXpress controls?
Q3How do I create an annotation object programmatically?
Q4How can I determine if I have the latest version of an Accusoft Pegasus control?
Q5How do I make annotations permanent?
Q6How do I use the Toolbar?
Q7How can I determine if I have the latest version of an Accusoft Pegasus control?
Q8How do I distribute my application (in .NET, Delphi, VB etc.)?
Q9What DLL's do I need to distribute with my application?
Q10Where can I find additional “How To” type sample code that demonstrates the usage of the control?

Q1: How can I determine if I have the latest version of an Accusoft Pegasus control?
Please download the PegConnect utility program from the following link: PegConnect
or reference the Latest Builds page.NotateXpress.ClientWindow = ImageXView1.Handle

Q2: How do I disconnect the ImagXpress and NotateXpress controls?
Call the NotateXpress ClientDisconnect() method.

This is equivalent to setting NotateXpress.ClientWindow to System.IntPtr.Zero.2) If you are using the ActiveX control you must call the UnlockRuntime and SetIXLicenseCodes methods where your application begins and pass the unlock codes as the parameters. For example:

ThumbnailXpress1.UnlockRuntime 5678, 5678, 5678, 5678

ThumbnailXpress1.SetIXLicenseCodes 1234, 1234, 1234, 1234

Please note that if you are using either the UsePDFXpress or the UsePDFXpress2 methods in your application then you need to call the UnlockPdfXpressRuntime method in the Licensing class where the application begins and pass the PDFXpress unlock codes as the parameters. For example:

ThumbnailXpress1. SetPDFXLicenseCodes 4545,4545,4545,4545

Q3: How do I create an annotation object programmatically?
1) If you are using the ActiveX interface please distribute the following DLL:

PegasusImaging.ActiveX.ThumbnailXpress2.dll

Please Note: You must register the PegasusImaging.ActiveX.ThumnailXpress2.dll via your installation program or manually via the regsvr32.exe utility.

PegasusImaging.WinForms.NotateXpress9.BlockHighlightTool highlight = new BlockHighlightTool();

2. Set the attributes of this element to specify its characteristics (see the Tool’s properties and methods in the NotateXpress .NET helpfile). For example,

highlight.BoundingRectangle = new Rectangle(100, 100, 300, 300);
highlight.FillColor = Color.Blue;
highlight.ToolTipText = "Block Highlight";

3. Call the NotateXpress.Layers.Selected method and assign the return value to a Layer object. For example:

Layer layer = notateXpress1.Layers.Selected();

4. Call the Layer.Elements.Add method to add the element to the element collection. For example,

layer.Elements.Add(highlight);

Q4: How can I determine if I have the latest version of an Accusoft Pegasus control?
Please download the PegConnect utility program from the following link: PegConnect
or reference the Latest Builds page.2. In NotateXpress's CurrentLayerChange event, set this object to the CurrentLayerChangeEventArgs’s Layer property value passed in the event. For example,

currLayer = e.Layer;

Q5: How do I make annotations permanent?
Call the NotateXpress.Layers.Brand method and specify the desired bit depth as the parameter. For example,

notateXpress.Layers.Brand(24);

Q6: How do I use the Toolbar?
1) If you are using the ActiveX interface please distribute the following DLL:

PegasusImaging.ActiveX.TwainPRO5.dll

Please Note: You must register the PegasusImaging.ActiveX.TwainPRO5.dll via your installation program or manually via the regsvr32.exe utility.

2. Make sure to create a layer by creating a Layer object and pass it in the NotateXpress.Layers.Add method.
3. Set the Layer.Toolbar.Visisble property equal to true.

It is common to have NotateXpress' toolbar visible while ImagXpress' toolbar is also visible. If ImagXpress' toolbar is currently set to a tool other than the pointer (Tool_none) the NotateXpress toolbar tools will not activate. Inform the user to set the ImagXpress tool to the pointer to be able to use the NotateXpress toolbar. A strongly worded tooltip for the pointer arrow is a good measure.

Q7: How can I determine if I have the latest version of an Accusoft Pegasus control?
Please download the PegConnect utility program from the following link: PegConnect
or reference the Latest Builds page.notateXpress.MenuSetEnabled(PegasusImaging.WinForms.NotateXpress9.MenuType.Context, PegasusImaging.WinForms.NotateXpress9.AnnotationTool.NoTool, true);

2. Make sure the PointerTool is selected.

If you want to modify the strings that are displayed on the context menu, call NotateXpress.MenuChangeItem. To remove an item call NotateXpress.MenuDeleteItem.

To determine what items are available on the Context menu, use NotateXpress.MenuGetFirstItemID and NotateXpress.MenuGetNextItemID to iterate through the available context menu items, calling NotateXpress.MenuGetItem with the various IDs.

To add additional user-defined items to the Context menu, use NotateXpress.MenuAddItem.

Q8: How do I distribute my application (in .NET, Delphi, VB etc.)?
PLEASE NOTE: NotateXpress is unlocked using the ImagXpress 9 .NET instructions. Please refer to:
http://www.accusoft.com/imagxpress9faq.htm#Q2

Q9: What DLL's do I need to distribute with my application?
1) If you are using the ActiveX interface please distribute the following DLL:

PegasusImaging.ActiveX.PrintPro4.dll

Please Note: You must register the PegasusImaging.ActiveX.PrintPro4.dll via your installation program or manually via the regsvr32.exe utility.


Q10: Where can I find additional “How To” type sample code that demonstrates the usage of the control?
Please refer to the “How To” section in the Contents section of the appropriate help file (.NET or ActiveX) for sample code showing the use of the control.