bindable (attribut)

  • Article

L’attribut [pouvant être lié] indique que la propriété prend en charge la liaison de données.

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

Paramètres

interface-attribute-list

Spécifie une liste de zéro ou plusieurs attributs IDL qui s’appliquent à l’interface dans son ensemble. Lorsque plusieurs attributs d’interface sont présents, ils doivent être séparés par des virgules.

nom_interface

Spécifie le nom de l’interface.

attribute-list

Spécifie zéro ou plusieurs attributs qui s’appliquent au prototype de fonction pour une propriété ou une méthode dans une interface ou une dispinterface. Les attributs suivants sont valides : [helpstring], [helpcontext], [string], [defaultbind], [displaybind], [immediatebind], [propget], [propput], [propputref] et [vararg]. Si vararg est spécifié, le dernier paramètre doit être un tableau sécurisé de type VARIANT. Séparez plusieurs attributs par des virgules.

returntype

Spécifie le type de retour de la fonction.

function-name

Spécifie le nom de la fonction à laquelle l’attribut [pouvant être lié] sera appliqué.

params

Liste des paramètres de fonction.

Notes

En prenant en charge la liaison de données, l’attribut [pouvant être lié] permet au client d’être averti chaque fois qu’une propriété a changé de valeur. (Si vous souhaitez que le client soit informé des modifications imminentes apportées à une propriété, utilisez l’attribut [requestedit]. )

Étant donné que l’attribut [pouvant être lié] fait référence à la propriété dans son ensemble, il doit être spécifié partout où la propriété est définie. Par conséquent, vous devez spécifier l’attribut à la fois sur la fonction d’accès aux propriétés et sur la fonction de paramètre de propriété.

Indicateurs

FUNCFLAG_FBINDABLE, VARFLAG_FBINDABLE

Exemples

[
    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); 
}

Voir aussi

defaultbind

dispinterface

displaybind

Génération d’une bibliothèque de types avec MIDL

helpstring

helpcontext

immediatebind

Interface

Exemple de fichier ODL

Syntaxe de fichier ODL

propget

propput

propputref

requestedit

String

TYPEFLAGS

vararg