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] 
        HRESULT 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

See Also

bindable, TYPEFLAGS, interface, dispinterface, ODL File Syntax, ODL File Example, Generating a Type Library With MIDL