public interface IEditHandles
Feature
or a Geometry
for example, can be modified.
This collection keeps itself up-to-date while the edited object changes.
See the related guide for an overview of the editing API.
The responsibilities of this class are to:
changes externally
.
IEditHandlesObserver
s, and fire the appropriate EditHandlesEvent
s whenever handles are added or removed.
Note: IEditHandles
is only accessed on the UI thread by Editor
.
Modifier and Type | Method and Description |
---|---|
void |
addObserver(IEditHandlesObserver observer)
Adds an observer that allows you to receive change events when a handle is added or removed.
|
List<IEditHandle> |
getList() |
void |
removeObserver(IEditHandlesObserver observer)
Removes the given observer.
|
@NotNull List<IEditHandle> getList()
IEditHandle
instances that can be used for editing. To make sure these handles are used in a consistent way, it's important to return them in a consistent order. The Editor
prioritizes handles for event handling according to the order they are returned in. The first returned element has the highest priority. All handles returned by this method must be valid, meaning that null
handles must be filtered out.void addObserver(@NotNull IEditHandlesObserver observer) throws NullPointerException, IllegalArgumentException
Adding the same observer twice is forbidden, and will cause an exception to be thrown.
observer
- an observer.IllegalArgumentException
- when the observer was already added.NullPointerException
- when the observer is null
.void removeObserver(@NotNull IEditHandlesObserver observer) throws NullPointerException, IllegalArgumentException
If the given observer was never added or already removed, an exception is thrown.
observer
- an observer.IllegalArgumentException
- when the observer is not known.NullPointerException
- when the observer is null
.