bindable 特性

[bindable] 属性指示该属性支持数据绑定。

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

参数

interface-attribute-list

指定应用于整个接口的零个或多个 IDL 属性的列表。 当存在两个或多个接口属性时,它们必须用逗号分隔。

interface-name

指定接口的名称。

attribute-list

指定应用于 接口非接口中属性或方法的函数原型的零个或多个属性。 以下属性有效: [helpstring][helpcontext][string][defaultbind][displaybind][immediatebind][propget][propput][propputref][vararg]。 如果指定 vararg ,则最后一个参数必须是 VARIANT 类型的安全数组。 用逗号分隔多个属性。

returntype

指定函数的返回类型。

function-name

指定将应用 [bindable] 属性的函数的名称。

params

函数参数列表。

注解

通过支持数据绑定, [bindable] 属性允许每当属性更改值时通知客户端。 (如果希望客户端收到属性即将发生更改的通知,请使用 [requestedit] attribute.)

由于 [bindable] 属性引用整个属性,因此必须在定义属性的位置指定该属性。 因此,需要在属性访问函数和属性设置函数上指定属性。

Flags

FUNCFLAG_FBINDABLE、VARFLAG_FBINDABLE

示例

[
    uuid(1e196b20-1f3c-1069-996b-00dd010fe676)
]
dispinterface MyObject 
{ 
    properties: 
    methods: 
        [id(1), propget, bindable, defaultbind, displaybind] long x(); 
        [id(1), propput, bindable, 
        defaultbind, displaybind] HRESULT x(long rhs); 
}

另请参阅

defaultbind

dispinterface

displaybind

使用 MIDL 生成类型库

helpstring

helpcontext

immediatebind

接口

ODL 文件示例

ODL 文件语法

propget

propput

propputref

requestedit

string

TYPEFLAGS

vararg