Selection
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
El servicio de selección controla el Instances que se selecciona en Roblox Studio.
Este servicio es particularmente útil cuando se desarrolla Plugins, ya que permite al desarrollador acceder y manipular la selección actual.
Actualmente seleccionado Instances se puede obtener y establecer usando las funciones Selection:Get() y Selection:Set(). El evento 1> Class.Selection.SelectionChanged1> se activa cuando el seleccionado actual cambia.
Para obtener más información sobre el uso de Selection y Plugins, véase Plugin.
La selección también se usa a menudo en la barra de comandos, para establecer propiedades ocultas o ejecutar funciones para Instances seleccionados.
Tenga en cuenta que esta clase solo se aplica a Roblox Studio y no tiene aplicación a los juegos.
Amostras de código
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
Propriedades
SelectionThickness
Métodos
Add
Parâmetros
Devolução
Get
Devuelve un arreglo de Instances en Roblox Studio.
Si no se seleccionan Class.Instance|Instances , el arreglo devuelto estará vacío. Esta función se puede utilizar en conjunción con el evento Class.Selection.SelectionChanged para obtener la selección siempre que cambie.
Nota, esta función solo se puede usar en Plugins o la línea de comandos.
Para cambiar la selección actual, por favor vea Selection:Set() .
Devolução
Un arreglo de Instances seleccionado actualmente.
Amostras de código
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
Parâmetros
Devolução
Set
Establece los objetos seleccionados actualmente en Roblox Studio en Instances en el matriz/listade datos proporcionado.
Al llamar a esta función, se producirá el evento Selection.SelectionChanged , a menos que el nuevo conjunto de selección sea idéntico al conjunto de selección anterior.
Tenga en cuenta que esta función sobrescribió la selección existente. Sin embargo, usar Selection:Get() un Instance se puede agregar a la selección existente como se muestra a continuación:
local selected = Selection:Get()table.insert(selected, object)Selection:Set(selected)
Parâmetros
Un arreglo de Instances para establecer la selección actual.
Devolução
Amostras de código
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)
Eventos
SelectionChanged
Se activa cuando el Instances seleccionado en Roblox Studio cambia.
Nota: este evento no otorga la nueva selección. Los desarrolladores necesitarán usar la función Selection:Get() para obtener la selección actual.
Aunque este evento se puede usar fuera de los plugins y la barra de comandos, solo se aplica a la selección en Roblox Studio y por lo tanto no tiene funcionalidad fuera de Studio.
Para cambiar la selección, use la función Selection:Set().
Amostras de código
local selection = game:GetService("Selection")
selection.SelectionChanged:Connect(function()
print("Selection contains " .. #selection:Get() .. " items.")
end)