Selection

Mostrar obsoleto

*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.

No creable
Servicio

El servicio de selección controla el Instances que se selecciona en Roblox Studio.

Este servicio es particularmente útil al desarrollar Plugins , ya que permite al desarrollador acceder y manipular la selección actual.

Actualmente seleccionado Instances se puede obtener y configurar usando las funciones Selection:Get() y Selection:Set().El evento Selection.SelectionChanged se activa cada vez que cambia la selección actual.

Para obtener más información sobre el uso de Selection y Plugins , vea Plugin .

La selección también se usa a menudo en la barra de comandos, para establecer propiedades ocultas o ejecutar funciones para los elementos seleccionados Instances.

Tenga en cuenta que esta clase solo se aplica a Roblox Studio y no tiene aplicabilidad a los juegos.

Muestras de código

The following code sample, when used in a plugin or the command bar, will rotate currently selected BaseParts.

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

Resumen

Métodos

  • Add(instancesToAdd : Instances):()
    Seguridad del plugin
  • Get():Instances
    Seguridad del plugin

    Devuelve un array de actualmente seleccionado Instances en Roblox Studio.

  • Remove(instancesToRemove : Instances):()
    Seguridad del plugin
  • Set(selection : Instances):()
    Seguridad del plugin

    Establece los objetos seleccionados actualmente en Roblox Studio en Instances en el matriz/listadado.

Ver todos los heredados de Instance
Ver todos los heredados de Object

Propiedades

SelectionThickness

number
Solo lectura
No replicado
Leer paralelo
Ver todos los heredados de Instance
Ver todos los heredados de Object

Métodos

Add

()
Seguridad del plugin

Parámetros

instancesToAdd: Instances
Valor predeterminado: ""

Devuelve

()

Get

Instances
Seguridad del plugin

Devuelve un array de actualmente seleccionado Instances en Roblox Studio.

Si no se seleccionan Instances, el array devuelto será vacío.Esta función se puede usar en conjunción con el evento Selection.SelectionChanged para obtener la selección cada vez que cambie.

Nota, esta función solo se puede usar en Plugins o en la línea de comandos.

Para cambiar la selección actual, consulte Selection:Set() .


Devuelve

Instances

Un array de actualmente seleccionado Instances .

Muestras de código

The following code sample, when used in a plugin or the command bar, will rotate currently selected BaseParts.

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

This example prints the number of selected items whenever SelectionChanged is fired:

Selection.SelectionChanged
local selection = game:GetService("Selection")



selection.SelectionChanged:Connect(function()

	print("Selection contains " .. #selection:Get() .. " items.")

end)

Remove

()
Seguridad del plugin

Parámetros

instancesToRemove: Instances
Valor predeterminado: ""

Devuelve

()

Set

()
Seguridad del plugin

Establece los objetos seleccionados actualmente en Roblox Studio en Instances en el matriz/listadado.

Llamar a esta función hará que se desencadenarel evento Selection.SelectionChanged , a menos que el nuevo conjunto de selección sea idéntico a la selección anterior.

Tenga en cuenta que esta función reemplaza la selección existente. Sin embargo, usar Selection:Get() una Instance se puede agregar a la selección existente como así:

local selected = Selection:Get()

table.insert(selected, object)

Selection:Set(selected)

Parámetros

selection: Instances

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

Valor predeterminado: ""

Devuelve

()

Muestras de código

This code sample will select every BasePart in the workspace that is Bright red.

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)
Ver todos los heredados de Instance
Ver todos los heredados de Object

Eventos

SelectionChanged

Se enciende cuando el Instances seleccionado en Roblox Studio cambia.

Tenga en cuenta que este evento no da la nueva selección. Los desarrolladores tendrán que 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().


Muestras de código

This example prints the number of selected items whenever SelectionChanged is fired:

Selection.SelectionChanged
local selection = game:GetService("Selection")



selection.SelectionChanged:Connect(function()

	print("Selection contains " .. #selection:Get() .. " items.")

end)
Ver todos los heredados de Instance
Ver todos los heredados de Object