FindDisplay property: Field class

Description

Use this property to set or return a boolean value indicating whether this field is found as a result of a search.

This property is set at the Rowset level, so it is not persisted to the database. It has a value as long as the underlying Rowset is in context.

Only one field in the Rowset should ever have the FindDisplay property set. When the FindDisplay property is set, PeopleTools removes the FindDisplay property from any other field in any Rowset on the page. Additionally, ensure that the FindDisplay property is cleared when it's no longer needed.

When the FindDisplay property is set to True:

• If the field is display only, a focus style is added to the field and the focus is moved to the field.

• If the field is editable, the focus is set on the field.

• If the field is not visible, then the focus cannot be set on the field, so application developers must ensure that the field is visible before setting the FindDisplay property to true.

When the FindDisplay property is set to False, the focus style is removed from the field if it is present, and the page is refreshed.

This property is read/write.

Example

Local Rowset &rs = GetRowset(Scroll.PS_FLUID_SA);
Local Field FieldObject = &rs.Find("String to Find");
if All(FieldObject) then;
	FieldObject.FindDisplay = true;

else
	MessageBox("String not found");
end-if;