Inherits From:
NSObject
NSCoding
Inherits From:
com.apple.yellow.webobjects
Class Description
A WODisplayGroup is the basic user interface manager for a WebObjects application that accesses a database. It collects objects from an EODataSource (defined in EOControl), filters and sorts them, and maintains a selection in the filtered subset. You bind WebObjects dynamic elements to WODisplayGroup attributes and methods to display information from the database on your web page.
A WODisplayGroup manipulates its EODataSource by sending it fetchObjects , insertObject: , and other messages, and registers itself as an editor and message handler of the EODataSource's EOEditingContext (also defined in EOControl). The EOEditingContext then monitors the WODisplayGroup for changes to objects.
Most of a WODisplayGroup's interactions are with its EODataSource and its EOEditingContext. See the EODataSource, and EOEditingContext class specifications in the Enterprise Objects Framework Reference for more information on these interactions.
The Delegate
The WODisplayGroup delegate offers a number of methods, and WODisplayGroup invokes them as appropriate. Besides displayArrayForObjects
, there are methods that inform the delegate that the WODisplayGroup has fetched, created an object (or failed to create one), inserted or deleted an object, changed the selection, or set a value for a property. There are also methods that request permission from the delegate to perform most of these same actions. The delegate can return true
to permit the action or false
to deny it. See each method's description in the WODisplayGroup.Delegates interface specification for more information.
WODisplayGroup
()
Creates and returns a new WODisplayGroup. The WODisplayGroup then needs to have an EODataSource (defined in EOControl) set with setDataSource
.
Instance Methods
allObjects
public NSArray allObjects
()
Returns all of the objects collected by the receiver.
See also:
displayedObjects
, fetch
allQualifierOperators
public NSArray allQualifierOperators
()
Returns an array containing all of the relational operators supported by EOControl's EOQualifier: =, !=, <, <=, >, >=, "like
" and "caseInsensitiveLike
".
See also:
queryOperator
, relationalQualifierOperators
batchCount
public int batchCount
()
The number of batches to display. For example, if the displayed objects array contains two hundred records and the batch size is ten, batchCount
returns twenty (twenty batches of ten records each).
See also:
currentBatchIndex
, displayNextBatch
, displayPreviousBatch
, hasMultipleBatches
,
numberOfObjectsPerBatch
clearSelection
public boolean clearSelection
()
Invokes setSelectionIndexes
to clear the selection, returning true
on success and false
on failure.
currentBatchIndex
public int currentBatchIndex
()
Returns the index of the batch currently being displayed. The total batch count equals the number of displayed objects divided by the batch size. For example, if the WODisplayGroup has one hundred objects to display and the batch size is twenty, there are five batches. The first batch has a batch index of 1.
See also:
batchCount
, numberOfObjectsPerBatch
, setCurrentBatchIndex
dataSource
public com.apple.yellow.eocontrol.EODataSource dataSource
()
Returns the receiver's EODataSource (defined in the EOControl framework).
See also:
hasDetailDataSource
, setDataSource
defaultStringMatchFormat
public java.lang.String defaultStringMatchFormat
()
Returns the format string that specifies how pattern matching will be performed on string values in the queryMatch
dictionary. If a key in the queryMatch
dictionary does not have an associated operator in the queryOperator
dictionary, then its value is matched using pattern matching, and the format string returned by this method specifies how it will be matched.
See also:
defaultStringMatchOperator
, setDefaultStringMatchFormat
defaultStringMatchOperator
public java.lang.String defaultStringMatchOperator
()
Returns the operator used to perform pattern matching for string values in the queryMatch
dictionary. If a key in the queryMatch
dictionary does not have an associated operator in the queryOperator
dictionary, then the operator returned by this method is used to perform pattern matching. Unless the default is changed, this method returns caseInsensitiveLike.
See also:
defaultStringMatchFormat
, setDefaultStringMatchOperator
delegate
public java.lang.Object delegate
()
Returns the receiver's delegate.
See also:
setDelegate
delete
public java.lang.Object delete
()
Uses deleteSelection
to attempt to delete the selected objects and then causes the page to reload. Returns null
to force reloading of the web page.
See also:
deleteObjectAtIndex
deleteObjectAtIndex
public boolean deleteObjectAtIndex
(int index)
Attempts to delete the object at index, returning true
if successful and false
if not. Checks with the delegate using the method shouldDeleteObject
. If the delegate returns false
, this method fails and returns false
. If successful, it sends the delegate a didDeleteObject
message.
This method performs the delete by sending
deleteObject
to the EODataSource (defined in the EOControl framework). If that message raises an exception, this method fails and returns false
.
See also:
delete
, deleteSelection
deleteSelection
public boolean deleteSelection
()
Attempts to delete the selected objects, returning true
if successful and false
if not.
See also:
delete
, deleteObjectAtIndex
For detail display groups, returns the key to the master object that specifies what this detail display group represents. That is, if you send the object returned by the
This method returns
See also:
Displays the batch containing the selection and sets the current batch index to that batch's index. Returns
See also:
:
Returns the objects that should be displayed or otherwise made available to the user, as filtered by the receiver's delegate, by the receiver's qualifier and sort ordering.
If batching is in effect,
See also:
Increments the current batch index, displays that batch of objects, and clears the selection. If the batch currently being displayed is the last batch, this method displays the first batch of objects. Returns
See also:
Decrements the current batch index, displays that batch of objects, and clears the selection. If the batch currently being displayed is the first batch, this method displays the last batch of objects. Returns
See also:
Attempts to fetch objects from the EODataSource (defined in the EOControl framework).
Before fetching, this method sends
This method returns
See also:
Returns
See also:
Returns
See also:
Returns
See also:
Returns the index of the first object displayed by the current batch. For example, if the current batch is displaying items 11 through 20, this method returns 11.
See also:
Returns the index of the last object display by the current batch. For example, if the current batch is displaying items 11 through 20, this method returns 20.
See also:
Returns
See also:
Invokes
This method returns
Returns the default values to be used for newly inserted objects. The keys into the dictionary are the properties of the entity that the display group manages. If the dictionary returned by this method is empty, the
Asks the receiver's EODataSource (defined in the EOControl framework) to create a new object by sending it a
createObject
message, then inserts the new object . If a new object can't be created, this method sends the delegate a
If the object is successfully created, this method then sets the default values specified by
See also:
Returns the master object for a detail display group (a display group that represents a detail in a master-detail relationship). A detail display group is one that uses an EODetailDataSource (defined in the EOControl framework). You create a detail display group by dragging a to-many relationship from EOModeler to an open component in WebObjects Builder. If the display group is not a detail display group or does not have a master object set, this method returns
See also:
Returns the batch size. You can set the batch size using
Returns the receiver's qualifier, which it uses to filter its array of objects for display when the delegate doesn't do so itself.
See also:
Builds a qualifier constructed from entries in these query dictionaries:
See also:
Takes the result of
See also:
Takes the result of the
See also:
Returns a dictionary containing the actual values that the user wants to query upon. You use this method to perform a query stored in the model file. Bind keys in this dictionary to elements on your component that specify query values, then pass this dictionary to the fetch specification that performs the fetch.
Returns a dictionary of query values to match. The
Use the
If the
See also:
Returns a dictionary of "less than" query values. The
See also:
Returns a dictionary of "greater than" query values. The
See also:
Returns a dictionary of operators to use on items in the
See also:
Sends out a contents changed notification.
Returns an array containing all of the relational operators supported by EOControl's EOQualifier: =, !=, <, <=, >, and >=. In other words, returns all of the EOQualifier operators except for the ones that work exclusively on strings: "
See also:
Returns the first selected object in the displayed objects array, or
See also:
Returns the objects selected in the receiver's displayed objects array.
See also:
Returns the selection as an array of integers. The integers are indexes into the array returned by
See also:
Attempts to select the object just after the currently selected one. The selection is altered in this way:
See also:
Attempts to select the object equal to anObject in the receiver's displayed objects array, returning
See also:
Attempts to select the objects in the receiver's displayed objects array whose addresses are equal to those of objects, returning
See also:
Selects the objects in the receiver's displayed objects array whose addresses are equal to those of objects, returning
See also:
Attempts to select the object just before the presently selected one. The selection is altered in this way:
See also:
Returns
WODisplayGroups by default do select the first object after a fetch when there was no previous selection.
See also:
Displays the anInt batch of objects. The total batch count equals the number of displayed objects divided by the batch size. For example, if the WODisplayGroup has one hundred objects to display and the batch size is twenty, there are five batches. The first batch has a batch index of 1.
If anInt is greater than the number of batches, this method displays the first batch.
See also:
Sets the receiver's EODataSource (defined in the EOControl framework) to aDataSource. In the process, it performs these actions:
Unregisters itself as an editor and message handler for the previous EODataSource's EOEditingContext (also defined in EOControl), if necessary, and registers itself with aDataSource's EOEditingContext. If the new EOEditingContext already has a message handler, however, the receiver doesn't assume that role.
Clears the receiver's array of objects.
Sends
See also:
Sets how pattern matching will be performed on String values in the
The default format string for pattern matching is "
See also:
Sets the operator used to perform pattern matching for String values in the
The default value for the query match operator is
See also:
Sets the receiver's delegate to anObject.
See also:
Sets the detail key to detailKey for a detail display group. The detail key is the key that retrieves from the master object the objects that this display group manages. You must set a detail key before you set a master object.
If the receiver is not a detail display group, this method has no effect. A display group is a detail display group if its data source is an EODetailDataSource (defined in the EOControl framework). You typically create a detail display group by dragging a to-many relationship from EOModeler to an open component in WebObjects Builder. Doing so sets the detail key and master object, so you rarely need to use this method.
See also:
Controls whether the receiver automatically fetches its objects after being loaded. If flag is
See also:
Sets according to flag whether the receiver is in query mode. In query mode, controls in the user interface that normally display values become empty, allowing users to type queries directly into them (this is also known as a "Query by Example" interface). In effect, the receiver's "displayedObjects" are replaced with an empty
See also:
Sets default values to be used for newly inserted objects. When you use the
See also:
Sets the master object to masterObject for detail display groups and then performs a fetch if the display group is set to fetch on load. The master object owns the objects controlled by this display group.
Before you use this method, you should use the
If the receiver is not a detail display group, this method has no effect.
See also:
Sets the number of objects the receiver displays at a time. For example, suppose you are displaying one hundred records. Instead of displaying all of these at once, you can set the batch size so that the page displays a more manageable number (for example, 10). WebObjects Builder allows you to set the number of objects per batch on the Display Group Options panel.
See also:
Sets the receiver's objects to objects, regardless of what its EODataSource (defined in the EOControl framework) provides. This method doesn't affect the EODataSource's objects at all; specifically, it results in neither inserts nor deletes of objects in the EODataSource. objects should contain objects with the same property names or methods as those accessed by the receiver. This method is used by
After setting the object array, this method restores as much of the original selection as possible. If there's no match and the receiver selects after fetching, then the first object is selected.
See also:
Sets the receiver's qualifier to aQualifier. This qualifier is used to filter the receiver's array of objects for display. Use
If the receiver's delegate responds to
See also:
Selects the objects at selection in the receiver's array if possible, returning
This method checks the delegate with a
Note:
The selection set here is only a programmatic selection; the objects on the screen are not highlighted
in any way.
See also:
Controls whether the receiver automatically selects its first displayed object after a fetch when there were no selected objects before the fetch. If flag is
WODisplayGroups by default do select the first object after a fetch when there was no previous selection.
See also:
Sets the EOSortOrdering objects (defined in the EOControl framework) that
If the receiver's delegate responds to
See also:
Controls the receiver's behavior on encountering a validation error. In the Web context, this method has no effect.
WODisplayGroups by default don't validate changes immediately.
See also:
-
saveChanges
(in EOControl's EOEditingContext), - tryToSaveChanges (EOEditingContext
Additions),
Returns an array of EOSortOrdering objects (defined in the EOControl framework) that
See also:
Recalculates the receiver's displayed objects arrays and redisplays. If the delegate responds to
See also:
Returns
By default, WODisplayGroups don't validate changes immediately.
See also:
detailKey
public java.lang.String detailKey
()masterObject
method a
valueForKey:
message with this key, you obtain the objects controlled by this display group. null
if the receiver is not a detail display group or if the detail key has not yet been set. You typically create a detail display group by dragging a to-many relationship from EOModeler to an open component in WebObjects Builder. hasDetailDataSource
, masterObject
, setDetailKey
displayBatchContainingSelectedObject
public java.lang.Object displayBatchContainingSelectedObject
()null
to force the page to reload. displayNextBatch
, displayPreviousBatch
, setCurrentBatchIndex
displayedObjects
public NSArray displayedObjects
()displayedObjects
returns the current batch of objects. allObjects
, updateDisplayedObjects
, qualifier
, setSortOrderings
, displayArrayForObjects
(delegate method)
displayNextBatch
public java.lang.Object displayNextBatch
()null
to force the page to reload. batchCount
, currentBatchIndex
, displayBatchContainingSelectedObject
,
displayPreviousBatch
displayPreviousBatch
public java.lang.Object displayPreviousBatch
()null
to force the page to reload. batchCount
, currentBatchIndex
, displayBatchContainingSelectedObject
, displayNextBatch
fetch
public java.lang.Object fetch
()displayGroupShouldFetch
to the delegate. If this method was successful, it then sends a fetchObjects
message to the receiver's EODataSource to replace the object array, and if successful sends the delegate a didFetchObjects
message. null
to force the page to reload. allObjects
, updateDisplayedObjects
fetchesOnLoad
public boolean fetchesOnLoad
()true
if the receiver fetches automatically after the component that contains it is loaded, false
if it must be told explicitly to fetch. The default is true
. You can set this behavior in WebObjects Builder using the Display Group Options panel. Note that if the display group fetches on load, it performs the fetch each time the component is loaded into the web browser. fetch
, setFetchesOnLoad
hasDetailDataSource
public boolean hasDetailDataSource
()true
if the display group's data source is an EODetailDataSource (defined in the EOControl framework), and false
otherwise. If you drag a to-many relationship from EOModeler to an open component in WebObjects Builder, you create a display group that has an EODetailDataSource. You can also set this up using the Display Group Options panel in WebObjects Builder. detailKey
, masterObject
hasMultipleBatches
public boolean hasMultipleBatches
()true
if the batch count is greater than 1. A display group displays its objects in batches if the numberOfObjectsPerBatch
method returns a number that is less than the number of objects in the displayedObjects
array. batchCount
, setNumberOfObjectsPerBatch
indexOfFirstDisplayedObject
public int indexOfFirstDisplayedObject
()indexOfLastDisplayedObject
indexOfLastDisplayedObject
public int indexOfLastDisplayedObject
()indexOfFirstDisplayedObject
inQueryMode
public boolean inQueryMode
()true
to indicate that the receiver is in query mode, false
otherwise. In query mode, controls in the user interface that normally display values become empty, allowing users to type queries directly into them (this is also known as a "Query by Example" interface). In effect, the receiver's "displayedObjects" are replaced with an empty queryMatch
dictionary. When qualifyDisplayGroup
or qualifyDataSource
is subsequently invoked, the query is performed and the display reverts to displaying values-this time, the objects returned by the query. setInQueryMode
insert
public java.lang.Object insert
()insertNewObjectAtIndex
with an index just past the first index in the selection, or at the end if there's no selection. null
to force the page to reload.
insertedObjectDefaultValues
public NSDictionary insertedObjectDefaultValues
()insert
method adds an object that is initially empty. Because the object is empty, the display group has no value to display on the HTML page for that object, meaning that there is nothing for the user to select and modify. Use the setInsertedObjectDefaultValues
method to set up a default value so that there is something to display on the page.
insertNewObjectAtIndex
public java.lang.Object insertNewObjectAtIndex
(int index)createObjectFailedForDataSource
message. insertedObjectDefaultValues
. insert
masterObject
public java.lang.Object masterObject
()null
. detailKey
, hasDetailDataSource
, setMasterObject
numberOfObjectsPerBatch
public int numberOfObjectsPerBatch
()setNumberOfObjectsPerBatch
or using WebObjects Builder's Display Group Options panel.
qualifier
public com.apple.yellow.eocontrol.EOQualifier qualifier
()displayedObjects
, setQualifier
:,updateDisplayedObjects
qualifierFromQueryValues
public com.apple.yellow.eocontrol.EOQualifier qualifierFromQueryValues
()queryMatch
, queryMax
, queryMin
, and queryOperator
. qualifyDataSource
, qualifyDisplayGroup
qualifyDataSource
public void qualifyDataSource
()qualifierFromQueryValues
and applies to the receiver's data source. The receiver then sends itself a fetch
message. If the receiver is in query mode, query mode is exited. This method differs from qualifyDisplayGroup
as follows: whereas qualifyDisplayGroup
performs in-memory filtering of already fetched objects, qualifyDataSource
triggers a new qualified fetch against the database. queryMatch
, queryMax
,, queryMin
,queryOperator
qualifyDisplayGroup
public void qualifyDisplayGroup
()qualifierFromQueryValues
and applies to the receiver using setQualifier
. The method updateDisplayedObjects
is invoked to refresh the display. If the receiver is in query mode, query mode is exited. qualifyDataSource
, queryMatch
, queryMax
, -queryMin
, queryOperator
queryBindings
public NSMutableDictionary queryBindings
()
queryMatch
public NSMutableDictionary queryMatch
()qualifierFromQueryValues
method uses this dictionary along with the queryMax
and queryMin
dictionaries to construct qualifiers. queryOperator
dictionary to specify the type of matching (=, <, >, like
, and so on) for each key in the queryMatch
dictionary. queryOperator
dictionary does not contain a key contained in the queryMatch
dictionary, the default is to match the value exactly (=) if the value is a number or a date and to perform pattern matching if the value is a String. In the case of string values, the defaultStringMatchFormat
and defaultStringMatchOperator
specify exactly how the pattern matching will be performed. allQualifierOperators
, qualifyDataSource
, qualifyDisplayGroup
,
relationalQualifierOperators
queryMax
public NSMutableDictionary queryMax
()qualifierFromQueryValues
method uses this dictionary along with the queryMatch
and queryMin
dictionaries to construct qualifiers. qualifyDataSource
, qualifyDisplayGroup
, queryOperator
queryMin
public NSMutableDictionary queryMin
()qualifierFromQueryValues
method uses this dictionary along with the queryMatch
and queryMin
dictionaries to construct qualifiers. qualifyDataSource
, qualifyDisplayGroup
, queryOperator
queryOperator
public NSMutableDictionary queryOperator
()queryMatch
dictionary. If a key in the queryMatch
dictionary also exists in queryOperator
, that operator for that key is used. The allQualifierOperators
method returns the operator strings you can use as values in this dictionary. qualifierFromQueryValues
, queryMax
, queryMin
, relationalQualifierOperators
redisplay
public void redisplay
()
relationalQualifierOperators
public NSArray relationalQualifierOperators
()like
" and "caseInsensitiveLike
". allQualifierOperators
, queryOperator
selectedObject
public java.lang.Object selectedObject
()null
if there's no such object. displayedObjects
, selectionIndexes
, selectedObjects
selectedObjects
public NSArray selectedObjects
()displayedObjects
, selectionIndexes
, selectedObject
selectionIndexes
public NSArray selectionIndexes
()displayedObjects
. selectedObject
, selectedObjects
, setSelectionIndexes
selectNext
public java.lang.Object selectNext
()
This method returns null
to force the page to reload. selectPrevious
, setSelectionIndexes
selectObject
public boolean selectObject
(java.lang.Object anObject)true
if successful and false
otherwise. anObject is equal to an object in the displayed objects array if its address is the same as the object in the array. selectNext
, selectPrevious
selectObjectsIdenticalTo
public boolean selectObjectsIdenticalTo
(NSArray objectSelection)true
if successful and false
otherwise. setSelectionIndexes
, selectObjectsIdenticalToAndSelectFirstOnNoMatch
selectObjectsIdenticalToAndSelectFirstOnNoMatch
public boolean selectObjectsIdenticalToAndSelectFirstOnNoMatch
(NSArray objects, boolean flag)true
if successful and false
otherwise. If no objects in the displayed objects array match objects and flag is true
, attempts to select the first object in the displayed objects array. setSelectionIndexes
, selectObjectsIdenticalTo
selectPrevious
public java.lang.Object selectPrevious
()
This method returns null
to force the page to reload. selectNext
, redisplay
selectsFirstObjectAfterFetch
public boolean selectsFirstObjectAfterFetch
()true
if the receiver automatically selects its first displayed object after a fetch if there was no selection, false
if it leaves an empty selection as-is. displayedObjects
, fetch
, setSelectsFirstObjectAfterFetch
setCurrentBatchIndex
public void setCurrentBatchIndex
(int anInt)setCurrentBatchIndex(3)
would display the third batch of objects (objects 41 to 60 in this example). batchCount
, currentBatchIndex
, displayBatchContainingSelectedObject
,displayNextBatch
,
displayPreviousBatch
,numberOfObjectsPerBatch
setDataSource
public void setDataSource
(com.apple.yellow.eocontrol.EODataSource aDataSource)displayGroupDidChangeDataSource
to the delegate if there is one. dataSource
setDefaultStringMatchFormat
public void setDefaultStringMatchFormat
(java.lang.String format)queryMatch
dictionary. This format is used for properties listed in the queryMatch
dictionary that have String values and that do not have an associated entry in the queryOperator
dictionary. In these cases, the value is matched using pattern matching and format specifies how it will be matched. %@*
" which means that the string value in the queryMatch
dictionary is used as a prefix. For example, if the queryMatch
dictionary contains a value "Jo" for the key "Name", the query returns all records whose name values begin with "Jo". defaultStringMatchFormat
, setDefaultStringMatchOperator
setDefaultStringMatchOperator
public void setDefaultStringMatchOperator
(java.lang.String operator)queryMatch
dictionary. This operator is used for properties listed in the queryMatch
dictionary that have String values and that do not have an associated entry in the queryOperator
dictionary. In these cases, the operator operator is used to perform pattern matching. caseInsensitiveLike
, which means that the query does not consider case when matching letters. The other possible value for this operator is like
, which matches the case of the letters exactly. allQualifierOperators
, defaultStringMatchOperator
, relationalQualifierOperators
,
setDefaultStringMatchFormat
setDelegate
public void setDelegate
(java.lang.Object anObject)delegate
, WODisplayGroup.Delegate
setDetailKey
public void setDetailKey
(java.lang.String detailKey)hasDetailDataSource
, detailKey
, setMasterObject
setFetchesOnLoad
public void setFetchesOnLoad
(boolean flag)true
it does; if flag is false
the receiver must be told explicitly to fetch. The default is false
. You can also set this behavior in WebObjects Builder in the Display Group Options panel. fetch
, fetchesOnLoad
setInQueryMode
public void setInQueryMode
(boolean flag)queryMatch
dictionary. When qualifyDisplayGroup
or qualifyDataSource
is subsequently invoked, the query is performed and the display reverts to displaying values-this time, the objects returned by the query. inQueryMode
setInsertedObjectDefaultValues
public void setInsertedObjectDefaultValues
(NSDictionary defaultValues)insert
method to add an object, that object is initially empty. Because the object is empty, there is no value to be displayed on the HTML page, meaning there is nothing for the user to select and modify. You use this method to provide at least one field that can be displayed for the newly inserted object. The possible keys into the dictionary are the properties of the entity managed by this display group. For example, a component that displays a list of movie titles and allows the user to insert new movie titles might contain these statements to ensure that all new objects have something to display as a movie title: [defaultValues setObject:@"New title" forKey:@"title"];
[movies setInsertedObjectDefaultValues:defaultValues];
insertedObjectDefaultValues
setMasterObject
public void setMasterObject
(java.lang.Object masterObject)setDetailKey
to set the key to this relationship. You typically create a detail display group by dragging a to-Many relationship from EOModeler to an open component in WebObjects Builder. Doing so sets the master object and detail key, so you typically do not have to use this method. hasDetailDataSource
, masterObject
setNumberOfObjectsPerBatch
public void setNumberOfObjectsPerBatch
(int count)batchCount
, displayNextBatch
, displayPreviousBatch
, numberOfObjectsPerBatch
setObjectArray
public void setObjectArray
(NSArray objects)fetch
to set the array of fetched objects; you should rarely need to invoke it directly. allObjects
, displayedObjects
, fetch
, selectsFirstObjectAfterFetch
setQualifier
public void setQualifier
(com.apple.yellow.eocontrol.EOQualifier aQualifier)updateDisplayedObjects
to apply the qualifier. displayArrayForObjects
, that method is used instead of the qualifier to filter the objects. displayedObjects
, qualifier
setSelectionIndexes
public boolean setSelectionIndexes
(NSArray selection)true
if successful and false
if not (in which case the selection remains unaltered). selection is an array of java.lang.Integers. This method is the primitive method for altering the selection; all other such methods invoke this one to make the change. shouldChangeSelectionToIndexes
message. If the delegate returns false
, this method also fails and returns false
. If the receiver successfully changes the selection, its observers each receive a subjectChanged
message and, if necessary, a displayGroupDidChangeSelectedObjects
message. allObjects
setSelectsFirstObjectAfterFetch
public void setSelectsFirstObjectAfterFetch
(boolean flag)true
it does; if flag is false
then no objects are selected. displayedObjects
, fetch
, selectsFirstObjectAfterFetch
setSortOrderings
public void setSortOrderings
(NSArray keySortOrderArray)updateDisplayedObjects
uses to sort the displayed objects to orderings. Use updateDisplayedObjects
to apply the sort orderings.You can also set this value using the WebObjects Builder Display Group Options panel. displayGroup:displayArrayForObjects:
, that method is used instead of the sort orderings to order the objects. displayedObjects
, sortOrderings
, updateDisplayedObjects
setValidatesChangesImmediately
public void setValidatesChangesImmediately
(boolean flag)validatesChangesImmediately
sortOrderings
public NSArray sortOrderings
()updateDisplayedObjects
uses to sort the displayed objects, as returned by the displayedObjects
method. setSortOrderings
updateDisplayedObjects
public void updateDisplayedObjects
()displayArrayForObjects
, it's sent this message and the returned array is set as the WODisplayGroup's displayed objects. Otherwise, the receiver applies its qualifier and sort ordering to its array of objects. In either case, any objects that were selected before remain selected in the new displayed object's array. redisplay
, allObjects
, displayedObjects
, qualifier
, selectedObjects
, sortOrderings
validatesChangesImmediately
public boolean validatesChangesImmediately
()true
if the receiver immediately handles validation errors, or leaves them for the EOEditingContext (defined in the EOControl framework) to handle when saving changes. setValidatesChangesImmediately