CurrentResult Property
Applies To
Vision Objects: Blob, Correlation, Edge, Geometric
Description
Defines which result to display in the Results list on the Object tab or which result to return data for when
an object searches for multiple results.
Usage
VGet Sequence.Object.CurrentResult, var
VSet Sequence.Object.CurrentResult, value
Sequence Name of a sequence or string variable containing a sequence name.
Object Name of an object or string variable containing an object name. The object must exist in the
specified sequence.
var Integer variable that will contain the value of the property.
value Integer expression for the new value of the property.
Values
Integer number from 1 - NumberToFind property value.
Default: 1
Remarks
Blob, Correlation, Edge, and Geometric objects support finding multiple results. The CurrentResult
property defines which result to work with.
When you are only trying to find 1 result (as defined by the NumberToFind property), the CurrentResult
property is automatically set to 1 since there is only 1 possible result to return.
When working with the Vision Guide window, you will also notice that the Results list on the Object tab
will display a heading like "Result (1 of 15)". This means that the system tried to find 15 features (as
defined by the NumberToFind property) and the Results list will display the results for item 1.
If you want to see the results for one of the other results, just change the CurrentResult property value to
indicate which result you want to examine.
Results are ordered according to the Sort property setting.
See Also
Blob Object, Correlation Object, Edge Object, Found Result, Geometric Object, NumberFound Result,
NumberToFind Property, Object Tab, Sort Property
Vision Guide 5.0 Reference (Ver.5.3) Rev.1 41