Documentation

Unity Engine


User Manual

Script Reference

Unity Engine


CursorLockMode

How the cursor should behave.
Read time 1 minuteLast updated 4 days ago

Definition

  • Type: Enum
  • Namespace: UnityEngine
  • Assembly: UnityEngine.CoreModule
public enum CursorLockMode

Remarks

These are various modes that control the behaviour of the Cursor. A default cursor must be set in PlayerSettings > Default Cursor.

Examples

//This script makes Buttons that control the Cursor's lock state. Note that the Confined mode only works on Windows and Linux Standalone platform build.using UnityEngine;public class Example : MonoBehaviour{ void Update() { //Press the space bar to apply no locking to the Cursor if (Input.GetKey(KeyCode.Space)) Cursor.lockState = CursorLockMode.None; } void OnGUI() { //Press this button to lock the Cursor if (GUI.Button(new Rect(0, 0, 100, 50), "Lock Cursor")) { Cursor.lockState = CursorLockMode.Locked; } //Press this button to confine the Cursor within the screen if (GUI.Button(new Rect(125, 0, 100, 50), "Confine Cursor")) { Cursor.lockState = CursorLockMode.Confined; } }}

Fields

Value

Description

ConfinedConfine cursor to the game window.
LockedLocks the cursor to the center of the Game view.
NoneCursor behavior is unmodified.