RB Binding Interfaces Documentation

The information below is based on REALbasic 4.0.2.

RB Classes

ClassInterfaces Implemented
BevelButtonActionSource
Checkbox bindingPartInterface, BooleanProvider, dataNotifier
DatabaseCursorFieldStringProvider
DatabaseQuery actionNotificationReceiver, listDataNotifier, listDataProvider, StringInterface
DatabaseRecordtupleInterface
EditFieldStringInterface
ListboxbindingPartInterface, ListDataNotificationReceiver, listInterface, ListSelectionNotifier
MoviePlayerbindingPartInterface
PopupMenu bindingPartInterface, dataAvailableProvider, dataNotifier, listInterface, StringProvider
PushButtonActionSource
RadioButtonbindingPartInterface

Interfaces

Class Interface ActionNotificationReceiver

Description
This interface is implemented by objects wishing to register with an ActionSource. It is not documented in the Language Reference.
Methods
PerformActionYou implement this method to perform the action you want.

Class Interface ActionSource

Description
This interface is implemented by BevelButton and PushButton. An ActionSource object calls the PerformAction method of each ActionNotificationReceiver registered with it. ActionSource is not documented in the Language Reference.
Methods
AddActionNotificationReceiver(foo as ActionNotificationReceiverRegisters an ActionNotificationReceiver
RemoveActionNotificationReceiver(foo as ActionNotificationReceiverUnregisters an ActionNotificationReceiver

Class Interface BindingInterface

Description
This interface is implemented by bind objects, used to define custom control bindings. It is not documented in the Language Reference, but is discussed in the Developers Guide.
Methods
Bind(source as Object, target as Object)Implement this method to set the binding information. Bind should contain the pragma statement which describes the bind: #pragma bindingSpecification sourceClassName,targetClassName,"Do something with %2 when %1 is tickled".

Class Interface BindingPartInterface

Description
I am unable to determine the purpose of this interface; it appears to be implemented by Listbox and Checkbox. It is not documented in the Language Reference.
Methods
GetBoundPart(s as String) as Object?

Class Interface BooleanProvider

Description
Objects which implement BooleanProvider supply Boolean values. BooleanProvider is implemented by Checkbox. It is not documented in the Language Reference.
Methods
GetBoolean as BooleanReturns a Boolean value
SetBoolean(b as Boolean)Passes a Boolean value into a method you implement.

Class Interface DataAvailableProvider

Description
This interface is implemented by PopupMenu. It is not documented in the Language Reference.
Methods
dataAvailable as BooleanTrue if data is available; for PopupMenu, DataAvailable returns true if the menu's ListIndex > -1, and false if the listIndex = -1.

Class Interface DataNotificationReceiver

Description
Objects implementing DataNotificationReceiver can register with a DataNotifier to be notifed when data changes. This interface is documented in the Language Reference, but the Reference is wrong -- or, I perhaps I should say, disagrees with the compiler.
Methods
dataChangedCalled when the data is changed.

Class Interface DataNotifier

Description
This interface is implemented by Checkbox and PopupMenu. Checkbox calls the dataChanged method of each registered DataNotificationReceiver when its value is changed; PopupMenu announces each change of selection.
Methods
AddDataNotificationReceiver(foo as DataNotificationReceiver)Registers a DataNotificationReceiver
RemoveDataNotificationReceiver(foo as listSelectionNotificationReceiver)Unregisters a DataNotificationReceiver

Class Interface listDataNotificationReceiver

Description
This interface is implemented by Listbox. It is not documented in the Language Reference.
Methods
listDataInsertedRow(i as Integer)?
listDataReload?
listDataRemovedRow(i as Integer?

Class Interface listDataNotifier

Description
This interface is implemented by DatabaseQuery.
Methods
addListDataNotificationReceiver(foo as listDataNotificationReceiver)Registers a listDataNotificationReceiver
removeListDataNotificationReceiver(foo as listDataNotificationReceiver)Unregisters a listData NotificationReceiver

Class Interface listDataProvider

Description
This interface is implemented by DatabaseQuery.
Methods
GetCount as Integer
GetRow(v as Integer) as tupleInterface

Class Interface listInterface

Description
listInterface is implemented by Listbox and PopupMenu, and its purpose appears to be to bind objects of either class to a DatabaseQuery.
Methods
BindList(foo as ListDataProvider)

Class Interface ListSelectionNotificationReceiver

Description
Objects implementing ListSelectionNotificationReceiver can register with a Listbox via the Listbox.AddListSelectionNotificationReceiver method to be notified before and after the listbox selection changes.
Methods
SelectionChangingCalled when the selection of the source listbox is about to change
Selection ChangedCalled after the selection of the source listbox has changed

Class Interface ListSelectionNotifier

Description
This interface is implemented by Listbox, and allows objects implementing ListSelectionNotificationReceiver to register with a listbox to receive notification before and after the listbox selection changes.
Methods
AddListSelectionNotificationReceiver(foo as listSelectionNotificationReceiver)Registers a listSelectionNotificationReceiver
RemoveListSelectionNotificationReceiver(foo as listSelectionNotificationReceiver)Unregisters a listSelectionNotificationReceiver

Class Interface StringInterface

Description
StringInterface provides an interface for passing strings. It's implemented by EditField and DatabaseCursorField.
Methods
SetString(s as String)For EditFields, calling SetString sets the EditField's text property.

Class Interface StringProvider

Description
This interface is implemented by DatabaseCursorField and PopupMenu. StringProvider is listed in the language reference, but the documentation is incorrect in that it claims that StringProvider also has a SetString method.
Methods
GetString as String

Class Interface tupleInterface

Description
Supported by DatabaseRecord.
Methods
FieldCount as IntegerFor DatabaseRecord objects, returns the number of columns added.
getIndString(i as Integer) as StringgetIndString(i) appears to return the values of the fields, in reverse order.

Quantum Meruit

RB Development

Last Modified 3/21/2002