InitFromStream(Stream) Method

In This Topic

Initializes the current AnnotationManager object from an instantiated Stream object according to what you have specified. The document previously handled by this AnnotationManager object will automatically close.

All document formats currently supported by the toolkit are listed here.

Be aware that the AnnotationManager object only handles GdPicture/XMP annotations contained in the source document.

Syntax

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

'Declaration
 
Public Overloads Function InitFromStream( _
   ByVal Stream As Stream _
) As GdPictureStatus

public GdPictureStatus InitFromStream( 
   Stream Stream
)

public function InitFromStream( 
    Stream: Stream
): GdPictureStatus;

public function InitFromStream( 
   Stream : Stream
) : GdPictureStatus;

public: GdPictureStatus InitFromStream( 
   Stream* Stream
)

public:
GdPictureStatus InitFromStream( 
   Stream^ Stream
)

Parameters

Stream: A System.IO.Stream object. This object must be properly initialized before it can be sent into this method and it must be disposed of by the user as well.

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

This method requires the Annotations component to run.

Example

How to initialize the AnnotationManager object from a JPG file using a stream.

VB.NET
C#

Dim annotationManager As AnnotationManager = New AnnotationManager()
Dim file As System.IO.Stream = New System.IO.FileStream("image.jpg", System.IO.FileMode.Open)
If (annotationManager.InitFromStream(file) = GdPictureStatus.OK) AndAlso
   (annotationManager.PageCount > 0) AndAlso (annotationManager.SelectPage(1) = GdPictureStatus.OK) Then
    Dim stamp As GdPicture14.Annotations.AnnotationRubberStamp = annotationManager.AddRubberStampAnnot(Color.Red, 0.5F, 0.5F, 2, 1, "APPROVED")
    If stamp IsNot Nothing Then
        stamp.Rotation = 20
        If (annotationManager.SaveAnnotationsToPage() = GdPictureStatus.OK) AndAlso
           (annotationManager.BurnAnnotationsToPage(True) = GdPictureStatus.OK) AndAlso
           (annotationManager.SaveDocumentToPDF("approved.pdf") = GdPictureStatus.OK) Then
            MessageBox.Show("Finished successfully!", "AnnotationManager.InitFromStream")
        Else
            MessageBox.Show("The file can't be saved. Status: " + annotationManager.GetStat().ToString(), "AnnotationManager.InitFromStream")
        End If
        stamp.Dispose()
    Else
        MessageBox.Show("The rubber stamp annotation can't be created. Status: " + annotationManager.GetStat().ToString(), "AnnotationManager.InitFromStream")
    End If
    annotationManager.Close()
Else
    MessageBox.Show("The AnnotationManager can't be properly initialized. Status: " + annotationManager.GetStat().ToString(), "AnnotationManager.InitFromStream")
End If
annotationManager.Dispose()
file.Dispose()

AnnotationManager annotationManager = new AnnotationManager();
System.IO.Stream file = new System.IO.FileStream("image.jpg", System.IO.FileMode.Open);
if ((annotationManager.InitFromStream(file) == GdPictureStatus.OK) &&
    (annotationManager.PageCount > 0) && (annotationManager.SelectPage(1) == GdPictureStatus.OK))
{
    GdPicture14.Annotations.AnnotationRubberStamp stamp = annotationManager.AddRubberStampAnnot(Color.Red, 0.5f, 0.5f, 2, 1, "APPROVED");
    if (stamp != null)
    {
        stamp.Rotation = 20;
        if ((annotationManager.SaveAnnotationsToPage() == GdPictureStatus.OK) &&
            (annotationManager.BurnAnnotationsToPage(true) == GdPictureStatus.OK) &&
            (annotationManager.SaveDocumentToPDF("approved.pdf") == GdPictureStatus.OK))
            MessageBox.Show("Finished successfully!", "AnnotationManager.InitFromStream");
        else
            MessageBox.Show("The file can't be saved. Status: " + annotationManager.GetStat().ToString(), "AnnotationManager.InitFromStream");
        stamp.Dispose();
    }
    else
        MessageBox.Show("The rubber stamp annotation can't be created. Status: " + annotationManager.GetStat().ToString(), "AnnotationManager.InitFromStream");
    annotationManager.Close();
}
else
    MessageBox.Show("The AnnotationManager can't be properly initialized. Status: " + annotationManager.GetStat().ToString(), "AnnotationManager.InitFromStream");
annotationManager.Dispose();
file.Dispose();

Reference

AnnotationManager Class
AnnotationManager Members
Overload List
InitFromFile Method
InitFromGdPictureImage Method
InitFromGdPicturePDF Method
InitFromGdViewer Method
Close Method
Dispose Method