Unreal Engine 4.26 Documentation

Unreal Engine 4.27 Documentation

Unreal Engine 5.0 Documentation

Unreal Engine 5.1 Documentation

Unreal Engine 5.2 Documentation

Unreal Engine 5.3 Documentation

> Unreal Engine API Reference > Runtime > InteractiveToolsFramework > BaseBehaviors > USingleClickInputBehavior

Light Theme

Dark Theme

USingleClickInputBehavior

[USingleClickInputBehavior](API\Runtime\InteractiveToolsFramework\BaseBehaviors\USingleClickInputBehavior) implements a standard "button-click"-style input behavior.

Choose your operating system:

Windows

macOS

Linux

Inheritance Hierarchy

UObjectBase

UObjectBaseUtility

UObject

UInputBehavior

UAnyButtonInputBehavior

USingleClickInputBehavior

ULocalSingleClickInputBehavior

References

Module	InteractiveToolsFramework
Header	/Engine/Source/Runtime/InteractiveToolsFramework/Public/BaseBehaviors/SingleClickBehavior.h
Include	#include "BaseBehaviors/SingleClickBehavior.h"

Syntax

class USingleClickInputBehavior : public UAnyButtonInputBehavior

Remarks

USingleClickInputBehavior implements a standard "button-click"-style input behavior. The state machine works as follows: 1) on input-device-button-press, hit-test the target. If hit, begin capture 2) on input-device-button-release, hit-test the target. If hit, call Target::OnClicked(). If not hit, ignore click.

The second hit-test is required to allow the click to be "cancelled" by moving away from the target. This is standard GUI behavior. You can disable this second hit test using the .HitTestOnRelease property. This is strongly discouraged.

The hit-test and on-clicked functions are provided by a IClickBehaviorTarget instance.

Variables

	Name	Description
bool	HitTestOnRelease	Hit-test is repeated on release (standard behavior). If false,
TFunction< bool...	ModifierCheckFunc	WantsCapture() will only return capture request if this function returns true (or is null)
FInputBehaviorM...	Modifiers	The modifier set for this behavior
IClickBehaviorT...	Target	Click Target object

Constructors

	Name	Description
	USingleClickInputBehavior()

Functions

		Name	Description
	void	Clicked ( const FInputDeviceState& Input, const FInputCaptureData& Data )	Internal function that forwards click evens to Target::OnClicked, you can customize behavior here
	void	Initialize ( IClickBehaviorTarget* Target )	Initialize this behavior with the given Target

Overridden from UInputBehavior

	Name	Description
FInputCaptur...	BeginCapture ( const FInputDeviceState& InputStat..., EInputCaptureSide eSide )	Called after WantsCapture() returns a capture request that was accepted
void	ForceEndCapture ( const FInputCaptureData& CaptureDa... )	If this is called, the Behavior has forcibly lost capture (eg due to app losing focus for example) and needs to clean up accordingly
FInputCaptur...	UpdateCapture ( const FInputDeviceState& InputStat..., const FInputCaptureData& CaptureDa... )	Called for each new input event during a capture sequence.
FInputCaptur...	WantsCapture ( const FInputDeviceState& InputStat... )	Given the input state, does this Behavior want to begin capturing some input devices?