Selection

Mostrar obsoleto

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.

Não criável
Serviço

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

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

Resumo

Métodos

  • Add(instancesToAdd : Instances):void
    Segurança do plugin
  • Get():Instances
    Segurança do plugin

    Devuelve un arreglo de Instances en Roblox Studio.

  • Remove(instancesToRemove : Instances):void
    Segurança do plugin
  • Set(selection : Instances):void
    Segurança do plugin

    Establece los objetos seleccionados actualmente en Roblox Studio en Instances en el matriz/listade datos proporcionado.

Propriedades

SelectionThickness

Somente leitura
Não replicado
Ler Parallel

Métodos

Add

void
Segurança do plugin

Parâmetros

instancesToAdd: Instances

Devolução

void

Get

Instances
Segurança do plugin

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

Instances

Un arreglo de Instances seleccionado actualmente.

Amostras de código

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
Segurança do plugin

Parâmetros

instancesToRemove: Instances

Devolução

void

Set

void
Segurança do plugin

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

selection: Instances

Un arreglo de Instances para establecer la selección actual.


Devolução

void

Amostras de código

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)

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

Selection.SelectionChanged

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