Selection

Afficher les obsolètes

*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.

Création impossible
Service

Le service de sélection contrôle le Instances qui est sélectionné dans Roblox Studio.

Ce service est particulièrement utile lors du développement de Plugins, car il permet à l' développeur d'accéder et de manipuler la sélection actuelle.

Actuellement sélectionné Instances peut être obtenu et défini en utilisant les fonctions Selection:Get() et Selection:Set().L'événement Selection.SelectionChanged se déclenche chaque fois que la sélection actuelle change.

Pour plus d'informations sur l'utilisation de Selection et Plugins, voir Plugin .

La sélection est également souvent utilisée dans la barre de commande, pour définir des propriétés cachées ou exécuter des fonctions pour les éléments sélectionnés Instances.

Notez que cette classe ne s'applique qu'à Roblox Studio et n'a pas de pertinence pour les jeux.

Échantillons de code

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

Résumé

Méthodes

  • Add(instancesToAdd : Instances):()
    Sécurité des plugins
  • Get():Instances
    Sécurité des plugins

    Renvoie un tableau d'éléments sélectionnés actuellement Instances dans Roblox Studio.

  • Remove(instancesToRemove : Instances):()
    Sécurité des plugins
  • Set(selection : Instances):()
    Sécurité des plugins

    Définit les objets sélectionnés actuellement dans Roblox Studio à Instances dans l'matricede données donné.

Événements

Propriétés

SelectionThickness

Lecture uniquement
Non répliqué
Lecture parallèle

Méthodes

Add

()
Sécurité des plugins

Paramètres

instancesToAdd: Instances
Valeur par défaut : ""

Retours

()

Get

Instances
Sécurité des plugins

Retours

Instances

Échantillons de code

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

()
Sécurité des plugins

Paramètres

instancesToRemove: Instances
Valeur par défaut : ""

Retours

()

Set

()
Sécurité des plugins

Paramètres

selection: Instances
Valeur par défaut : ""

Retours

()

Échantillons de code

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)

Événements

SelectionChanged


Échantillons de code

Selection.SelectionChanged

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