Language Reference Guide : System Classes : CompSource Class : GetTagText Method
 
Share this page          
GetTagText Method
The GetTagText method returns a string containing the text value associated with the supplied tag name or row number.
If it is a ClassSource (see ClassSource Class) and the specified tag name is not found in the local array, the method will search the corresponding TaggedValues array in superclasses for the first instance of the tag; the name of the superclass is returned in the classname parameter. In all other circumstances only the local TaggedValues array is searched.
This method has the following syntax:
varchar(maxsize) = CompSource.GetTagText(tag = varchar(256) |
          row = integer
          [, classname=Byref(varchar(32))])
This method has the following variable and parameters:
CompSource
Specifies the frame, procedure, or user class
tag
(Either this parameter or row is required.) Specifies the name of the tag in the TaggedValues array.
row
(Either this parameter or tag is required.) Specifies the row number in the TaggedValues array.
classname
Specifies the name of the class Byref. If the object calling this method is a ClassSource, this string is set to the class name of the ClassSource to which the identified TaggedValue actually belongs (this may be a superclass of the caller).
This method returns a string containing the text of the TaggedValue, or an empty string if the entry for this tag or index is not present. The returned value is truncated if necessary to the declared size of the variable to which it is returned. The method returns an empty string if the entry for this tag or index is not present.