ImageGear for C and C++ on Windows v19.9 - Updated
IG_ISIS_tag_set_long
API Reference Guide > ISIS Component API Reference > ISIS Component Functions Reference > Tag Functions > IG_ISIS_tag_set_long

Set the value of a type long tag.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_ISIS_tag_set_long(
        HISISDRV hDriver,
        AT_MODE nTag,
        WORD wIndex,
        LONG lValue
);

Arguments:

Name Type Description
hDriver HISISDRV The handle to the driver.
nTag AT_MODE Specifies the type long tag to set.
wIndex WORD Specifies which element to set. wIndex must be greater than or equal to zero and at most one less than the value returned by IG_ISIS_tag_get_length.
lValue LONG Specifies the value to which to set nTag's specified element.

Return Value:

Returns the number of ImageGear errors that occurred during this function call. If there are no errors, the return value is IGE_SUCCESS.

Supported Raster Image Formats:

This function does not process image pixels.

Remarks:

The IG_ISIS_tag_set_long function sets the value of the specified integer tag's specified element to the given value.

Use IG_ISIS_tag_set_long to set the specified element of nTag to the value given in lValue. This function is used to set byte, short, and long values. IG_ISIS_tag_set_long will not automatically increase the number of elements in a tag. You must use IG_ISIS_tag_set_length before calling IG_ISIS_tag_set_long to do this.

Example:

See example for IG_ISIS_tag_set_length.

See Also

IG_ISIS_tag_get_long

IG_ISIS_tag_set_ascii

IG_ISIS_tag_set_default

IG_ISIS_tag_set_length

IG_ISIS_tag_set_rational