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