Selection

Visualizza obsoleti

*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.

Non costruibile
Assistenza

Il servizio di selezione controlla il Instances che è selezionato in Roblox Studio.

Questo servizio è particolarmente utile quando si sviluppa Plugins , poiché consente al sviluppatore di accedere e manipolare la selezione attuale.

Attualmente selezionato Instances può essere ottenuto e impostato utilizzando le funzioni Selection:Get() e Selection:Set(). L'evento 1> Class.Selection.SelectionChanged1> attiva ogni volta che la selezione attuale cambia.

For more information on using Selection and Plugins, see Plugin .

La selezione viene anche spesso utilizzata nella barra dei comandi, per impostare proprietà nascoste o eseguire funzioni per Instances selezionati.

Nota che questa classe si applica solo a Roblox Studio e non ha applicabilità ai giochi.

Campioni di codice

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

Sommario

Metodi

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

    Restituisce un'area di selezione attualmente selezionata Instances in Roblox Studio.

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

    Imposta gli oggetti attualmente selezionati in Roblox Studio su Instances nell' vettorefornito.

Proprietà

SelectionThickness

Sola Lettura
Non Replicato
Lettura Parallela

Metodi

Add

void
Sicurezza Plugin

Parametri

instancesToAdd: Instances

Restituzioni

void

Get

Instances
Sicurezza Plugin

Restituisce un'area di selezione attualmente selezionata Instances in Roblox Studio.

Se non sono selezionati Class.Instance|Instances , l' array restituita sarà vuota. Questa funzione può essere utilizzata in conjunction con l'evento Class.Selection.SelectionChanged per ottenere la selezione ogni volta che cambia.

Nota, questa funzione può essere utilizzata solo in Plugins o nella linea di comando.

Per cambiare la selezione attuale, vedi Selection:Set() .


Restituzioni

Instances

Un array di attualmente selezionati Instances .

Campioni di codice

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

Parametri

instancesToRemove: Instances

Restituzioni

void

Set

void
Sicurezza Plugin

Imposta gli oggetti attualmente selezionati in Roblox Studio su Instances nell' vettorefornito.

Chiamando questa funzione, verrà Lanciarel'evento Selection.SelectionChanged , a meno che il nuovo set di selezione non sia identico all'ultima selezione.

Nota che questa funzione sovrascrive la selezione esistente. Tuttavia, l'uso di Selection:Get() un Instance può essere aggiunto alla selezione esistente come segue:


local selected = Selection:Get()
table.insert(selected, object)
Selection:Set(selected)

Parametri

selection: Instances

Un array di Instances per impostare la selezione corrente.


Restituzioni

void

Campioni di codice

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)

Eventi

SelectionChanged

Si attiva quando il Instances selezionato in Roblox Studio cambia.

Nota che questo evento non fornisce la nuova selezione. Gli sviluppatori dovranno utilizzare la funzione Selection:Get() per ottenere la selezione attuale.

Anche se questo evento può essere utilizzato al di fuori dei plugin e della barra dei comandi, si applica solo alla selezione in Roblox Studio e quindi non ha alcuna funzionalità al di fuori di Studio.

Per cambiare la selezione usa la funzione Selection:Set() .


Campioni di codice

Selection.SelectionChanged

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