HideTextEditBox Method (GdViewer)

In This Topic

Terminates the editing mode for modifying the annotation text within its rectangle area. You can specify if the defined text will be saved to the related annotation.

The annotation's rectangle area previously enabled for editing by DisplayTextEditBox method will be disabled. If the editable dialogue box is not displayed, this method will fail.

The AnnotationEndEditingText event, respectively the PreviewAnnotationEndEditingText event is raised after closing the dialogue box.

Syntax

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

'Declaration
 
Public Function HideTextEditBox( _
   ByVal SaveText As Boolean _
) As GdPictureStatus

public GdPictureStatus HideTextEditBox( 
   bool SaveText
)

public function HideTextEditBox( 
    SaveText: Boolean
): GdPictureStatus;

public function HideTextEditBox( 
   SaveText : boolean
) : GdPictureStatus;

public: GdPictureStatus HideTextEditBox( 
   bool SaveText
)

public:
GdPictureStatus HideTextEditBox( 
   bool SaveText
)

Parameters

SaveText: Set this parameter to true to save the currently defined text to the related annotation object, otherwise set it to false.

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.

Remarks

Be aware that if the annotation's rectangle area is not displayed as the editable dialogue box, this method will fail.

Just to remind you that the AnnotationEndEditingText event, respectively the PreviewAnnotationEndEditingText event is raised using this method.

Example

How to prevent users from editing the annotation text.

VB.NET
C#

'We assume that the GdViewer1 control has been properly integrated
'and the AnnotationStartEditingText event has been properly added.
            
'Define the event.
Sub GdViewer1_AnnotationStartEditingText(object sender, GdPicture14.WPF.GdViewer.AnnotationStartEditingTextEventArgs e)
    Dim annot As GdPicture14.Annotations.Annotation = GdViewer1.GetAnnotationFromIdx(e.AnnotationIdx)
    Dim text As String = ""
    If TypeOf annot Is GdPicture14.Annotations.AnnotationStickyNote Then
        text = (CType(annot, GdPicture14.Annotations.AnnotationStickyNote)).Text
    ElseIf TypeOf annot Is GdPicture14.Annotations.AnnotationText Then
        text = (CType(annot, GdPicture14.Annotations.AnnotationText)).Text
    End If
    'Hiding the editable dialogue box without allowing users to change the original text.
    HideTextEditBox(false)
    MessageBox.Show(text, "GdViewer.HideTextEditBox")
End Sub

//We assume that the GdViewer1 control has been properly integrated
//and the AnnotationStartEditingText event has been properly added.
            
//Define the event.
void GdViewer1_AnnotationStartEditingText(object sender, GdPicture14.WPF.GdViewer.AnnotationStartEditingTextEventArgs e)
{
    GdPicture14.Annotations.Annotation annot = GdViewer1.GetAnnotationFromIdx(e.AnnotationIdx);
    string text = "";
    if (annot is GdPicture14.Annotations.AnnotationStickyNote)
        text = ((GdPicture14.Annotations.AnnotationStickyNote)annot).Text;
    else if (annot is GdPicture14.Annotations.AnnotationText)
        text = ((GdPicture14.Annotations.AnnotationText)annot).Text;
    //Hiding the editable dialogue box without allowing users to change the original text.
    HideTextEditBox(false);
}

Reference

GdViewer Class
GdViewer Members
DisplayTextEditBox Method
GetAnnotationCount Method
GetAnnotationFromIdx Method
AnnotationAddedByUserEvent Field
AnnotationEndEditingText Event
PreviewAnnotationEndEditingText Event
AnnotationStartEditingText Event