Selection
*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.
Der Auswahl-Dienst kontrolliert die Instances, die in Roblox Studio ausgewählt sind.
Dieser Dienst ist besonders nützlich, wenn Plugins entwickelt wird, da er den Entwickler ermöglicht, auf die aktuelle Auswahl zuzugreifen und zu manipulieren.
Derzeit ausgewählte Instances kann mit den Funktionen Selection:Get() und Selection:Set() erhalten und gesetzt werden. Das 1> Class.Selection.SelectionChanged1> -Ereignis wird ausgelöst, wenn die aktuelle Auswahl geändert wird.
For more information on using Selection and Plugins, see Plugin.
Auswahl wird auch in der Befehlsleiste verwendet, um versteckte Eigenschaften oder Funktionen für ausgewählte Instances festzulegen.
Beachten Sie, dass diese Klasse nur auf Roblox Studio angewendet wird und keine Anwendbarkeit für Spiele hat.
Code-Beispiele
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
Zusammenfassung
Eigenschaften
Methoden
Ereignisse
Feuert, wenn die Instances in Roblox Studio geändert werden.
Eigenschaften
SelectionThickness
Methoden
Add
Parameter
Rückgaben
Get
Gibt eine Reihe von derzeit ausgewählten Instances in Roblox Studio zurück.
Wenn keine Class.Instance|Instances ausgewählt wurden, ist die zurückgegebene Matrix leer. Diese Funktion kann in Kombination mit dem Ereignis Class.Selection.SelectionChanged verwendet werden, um die Auswahl jedes Mal zu erhalten, wenn sie sich ändert.
Beachten Sie, dass diese Funktion nur in Plugins oder der Befehlszeile verwendet werden kann.
Für die Änderung der aktuellen Auswahl, siehe Selection:Set() .
Rückgaben
Ein Array von derzeit ausgewählten Instances .
Code-Beispiele
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
local selection = game:GetService("Selection")
selection.SelectionChanged:Connect(function()
print("Selection contains " .. #selection:Get() .. " items.")
end)
Remove
Parameter
Rückgaben
Set
Setzt die derzeit ausgewählten Objekte in Roblox Studio auf Instances in der angegebenen Array.
Wenn Sie diese Funktion aufrufen, wird das Ereignis Selection.SelectionChanged initiieren, es sei denn, das neue Auswahlset ist identisch mit der vorherigen Auswahl.
Beachten Sie, dass diese Funktion die vorhandene Auswahl überschreibt. jedoch, die Verwendung von Selection:Get() an Instance kann der vorhandenen Auswahl wie folgt hinzugefügt werden:
local selected = Selection:Get()table.insert(selected, object)Selection:Set(selected)
Parameter
Ein Array von Instances , um die aktuelle Auswahl einzustellen.
Rückgaben
Code-Beispiele
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)
Ereignisse
SelectionChanged
Feuert, wenn die Instances in Roblox Studio geändert werden.
Beachten Sie, dass dieses Ereignis keine neue Auswahl gibt. Entwickler müssen die Selection:Get() Funktion verwenden, um die aktuelle Auswahl zu erhalten.
Obwohl dieses Ereignis außerhalb von Plugins und der Kommandoleiste verwendet werden kann, gilt es nur für die Auswahl in Roblox Studio und hat daher keine Funktionalität außerhalb von Studio.
Um die Auswahl zu ändern, verwenden Sie die Funktion Selection:Set().
Code-Beispiele
local selection = game:GetService("Selection")
selection.SelectionChanged:Connect(function()
print("Selection contains " .. #selection:Get() .. " items.")
end)