com.webobjects.directtoweb
Class D2WSelect

java.lang.Object
  |
  +--com.webobjects.appserver.WOElement
        |
        +--com.webobjects.appserver.WOComponent
              |
              +--com.webobjects.directtoweb.D2WEmbeddedComponent
                    |
                    +--com.webobjects.directtoweb.D2WSelect

All Implemented Interfaces:

Cloneable, NSKeyValueCoding, NSKeyValueCoding.ErrorHandling, NSKeyValueCodingAdditions, NSValidation, Serializable, WOActionResults

public class D2WSelect

extends D2WEmbeddedComponent

This Direct to Web reusable component displays a select component.

Synopsis

D2WSelect { [action=anAction;] dataSource=aDataSource | list=anArray; [displayKeys=keyArray;] entityName=nameString; [pageConfiguration=configurationName;] selectedObject=anObject; };

Bindings

action - the action method to invoke when the user clicks Select or Return.

dataSource - an EODataSource containing the objects the user can select from.

list - an array containing the objects to display as a list.

displayKeys - the properties of the entity to select (NSArray). You can also represent the array as a string: "(prop1, prop2, ...)".

entityName - the name of the entity for this record (String).

pageConfiguration - the named configuration containing the Web Assistant settings for this component (String).

If this binding is not specified, the "*all*" configuration for the select task and the entityName entity is used.

selectedObject - the object the user selects with this component or null if no object is selected.

Example

 mySelect : D2WSelect {
     entityName = "Movie";
     selectedObject = displayGroup.selectedObject;
     dataSource = displayGroup.dataSource;
     action = selectAction;
 }
 

See Also:

Serialized Form

Inner classes inherited from class com.webobjects.appserver.WOComponent

WOComponent.Event

Inner classes inherited from class com.webobjects.foundation.NSKeyValueCoding

NSKeyValueCoding.DefaultImplementation, NSKeyValueCoding.ErrorHandling, NSKeyValueCoding.Null, NSKeyValueCoding.UnknownKeyException, NSKeyValueCoding.Utility, NSKeyValueCoding.ValueAccessor

Inner classes inherited from class com.webobjects.foundation.NSKeyValueCodingAdditions

NSKeyValueCodingAdditions.DefaultImplementation, NSKeyValueCodingAdditions.Utility

Inner classes inherited from class com.webobjects.foundation.NSValidation

NSValidation.DefaultImplementation, NSValidation.Utility, NSValidation.ValidationException

Fields inherited from interface com.webobjects.foundation.NSKeyValueCoding

NullValue

Fields inherited from interface com.webobjects.foundation.NSKeyValueCodingAdditions

KeyPathSeparator

Constructor Summary

D2WSelect(WOContext aContext)
Constructs a D2WSelect with the specified context.

Method Summary

EODataSource	dataSource() Returns the EODataSource containing the objects displayed on the page.
NextPageDelegate	newPageDelegate() Returns the new page delegate.
Object	selectSettings() Returns the settings for the page.
void	setDataSource(Object newValue)

Methods inherited from class com.webobjects.directtoweb.D2WEmbeddedComponent

actionPageDelegate, awake, findTarget, setActionPageDelegate, synchronizesVariablesWithBindings

Methods inherited from class com.webobjects.appserver.WOComponent

appendToResponse, application, baseURL, bindingKeys, canAccessFieldsDirectly, canGetValueForBinding, canSetValueForBinding, clone, context, debugString, descriptionForResponse, ensureAwakeInContext, frameworkName, generateResponse, handleQueryWithUnboundKey, handleTakeValueForUnboundKey, hasBinding, hasSession, invokeAction, isCachingEnabled, isEventLoggingEnabled, isStateless, logString, name, pageWithName, parent, path, performParentAction, pullValuesFromParent, pushValuesToParent, reset, session, set_componentUnroll, set_unroll, setCachingEnabled, setValueForBinding, sleep, takeValueForKey, takeValueForKeyPath, takeValuesFromRequest, template, templateWithHTMLString, templateWithName, toString, unableToSetNullForKey, validateTakeValueForKeyPath, validateValueForKey, validationFailedWithException, valueForBinding, valueForKey, valueForKeyPath

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

D2WSelect

public D2WSelect(WOContext aContext)

Constructs a D2WSelect with the specified context.

Parameters:

aContext - - the WOContext.

Method Detail

dataSource

public EODataSource dataSource()

Returns the EODataSource containing the objects displayed on the page.

Returns:

- data source with objects being displayed.

newPageDelegate

public NextPageDelegate newPageDelegate()

Returns the new page delegate.

Overrides:

newPageDelegate in class D2WEmbeddedComponent

Returns:

the NextPageDelegate.

selectSettings

public Object selectSettings()

Returns the settings for the page.

Returns:

the settings.

setDataSource

public void setDataSource(Object newValue)