InsertItemFromMemory Method

Description

Inserts an image into the list of thumbnail items by way of a user supplied image memory buffer.

PDF support is deprecated in ImagXpress; instead, please use PDF Xpress for PDF support via the UsePdfXpressForPDFsOnly property.

Syntax

Visual Basic
Public Sub InsertItemFromMemory( _ ByRef pImageMemoryBuffer As Byte, _ ByVal MemoryBufferSize As Long, _ ByVal InsertIndex As Long, _ ByVal Descriptor As String, _ ByVal ThumbnailStatus As TN_ThumbnailStatus, _ ByVal ThumbnailType As TN_ThumbnailType, _ ByVal Page As Long, _ ByVal PageCount As Long, _ ByVal UserTag As Variant _ )

Visual Basic

Public Sub InsertItemFromMemory( _
   ByRef pImageMemoryBuffer As Byte, _
   ByVal MemoryBufferSize As Long, _
   ByVal InsertIndex As Long, _
   ByVal Descriptor As String, _
   ByVal ThumbnailStatus As TN_ThumbnailStatus, _
   ByVal ThumbnailType As TN_ThumbnailType, _
   ByVal Page As Long, _
   ByVal PageCount As Long, _
   ByVal UserTag As Variant _
)

Parameters

pImageMemoryBuffer

A byte value which represents the image from memory buffer.

MemoryBufferSize

A long value which represents the memory buffer size.

InsertIndex

A long value which represents the location to insert the item.

Descriptor

A string value which represents the description of the item to insert.

ThumbnailStatus

Value	Description
TN_BeingGenerated	2 - Thumbnail bitmap in the process of being generated.
TN_Canceled	6 - The thumbnail is canceled.
TN_FailedWithError	4 - ThumbnailXpress failed to generate thumbnail bitmap for the image (likely decompression error).
TN_FailedWithTimeout	5 - Failed to generate thumbnail bitmap within time limits. See ThreadHungThreshold property.
TN_Generated	3 - A thumbnail bitmap successfully generated (though it may not be in cache at this point).
TN_NotValidated	0 - The thumbnail is not validated.
TN_Validated	1 - File validated at some level; ThumbnailXpress believes it is a supported file type.

A TN_ThumbnailStatus enumeration value.

ThumbnailType

Value	Description
TN_CAD	5 - Supported CAD (Computer Aided Design) file type.
TN_Image	3 - Supported ImagXpress file type.
TN_Internet	1 - Specifies that the file is an Internet file.
TN_ParentDirectory	6 - Parent directory folder.
TN_PDF	4 - Supported PDFXpress file type.
TN_Subdirectory	7 - Sub-directory folder type.
TN_Unknown	0 - Thumbnail type is not recognized by ThumbnailXpress operations.
TN_Unsupported	2 - ImagXpress or PDF Xpress (if available) does not support the file.

A TN_ThumbnailType enumeration value.

Page

A long value which represents the page.

PageCount

A long value which represents the number of pages.

UserTag

A variant which represents the user tag.

Remarks

The LoadFromMemory event may optionally be used to supply the memory buffer.