2.160 .idispatch

The Idispatch COM interface pointer of the object can be accessed through this attribute under Microsoft Windows. When a new value is set to an object, the saved COM object will be deleted.

Definition

  • Data type

    pointer

  • Access

    get

    set (document, subcontrol)

  • changed event

    no

  • C

    Identifier: AT_idispatch

    Data type: DT_pointer

  • COBOL

    Identifier: AT-idispatch

    Data type: DT-pointer

  • Inheritance

    no

  • Classification

    object-specific attribute

  • Objects

    control, doccursor, document, subcontrol

In the Rule Language the attribute can only be assigned to the same attribute of a different Dialog Manager object. Be aware, that in the programming interface the COM object is only valid during the time when it is in use by the Dialog Manager. Therefore, an application should increase its reference counter (COM Method: IUnknown->AddRef). When the object is no longer needed, the counter should be set back again, or decreased (COM Method: IUnknown->Release). Please note, the counter cannot be decreased more often than it is increased. Otherwise, the COM object will be released. The Dialog Manager cannot recognize this situation and this will lead to a system crash. The Dialog Manager will also crash if the given pointer does not point to a COM interface.

The attribute is available for the control in mode_client, the XML Cursor, the XML Document and the subcontrol. It, however, cannot be passed down. The XML Document tests to see if the IXMLDOMDocument2 COM interface is implemented, while the XML Cursor tests to see if the IXMLDOMNode COM interface is implemented. Please note, an XML Cursors, whose attribute .mapped possesses the value false, will automatically be positioned to the root of the DOM document.