View source for SDK:Similar Objects Creation

{{LocationMain|category=LocationSDKSpecial|specific=}}
<div class="rightmenu">
__TOC__
</div>

By [mailto:vstanev@nemetschek.net Vladislav Stanev]

== What's that ==

Make the menu command 'Create Similar Object' work for any custom parametric.

== Parametric Object Part ==

The parametric object responds to event with the name of the tool that should be activated. The name of the tool is actually the name of the dynamic library of the tool plug-in.

In your parametric plug-in you should handle [[SDK:Plug-in Object Events#kObjOnGetToolName|kObjOnGetToolName]] event inside your [[SDK:Plug-in Object Main Function]].

<code lang="cpp">
long ParametricMain(long action, MCObjectHandle hParametricObj, long message, long &userData)
{
  // ...
  long	reply = kParametricNoErr;
  switch (action) {

    // ...

    case kObjOnGetToolName: {
      TXString*	pToolName	= (TXString*) message;
      if ( pToolName ) {
         // return the dyn library file name of the tool plug-in
         *pToolName	= "SampleObjectTool";
         reply		= kObjectEventHandled;
      }
      break;

    // ...

  }

  return reply;
}
</code>

== Tool Part ==

The tool is notified by VectorWorks for the object that needs to be duplicated.

In your tool plug-in you should handle [[SDK:Plug-in Tool Events#kToolInitByObject|kToolInitByObject]] event inside your [[SDK:Plug-in Tool Main Function]].

The tool can setup itself properly by the specified object Handle.

<b>Note</b> VectorWorks have already copied the parametric record data.

<code lang="cpp">
long ToolMain(long action, long message1, long message2, long &userData)
{
  // ...

  switch (action) {

    // ...

    case kToolInitByObject: {
      MCObjectHandle hTheObject	= (MCObjectHandle) message1;

      // use hTheObject to set proper default data in your tool.
      // NOTE: VectorWorks have already copied the parametric record data
      // ...

      break;
    }


    // ...
  }
}
</code>

== See also ==

[[SDK:Plug-in Tool Events]] |
[[SDK:Parametric Tool Plug-in]]

[[Category:SDK]]