In Kanzi Studio create a project using the Application template.
In the Node Tree create a node for which you want to enable the drag-and-drop gesture.
For example, create an Empty Node 2D node and name it DragAndDropNode .
In the Node Tree select the node that you created in the previous step, in the Properties add the Input > Hit Testable property, and set it to enabled.
When you enable this property you enable the user to pick a node.
By default hit testing is enabled for the Button , Toggle Button , List Box Item Container , Scroll View , Slider , and Text Box nodes.
See Defining which node receives input
In the Node Tree press Alt and right-click the node that you created and select Alias .
Kanzi Studio creates an alias pointing to the node from which you created the alias and adds it to the resource dictionary of its nearest ancestor node that contains a resource dictionary.
Access alias target nodes using the #
Select File > Export > Export KZB .
Kanzi Studio creates the kzb file and configuration files from your Kanzi Studio project. Kanzi Studio stores the exported files in the <ProjectName>/Application/bin Project > Properties in the Binary Export Directory property. The kzb file contains all nodes and resources from your Kanzi Studio project, except the resources that you mark in a localization table as locale packs.
When you run your Kanzi application from Visual Studio, your application loads the kzb file and configuration files.
In Kanzi Studio, select File > Open Kanzi Command Prompt .
The Kanzi Command Prompt opens the Windows Command Prompt with the Kanzi environment variables set for the version of Kanzi for which you open a Kanzi Command Prompt.
Use the Kanzi Command Prompt to access Kanzi utilities and build tools, such as Gradle, SCons, and CMake, without using absolute paths or setting environment variables.
Tip
You can find the Kanzi Command Prompt in the Windows Start Menu in the Rightware directory.
When you have more than one version of Kanzi installed, make sure that you launch a Kanzi Command Prompt for the version of Kanzi with which you want to work in that command prompt.
In the Kanzi Command Prompt in the <ProjectName>/Application
For example, if you use Visual Studio 2019, run
generate_cmake_vs2019_solution . bat
Copy to clipboard
This script generates a Visual Studio solution for the application in the directory <ProjectName>/Application/build_vs2019
In Visual Studio open the <ProjectName>/Application/build_vs<Version>/<ProjectName>.sln DragAndDropManipulator
Define the handlers for the drag-and-drop messages.
For example, after the public section of the class which implements the logic of your application add:
private :
// Define the handler for the DragAndDropManipulator::StartedMessage message from 2D nodes
// that have an input manipulator which generates drag-and-drop messages.
// This prepares the 2D node for dragging.
void onDragStarted ( DragAndDropManipulator :: StartedMessageArguments & messageArguments )
{
// Get from the message arguments the node that the user drags.
Node2DSharedPtr dragAndDropNode = dynamic_pointer_cast < Node2D > ( messageArguments . getSource ());
if ( ! dragAndDropNode )
{
return ;
}
// Save the point from which the user started dragging the node,
// relative to the origin (by default the top left corner) of the node.
m_dragGrabOffset = messageArguments . getPoint ();
// When starting a drag-and-drop gesture on the node, bring the node to front.
dragAndDropNode -> moveToFront ();
}
// Define the handler for the DragAndDropManipulator::MovedMessage message from 2D nodes
// that have an input manipulator which generates drag-and-drop messages.
// This translates (moves) the node by the distance the user drags it.
void onDragMoved ( DragAndDropManipulator :: MovedMessageArguments & messageArguments )
{
// Get from the message arguments the node that the user drags.
Node2DSharedPtr dragAndDropNode = dynamic_pointer_cast < Node2D > ( messageArguments . getSource ());
if ( ! dragAndDropNode )
{
return ;
}
// Move the node by traveled distance given by getPoint, relative to the origin of the node.
// To keep dragging from the same point on the node, subtract the grab offset.
SRTValue2D transform = dragAndDropNode -> getLayoutTransformation ();
transform . translate ( messageArguments . getPoint () - m_dragGrabOffset );
dragAndDropNode -> setLayoutTransformation ( transform );
}
// Offset from the top left corner of the DragAndDropNode where the user pressed down or clicked on it.
Vector2 m_dragGrabOffset ;
Copy to clipboard
In the Application::onProjectLoaded DragAndDropManipulator
For example, add:
void onProjectLoaded () override
{
ScreenSharedPtr screen = getScreen ();
Domain * domain = getDomain ();
// Get the DragAndDropNode using its alias.
NodeSharedPtr dragAndDropNode = screen -> lookupNode < Node > ( "#DragAndDropNode" );
// Create an input manipulator that generates drag-and-drop messages.
DragAndDropManipulatorSharedPtr nodeDragAndDropManipulator = DragAndDropManipulator :: create ( domain );
// Add the input manipulator to the DragAndDropNode.
dragAndDropNode -> addInputManipulator ( nodeDragAndDropManipulator );
// Set the duration of the long press before the drag-and-drop starts to 200 ms. The default is 500 ms.
// This is the amount of time the user has to press the node before they can start dragging it.
nodeDragAndDropManipulator -> setPressDuration ( chrono :: milliseconds ( 200 ));
// Subscribe to the DragAndDropManipulator::StartedMessage message at the DragAndDropNode node.
// The DragAndDropManipulator generates this message when the user has pressed the node
// for the duration set by DragAndDropManipulator::setPressDuration.
dragAndDropNode -> addMessageHandler ( DragAndDropManipulator :: StartedMessage , bind ( & MyProject :: onDragStarted , this , placeholders :: _1 ));
// Subscribe to the DragAndDropManipulator::MovedMessage message at the DragAndDropNode node.
// The DragAndDropManipulator generates this message when the finger or mouse moves.
dragAndDropNode -> addMessageHandler ( DragAndDropManipulator :: MovedMessage , bind ( & MyProject :: onDragMoved , this , placeholders :: _1 ));
}
Copy to clipboard
Build and run your application. See Deploying Kanzi applications
In the application long-press and drag the node for which you enabled the drag-and-drop gesture.