Pegasus Imaging Corporation
Accusoft Pegasus

my cart
purchase
download
contact us

imaging SDKs that accelerate development

NotateXpress v8 .NET FAQ

 Contact Support


Q1: How do I connect the ImagXpress and NotateXpress controls?
Q2: How do I disconnect the ImagXpress and NotateXpress controls?
Q3: How do I create an annotation object programmatically?
Q4: How do I keep track of the current layer?
Q5: How do I make annotations permanent?
Q6: How do I use the Toolbar?
Q7: How do I use and modify the Context menu?
Q8: How do I distribute my application (in .NET, Delphi, VB etc.)?
Q9: What DLL's do I need to distribute with my application?

Q1: How do I connect the ImagXpress and NotateXpress controls?
Set the NotateXpress.ClientWindow property to the window handle of the ImagXpress View Window to which you wish to add annotation capability, for example:

NotateXpress1.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.

Q3: How do I create an annotation object programmatically?
1. Create a programmable element (i.e. RectangleTool, TextTool, etc.).
2. Set attributes of this element to specify its characteristics (see the Tool’s properties and methods in the NotateXpress .NET helpfile).
3 Call the NotateXpress.Layers.Selected method and assign the return value to a Layer object.
4. Call the Layer.Elemement.Add method to add the element to the element collection.

Q4: How do I keep track of the current layer?
Although you can always call the NotateXpress.Layers.Selected method to receive a reference to the current Layer, here is an easy way to keep track of the current layer:

1. Declare your own current Layer object.
2. In NotateXpress's CurrentLayerChange event, set this object to the CurrentLayerChangeEventArgs’s Layer property value passed in the event.

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

Q6: How do I use the Toolbar?
1. Make sure NotateXpress1.InteractMode property is equal to Edit (Edit is the default).
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 do I use and modify the Context menu?
1. To enable the built-in Context menu, call the NotateXpress.MenuSetEnabled method with the MenuType parameter set to Context, AnnotationTool set to NoTool, and Enabled equal to 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 8 .NET instructions. Please refer to: http://www.jpg.com/imagxpress8netfaq.htm#Q4

Q9: What DLL's do I need to distribute with my application?
PegasusImaging.WinForms.NotateXpress8.dll