start editing

Typecommand
DictionaryLCS
LibraryLiveCode Script
Syntax
start editing <group> [of <stack>]
Associationsgroup
Summary

Puts a stack into group-editing mode.

Introduced1.0
OSmac, windows, linux, ios, android
Platformsdesktop, server, mobile
Parameters
NameTypeDescription
group

A reference to a group you want to edit.

stack

A reference to the stack that contains the group you want to edit.

Example
start editing group "container"
RelatedProperty: foregroundColor, properties, editBackground, relayerGroupedControls
Command: remove, start editing, place, group, stop editing, ungroup
Object: stack
Glossary: object, inheritance, handler, object hierarchy, group, debugger, command, current stack
Description

Use the start editing command to add objects to a group or change the objects in a group.

If you don't specify a stack, the specified group in the current stack is put into group-editing mode.

Any objects created while in group-editing mode are added to that group.

When a group is in group-editing mode, font and color properties for the group (though not for objects in the group) are disregarded. This means that if properties such as textFont, foregroundColor, and so on are set for the group, it displays differently when in group-editing mode, using the fonts and colors of the stack the group is in. As soon as you exit group-editing mode with the stop editing command, the group's correct appearance is restored.

Note: The start editing command temporarily modifies the object hierarchy, displaying only the objects that belong to the group being edited. Inherited font and color properties may not appear correctly while the group is being edited, but will be restored whhen you exit group-editing mode. Also, if the start editing command is included in a handler, using the debugger to step through that handler may cause unexpected results because of the change in object context.