bindable (attributo)

Articolo
06/13/2023

L'attributo [associabile] indica che la proprietà supporta il data binding.

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

Parametri

interface-attribute-list: Specifica un elenco di zero o più attributi IDL che si applicano all'interfaccia nel suo complesso. Quando sono presenti due o più attributi di interfaccia, devono essere separati da virgole.
nome dell'interfaccia: Specifica il nome dell'interfaccia.
attribute-list: Specifica zero o più attributi che si applicano al prototipo di funzione per una proprietà o un metodo in un'interfaccia o dispinterface. Gli attributi seguenti sono validi: [helpstring], [helpcontext], [string], [defaultbind], [displaybind], [immediatebind], [propget], [propput], [propputref]e [vararg]. Se viene specificato vararg , l'ultimo parametro deve essere una matrice sicura di tipo VARIANT. Separare più attributi con virgole.
Returntype: Specifica il tipo restituito della funzione.
nome funzione: Specifica il nome della funzione a cui verrà applicato l'attributo [associabile].
params: Elenco dei parametri della funzione.

Commenti

Supportando il data binding, l'attributo [associabile] consente al client di ricevere una notifica ogni volta che una proprietà ha modificato il valore. Se si vuole che il client riceva una notifica delle modifiche in sospeso a una proprietà, usare l'attributo [requestedit] .

Poiché l'attributo [associabile] fa riferimento alla proprietà nel suo complesso, deve essere specificato ovunque sia definita la proprietà. È quindi necessario specificare l'attributo sia nella funzione di accesso alla proprietà che nella funzione di impostazione delle proprietà.

Flags

FUNCFLAG_FBINDABLE, VARFLAG_FBINDABLE

Esempi

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

Vedere anche

defaultbind
dispinterface
displaybind
Generazione di una libreria di tipi con MIDL
helpstring
helpcontext
immediatebind
Interfaccia
Esempio di file ODL
Sintassi del file ODL
propget
propput
propputref
requestedit
string
TYPEFLAGS
vararg

Condividi tramite