AddFreeHandAnnotInteractive(Color,Single,LineCap,LineCap,Single,Boolean) Method

In This Topic

Allows users to interactively add a new freehand 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 annotation is an arbitrary line, which users draw by moving the mouse, with specified cap styles on its ending points. This method enables users to draw multiple separated freehand lines within one freehand annotation.

The type of the newly added annotation object is GdPictureAnnotationType.AnnotationTypeFreeHand. You can change the annotation properties directly using the GdPicture14.Annotations.AnnotationFreeHand class before or after the successful creation of the annotation object. Please refer to both the BeforeAnnotationAddedByUser and the AnnotationAddedByUser events for how to achieve this.

Be aware that the editing mode for annotations must be enabled using the SetAnnotationEditorMode method, otherwise this method will fail.

Syntax

Visual Basic
C#
Delphi
JScript
Managed Extensions for C++
C++/CLI

'Declaration
 
Public Overloads Sub AddFreeHandAnnotInteractive( _
   ByVal BorderColor As Color, _
   ByVal BorderWidth As Single, _
   ByVal StartCap As LineCap, _
   ByVal EndCap As LineCap, _
   ByVal Opacity As Single, _
   ByVal ContinuousMode As Boolean _
)

public void AddFreeHandAnnotInteractive( 
   Color BorderColor,
   float BorderWidth,
   LineCap StartCap,
   LineCap EndCap,
   float Opacity,
   bool ContinuousMode
)

public procedure AddFreeHandAnnotInteractive( 
    BorderColor: Color;
    BorderWidth: Single;
    StartCap: LineCap;
    EndCap: LineCap;
    Opacity: Single;
    ContinuousMode: Boolean
);

public function AddFreeHandAnnotInteractive( 
   BorderColor : Color,
   BorderWidth : float,
   StartCap : LineCap,
   EndCap : LineCap,
   Opacity : float,
   ContinuousMode : boolean
);

public: void AddFreeHandAnnotInteractive( 
   Color BorderColor,
   float BorderWidth,
   LineCap StartCap,
   LineCap EndCap,
   float Opacity,
   bool ContinuousMode
)

public:
void AddFreeHandAnnotInteractive( 
   Color BorderColor,
   float BorderWidth,
   LineCap StartCap,
   LineCap EndCap,
   float Opacity,
   bool ContinuousMode
)

Parameters

BorderColor: A color object that defines the required color of the newly added freehand annotation. It corresponds to the AnnotationFreeHand.StrokeColor property.
BorderWidth: The width of the newly added freehand annotation, in inches. It corresponds to the AnnotationFreeHand.BorderWidth property.
StartCap: A member of the LineCap enumeration. Specifies the cap style used at the beginning of a drawn freehand line.
EndCap: A member of the LineCap enumeration. Specifies the cap style used at the end of a drawn v line.
Opacity: The opacity value of the newly added freehand annotation, from 0 (full transparency) to 1 (full opacity).
ContinuousMode: Set this parameter to true to enable the creation of multiple separated lines during one drawing operation. In this mode users finish the whole freehand annotation with a first double-click.
Set it to false to only enable the creation of one continual freehand line.

Remarks

The GetStat method can be subsequently used to determine if this method has been successful. If the editing mode for annotations is disabled, the method will fail.

Example

How to allow users to interactively add a freehand annotation on the currently displayed page.

VB.NET
C#

'We assume that the GdViewer1 control has been properly integrated.
Sub buttonAddFreeHand_Click(ByVal sender As Object, ByVal e As EventArgs)
    GdViewer1.AddFreeHandAnnotInteractive(Color.BlueViolet, 0.1F, System.Drawing.Drawing2D.LineCap.Triangle, System.Drawing.Drawing2D.LineCap.Triangle, 1, True)
    If GdViewer1.GetStat() <> GdPictureStatus.OK Then MessageBox.Show("Error!  Status: " + GdViewer1.GetStat().ToString(), "AddFreeHandAnnotInteractive")
End Sub

//We assume that the GdViewer1 control has been properly integrated.
void buttonAddFreeHand_Click(object sender, EventArgs e)
{
    GdViewer1.AddFreeHandAnnotInteractive(Color.BlueViolet, 0.1f, System.Drawing.Drawing2D.LineCap.Triangle, System.Drawing.Drawing2D.LineCap.Triangle, 1, true);
    if (GdViewer1.GetStat() != GdPictureStatus.OK) MessageBox.Show("Error!  Status: " + GdViewer1.GetStat().ToString(), "AddFreeHandAnnotInteractive");
}

Reference

GdViewer Class
GdViewer Members
Overload List
BeforeAnnotationAddedByUser Event
AnnotationAddedByUser Event
SetAnnotationEditorMode Method
GetAnnotationCount Method