Selection

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.

Tidak Dapat Dibuat
Layanan

Layanan Pemilihan mengontrol Instances yang dipilih di Roblox Studio.

Layanan ini sangat berguna ketika mengembangkan Plugins, karena memungkinkan pengembang untuk mengakses dan menyetel pilihan saat ini.

Saat ini dipilih Instances dapat diperoleh dan ditetapkan menggunakan fungsi Selection:Get() dan Selection:Set(). Acara 1> Class.Selection.SelectionChanged1> diaktifkan setiap kali perubahan seleks saat ini.

Untuk lebih banyak informasi tentang menggunakan Selection dan Plugins, lihat Plugin.

Pemilihan juga sering digunakan di bilah perintah, untuk menetapkan propperti tersembunyi atau mengeksekusi fungsi untuk Instances yang dipilih.

Catat bahwa kelas ini hanya berlaku untuk Roblox Studio dan tidak ada kesanggupan untuk game.

Contoh Kode

The following code sample, when used in a plugin or the command bar, will rotate currently selected BaseParts.

Selection
local Selection = game:GetService("Selection")



for _, object in pairs(Selection:Get()) do

	if object:IsA("BasePart") then

		object.CFrame = object.CFrame * CFrame.Angles(0, math.pi / 2, 0)

	end

end

Rangkuman

Metode

  • Add(instancesToAdd : Instances):void
    Keamanan Plugin
  • Get():Instances
    Keamanan Plugin

    Mengembalikan sebuah array dari saat ini dipilih Instances di Roblox Studio.

  • Remove(instancesToRemove : Instances):void
    Keamanan Plugin
  • Set(selection : Instances):void
    Keamanan Plugin

    Tetapkan objek yang saat ini dipilih di Roblox Studio menjadi Instances dalam array yang diberikan.

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

Properti

SelectionThickness

number
Hanya Baca
Tidak Direplikasi
Baca Paralel
Lihat semua yang diwarisi dari Instance
Lihat semua yang diwarisi dari Object

Metode

Add

void
Keamanan Plugin

Parameter

instancesToAdd: Instances

Memberikan nilai

void

Get

Instances
Keamanan Plugin

Mengembalikan sebuah array dari saat ini dipilih Instances di Roblox Studio.

Jika tidak ada Instances yang dipilih, array yang dikembalikan akan kosong. Fungsi ini dapat digunakan bersama dengan acara Selection.SelectionChanged untuk mendapatkan pilihan setiap kali itu berubah.

Catatan, fungsi ini hanya dapat digunakan di Plugins atau di command line.

Untuk mengubah pilihan saat ini, silakan lihat Selection:Set() .


Memberikan nilai

Instances

Sebuah matriks dari saat ini dipilih Instances .

Contoh Kode

The following code sample, when used in a plugin or the command bar, will rotate currently selected BaseParts.

Selection
local Selection = game:GetService("Selection")



for _, object in pairs(Selection:Get()) do

	if object:IsA("BasePart") then

		object.CFrame = object.CFrame * CFrame.Angles(0, math.pi / 2, 0)

	end

end

This example prints the number of selected items whenever SelectionChanged is fired:

Selection.SelectionChanged
local selection = game:GetService("Selection")



selection.SelectionChanged:Connect(function()

	print("Selection contains " .. #selection:Get() .. " items.")

end)

Remove

void
Keamanan Plugin

Parameter

instancesToRemove: Instances

Memberikan nilai

void

Set

void
Keamanan Plugin

Tetapkan objek yang saat ini dipilih di Roblox Studio menjadi Instances dalam array yang diberikan.

Memanggil fungsi ini akan menyebabkan acara Selection.SelectionChanged terjadi, kecuali jika set pemilihan baru sama dengan pemilihan sebelumnya.

Catat bahwa fungsi ini menggeser pilihan yang ada. Namun, menggunakan Selection:Get() an Instance dapat ditambahkan ke pilihan yang ada seperti berikut:

local selected = Selection:Get()

table.insert(selected, object)

Selection:Set(selected)

Parameter

selection: Instances

Sebuah matriks Instances untuk menetapkan pilihan saat ini.


Memberikan nilai

void

Contoh Kode

This code sample will select every BasePart in the workspace that is Bright red.

Selection Set
local Selection = game:GetService("Selection")



local newSelection = {}

for _, object in pairs(workspace:GetDescendants()) do

	if object:IsA("BasePart") and object.BrickColor == BrickColor.new("Bright red") then

		table.insert(newSelection, object)

	end

end



Selection:Set(newSelection)
Lihat semua yang diwarisi dari Instance
Lihat semua yang diwarisi dari Object

Acara

SelectionChanged

Dibakar saat Instances yang dipilih di Roblox Studio berubah.

Catat bahwa acara ini tidak memberikan pilihan baru. Pengembang akan perlu menggunakan fungsi Selection:Get() untuk mengambil pilihan saat ini.

Meskipun acara ini dapat digunakan di luar plugin dan bilah perintah, itu hanya berlaku untuk pemilihan di Roblox Studio dan oleh karena itu tidak memiliki fungsionalitas di luar Studio.

Untuk mengubah pilihan menggunakan fungsi Selection:Set() .


Contoh Kode

This example prints the number of selected items whenever SelectionChanged is fired:

Selection.SelectionChanged
local selection = game:GetService("Selection")



selection.SelectionChanged:Connect(function()

	print("Selection contains " .. #selection:Get() .. " items.")

end)
Lihat semua yang diwarisi dari Instance
Lihat semua yang diwarisi dari Object