LuciadCPillar C# 2024.0.08
Luciad.Edit.Handles Namespace Reference

Edit handles. More...

Classes

class  EditActionBinder
 This class allows you to specify more options or requirements for actions that can be executed by handles, such as the mouse buttons that users need to click for the action to be executed, or the mouse cursor that is displayed when interacting with the handle. More...
 
class  EditHandlesEvent
 Event that indicates that the collection of edit handles has changed. More...
 
interface  IEditHandle
 An edit handle is a visual element on the Map that can react to events to perform an edit operation. More...
 
interface  IEditHandles
 Represents a collection of handles that determine how an edited object, a Feature or a Geometry for example, can be modified. More...
 
interface  IEditHandlesObserver
 An observer that allows you to receive change events from an IEditHandles when the collection of handles changes. More...
 
interface  IPointEditAction
 Abstraction of an action that is executed based on a Point. More...
 
interface  ITranslateEditAction
 A translate action performs a translation of a geometry or feature. More...
 
class  PointEditHandle
 This handle represents a Point on the Map and can be visualized using an icon. More...
 
class  TranslateEditHandle
 This handle allows you to translate a feature by translating its geometry using ITranslateEditAction. More...
 

Enumerations

enum  EditHandleState { Inactive , Highlighted , Active }
 The possible states of an IEditHandle. More...
 
enum  EditMoveConstraint { XY , Z }
 A constraint that determines how a move operation is constrained. More...
 

Detailed Description

Edit handles.

An edit handle is a visual element on the Map that can react to events to perform an edit operation. See the related guide for an overview of the editing API.

Enumeration Type Documentation

◆ EditHandleState

The possible states of an IEditHandle.

The state determines the order in which events are dispatched to a handle, and the order in which the mouse cursor is retrieved: Active > Highlighted > Inactive

Depending on their state, handles are usually visualized differently or have a different mouse cursor.

Since
2020.1
Enumerator
Inactive 

Inactive handles have the lowest priority when it comes to event handling.

Both highlighted and active handles have a higher priority. They are also typically painted differently than highlighted or active handles, and they typically don't trigger the use of a non-standard mouse cursor.

Highlighted 

Highlighted handles are not interacted with, but signal that they are ready for interaction.

Handles are typically highlighted when users hover over them using the mouse. As for handling events, active handles take precedence. Highlighted handles however take precedence over other handles, and get the chance to become active first.

Highlighted handles can be painted differently to make it visually clear that they can be interacted with, or they can trigger the use of a different mouse cursor.

Active 

Active handles are handles that users are currently interacting with.

This is the case while a user drags a point handle, for example. Active handles get the chance to consume events before any other handle.

Active handles can be painted differently to make it visually clear that they are being interacted with, or they can trigger the use of a different mouse cursor.

◆ EditMoveConstraint

A constraint that determines how a move operation is constrained.

It is used by PointEditHandle for example, to configure if the handle can be moved horizontally (parallel to the map) or vertically (in the Z direction).

Since
2020.1
Enumerator
XY 

With this constraint, moving is only allowed in the x- and y-directions.

With this constraint, moving is only allowed in the Z direction, keeping the x- and y-direction constant.