DisplayTextEditBox Method (GdViewer)
In This Topic
Allows users to modify the annotation text directly within the defined annotation rectangle area. The actual annotation content is completely selected. This method is only applicable to sticky note and text annotations.
The method can be particularly useful if you want to let users add the new text (the annotation content) of the sticky note or text annotation right after they create it. The annotation rectangle area will serve as an editable dialogue box. Please refer to the attached example how it works.
The AnnotationStartEditingText event is raised after opening the dialogue box.
Syntax
Parameters
- AnnotationIdx
- The 0-based index of the required annotation within the current page of the displayed document. It must be a value from 0 to GetAnnotationCount-1.
Return Value
A member of the GdPictureStatus enumeration. If the method has been successfully followed, then the return value is GdPictureStatus.OK.
We strongly recommend always checking this status first.
Example
How to prompt the user to modify the annotation text by catching the AnnotationAddedByUser event.
'We assume that the GdViewer1 control has been properly integrated
'and the AnnotationAddedByUser event has been properly added.
Sub GdViewer1_AnnotationAddedByUser(ByVal AnnotationIdx As Integer) Handles GdViewer1.AnnotationAddedByUser
Dim annot As GdPicture14.Annotations.Annotation = GdViewer1.GetAnnotationFromIdx(AnnotationIdx)
If TypeOf annot Is GdPicture14.Annotations.AnnotationStickyNote OrElse
TypeOf annot Is GdPicture14.Annotations.AnnotationText Then
GdViewer1.DisplayTextEditBox(AnnotationIdx)
End If
End Sub
//We assume that the GdViewer1 control has been properly integrated.
//and the AnnotationAddedByUser event has been properly added.
void GdViewer1_AnnotationAddedByUser(int AnnotationIdx)
{
GdPicture14.Annotations.Annotation annot = GdViewer1.GetAnnotationFromIdx(AnnotationIdx);
if (annot is GdPicture14.Annotations.AnnotationStickyNote ||
annot is GdPicture14.Annotations.AnnotationText)
{
GdViewer1.DisplayTextEditBox(AnnotationIdx);
}
}
Example
How to prompt the user to modify the annotation text by catching the AnnotationAddedByUser event.
'We assume that the GdViewer1 control has been properly integrated
'and the AnnotationAddedByUser event has been properly added.
Sub GdViewer1_AnnotationAddedByUser(ByVal AnnotationIdx As Integer) Handles GdViewer1.AnnotationAddedByUser
Dim annot As GdPicture14.Annotations.Annotation = GdViewer1.GetAnnotationFromIdx(AnnotationIdx)
If TypeOf annot Is GdPicture14.Annotations.AnnotationStickyNote OrElse
TypeOf annot Is GdPicture14.Annotations.AnnotationText Then
GdViewer1.DisplayTextEditBox(AnnotationIdx)
End If
End Sub
//We assume that the GdViewer1 control has been properly integrated.
//and the AnnotationAddedByUser event has been properly added.
void GdViewer1_AnnotationAddedByUser(int AnnotationIdx)
{
GdPicture14.Annotations.Annotation annot = GdViewer1.GetAnnotationFromIdx(AnnotationIdx);
if (annot is GdPicture14.Annotations.AnnotationStickyNote ||
annot is GdPicture14.Annotations.AnnotationText)
{
GdViewer1.DisplayTextEditBox(AnnotationIdx);
}
}
See Also