2.161 .idispatch

Über dieses Attribut kann unter Microsoft Windows auf den IDispatch COM Interface Pointer des Objekts zugegriffen werden. Wenn beim Objekt ein neuer Wert gesetzt wird, wird das gespeicherte COM Objekt gelöscht.

Definition

  • Datentyp

    pointer

  • Zugriff

    get

    set (document, subcontrol)

  • changed-Ereignis

    nein

  • C

    Bezeichner: AT_idispatch

    Datentyp: DT_pointer

  • COBOL

    Bezeichner: AT-idispatch

    Datentyp: DT-pointer

  • Vererbung

    nein

  • Klassifizierung

    Objektspezifisches Attribut

  • Objekte

    control, doccursor, document, subcontrol

In der Regelsprache darf das Attribut nur demselben Attribut eines anderen Dialog Manager Objektes zugewiesen werden. In den Programmierschnittstellen ist zu beachten, dass das COM Objekt nur so lange gültig ist, wie der Dialog Manager dieses verwendet. Eine Anwendung sollte deshalb nach einer Abfrage den Referenzzähler sofort erhöhen (COM Methode: IUnknown->AddRef). Wenn das Objekt nicht mehr gebraucht wird, muss der Zähler wieder heruntergezählt werden (COM Methode: IUnknown->Release). Es darf aber auf gar keinen Fall der Zähler öfter erniedrigt als erhöht werden, da sonst das COM Objekt freigegeben wird. Der Dialog Manager kann diese Situation nicht erkennen und wird abstürzen. Der Dialog Manager wird ebenso abstürzen, wenn der angegebene Zeiger nicht auf ein COM Interface zeigt.

Das Attribut ist für das Control im mode_client, den XML-Cursor, das XML-Dokument und das Subcontrol verfügbar, es ist nicht vererbbar. Das XML-Dokument überprüft, ob das IXMLDOMDocument2 COM Interface implementiert ist und der XML-Cursor überprüft, ob das IXMLDOMNode COM Interface implementiert ist. Es ist zu beachten, dass ein XML-Cursor, dessen Attribut .mapped den Wert false besitzt, automatisch auf die Wurzel des DOM-Dokuments positioniert wird.