immediatebind (attribut)
L’attribut [ immediatebind ] indique que la base de données sera immédiatement notifiée de toutes les modifications apportées à la propriété d’un objet lié aux données.
[
interface-attribute-list
]
interface | dispinterface interface-name
{
[bindable, immediatebind[, optional-attribute-list]] returntype function-name(params)
}
Paramètres
-
interface-attribut-List
-
Spécifie une liste d’un ou plusieurs attributs qui s’appliquent à l’ensemble de l’interface.
-
nom de l’interface
-
Spécifie le nom de l' interface ou de dispinterface.
-
Optional-attribute-List
-
Zéro, un ou plusieurs attributs de fonction.
-
ReturnType
-
Spécifie le type de retour de la fonction.
-
nom de fonction
-
Spécifie le nom de la fonction dans le fichier IDL.
-
params
-
Zéro, un ou plusieurs paramètres de fonction.
Notes
L’attribut [ immediatebind ] permet aux contrôles de faire la différence entre les propriétés qui doivent notifier la base de données de chaque modification et celles qui ne le font pas. Par exemple, chaque modification apportée à un contrôle de case à cocher doit être envoyée immédiatement à la base de données sous-jacente, même si le contrôle n’a pas perdu le focus. Toutefois, pour un contrôle ListBox, une modification se produit chaque fois qu’une sélection différente est mise en surbrillance. Notifier la base de données d’une modification avant que le contrôle ne perde le focus n’est pas efficace et inutile. L’attribut [ immediatebind ] vous permet de spécifier, en définissant le bit immediatebind, des propriétés individuelles sur un formulaire dont les modifications doivent être signalées immédiatement.
Les propriétés qui ont l’attribut [ immediatebind ] doivent également avoir l' [ attribut pouvant être lié ] .
Indicateurs
FUNCFLAG _ FIMMEDIATEBIND, VARFLAG _ FIMMEDIATEBIND
Exemples
[
uuid(12345678-1234-1234-1234-123456789ABC)
]
interface MyObject : IUnknown
{
properties:
methods:
[id(1), propget, bindable, immediatebind] long Size(void);
[id(1), propput, bindable,
immediatebind] HRESULT Size([in]long lSize);
}