PATH |
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) askey
.
- 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. Theformatter
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.