bindable (attribut)
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