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

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.

Properti

SelectionThickness

Hanya Baca
Tidak Direplikasi
Baca Paralel

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

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
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

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)

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

Selection.SelectionChanged

local selection = game:GetService("Selection")
selection.SelectionChanged:Connect(function()
print("Selection contains " .. #selection:Get() .. " items.")
end)