AcRxObject::x

C++

ACBASE_PORT AcRxObject* x(
    const AcRxClass* protocolClass
) const;

Description

This method searches for a protocol extension object associated with this class. The method begins the search by examining the AcRxClass object associated with this class, and if no protocol extension object is found, the search continues in this class's base class and so on up the inheritance tree for this class. This procedure provides a form of protocol extension inheritance. This class's AcRxClass member may be found by using this class's isA() method.

Because the intended usage is to immediately invoke a function in the returned object, if the search for a protocol extension object is unsuccessful, then acrx_abort() is called to cleanly terminate AutoCAD. If you would prefer to get a NULL returned instead of terminating AutoCAD, use the AcRxObject::queryX method instead.

Note that the returned protocol extension object is returned via a generic AcRxObject pointer, so you must cast down to the actual type of the protocol extension class in order to be able to access the methods in the protocol extension object. The cast() method is the safest way to do this.

Parameters

Links

AcRxObject