CogOCVMaxPattern.AddText Method (String[], CogOCVMaxLineIterator)

CogOCVMaxPattern AddText Method ( String , CogOCVMaxLineIterator)

Cognex VisionPro 9.7

Creates one or more new lines and inserts them at the line position specified by the line iterator.

Namespace: Cognex.VisionPro.OCVMax
Assembly: Cognex.VisionPro.OCVMax (in Cognex.VisionPro.OCVMax.dll) Version: 73.0.0.0

Syntax

public void AddText(
	string[] srcText,
	CogOCVMaxLineIterator pNext
)

public void AddText(
	string[] srcText,
	CogOCVMaxLineIterator pNext
)

Public Sub AddText ( 
	srcText As String(),
	pNext As CogOCVMaxLineIterator
)

Public Sub AddText ( 
	srcText As String(),
	pNext As CogOCVMaxLineIterator
)

public:
void AddText(
	array<String^>^ srcText, 
	CogOCVMaxLineIterator^ pNext
)

public:
void AddText(
	array<String^>^ srcText, 
	CogOCVMaxLineIterator^ pNext
)

srcText: Type: System String
An array of strings, each of which corresponds to a line of text. May not be NULL. This assumes that the character keys in the associated font correspond to Unicode code point values.

pNext: Type: Cognex.VisionPro.OCVMax CogOCVMaxLineIterator
A CogOCVMaxLineIterator which specifies the line position at which the new line(s) should be inserted. May not be NULL.

Events

Event Type	Reason
ICogChangedEvent Changed	Fires when the pattern object is modified.
CogOCVMaxPattern LineAdded	Fires when a line is added to the pattern object.

Exceptions

Exception	Condition
InvalidOperationException	If the line iterator does not specify a valid position.
ObjectDisposedException	If this CogOCVMaxPattern object has already been disposed.
ArgumentNullException	If srcText argument is NULL.
ArgumentException	If the supplied line iterator does not reference this CogOCVMaxPattern object.

Remarks

Each string in the srcText array corresponds to an individual line. An empty string (length zero) is interpreted as a blank line.