Selection

Veraltete anzeigen

*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.

Nicht erstellbar
Dienst

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

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

Zusammenfassung

Methoden

  • Add(instancesToAdd : Instances):void
    Plugin-Sicherheit
  • Get():Instances
    Plugin-Sicherheit

    Gibt eine Reihe von derzeit ausgewählten Instances in Roblox Studio zurück.

  • Remove(instancesToRemove : Instances):void
    Plugin-Sicherheit
  • Set(selection : Instances):void
    Plugin-Sicherheit

    Setzt die derzeit ausgewählten Objekte in Roblox Studio auf Instances in der angegebenen Array.

Eigenschaften

SelectionThickness

Schreibgeschützt
Nicht repliziert
Parallel lesen

Methoden

Add

void
Plugin-Sicherheit

Parameter

instancesToAdd: Instances

Rückgaben

void

Get

Instances
Plugin-Sicherheit

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

Instances

Ein Array von derzeit ausgewählten Instances .

Code-Beispiele

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

Parameter

instancesToRemove: Instances

Rückgaben

void

Set

void
Plugin-Sicherheit

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

selection: Instances

Ein Array von Instances , um die aktuelle Auswahl einzustellen.


Rückgaben

void

Code-Beispiele

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)

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

Selection.SelectionChanged

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