RoomlePlannerUiCallback.Internal.ExternalObjectUiCallback

planner-core/src/roomle-planner-ui-callback.internal.ExternalObjectUiCallback

Implemented by

Table of contents

Methods

Methods

onDeleteExternalObjectGroup

onDeleteExternalObjectGroup(groupIdToDelete): void

"onDeleteExternalObjectGroup" is invoked when a group of root modules and all the root modules it contains are deleted. The group with the ID "groupIdToDelete" is removed from the plan and is completely deleted.

Parameters

Name
Type
Description

groupIdToDelete

string

The ID of the group of root modules.

Returns

void


onDeleteExternalObjectRootModule

onDeleteExternalObjectRootModule(remainingGroup, rootModuleIdToDelete, splitOffGroups?): void

"onDeleteExternalObjectRootModule" is invoked when a root module is deleted from a group of root modules. The root module with the ID "rootModuleIdToDelete" is removed from the group with the ID "group.id" and is completely deleted. "group" contains the information about the group and the remaining root modules. If removing the root module results in a group of root modules being split into two or more groups, "splitGroups" contains the information about the new groups and root modules. This callback is not be called when the solely remaining root module of a group is deleted. In this case, "onDeleteExternalObjectGroup" is called.

Parameters

Name
Type
Description

remainingGroup

-

rootModuleIdToDelete

string

The ID of the root module.

splitOffGroups?

-

Returns

void


onDeleteExternalObjectSubModule

onDeleteExternalObjectSubModule(rootModuleId, subModuleIdToDelete): void

"onDeleteExternalObjectSubModule" is invoked when a sub module is deleted from a root module. The sub module with the ID "subModuleIdToDelete" is removed from the root module with the ID "rootModuleId" and is completely deleted.

Parameters

Name
Type
Description

rootModuleId

string

The ID of the root module.

subModuleIdToDelete

string

The ID of the sub module.

Returns

void


onDuplicateExternalObjectGroup

onDuplicateExternalObjectGroup(sourceGroupId, newGroupPosition): void

"onDuplicateExternalObjectGroup" is invoked when a group of root modules is duplicated. This event request generating a completely new group with the an new root modules with exactly the same structure as the group wih the ID "sourceGroupId". The new group is placed at the position and orientation defined in "newGroupPosition".

Parameters

Name
Type
Description

sourceGroupId

string

The ID of the source group of root modules.

newGroupPosition

The position and orientation of the new group.

Returns

void


onExternalObjectAttributeChanged

onExternalObjectAttributeChanged(rootModuleId, subModuleId, attributeId, value): void

"oneExternalObjectAttributeChanged" is invoked when an attribute of a root module or sub module has changed. The attribute with the ID "attributeId" of the sub module with the ID "subModuleId" of the root module with the ID "rootModuleId" has the new value "value". If "subModuleId" is "null", an attribute of the root module has changed.

Parameters

Name
Type
Description

rootModuleId

string

The ID of the root module.

subModuleId

string

The ID of the sub module or "null".

attributeId

string

The ID of the attribute.

value

string

The new value of the attribute.

Returns

void


onExternalObjectEnvironmentChanged

onExternalObjectEnvironmentChanged(affectedGroupIds): void

"onExternalObjectEnvironmentChanged" is invoked when the plan (walls, doors, windows, etc.) has changed. "affectedGroupIds" contains the IDs of all groups of root modules that are affected by the change.

Parameters

Name
Type
Description

affectedGroupIds

string[]

The IDs of the groups of root modules that are affected by the change.

Returns

void


onExternalObjectGroupChanged

onExternalObjectGroupChanged(stringifiedGroupData): void

"onExternalObjectGroupChanged" is invoked when the modules of a group itself have changed. This can be the case in relation with undo/redo operations. "stringifiedGroupData" contains the complete information about the group and the root modules.

Parameters

Name
Type
Description

stringifiedGroupData

string

The group data as string.

Returns

void


onExternalObjectGroupLoaded

onExternalObjectGroupLoaded(stringifiedGroupData): void

onExternalObjectGroupLoaded is invoked when an external object is loaded from a plan.

Parameters

Name
Type
Description

stringifiedGroupData

string

The group data as string.

Returns

void


onExternalObjectModuleSelected

onExternalObjectModuleSelected(groupId, rootModuleId, subModuleId): void

"onExternalObjectModuleSelected" is invoked when the selection has been changed by and user interaction and a group, a root module or a sub module is selected.

Parameters

Name
Type
Description

groupId

string

The ID of the group of root modules.

rootModuleId

string

The ID of the root modules. Is null if a group is selected.

subModuleId

string

The ID of the sub module. Is null if a group or a root module is selected.

Returns

void


onExternalObjectSelectionCancel

onExternalObjectSelectionCancel(): void

"onExternalObjectSelectionCancel" is invoked when the selection of a group, root module or sub module is canceled.

Returns

void


onMergeExternalObjectGroup

onMergeExternalObjectGroup(targetGroup, sourceGroupId): void

"onMergeExternalObjectGroup" is invoked when a group of root modules is merged into another group of root modules. The group with the ID "sourceGroupId" is merged into the group with the ID "targetGroup.id". The root modules of the source group are added to the target group and the soured group does no longer exist. "targetGroup" contains information about all root modules of the target group (both present and new) and their relative position and orientation.

Parameters

Name
Type
Description

targetGroup

The target group of root modules.