ImageGear for .NET
setTagRational Method
See Also  "Example" Send comments on this topic.
ImageGear.Web.Isis Namespace Client API Library > ImageGear.Web.Isis Namespace > ImGearIsisScanner Class : setTagRational Method

tagID
The ID of the tag.
numerator
The value to set the tag numerator to.
denominator
The value to set the tag denominator to.
index
The index to use, for tags that contain multiple values. If the tag contains only a single value, this must be 0.
callback
Callback which is called when the tag is set.

Glossary Item Box

Sets the value of an ISIS tag of data type Rational.

Syntax

ASP.NET Ajax Javascript (Specification) 
function setTagRational( 
   tagID : number(Integer),
   numerator : number(Integer),
   denominator : number(Integer),
   index : number(Integer),
   callback : function
) : ImGearIsisOperationStatus;
ASP.NET Ajax Javascript (Usage) 
var resultVar = instanceOfImGearIsisScanner.setTagRational(number(Integer),number(Integer),number(Integer),number(Integer),function);

Parameters

tagID
The ID of the tag.
numerator
The value to set the tag numerator to.
denominator
The value to set the tag denominator to.
index
The index to use, for tags that contain multiple values. If the tag contains only a single value, this must be 0.
callback
Callback which is called when the tag is set.

Return Value

ImGearIsisOperationStatus value.

Example

The JavaScript code below demonstrates how to set the scanner ISIS X resolution tag to a rational value of 300/1. You can use the getTag method to get the tag type and list or range of supported values for a tag.

JavaScriptCopy Code
function setTagCallback(status) {
    if (status.get_status() !== ImageGear.Web.Isis.ImGearIsisStatus.Completed) {
        alert(status.get_statusMessage());
    }
}

scannerSession.get_scanner().setTagRational(ImageGear.Web.Isis.ImGearIsisTag.XResolution, 300, 1, 0, setTagCallback);

Remarks

This is an asynchronous method.

To set the values of multiple tags, it is more efficient to use setAllTags.

The scanner must be set before calling this method.

For more information on ISIS tags, refer to the ISIS Tags topic.

See Also

©2013. Accusoft Corporation. All Rights Reserved.