bindable 特性

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

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

参数

interface-attribute-list

指定应用于接口的零个或多个 IDL 属性作为一个整体的列表。 如果存在两个或多个接口属性,则必须用逗号分隔它们。

interface-name

指定接口的名称。

attribute-list

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

returntype

指定函数的返回类型。

function-name

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

params

函数参数列表。

备注

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

由于 [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