Legacy Documentation: Version 4.5.0

Script language:

  • JS
  • C#
  • Boo
Script language

Select your preferred scripting language. All code snippets will be displayed in this language.

HitTest(screenPosition: Vector3, camera: Camera = null): bool;
bool HitTest(Vector3 screenPosition, Camera camera = null);
def HitTest(screenPosition as Vector3, camera as Camera = null) as bool

Description

Is a point on screen inside the element.

Returns true if the screenPosition is contained in this GUIElement. screenPosition is specified in screen coordinates, like the values returned by Input.mousePosition property. If no camera is given a camera filling the entire game window will be assumed.

Note that if the position is inside the element, true will be returned even if the game object belongs to Ignore Raycast layer (normally mouse events are not sent to Ignore Raycast objects).

See Also: GUILayer.HitTest.

	if (guiText.HitTest (Vector3(360, 450, 0)))
		print ("This gui texture covers pixel 360, 450");
using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour {
    void Example() {
        if (guiText.HitTest(new Vector3(360, 450, 0)))
            print("This gui texture covers pixel 360, 450");
        
    }
}
import UnityEngine
import System.Collections

public class ExampleClass(MonoBehaviour):

	def Example() as void:
		if guiText.HitTest(Vector3(360, 450, 0)):
			print('This gui texture covers pixel 360, 450')