immediatebind

[interface-attribute-list] interface | dispinterface interface-name
{
[bindable, immediatebind[, optional-attribute-list]] returntype function-name(params)
}

Example

[uuid(. . .)] interface MyObject : IUnknown

{

properties:

methods:

[id(1), propget, bindable, immediatebind]

long Size(void);

[id(1), propput, bindable, immediatebind]

void Size([in]long lSize);

}

Remarks

The immediatebind attribute indicates that the database will be notified immediately of all changes to a property of a data-bound object.

This attribute allows controls to differentiate between properties that need to notify the database of every change, and those that do not. For example, every change to a checkbox control should be sent to the underlying database immediately, even if the control has not lost the focus. However, for a listbox control, a change occurs whenever a different selection is highlighted. Notifying the database of a change before the control loses focus would be inefficient and unnecessary. The immediatebind attribute allows individual properties on a form to specify, by setting the ImmediateBind bit, that changes should be reported immediately.

Properties that have the immediatebind attribute must also have the bindable attribute.

Flags

FUNCFLAG_FIMMEDIATEBIND, VARFLAG_FIMMEDIATEBIND