WOAnyField

Component Description

The WOAnyField component provides an interface for the user to qualify a WODisplayGroup's enterprise objects based on a single attribute of the objects. The user can choose the attribute, an operator (less than, greater than, equal to, or not equal to), and a value for the attribute. The attribute can be an attribute of the displayed objects, or an attribute of another object obtained by traversing a relationship. The component sets a WODisplayGroup's queryMatch dictionary according to the user's choices but does not redisplay the objects.

This component must be embedded within a WOForm. If you want to redisplay the objects with the new qualifier, bind the value attribue of the WOForm's submit button to the WODisplayGroup's qualifyDataSource method.

Synopsis

WOAnyField { displayGroup=aDisplayGroup; displayKey=aString;] [formatter=formatterObj; key=aString; keyList=anArray; [relationshipKey=aString;] [selectedKey=aString;] sourceEntityName=aString; [value=anObject;] };

Bindings

displayGroup: The display group for which the WOAnyField component sets the queryMatch dictionary.

displayKey: The string corresponding to key that the WOAnyField component displays. Can be bound to the same String (NSString in Objective-C) as key.

formatter: An instance of an NSFormatter subclass for the attribute corresponding to key used to format the attribute's values for display as strings and format user entered strings back into the attribute's values. The formatter attribute should specify a variable containing (or method returning) a preconfigured formatter object.

key: The key corresponding to the current iteration through the key list.

keyList: An array containing keys corresponding to the attributes with which the user can qualify the displayed objects.

relationshipKey: The key corresponding to one of the source entity's relationships. If this binding is specified, the WOAnyField component builds the queryMatch dictionary based on attributes from the destination object. This binding allows you to query with a single level of indirection. For example, you can query for all movies produced by studios starting with 'P'. If this binding is omitted, the source entity's attributes are used.

selectedKey: The key that is selected when the WOAnyField component is first displayed.

sourceEntityName: The name of entity displayed by the display group.

value: The value that appears in the value text field when the WOAnyField component is first displayed.