Documentation Archive Developer
Search
PATH Documentation > WebObjects

Table of Contents

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.

[image: Art/WOExtWOAnyField.gif]

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.

Table of Contents