[This is preliminary documentation and is subject to change.]
Finds an object with a multi-word name which matches one or more
of the words in set of name words.
Declaration Syntax| C# |
public static Persistent FindByName( string[] nameWords, ref int startPos, NameFinder nameFinder )
Parameters- nameWords (array<String>[]()[][])
- An array containing the words within which may be an object name.
- startPos (Int32%)
- The position in the array to start searching. If an object is found, this value returned here is the position in nameWords one after the position of the last word in the matched name. If no object is found, it is unchanged.
- nameFinder (NameFinder)
- A NameFinder delegate which will lookup the object. The name passed to this method will be one or more of the name words, concatenated and separated by a single space.
Return ValueThe object found by the search or null if none was found.
Remarks This method searches using first one name word, then two, three,
etc., and returns the longest name which matches.