ClickDetector

Tampilkan yang Tidak Digunakan Lagi

*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.

KlikDetektor mengizinkan Scripts dan Class.LocalScript|LocalScripts</

Skrip kontrol default mengikat ButtonR2 untuk berinteraksi dengan ClickDetectors menggunakan Class

MaxActivationDistance dapat digunakan untuk menghindari jarak yang dapat ditembus seorang pemain dari detektor klik sebelum itu tidak lagi dapat diklik.

ClickDetector acara berapi-api

Prioritas Masukan

Jika beberapa ClickDetectors dapat mendeteksi masukan pengguna, hanya yang paling dalam akan menembus acara kebakaran. Jika dua ClickDetectors adalah saudara kandung, yang pertama akan mengambil prioritas.

Jika tindakan berdasarkan dengan ContextActionService menggunakan input yang sama seperti ClickDetector, tindakan berdasarkan dengan ContextActionService akan mengambil prioritas atas acara klik detector.

UserInputService.InputBegan akan berfungsi sebelum acara ClickDetector.

Contoh Kode

Place this code inside a Script inside a ClickDetector. The code sample creates a reference to the parent and defines a function to show a message that greets a player. Finally, it connects the MouseClick event to the defined function.

ClickDetector Example 
local clickDetector = script.Parent



local function onClicked(player)

	-- Show a message to the player

	local msg = Instance.new("Message")

	msg.Parent = player:FindFirstChild("PlayerGui")

	msg.Text = "Hello, " .. player.Name

	wait(2.5)

	msg:Destroy()

end



-- Connect the function to the MouseClick event

clickDetector.MouseClick:Connect(onClicked)

This code sample will allow a part to be clicked to toggle its anchored property. When toggled, the visual appearance of the part is updated (red means anchored, yellow means free).

Part Anchored Toggle 
local part = script.Parent



-- Create a ClickDetector so we can tell when the part is clicked 

local cd = Instance.new("ClickDetector", part)



-- This function updates how the part looks based on its Anchored state

local function updateVisuals()

	if part.Anchored then

		-- When the part is anchored...

		part.BrickColor = BrickColor.new("Bright red")

		part.Material = Enum.Material.DiamondPlate

	else

		-- When the part is unanchored...

		part.BrickColor = BrickColor.new("Bright yellow")

		part.Material = Enum.Material.Wood

	end

end



local function onToggle()

	-- Toggle the anchored property

	part.Anchored = not part.Anchored

	

	-- Update visual state of the brick

	updateVisuals()

end



-- Update, then start listening for clicks

updateVisuals()

cd.MouseClick:Connect(onToggle)

Rangkuman

Properti

Lihat semua yang diwarisi dari Instance
Lihat semua yang diwarisi dari Object

Acara

Lihat semua yang diwarisi dari Instance
Lihat semua yang diwarisi dari Object

Properti

CursorIcon

ContentId
Baca Paralel

Tetapkan ikon kurungan untuk ditampilkan saat mouse ditampilkan di atas nenek moyang ini ClickDetector atau DragDetector . Jika elemen ini ditinggalkan kosong, detector akan menggunakan ikon default.

Untuk mengubah ikon kurungan, atur property ini ke ID aset gambar yang ingin Anda gunakan.

MaxActivationDistance

number
Baca Paralel

Properti ini mengontrol jarak maksimum, dalam stud, antara Character dan ClickDetector atau DragDetector bagi pemain untuk dapat berinteraksi deng

Lihat semua yang diwarisi dari Instance
Lihat semua yang diwarisi dari Object

Metode

Lihat semua yang diwarisi dari Instance
Lihat semua yang diwarisi dari Object

Acara

MouseClick

Acara ini menyebar dari salah satu Script atau LocalScript ketika seorang pemain berinteraksi dengan ClickDetector atau 1> Class.DragDetector1> melalui input berikut:

  • Pada platform dengan mouse, ketika pemain meninggalkan mouse klik.
  • Pada TouchEnabled platform, ketika pemain mengetuk.
  • Pada GamepadEnabled platform, ketika titik pusat berada di atas model yang sama dan tombol A ditekan dan dilepaskan.

Catat bahwa Character pemain harus berada dalam MaxActivationDistance dari detector.

Parameter

playerWhoClicked: Player

Class.Player yang mengklik pada orang tua dari ClickDetector atau DragDetector.


MouseHoverEnter

Acara ini diaktifkan dari a Script atau a LocalScript ketika orang tua dari a ClickDetector atau a 1>Class.DragDetector1> ditampilkan ole

Karena sifat masukan pengguna, Anda seharusnya tidak bergantung pada semua acara MouseHoverEnter yang menjalankan acara terkait MouseHoverLeave .

Parameter

playerWhoHovered: Player

The Player who started hovering over the parent of a ClickDetector or DragDetector .


Contoh Kode

The following code will print "[PlayerName] hovered over my parent!" when a player's cursor hovers over the ClickDetector parent. It will also print "[PlayerName] hovered off my parent!" when the player's cursor moves off the ClickDetector parent.

In order for this example to work as expected, it must be placed in a Script or LocalScript whose parent is a ClickDetector.

Hovering Over and Off a ClickDetector 
local clickDetector = script.Parent:FindFirstChildOfClass("ClickDetector")



clickDetector.MouseHoverEnter:Connect(function(player)

  print(player.Name .. " hovered over my parent!")

end)



clickDetector.MouseHoverLeave:Connect(function(player)

  print(player.Name .. " hovered off my parent!")

end)

MouseHoverLeave

Acara ini menyebabkan dari a Script atau a LocalScript ketika kursoir pemain menonaktifkan mouse pemain ketika mouse pemain menggantikan kursoir. Ini tidak melibatkan inter

Karena sifat masukan pengguna, Anda seharusnya tidak bergantung pada semua acara MouseHoverLeave setelah acara MouseHoverEnter yang sesuai.

Parameter

playerWhoHovered: Player

The Player whose cursor hovered off the parent of a ClickDetector or DragDetector .


Contoh Kode

The following code will print "[PlayerName] hovered over my parent!" when a player's cursor hovers over the ClickDetector parent. It will also print "[PlayerName] hovered off my parent!" when the player's cursor moves off the ClickDetector parent.

In order for this example to work as expected, it must be placed in a Script or LocalScript whose parent is a ClickDetector.

Hovering Over and Off a ClickDetector 
local clickDetector = script.Parent:FindFirstChildOfClass("ClickDetector")



clickDetector.MouseHoverEnter:Connect(function(player)

  print(player.Name .. " hovered over my parent!")

end)



clickDetector.MouseHoverLeave:Connect(function(player)

  print(player.Name .. " hovered off my parent!")

end)

RightMouseClick

Acara ini menyebabkan dari a Script atau a LocalScript ketika pemain mengklik mouse cursor mereka dengan benar di ClickDetector atau 1> Class.DragDetector1> . Cat

Parameter

playerWhoClicked: Player

The Player who right clicked their mouse cursor on the parent of a ClickDetector or DragDetector .


Lihat semua yang diwarisi dari Instance
Lihat semua yang diwarisi dari Object