Skip to main content

onDrawingNewRevision

Last updated 12/05/2026

Definition​

onDrawingNewRevision
is a host callback invoked by
DimensionIQWidget
 when a user creates a new drawing revision in the widget. As part of this process, the host appliction must delete the provided

previousLayouts
from storage and replace them with
newLayouts
, ensuring the revision reflects the updated state. The host application must handle the persistent storage of the drawing revision and manage the update from the previous layouts to the new layouts.

Once processing is complete, please refer to the onResponse contract in the Widget Callback Introduction.

This callback ensures the widget and the host application remain synchronized when a drawing revision is updated with new layouts.

Function Signature​

TypeScript
Function Signature
onDrawingNewRevision: (
    drawing: DIQ_DrawingRevision,
    previousLayouts: Array<DIQ_Layout>,
    newLayouts: Array<DIQ_Layout>,
    onResponse: (result: DIQ_Result) => void
) => void;

Callback Parameters​

drawing
Type: DIQ_DrawingRevision
Description: The

DIQ_DrawingRevision
object associated with the update.

previousLayouts
Type: Array<DIQ_Layout>
Description: An array of

DIQ_Layout
objects that existed before the revision change.

newLayouts
Type: Array<DIQ_Layout>
Description: An array of

DIQ_Layout
objects after the new revision has been applied.

onResponse
Type: (result: DIQ_Result) => void
Description: Callback function that must be called by the host to complete the operation.

Examples​

onDrawingNewRevision