Message data sent to iframe is expected to be a JSON object with a messageName string and some message dependent strings.

{
  messageName: "nameOfTheMessage",
  ...
}

Supported messages

runcommand

Run a command in Kudo:

where resultMessage: if specified, a message with this name is posted to the iframe parent when command execution is done
and messageId: if specified, it is passed to the resultMessage

const message = {
  messageName: "runcommand",
  commandString: "_YourCommand",
  resultMessage: "nameOfPostedResultMessage", //optional
  messageId: "messageId" ;//optional
}
const iframe = document.getElementById("cadcontent");
iframe.contentWindow.postMessage(message, '*');

You can also pass parameters to your command like this:

 commandString: "_YourCommand Param1 Param2"

or

commandString: "_YourCommand\nParam1\nParam2"

const message = {
  messageName: "runcommand",
  commandString: "_LINE 0,0 10,10  "
}
const iframe = document.getElementById("cadcontent");
iframe.contentWindow.postMessage(message, '*');

<?xml version="1.0" encoding="UTF-8"?>
<commands>
 <OEM name="graebert">
   <command name="_XEREPLACEOPEN"/>
   <command name="_DOATTACHMENT"/>
   <command name=" _YourCommand"/>
 </OEM>
</commands>

runlisp

Execute the passed Lisp expression:

where resultMessage: if specified, a message with this name is posted to iframe parent when lisp execution is done
and messageId: if specified, it is passed to the resultMessage

const message = {
  messageName: "runlisp",
  lispExpression: "lispExpression",
  resultMessage: "nameOfPostedResultMessage", //optional
  messageId: "messageId"; //optional
}
const iframe = document.getElementById("cadcontent");
iframe.contentWindow.postMessage(message, '*');

eventRegister/eventDeRegister

Event types: commandEvent, sysVarEvent, lispEvent, drawingEvent, selectionEvent, drawingModifiedEvent

You can find available events on the event page. See https://graebert.atlassian.net/wiki/x/QAFdRg page for more details about events.

eventRegister

Register for receiving different types of additional events notifications.

where eventName will be the event type which you want to register:

const message = {
  messageName: "eventRegister",
  eventName: "commandEvent";//one of the above event types
}
const iframe = document.getElementById("cadcontent");
iframe.contentWindow.postMessage(message, '*');

eventDeRegister

Deregister to stop receiving different types of additional events notifications.

where eventName will be the event type which you want to deregister:

const message = {
  messageName: "eventDeRegister",
  eventName: "commandEvent";//one of the above event types
}
const iframe = document.getElementById("cadcontent");
iframe.contentWindow.postMessage(message, '*');

Upgrading/Downgrading

Upgrading: To change from View mode to Edit mode

Downgrading: Change from Edit mode to view mode

You can update the drawing state using send post message from iframe parent

where state can be “view” or “edit”

const message={
  messageName= “stateChanged”,
  state = “view”;
}
const iframe = document.getElementById("cadcontent");
iframe.contentWindow.postMessage(message, '*');

setvariable **

drawingdescription**

** Not implemented yet