Note: This topic is for Document/Medical only.
When working with automated annotations, you can use automated pop-up menus when you right-click an object while in design mode. These menus allow you to set certain properties of The WPF annotation object. In design mode, you can click on the object with the right mouse button to perform various actions. All objects provide the following actions:
Cut or copy the object to the clipboard. Delete the object. Bring the object to the front or send it to the back, the first, or the last position in the Z-order. Flip or reverse the object. Lock or unlock the object. Reset Rotate Points (if you have selected the Use Rotate Points behavior). For more information refer to WPF Annotation Rotation Options.. Set default properties. For more information, refer to Setting Annotation Defaults.
Audio Clip Tool Button Tool Closed Curve Tool Cross Product Tool Curve Tool Ellipse Tool Encrypt Tool Freehand Hotspot Tool Highlight Tool Hotspot Tool Line Tool Note Tool Point Tool Pointer Tool Polygon Tool Polyline (Freehand Line) Tool Polyline Tool PolyRuler Tool Protractor Tool Rectangle Tool Redaction Tool Rubber Stamp Tool Ruler Tool Selection Pointer Tool Stamp Tool Text Pointer Tool Text Tool TextRollup Tool
Go to the Top of this topic.
![](Aaudio.gif)
The AnnAudioObject annotation object is a rectangle containing a scaled image that can be activated to play a WAV file. In design mode, you can click and drag to specify the rectangle in the current window. You can then use the Properties dialog to specify the WAV file. In run mode the mouse pointer changes to a hand when it is over the object, and clicking on the object plays the WAV file. In design mode, you can click on the object with the right mouse button to do the following:
Play the WAV file. Access the Audio Properties dialog box.
Change the header properties. Set and manage hyperlink properties for an object or group of objects. Change the picture properties. Select a WAV file to load into the object.
Go to the Top of this topic.
![](abutton.gif)
Access the Button Properties dialog box.
Change the header properties. Set and manage hyperlink properties for an object or group of objects. Note: The actual management of a hyperlink must be done through low-level implementation. Only the Menu Item "Hyperlink" and an associated event are provided through the automation object. For more information, refer to Implementing Annotation Hyperlinks. Change the text and its characteristics. Change the font selection and font characteristics.
Go to the Top of this topic.
![](ACrPr.gif)
The AnnCrossProductObject annotation object consists of two simple lines intersecting at right angles. With the automated functions, in design mode the cross product is started on a mouse-down and completed on a mouse-up. In run mode the mouse pointer changes to a hand when it is over the object, and clicking on the object fires the Run event. You can add code to process the event. (The example program merely displays a message box.).In design mode, you can click on the object with the right mouse button to do the following:
Access the Cross Product Properties dialog box.
Change the header properties. Set and manage hyperlink properties for an object or group of objects. Note: The actual management of a hyperlink must be done through low-level implementation. Only the Menu Item "Hyperlink" and an associated event are provided through the automation object. For more information, refer to Implementing WPF Annotation Hyperlinks. Change the measurement units, precision, gauge length, and tick mark settings. Change the stroke and its characteristics (line width and brush properties). Change the font selection and font characteristics.
Go to the Top of this topic.
![](Aellipse.gif)
Access the Ellipse Properties dialog box.
Change the header properties. Set and manage hyperlink properties for an object or group of objects. Note: The actual management of a hyperlink must be done through low-level implementation. Only the Menu Item "Hyperlink" and an associated event are provided through the automation object. For more information, refer to Implementing Annotation Hyperlinks. Change the stroke and its characteristics (line width and brush properties). Change the fill and its characteristics (fill mode).
Go to the Top of this topic.
![](AFrHS.gif)
Delete or Add a Control Point. Access the Freehand Hotspot Properties dialog box.
Change the header properties. Set and manage hyperlink properties for an object or group of objects. Note: The actual management of a hyperlink must be done through low-level implementation. Only the Menu Item "Hyperlink" and an associated event are provided through the automation object. For more information, refer to Implementing Annotation Hyperlinks. Change the fill rule. Set the IsClosed flag. Change the picture and its properties.
Go to the Top of this topic.
![](Ahighlit.gif)
Access the Hilite Properties dialog box.
Change the header properties. Set and manage hyperlink properties for an object or group of objects. Note: The actual management of a hyperlink must be done through low-level implementation. Only the Menu Item "Hyperlink" and an associated event are provided through the automation object. For more information, refer to Implementing Annotation Hyperlinks. Change the Hilite color.
Go to the Top of this topic.
![](Ahot.gif)
Access the HotSpot Properties dialog box.
Change the header properties. Set and manage hyperlink properties for an object or group of objects. Note: The actual management of a hyperlink must be done through low-level implementation. Only the Menu Item "Hyperlink" and an associated event are provided through the automation object. For more information, refer to Implementing Annotation Hyperlinks. Change the picture and its properties.
Go to the Top of this topic.
![](Aline.gif)
Access the Line Properties dialog box.
Change the header properties. Set and manage hyperlink properties for an object or group of objects. Note: The actual management of a hyperlink must be done through low-level implementation. Only the Menu Item "Hyperlink" and an associated event are provided through the automation object. For more information, refer to Implementing Annotation Hyperlinks. Change the stroke and its characteristics (line width and brush properties).
Go to the Top of this topic.
![](Anote.gif)
Access the Note Properties dialog box.
Change the header properties. Set and manage hyperlink properties for an object or group of objects. Note: The actual management of a hyperlink must be done through low-level implementation. Only the Menu Item "Hyperlink" and an associated event are provided through the automation object. For more information, refer to Implementing Annotation Hyperlinks. Change the text and its characteristics. Change the stroke and its characteristics (line width and brush properties). Change the fill and its characteristics. Change the font selection and font characteristics.
Go to the Top of this topic.
![](Apoint.gif)
Access the Point Properties dialog box.
Change the header properties. Set the show flag. Set and manage hyperlink properties for an object or group of objects. Note: The actual management of a hyperlink must be done through low-level implementation. Only the Menu Item "Hyperlink" and an associated event are provided through the automation object. For more information, refer to Implementing Annotation Hyperlinks. Change the point's radius. Change the picture and its properties, or delete it. Change the stroke and its characteristics (line width and brush properties). Set the use flag. Change the fill and its characteristics. Set the use flag.
Go to the Top of this topic.
![](Apointer.gif)
Access the Pointer Properties dialog box.
Change the header properties. Set and manage hyperlink properties for an object or group of objects. Note: The actual management of a hyperlink must be done through low-level implementation. Only the Menu Item "Hyperlink" and an associated event are provided through the automation object. For more information, refer to Implementing Annotation Hyperlinks. Change the stroke and its characteristics (line width and brush properties).
Go to the Top of this topic.
![](Apolygon.gif)
Delete or Add a Control Point. Access the Polygon Properties dialog box.
Change the header properties. Set and manage hyperlink properties for an object or group of objects. Note: The actual management of a hyperlink must be done through low-level implementation. Only the Menu Item "Hyperlink" and an associated event are provided through the automation object. For more information, refer to Implementing Annotation Hyperlinks. Change the fill mode and set the Closed flag, which controls whether the double-click also closes the polygon with a line from the last point to the first point. Change the stroke and its characteristics (line width and brush properties). Change the fill and its characteristics. Change the gap between control points.
Go to the Top of this topic.
![](Afreehan.gif)
Delete or Add a Control Point. Access the Polyline Properties dialog box.
Change the header properties. Set and manage hyperlink properties for an object or group of objects. Note: The actual management of a hyperlink must be done through low-level implementation. Only the Menu Item "Hyperlink" and an associated event are provided through the automation object. For more information, refer to Implementing Annotation Hyperlinks. Change the stroke and its characteristics (line width and brush properties). Change the gap between control points.
Go to the Top of this topic.
![](Aprotrac.gif)
The AnnProtractorObject annotation object consists of two simple lines joined at a vertex to create an angle. With the automated functions, the first line of the protractor is started on a mouse-down and completed on a second mouse-down. The second line is completed on a third mouse-down. The center is the point created with the first mouse-down. In run mode, the mouse pointer changes to a hand when it is over the object, and clicking on the object fires the Run event. You can add code to process the event. (The example program merely displays a message box.). In design mode, you can click on the object with the right mouse button to do the following:
Access the Protractor Properties dialog box.
Change the header properties. Set and manage hyperlink properties for an object or group of objects. Note: The actual management of a hyperlink must be done through low-level implementation. Only the Menu Item "Hyperlink" and an associated event are provided through the automation object. For more information, refer to Implementing WPF Annotation Hyperlinks. Change the protractor's angular unit of measure, abbreviation, precision, arc radius and arc radius unit of measure. Set the Acute flag, which specifies whether to mark the inside (acute) or outside (obtuse) angle. Change the measurement units, precision, gauge length, and tick marks used by the ruler. Change the stroke and its characteristics (line width and brush properties). Change the fill and its characteristics. Change the font selection and font characteristics.
Go to the Top of this topic.
![](Arect.gif)
Access the Rectangle Properties dialog box.
Change the header properties. Set and manage hyperlink properties for an object or group of objects. Note: The actual management of a hyperlink must be done through low-level implementation. Only the Menu Item "Hyperlink" and an associated event are provided through the automation object. For more information, refer to Implementing Annotation Hyperlinks. Change the stroke and its characteristics (line width and brush properties). Change the fill and its characteristics.
Go to the Top of this topic.
![](Aredact.gif)
Realize the redaction object. Restore a redaction object that has been realized. Access the Redaction Properties dialog box.
Change the header properties. Set and manage hyperlink properties for an object or group of objects. Note: The actual management of a hyperlink must be done through low-level implementation. Only the Menu Item "Hyperlink" and an associated event are provided through the automation object. For more information, refer to Implementing Annotation Hyperlinks. Change the brush and its characteristics.
Go to the Top of this topic.
![](ARStamp.gif)
Access the Rubber Stamp Properties dialog box.
Change the header properties. Set and manage hyperlink properties for an object or group of objects. Note: The actual management of a hyperlink must be done through low-level implementation. Only the Menu Item "Hyperlink" and an associated event are provided through the automation object. For more information, refer to Implementing Annotation Hyperlinks. Change the rubber stamp type.
Go to the Top of this topic.
![](Aruler.gif)
The AnnRulerObject annotation object is a line marked off in units that can be used to measure the distance between two points on the image on which it lies. In design mode, the ruler is formed with a mouse move when the left button is down, and the object is completed on a mouse up. In run mode, the mouse pointer changes to a hand when it is over the object, and clicking on the ruler fires the Run event. You can add code to process the event. (The example program merely displays a message box.) In design mode, you can click on the object with the right mouse button to do the following:
Access the Ruler Properties dialog box.
Change the name properties. Set and manage hyperlink properties for an object or group of objects. Note: The actual management of a hyperlink must be done through low-level implementation. Only the Menu Item "Hyperlink" and an associated event are provided through the automation object. For more information, refer to Implementing WPF Annotation Hyperlinks. Change the measurement units, precision, gauge length, and tick mark settings. Change the stroke and its characteristics (line width and brush properties). Change the font selection and font characteristics.
Go to the Top of this topic.
![](Aselect.gif)
You can select a single object by clicking on the object. You can click and drag to create a rectangular selection area that selects all objects that are completely contained within it. You can hold down the shift key while clicking on several objects, one-at-a-time, which selects the objects that have been clicked.
Go to the Top of this topic.
![](Astamp.gif)
Access the Stamp Properties dialog box.
Change the header properties. Set and manage hyperlink properties for an object or group of objects. Note: The actual management of a hyperlink must be done through low-level implementation. Only the Menu Item "Hyperlink" and an associated event are provided through the automation object. For more information, refer to Implementing Annotation Hyperlinks. Select a picture and set its properties. Change the text and its characteristics. Change the stroke and its characteristics (line width and brush properties). Change the file and its characteristics. Change the font selection and font characteristics.
Go to the Top of this topic.
![](Atext.gif)
Access the Text Properties dialog box.
Change the header properties. Set and manage hyperlink properties for an object or group of objects. Note: The actual management of a hyperlink must be done through low-level implementation. Only the Menu Item "Hyperlink" and an associated event are provided through the automation object. For more information, refer to Implementing Annotation Hyperlinks. Change the text and its characteristics. Change the stroke and its characteristics (line width and brush properties). Change the fill and its characteristics. Change the font selection and font characteristics.
Go to the Top of this topic.
![](ANote.gif)
Select the Expanded option. Access the Text Rollup Properties dialog box.
Change the header properties. Set and manage hyperlink properties for an object or group of objects. Note: The actual management of a hyperlink must be done through low-level implementation. Only the Menu Item "Hyperlink" and an associated event are provided through the automation object. For more information, refer to Implementing Annotation Hyperlinks. Change the text and its characteristics. Change the stroke and its characteristics (line width and brush properties). Change the fill and its characteristics. Change the font selection and font characteristics.
Go to the Top of this topic.
![](curvetool.gif)
Delete or Add a Control Point. Access the Curve Properties dialog box.
Change the header properties. Set and manage hyperlink properties for an object or group of objects. Note: The actual management of a hyperlink must be done through low-level implementation. Only the Menu Item "Hyperlink" and an associated event are provided through the automation object. For more information, refer to Implementing Annotation Hyperlinks. Set the Tension value. Change the stroke and its characteristics (line width and brush properties). Change Control Point properties.
Go to the Top of this topic.
![](ClosedCurveTool.gif)
Delete or Add a Control Point. Access the Closed Curve Properties dialog box.
Change the header properties. Set and manage hyperlink properties for an object or group of objects. Note: The actual management of a hyperlink must be done through low-level implementation. Only the Menu Item "Hyperlink" and an associated event are provided through the automation object. For more information, refer to Implementing Annotation Hyperlinks. Change the Polygon properties. Set the Tension value. Change the stroke and its characteristics (line width and brush properties). Change the fill and its characteristics. Change Control Point properties.
Go to the Top of this topic.
![](IconPolyruler.gif)
The AnnPolyrulerObject annotation object is an array of points that create a sequence of joined rulers. In design mode, each line segment is formed with a mouse click, and the object is completed on a double-click. The polyruler can be used to measure the distance of an irregularly shaped object. As ruler segments are added, removed, or changed in length, a running total of the total distance is displayed. In run mode, the mouse pointer changes to a hand when it is over the object, and clicking on the object fires the Run event. You can add code to process the event. (The example program merely displays a message box.). In design mode, you can click on the object with the right mouse button to do the following:
Delete or Add a Control Point. Access the Poly Ruler Properties dialog box.
Change the header properties. Set and manage hyperlink properties for an object or group of objects. Note: The actual management of a hyperlink must be done through low-level implementation. Only the Menu Item "Hyperlink" and an associated event are provided through the automation object. For more information, refer to Implementing WPF Annotation Hyperlinks. Change the measurement units, precision, gauge length, and tick marks. Change the stroke and its characteristics (line width and brush properties). Change the font selection and font characteristics. Change Control Point properties.
Go to the Top of this topic.
![](EncryptIcon.gif)
The AnnEncryptObject annotation object is a rectangular object that is used to encrypt rectangular portions of a bitmap. It can also be used to encrypt the entire bitmap.
The encrypt object is useful for encrypting portions of a bitmap. After encrypting, the scrambled bitmap cannot easily be unscrambled without the associated annotation file. The scrambling can be removed by using the associated annotation file, or by using automation mode to manually change the encryptor to a decryptor, position it correctly, and setting the key appropriately.
In design mode, create the encrypt object by selecting the Encrypt tool and then clicking and dragging the mouse to create the rectangular encrypt object. Then while the object is selected, right-click the object and select the Encrypt Properties menu item, enter the key in the Key field on the Encrypt tab of the Encrypt Properties dialog that appears, and then click Apply.
After setting the key you can right-click the object and select the Apply Encryptor option to scramble the pixels underneath the object. In design mode, the encrypt object is visible but partially transparent to show the part of the bitmap that it covers.
In run mode, the encrypt object is invisible. In run mode, if an encrypt object (state encryptor) has been applied to the bitmap, the pixels underneath the encryptor's location are physically scrambled in a manner that depends upon the key used when the encrypt object was created.
An encrypt object has two pictures--one for when it is an encryptor (Primary), and one for when it is a decryptor (Secondary). In design mode you can change the pictures used by the automation object on the Pictures tab of the Encrypt Properties dialog (or in the code set the PrimaryPicture property and the SecondaryPicture property). The default picture for the encryptor is shown in the following figure:
The default picture for the decryptor is shown in the following figure:
If you have one or more encrypt objects selected and you change the "pictures" then the encryptor picture changes for all of the selected encrypt objects. Overlapping regions can be encrypted. When encrypting overlapping regions, note the following points:
All annotation objects have an order in which they are drawn (the Z-order). The encryptors are encrypted from the front of the Z-order to the back. Those that are drawn first are encrypted first. Those that are drawn last ("on top" of other encryptors) are encrypted last. The Z-order can be changed through automation by right-clicking and choosing "Bring To Front" or "Send To Back". The decryptors are decrypted in reverse order of the encryptors.
After creating an encrypt object by designating its key and location, you must call Apply to apply the encrypt object. Once applied, the portion of the bitmap under the encrypt object becomes scrambled, and the encrypt object changes state to become a decryptor. Using different keys before calling this function gives different scrambling patterns The decryptor state differs from the encryptor state in that a decryptor cannot be moved, and cannot be changed to an encryptor. The scrambling can be removed by calling Apply on the decryptor with the appropriate arguments. If successful, the decryptor state changes to encryptor. An encrypt object in that encrytpor state can be moved, can have its key changed, and can be changed to a decryptor.
When a bitmap that has had portion(s) of the bitmap encrypted is saved, the encryption information is saved with the rest of the annotation information in the associated annotation information file. In design mode, you can click on the object with the right mouse button to do the following:
Apply an Encryptor. Apply a Decryptor. Access the Encrypt Properties dialog box.
In design mode, access the Encrypt Properties dialog box to do the following:
Change the header properties. Set and manage hyperlink properties for an object or group of objects. Note: The actual management of a hyperlink must be done through low-level implementation. Only the Menu Item "Hyperlink" and an associated event are provided through the automation object. For more information, refer to Implementing WPF Annotation Hyperlinks. Change the Encrypt properties. Change the pictures used for the Encryptor and Decryptor and set their properties.
For more information, refer to AnnEncryptObject.
Go to the Top of this topic.
![](IconTextPointer.gif)
Select or deselect the Fixed Pointer option. Access the Text Pointer Properties dialog box.
Change the header properties. Set and manage hyperlink properties for an object or group of objects. Note: The actual management of a hyperlink must be done through low-level implementation. Only the Menu Item "Hyperlink" and an associated event are provided through the automation object. For more information, refer to Implementing Annotation Hyperlinks. Edit the text and its characteristics. Change the stroke and its characteristics (line width and brush properties). Change the fill and its characteristics. Change the font selection and font characteristics.
Go to the Top of this topic.
![](APolyLin.gif)
Delete or Add a Control Point. Access the Polyline Properties dialog box.
Change the header properties. Set and manage hyperlink properties for an object or group of objects. Note: The actual management of a hyperlink must be done through low-level implementation. Only the Menu Item "Hyperlink" and an associated event are provided through the automation object. For more information, refer to Implementing Annotation Hyperlinks. Change the stroke and its characteristics (line width and brush properties). Change the gap between control points.
Go to the Top of this topic.