AddFreeHandHighlighterAnnotInteractive(Color,Single,Boolean) Method
Allows users to interactively add a new freehand highlighter annotation using the mouse on the current page of the document displayed in the GdViewer control. The annotation object is added following all the parameters you have specified and respecting the dimensions users will define using the mouse as well.
A freehand highlighter annotation is an arbitrary line, which users draw moving the mouse to highlight the required area on the page. This method enables users to draw multiple separated freehand highlighter lines within one freehand highlighter annotation.
The type of the newly added annotation object is GdPictureAnnotationType.AnnotationTypeFreeHandHighlighter. You can change the annotation properties directly using the GdPicture14.Annotations.AnnotationFreeHandHighlighter class before or after the successful creation of the annotation object. Please refer to both the GdViewer.BeforeAnnotationAddedByUser and the GdViewer.AnnotationAddedByUser events for how to achieve this.
Be aware that the editing mode for annotations must be enabled using the GdViewer.SetAnnotationEditorMode method, otherwise this method will fail.
public void AddFreeHandHighlighterAnnotInteractive(
Color ,
float ,
bool
)
public procedure AddFreeHandHighlighterAnnotInteractive(
: Color;
: Single;
: Boolean
);
public function AddFreeHandHighlighterAnnotInteractive(
: Color,
: float,
: boolean
);
public: void AddFreeHandHighlighterAnnotInteractive(
Color ,
float ,
bool
)
public:
void AddFreeHandHighlighterAnnotInteractive(
Color ,
float ,
bool
)
'Declaration
Public Overloads Sub AddFreeHandHighlighterAnnotInteractive( _
ByVal As Color, _
ByVal As Single, _
ByVal As Boolean _
)
Parameters
- BorderColor
- A color object that defines the required color of the newly added freehand highlighter annotation. It corresponds to the AnnotationFreeHandHighlighter.StrokeColor property.
- BorderWidth
- The width of the newly added freehand highlighter anotation, in inches. It corresponds to the AnnotationFreeHandHighlighter.BorderWidth property.
- ContinuousMode
- Set this parameter to true to enable the creation of multiple separated highlighter lines during one drawing operation. In this mode users finish the whole freehand highlighter annotation with a first double-click.
Set it to false to only enable the creation of one continual freehand highlighter line.
How to allow users to interactively add a freehand highlighter annotation on the currently displayed page.
'We assume that the GdViewer1 control has been properly integrated.
Sub buttonAddFreeHandHighlighter_Click(ByVal sender As Object, ByVal e As EventArgs)
GdViewer1.AddFreeHandHighlighterAnnotInteractive(Color.Red, 0.2F, True)
If GdViewer1.GetStat() <> GdPictureStatus.OK Then MessageBox.Show("Error! Status: " + GdViewer1.GetStat().ToString(), "AddFreeHandHighlighterAnnotInteractive")
End Sub
//We assume that the GdViewer1 control has been properly integrated.
void buttonAddFreeHandHighlighter_Click(object sender, EventArgs e)
{
GdViewer1.AddFreeHandHighlighterAnnotInteractive(Color.Red, 0.2f, true);
if (GdViewer1.GetStat() != GdPictureStatus.OK) MessageBox.Show("Error! Status: " + GdViewer1.GetStat().ToString(), "AddFreeHandHighlighterAnnotInteractive");
}
