immediatebind-Attribut

Artikel
06/13/2023

Das [immediatebind] -Attribut gibt an, dass die Datenbank sofort über alle Änderungen an einer Eigenschaft eines datengebundenen Objekts benachrichtigt wird.

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

Parameter

interface-attribute-list: Gibt eine Liste mit einem oder mehreren Attributen an, die für die Schnittstelle als Ganzes gelten.
Schnittstellenname: Gibt den Namen der Schnittstelle oder der Dispinterface an.
optional-attribute-list: Null oder mehr Funktionsattribute.
returntype: Gibt den Rückgabetyp der Funktion an.
Funktionsname: Gibt den Namen der Funktion in der IDL-Datei an.
params: Null oder mehr Funktionsparameter.

Bemerkungen

Mit dem [immediatebind]- Attribut können Steuerelemente zwischen Eigenschaften unterscheiden, die die Datenbank über jede Änderung benachrichtigen müssen, und solchen, die dies nicht tun. Beispielsweise sollte jede Änderung an einem Kontrollkästchen-Steuerelement sofort an die zugrunde liegende Datenbank gesendet werden, auch wenn das Steuerelement den Fokus nicht verloren hat. Bei einem Listbox-Steuerelement tritt jedoch eine Änderung auf, wenn eine andere Auswahl hervorgehoben wird. Die Datenbank über eine Änderung zu benachrichtigen, bevor das Steuerelement den Fokus verliert, wäre ineffizient und unnötig. Mit dem [immediatebind]- Attribut können Sie durch Festlegen des ImmediateBind-Bits einzelne Eigenschaften für ein Formular angeben, deren Änderungen sofort gemeldet werden sollen.

Eigenschaften, die über das [immediatebind]- Attribut verfügen, müssen ebenfalls über das Attribut [bindable] verfügen .

Flags

FUNCFLAG_FIMMEDIATEBIND, VARFLAG_FIMMEDIATEBIND

Beispiele

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

Weitere Informationen

bindable
TYPEFLAGS
Schnittstelle
Dispatchschnittstelle
ODL-Dateisyntax
ODL-Dateibeispiel
Generieren einer Typbibliothek mit MIDL

Share via